Skip to main content

Retrieve monthly package download statistics from PyPI

Project description


pypstats is for retrieving monthly and per release download statistics of packages that are distributed via PyPI. It can be used to write .csv files, plot monthly stats, and retrieve information on the latest release. Monthly statistics are stored at in compressed files starting from June 2010. These files contain information on releases that are removed from PyPI, so pypstats provides complete statistics for packages that are released after June 2010.


Download a package file from Extract its contents and run as follows:

$ tar -xzf pypstats-1.x.tar.gz
$ cd pypstats-1.x
$ python install

Or, if if you have Easy Install installed, type the following:

$ easy_install -U pypstats


First use

Before statistics can be printed or plotted, you need to retrieve statistics and save them locally using pypstats update command:

$ pypstats update ProDy
Fetching content from ''.
Parsing monthly statistics file details.
Updating statistics for 2010-06.
Updating statistics for 2012-01.
Package statistics are updated (ProDy_stats.pkl).

Retrieving statistics at the first use will take some time, since all monthly stats files are downloaded.

Monthly stats

Monthly statistics can be printed using pypstats monthly command:

$ pypstats monthly ProDy_stats.pkl
Loading statistics from 'ProDy_stats.pkl'.
Month Downloads
2010-11       286
2012-01       1041
Total   10664

This information can also be plotted and saved in a .csv file as follows:

$ pypstats monthly -o monthly.csv -p monthly.png ProDy_stats.pkl
Loading statistics from 'ProDy_stats.pkl'.
Monthly statistics are written in 'monthly.csv'.
Monthly downloads plot is saved as 'monthly.png'.

See an example plot here:

Release stats

Release statistics can be printed using pypstats release command:

$ pypstats release ProDy_stats.pkl
Loading statistics from 'ProDy_stats.pkl'.
Release       Downloads
0.1.0 397
0.9.2 328
Total 10664

Similarly, output can be written into a .csv file as follows:

$ pypstats release -o release_stats.csv -q ProDy_stats.pkl

Note that -q argument suppresses messages written to stderr.

Total downloads

Total number of downloads can be printed using pypstats total command:

$ pypstats total -q ProDy_stats.pkl

Latest release

Latest release information can be retrieved using pypstats latest command:

$ pypstats latest -q ProDy
File  URL     md5     Type    Py Version      Size    Downloads
ProDy-0.9.2.tar.gz       9ad6f6e6012f824ea5e7acb344607eae        Source          711KB   119
ProDy-0.9.2.win32-py2.6.exe 51f8587dcc8fe6d0355327d811ea71c3        MS Windows installer    2.6     455KB   47
ProDy-0.9.2.win32-py2.7.exe 68ba279f3d9e02b38e4f3e6339b41b26        MS Windows installer    2.7     909KB   53  b447f8b607defd5cda65163e43b32150        Source          744KB   109

This information can be written into a CSV file using reStructured Text style:

$ pypstats latest -q -o latest_release.csv --rst ProDy

This file can be used in a page prepared using Sphinx, see for an example:


Local statistics file can be updated using pypstats update command:

$ pypstats update -s ProDy_stats.pkl ProDy
Fetching content from ''.
Parsing monthly statistics file details.
Nothing to update.

This command will make an incremental update by downloading the files that changed since the last update.


To get help, type in a command name with -h argument:

$ pypstats -h
usage: [-h] {latest,monthly,total,update,release} ...

Fetch package download statistics from Python Package Index (PyPI). Package
needs to be distributed via PyPI.

optional arguments:
  -h, --help            show this help message and exit

    update              retrieve or update download statistics
    latest              retrieve and output latest release information
    monthly             output/plot monthly download statistics
    release             output download statistics by release
    total               output total number of downloads

See 'pypstats <command> -h' for more information on a specific command.
$ pypstats monthly -h
usage: monthly [-h] [-q] [-o FILENAME] [-d DELIMITER]
                           [-p FILENAME] [--dpi INT] [--mlabelstep INT]

positional arguments:
  pkl               package statistics filename

optional arguments:
  -h, --help        show this help message and exit
  -q, --quiet       suppress stderr log messages
  -o FILENAME       output CSV filename, if not provided print to stdout
  -d DELIMITER      output column delimiter (default: ' ')
  -p FILENAME       figure filename, requires Matplotlib
  --dpi INT         figure resolution (default: '72')
  --mlabelstep INT  figure month label step (default: '2')


pypstats is available under GNU General Public License version 3. See LICENSE.rst for more details.



  • Renamed script pypstats to pyps.

  • Downloaded stats files are save to temp folder. When multiple package stats are updated consequently, content is read from this folder.


  • Renamed command current to latest.



Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions (11.0 kB view hashes)

Uploaded Source

pypstats-1.2.1.tar.gz (7.7 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page