{"id":13821124,"url":"https://github.com/laughingman7743/PyAthena","last_synced_at":"2025-05-16T12:32:34.746Z","repository":{"id":37470570,"uuid":"91921249","full_name":"laughingman7743/PyAthena","owner":"laughingman7743","description":"PyAthena is a Python DB API 2.0 (PEP 249) client for Amazon Athena.","archived":false,"fork":false,"pushed_at":"2025-04-24T14:50:50.000Z","size":2607,"stargazers_count":475,"open_issues_count":21,"forks_count":101,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-05-13T23:18:02.433Z","etag":null,"topics":["athena","aws","dbapi","python","sqlalchemy"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/laughingman7743.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-05-20T23:05:31.000Z","updated_at":"2025-05-10T03:07:25.000Z","dependencies_parsed_at":"2022-07-09T11:16:07.476Z","dependency_job_id":"6a8a0bde-366d-4d71-9b02-ffdf108ec301","html_url":"https://github.com/laughingman7743/PyAthena","commit_stats":{"total_commits":766,"total_committers":23,"mean_commits":33.30434782608695,"dds":0.06135770234986948,"last_synced_commit":"3a53ac35285365a5facc9ee281ef12c6936be8ed"},"previous_names":[],"tags_count":145,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laughingman7743%2FPyAthena","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laughingman7743%2FPyAthena/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laughingman7743%2FPyAthena/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laughingman7743%2FPyAthena/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/laughingman7743","download_url":"https://codeload.github.com/laughingman7743/PyAthena/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254300806,"owners_count":22047876,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["athena","aws","dbapi","python","sqlalchemy"],"created_at":"2024-08-04T08:01:15.667Z","updated_at":"2025-05-16T12:32:29.737Z","avatar_url":"https://github.com/laughingman7743.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":".. |badge package| image:: https://badge.fury.io/py/pyathena.svg\n  :target: https://badge.fury.io/py/pyathena\n.. |badge pypi| image:: https://img.shields.io/pypi/pyversions/PyAthena.svg\n  :target: https://pypi.org/project/PyAthena/\n.. |badge test| image:: https://github.com/laughingman7743/PyAthena/actions/workflows/test.yaml/badge.svg\n  :target: https://github.com/laughingman7743/PyAthena/actions/workflows/test.yaml\n.. |badge docs| image:: https://github.com/laughingman7743/PyAthena/actions/workflows/docs.yaml/badge.svg\n  :target: https://github.com/laughingman7743/PyAthena/actions/workflows/docs.yaml\n.. |badge license| image:: https://img.shields.io/pypi/l/PyAthena.svg\n  :target: https://github.com/laughingman7743/PyAthena/blob/master/LICENSE\n.. |badge downloads| image:: https://static.pepy.tech/badge/pyathena/month\n  :target: https://pepy.tech/project/pyathena\n.. |badge ruff| image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json\n  :target: https://github.com/astral-sh/ruff\n  :alt: Ruff\n.. |badge mypy| image:: https://www.mypy-lang.org/static/mypy_badge.svg\n  :target: https://mypy-lang.org/\n  :alt: mypy\n\nPyAthena\n========\n\nPyAthena is a Python `DB API 2.0 (PEP 249)`_ client for `Amazon Athena`_.\n\n+---------+------------------------------------------------+\n| Package | |badge package| |badge pypi| |badge downloads| |\n+---------+------------------------------------------------+\n| CI/CD   | |badge test| |badge docs|                      |\n+---------+------------------------------------------------+\n| Meta    | |badge license| |badge ruff| |badge mypy|      |\n+---------+------------------------------------------------+\n\n.. _`DB API 2.0 (PEP 249)`: https://www.python.org/dev/peps/pep-0249/\n.. _`Amazon Athena`: https://docs.aws.amazon.com/athena/latest/APIReference/Welcome.html\n\n.. _requirements:\n\nRequirements\n------------\n\n* Python\n\n  - CPython 3.8 3.9 3.10, 3.11 3.12\n\n.. _installation:\n\nInstallation\n------------\n\n.. code:: bash\n\n    $ pip install PyAthena\n\nExtra packages:\n\n+---------------+---------------------------------------+------------------+\n| Package       | Install command                       | Version          |\n+===============+=======================================+==================+\n| SQLAlchemy    | ``pip install PyAthena[SQLAlchemy]``  | \u003e=1.0.0          |\n+---------------+---------------------------------------+------------------+\n| Pandas        | ``pip install PyAthena[Pandas]``      | \u003e=1.3.0          |\n+---------------+---------------------------------------+------------------+\n| Arrow         | ``pip install PyAthena[Arrow]``       | \u003e=7.0.0          |\n+---------------+---------------------------------------+------------------+\n| fastparquet   | ``pip install PyAthena[fastparquet]`` | \u003e=0.4.0          |\n+---------------+---------------------------------------+------------------+\n\n.. _usage:\n\nUsage\n-----\n\n.. code:: python\n\n    from pyathena import connect\n\n    cursor = connect(s3_staging_dir=\"s3://YOUR_S3_BUCKET/path/to/\",\n                     region_name=\"us-west-2\").cursor()\n    cursor.execute(\"SELECT * FROM one_row\")\n    print(cursor.description)\n    print(cursor.fetchall())\n\n.. _license:\n\nLicense\n-------\n\n`MIT license`_\n\nMany of the implementations in this library are based on `PyHive`_, thanks for `PyHive`_.\n\n.. _`MIT license`: LICENSE\n.. _`PyHive`: https://github.com/dropbox/PyHive\n\nLinks\n-----\n\n- Documentation: https://laughingman7743.github.io/PyAthena/\n- PyPI Releases: https://pypi.org/project/PyAthena/\n- Source Code: https://github.com/laughingman7743/PyAthena/\n- Issue Tracker: https://github.com/laughingman7743/PyAthena/issues\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flaughingman7743%2FPyAthena","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flaughingman7743%2FPyAthena","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flaughingman7743%2FPyAthena/lists"}