https://github.com/jwodder/pypi-stats

Show download stats for PyPI packages
https://github.com/jwodder/pypi-stats

pypi pypistats python

Last synced: 17 days ago
JSON representation

Show download stats for PyPI packages

• Host: GitHub
• URL: https://github.com/jwodder/pypi-stats
• Owner: jwodder
• License: mit
• Created: 2021-10-09T02:21:42.000Z (about 3 years ago)
• Default Branch: master
• Last Pushed: 2024-11-29T14:35:45.000Z (about 1 month ago)
• Last Synced: 2024-11-29T15:33:34.685Z (about 1 month ago)
• Topics: pypi, pypistats, python
• Language: Python
• Homepage:
• Size: 25.4 KB
• Stars: 0
• Watchers: 4
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
|repostatus| |ci-status| |license|

.. |repostatus| image:: https://www.repostatus.org/badges/latest/concept.svg

    :target: https://www.repostatus.org/#concept

    :alt: Project Status: Concept – Minimal or no implementation has been done

          yet, or the repository is only intended to be a limited example,

          demo, or proof-of-concept.

.. |ci-status| image:: https://github.com/jwodder/pypi-stats/actions/workflows/test.yml/badge.svg

    :target: https://github.com/jwodder/pypi-stats/actions/workflows/test.yml

    :alt: CI Status

.. |license| image:: https://img.shields.io/github/license/jwodder/pypi-stats.svg

    :target: https://opensource.org/licenses/MIT

    :alt: MIT License

`GitHub `_

| `Issues `_

``pypi-stats`` (note hyphen) is a wrapper around pypistats_ (note non-hyphen)

for making API requests to https://pypistats.org (note .org) to fetch recent

download stats for given PyPI packages (and/or packages belonging to given PyPI

users), outputting either a CSV file or an ASCII table.

.. _pypistats: https://github.com/hugovk/pypistats

Installation

============

``pypi-stats`` requires Python 3.11 or higher.  Just use `pip

`_ for Python 3 (You have pip, right?) to install it::

    python3 -m pip install git+https://github.com/jwodder/pypi-stats.git

Usage

=====

::

    pypi-stats []  ...

``pypi-stats`` queries https://pypistats.org for the recent download stats for

each PyPI package named on the command line, outputting the number of downloads

for each one in the last month, week, and day.

Options

-------

-A, --sort-alpha                Sort packages alphabetically by name

-C, --csv                       Output a CSV document; this is the default.

                                The first line of the output is a header

                                giving the field names: ``package``,

                                ``last_month``, ``last_week``, and

                                ``last_day``, in that order.

-N, --sort-num                  Sort packages by downloads in the last month in

                                descending order

-T, --table                     Output an ASCII table

-u, --user USER                 Also fetch download stats for all packages for

                                which the given PyPI user is an owner or

                                maintainer.  This option can be specified

                                multiple times.