|repostatus| |ci-status| |coverage| |pyversions| |license|
.. |repostatus| image:: https://www.repostatus.org/badges/latest/active.svg
:target: https://www.repostatus.org/#active
:alt: Project Status: Active — The project has reached a stable, usable
state and is being actively developed.
.. |ci-status| image:: https://github.com/jwodder/pypi-simple/actions/workflows/test.yml/badge.svg
:target: https://github.com/jwodder/pypi-simple/actions/workflows/test.yml
:alt: CI Status
.. |coverage| image:: https://codecov.io/gh/jwodder/pypi-simple/branch/master/graph/badge.svg
:target: https://codecov.io/gh/jwodder/pypi-simple
.. |pyversions| image:: https://img.shields.io/pypi/pyversions/pypi-simple.svg
:target: https://pypi.org/project/pypi-simple/
.. |license| image:: https://img.shields.io/github/license/jwodder/pypi-simple.svg
:target: https://opensource.org/licenses/MIT
:alt: MIT License
`GitHub <https://github.com/jwodder/pypi-simple>`_
| `PyPI <https://pypi.org/project/pypi-simple/>`_
| `Documentation <https://pypi-simple.readthedocs.io>`_
| `Issues <https://github.com/jwodder/pypi-simple/issues>`_
| `Changelog <https://github.com/jwodder/pypi-simple/blob/master/CHANGELOG.md>`_
``pypi-simple`` is a client library for the Python Simple Repository API as
specified in :pep:`503` and updated by :pep:`592`, :pep:`629`, :pep:`658`,
:pep:`691`, :pep:`700`, :pep:`708`, :pep:`714`, :pep:`740`, and :pep:`792`.
With it, you can query `the Python Package Index (PyPI) <https://pypi.org>`_
and other `pip <https://pip.pypa.io>`_-compatible repositories for a list of
their available projects and lists of each project's available package files.
The library also allows you to download package files and query them for their
project version, package type, file digests, ``requires_python`` string, PGP
signature URL, and metadata URL.
See `the documentation <https://pypi-simple.readthedocs.io>`_ for more
information.
Installation
============
``pypi-simple`` requires Python 3.8 or higher. Just use `pip
<https://pip.pypa.io>`_ for Python 3 (You have pip, right?) to install it::
python3 -m pip install pypi-simple
``pypi-simple`` can optionally make use of tqdm_. To install it alongside
``pypi-simple``, specify the ``tqdm`` extra::
python3 -m pip install "pypi-simple[tqdm]"
.. _tqdm: https://tqdm.github.io
Examples
========
Get information about a package:
>>> from pypi_simple import PyPISimple
>>> with PyPISimple() as client:
... requests_page = client.get_project_page('requests')
>>> pkg = requests_page.packages[0]
>>> pkg.filename
'requests-0.2.0.tar.gz'
>>> pkg.url
'https://files.pythonhosted.org/packages/ba/bb/dfa0141a32d773c47e4dede1a617c59a23b74dd302e449cf85413fc96bc4/requests-0.2.0.tar.gz'
>>> pkg.project
'requests'
>>> pkg.version
'0.2.0'
>>> pkg.package_type
'sdist'
>>> pkg.digests
{'sha256': '813202ace4d9301a3c00740c700e012fb9f3f8c73ddcfe02ab558a8df6f175fd'}
Download a package with a tqdm progress bar:
.. code:: python
from pypi_simple import PyPISimple, tqdm_progress_factory
with PyPISimple() as client:
page = client.get_project_page("pypi-simple")
pkg = page.packages[-1]
client.download_package(
pkg, path=pkg.filename, progress=tqdm_progress_factory(),
)
`See more examples in the docs.`__
__ https://pypi-simple.readthedocs.io/en/stable/examples.html
Raw data
{
"_id": null,
"home_page": null,
"name": "pypi-simple",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "packages, pep503, pip, pypi, simple repository api",
"author": null,
"author_email": "John Thorvald Wodder II <pypi-simple@varonathe.org>",
"download_url": "https://files.pythonhosted.org/packages/f5/bc/6c1e5caa5cd13b57cde193e1c1a17f370603dd78c55a3a01c1fcbe5149d3/pypi_simple-1.8.0.tar.gz",
"platform": null,
"description": "|repostatus| |ci-status| |coverage| |pyversions| |license|\n\n.. |repostatus| image:: https://www.repostatus.org/badges/latest/active.svg\n :target: https://www.repostatus.org/#active\n :alt: Project Status: Active \u2014 The project has reached a stable, usable\n state and is being actively developed.\n\n.. |ci-status| image:: https://github.com/jwodder/pypi-simple/actions/workflows/test.yml/badge.svg\n :target: https://github.com/jwodder/pypi-simple/actions/workflows/test.yml\n :alt: CI Status\n\n.. |coverage| image:: https://codecov.io/gh/jwodder/pypi-simple/branch/master/graph/badge.svg\n :target: https://codecov.io/gh/jwodder/pypi-simple\n\n.. |pyversions| image:: https://img.shields.io/pypi/pyversions/pypi-simple.svg\n :target: https://pypi.org/project/pypi-simple/\n\n.. |license| image:: https://img.shields.io/github/license/jwodder/pypi-simple.svg\n :target: https://opensource.org/licenses/MIT\n :alt: MIT License\n\n`GitHub <https://github.com/jwodder/pypi-simple>`_\n| `PyPI <https://pypi.org/project/pypi-simple/>`_\n| `Documentation <https://pypi-simple.readthedocs.io>`_\n| `Issues <https://github.com/jwodder/pypi-simple/issues>`_\n| `Changelog <https://github.com/jwodder/pypi-simple/blob/master/CHANGELOG.md>`_\n\n``pypi-simple`` is a client library for the Python Simple Repository API as\nspecified in :pep:`503` and updated by :pep:`592`, :pep:`629`, :pep:`658`,\n:pep:`691`, :pep:`700`, :pep:`708`, :pep:`714`, :pep:`740`, and :pep:`792`.\nWith it, you can query `the Python Package Index (PyPI) <https://pypi.org>`_\nand other `pip <https://pip.pypa.io>`_-compatible repositories for a list of\ntheir available projects and lists of each project's available package files.\nThe library also allows you to download package files and query them for their\nproject version, package type, file digests, ``requires_python`` string, PGP\nsignature URL, and metadata URL.\n\nSee `the documentation <https://pypi-simple.readthedocs.io>`_ for more\ninformation.\n\n\nInstallation\n============\n``pypi-simple`` requires Python 3.8 or higher. Just use `pip\n<https://pip.pypa.io>`_ for Python 3 (You have pip, right?) to install it::\n\n python3 -m pip install pypi-simple\n\n``pypi-simple`` can optionally make use of tqdm_. To install it alongside\n``pypi-simple``, specify the ``tqdm`` extra::\n\n python3 -m pip install \"pypi-simple[tqdm]\"\n\n.. _tqdm: https://tqdm.github.io\n\n\nExamples\n========\n\nGet information about a package:\n\n>>> from pypi_simple import PyPISimple\n>>> with PyPISimple() as client:\n... requests_page = client.get_project_page('requests')\n>>> pkg = requests_page.packages[0]\n>>> pkg.filename\n'requests-0.2.0.tar.gz'\n>>> pkg.url\n'https://files.pythonhosted.org/packages/ba/bb/dfa0141a32d773c47e4dede1a617c59a23b74dd302e449cf85413fc96bc4/requests-0.2.0.tar.gz'\n>>> pkg.project\n'requests'\n>>> pkg.version\n'0.2.0'\n>>> pkg.package_type\n'sdist'\n>>> pkg.digests\n{'sha256': '813202ace4d9301a3c00740c700e012fb9f3f8c73ddcfe02ab558a8df6f175fd'}\n\nDownload a package with a tqdm progress bar:\n\n.. code:: python\n\n from pypi_simple import PyPISimple, tqdm_progress_factory\n\n with PyPISimple() as client:\n page = client.get_project_page(\"pypi-simple\")\n pkg = page.packages[-1]\n client.download_package(\n pkg, path=pkg.filename, progress=tqdm_progress_factory(),\n )\n\n`See more examples in the docs.`__\n\n__ https://pypi-simple.readthedocs.io/en/stable/examples.html\n",
"bugtrack_url": null,
"license": null,
"summary": "PyPI Simple Repository API client library",
"version": "1.8.0",
"project_urls": {
"Bug Tracker": "https://github.com/jwodder/pypi-simple/issues",
"Source Code": "https://github.com/jwodder/pypi-simple"
},
"split_keywords": [
"packages",
" pep503",
" pip",
" pypi",
" simple repository api"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "c4ad5ce88458a6d01147d600d72bb55f5086ff3ffa5f4085c6d3e37e91f4d591",
"md5": "ccbbcc8956ddab450be82017886515dc",
"sha256": "85f56420ab1d8e7ef5e55daabcee20c73e714f2bfee5505d811b075cc72d9ecc"
},
"downloads": -1,
"filename": "pypi_simple-1.8.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ccbbcc8956ddab450be82017886515dc",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 26663,
"upload_time": "2025-09-03T14:46:23",
"upload_time_iso_8601": "2025-09-03T14:46:23.739796Z",
"url": "https://files.pythonhosted.org/packages/c4/ad/5ce88458a6d01147d600d72bb55f5086ff3ffa5f4085c6d3e37e91f4d591/pypi_simple-1.8.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "f5bc6c1e5caa5cd13b57cde193e1c1a17f370603dd78c55a3a01c1fcbe5149d3",
"md5": "d2d2597bf09ae030d5efec3bce063e2f",
"sha256": "466f2fcd0d723822aae3a0ccfda22e68ff8cd7f50aae68911946ab1dd1d587e1"
},
"downloads": -1,
"filename": "pypi_simple-1.8.0.tar.gz",
"has_sig": false,
"md5_digest": "d2d2597bf09ae030d5efec3bce063e2f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 57463,
"upload_time": "2025-09-03T14:46:25",
"upload_time_iso_8601": "2025-09-03T14:46:25.115446Z",
"url": "https://files.pythonhosted.org/packages/f5/bc/6c1e5caa5cd13b57cde193e1c1a17f370603dd78c55a3a01c1fcbe5149d3/pypi_simple-1.8.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-03 14:46:25",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jwodder",
"github_project": "pypi-simple",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "pypi-simple"
}
JSON
