Package: pypstats
SYNOPSISpypstatsis for retrieving monthly and per release download statistics
of packages that are distributed viaPyPI.
It can be used to write.csvfiles, plot monthly stats, and retrieve
information on the latest release.  Monthly statistics are stored athttp://pypi.python.org/stats/months/in compressed files starting from
June 2010.  These files contain information on releases that are removed
from PyPI, sopypstatsprovides complete statistics for packages that
are released after June 2010.INSTALLATIONDownload a package file fromhttp://pypi.python.org/pypi/pypstats. Extract
its contents and runsetup.pyas follows:$ tar -xzf pypstats-1.x.tar.gz
$ cd pypstats-1.x
$ python setup.py installOr, if if you haveEasy Installinstalled, type the following:$ easy_install -U pypstatsUSAGEFirst useBefore statistics can be printed or plotted, you need to retrieve statistics
and save them locally usingpypstats updatecommand:$ pypstats update ProDy
Fetching content from 'http://pypi.python.org/stats/months/'.
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. Note that downloaded files will be
save in temporary folder, unless--nocacheoption is passed.  Saving
downloaded files will make building stats file for multiple packages faster.Monthly statsMonthly statistics can be printed usingpypstats monthlycommand:$ pypstats monthly ProDy_stats.pkl
Loading statistics from 'ProDy_stats.pkl'.
Month Downloads
2010-11       286
...
2012-01       1041
Total   10664This information can also be plotted and saved in a.csvfile 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'.Release statsRelease statistics can be printed usingpypstats releasecommand:$ pypstats release ProDy_stats.pkl
Loading statistics from 'ProDy_stats.pkl'.
Release       Downloads
0.1.0 397
...
0.9.2 328
Total 10664Similarly, output can be written into a.csvfile as follows:$ pypstats release -o release_stats.csv -q ProDy_stats.pklNote that-qargument suppresses messages written tostderr.Total downloadsTotal number of downloads can be printed usingpypstats totalcommand:$ pypstats total -q ProDy_stats.pkl
10664Latest releaseLatest release information can be retrieved usingpypstats latestcommand:$ pypstats latest -q ProDy
File  URL     md5     Type    Py Version      Size    Downloads
ProDy-0.9.2.tar.gz    http://pypi.python.org/packages/source/P/ProDy/ProDy-0.9.2.tar.gz       9ad6f6e6012f824ea5e7acb344607eae        Source          711KB   119
ProDy-0.9.2.win32-py2.6.exe   http://pypi.python.org/packages/2.6/P/ProDy/ProDy-0.9.2.win32-py2.6.exe 51f8587dcc8fe6d0355327d811ea71c3        MS Windows installer    2.6     455KB   47
ProDy-0.9.2.win32-py2.7.exe   http://pypi.python.org/packages/2.7/P/ProDy/ProDy-0.9.2.win32-py2.7.exe 68ba279f3d9e02b38e4f3e6339b41b26        MS Windows installer    2.7     909KB   53
ProDy-0.9.2.zip       http://pypi.python.org/packages/source/P/ProDy/ProDy-0.9.2.zip  b447f8b607defd5cda65163e43b32150        Source          744KB   109This information can be written into a CSV file using reStructured Text style:$ pypstats latest -q -o latest_release.csv --rst ProDyThis file can be used in a page prepared usingSphinx,
see for an example:http://www.csb.pitt.edu/ProDy/getprody.htmlUpdatesLocal statistics file can be updated usingpypstats updatecommand:$ pypstats update -s ProDy_stats.pkl ProDy
Fetching content from 'http://pypi.python.org/stats/months/'.
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.HelpTo get help, type in a command name with-hargument:$ pypstats -h
usage: pypstats.py [-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

subcommands:
  {latest,monthly,total,update,release}
    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: pypstats.py monthly [-h] [-q] [-o FILENAME] [-d DELIMITER]
                           [-p FILENAME] [--dpi INT] [--mlabelstep INT]
                           pkl

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')Functionsfrom pypstats import *imports the following functions which can be used
directly in Python code:pyps_update(package, pkl, cache)- update package statisticspyps_monthly(pkl)- return monthly download statisticspyps_release(pkl)- return release download statisticspyps_total(pkl)- return total number of downloadsLICENSEpypstatsis available under GNU General Public License version 3.  See
LICENSE.rst for more details.CHANGESv1.3Added new functions that can be used directly in Python code. See usage
section above.Using timestamps when saving downloaded stats file so that time zone
differences do not cause a problem.v1.2.1Fixed an installation problem.v1.2Renamed scriptpypstatstopyps.Downloaded stats files are save to temp folder.  When multiple package stats
are updated consequently, content is read from this folder.v1.1Renamed commandcurrenttolatest.SOURCEhttp://github.com/abakan/pypstatsREPORT ISSUEShttps://github.com/abakan/pypstats/issues