{
    "info": {
        "author": "Ahmet Bakan",
        "author_email": "ahmetbakan at msn dot com",
        "bugtrack_url": null,
        "classifiers": [
            "License :: OSI Approved :: GNU General Public License (GPL)",
            "Operating System :: MacOS",
            "Operating System :: Microsoft :: Windows",
            "Operating System :: POSIX",
            "Programming Language :: Python",
            "Programming Language :: Python :: 2"
        ],
        "description": "SYNOPSIS\r\n========\r\n\r\n*pypstats* is for retrieving monthly and per release download statistics \r\nof packages that are distributed via `PyPI <http://pypi.python.org/pypi>`_.  \r\nIt can be used to write **.csv** files, plot monthly stats, and retrieve\r\ninformation on the latest release.  Monthly statistics are stored at \r\nhttp://pypi.python.org/stats/months/ in compressed files starting from \r\nJune 2010.  These files contain information on releases that are removed \r\nfrom PyPI, so *pypstats* provides complete statistics for packages that \r\nare released after June 2010.\r\n\r\n\r\nINSTALLATION\r\n============\r\n\r\nDownload a package file from http://pypi.python.org/pypi/pypstats. Extract \r\nits contents and run **setup.py** as follows::\r\n  \r\n  $ tar -xzf pypstats-1.x.tar.gz\r\n  $ cd pypstats-1.x\r\n  $ python setup.py install\r\n\r\nOr, if if you have `Easy Install <http://peak.telecommunity.com/DevCenter/EasyInstall>`_\r\ninstalled, type the following::\r\n\r\n  $ easy_install -U pypstats\r\n\r\n\r\nUSAGE\r\n=====\r\n\r\nFirst use\r\n---------\r\n\r\nBefore statistics can be printed or plotted, you need to retrieve statistics \r\nand save them locally using **pypstats update** command::\r\n\r\n  $ pypstats update ProDy\r\n  Fetching content from 'http://pypi.python.org/stats/months/'.\r\n  Parsing monthly statistics file details.\r\n  Updating statistics for 2010-06.\r\n  ...\r\n  Updating statistics for 2012-01.\r\n  Package statistics are updated (ProDy_stats.pkl).\r\n\r\nRetrieving statistics at the first use will take some time, since all \r\nmonthly stats files are downloaded. Note that downloaded files will be\r\nsave in temporary folder, unless ``--nocache`` option is passed.  Saving\r\ndownloaded files will make building stats file for multiple packages faster.\r\n\r\n\r\nMonthly stats\r\n-------------\r\n\r\nMonthly statistics can be printed using **pypstats monthly** command::\r\n\r\n  $ pypstats monthly ProDy_stats.pkl \r\n  Loading statistics from 'ProDy_stats.pkl'.\r\n  Month\tDownloads\r\n  2010-11\t286\r\n  ...\r\n  2012-01\t1041\r\n  Total\t  10664\r\n\r\nThis information can also be plotted and saved in a **.csv** file as \r\nfollows::\r\n\r\n  $ pypstats monthly -o monthly.csv -p monthly.png ProDy_stats.pkl\r\n  Loading statistics from 'ProDy_stats.pkl'.\r\n  Monthly statistics are written in 'monthly.csv'.\r\n  Monthly downloads plot is saved as 'monthly.png'.\r\n  \r\n\r\nRelease stats\r\n-------------\r\n\r\nRelease statistics can be printed using **pypstats release** command::\r\n\r\n\r\n  $ pypstats release ProDy_stats.pkl \r\n  Loading statistics from 'ProDy_stats.pkl'.\r\n  Release\tDownloads\r\n  0.1.0\t397\r\n  ...\r\n  0.9.2\t328\r\n  Total\t10664\r\n  \r\nSimilarly, output can be written into a **.csv** file as follows::\r\n\r\n  $ pypstats release -o release_stats.csv -q ProDy_stats.pkl\r\n  \r\nNote that **-q** argument suppresses messages written to **stderr**.\r\n\r\n\r\nTotal downloads\r\n---------------\r\n\r\nTotal number of downloads can be printed using **pypstats total** command::\r\n\r\n  $ pypstats total -q ProDy_stats.pkl \r\n  10664\r\n\r\n\r\nLatest release\r\n---------------\r\n\r\nLatest release information can be retrieved using **pypstats latest** \r\ncommand::\r\n\r\n  $ pypstats latest -q ProDy\r\n  File\tURL\tmd5\tType\tPy Version\tSize\tDownloads\r\n  ProDy-0.9.2.tar.gz\thttp://pypi.python.org/packages/source/P/ProDy/ProDy-0.9.2.tar.gz\t9ad6f6e6012f824ea5e7acb344607eae\tSource\t\t711KB\t119\r\n  ProDy-0.9.2.win32-py2.6.exe\thttp://pypi.python.org/packages/2.6/P/ProDy/ProDy-0.9.2.win32-py2.6.exe\t51f8587dcc8fe6d0355327d811ea71c3\tMS Windows installer\t2.6\t455KB\t47\r\n  ProDy-0.9.2.win32-py2.7.exe\thttp://pypi.python.org/packages/2.7/P/ProDy/ProDy-0.9.2.win32-py2.7.exe\t68ba279f3d9e02b38e4f3e6339b41b26\tMS Windows installer\t2.7\t909KB\t53\r\n  ProDy-0.9.2.zip\thttp://pypi.python.org/packages/source/P/ProDy/ProDy-0.9.2.zip\tb447f8b607defd5cda65163e43b32150\tSource\t\t744KB\t109\r\n\r\nThis information can be written into a CSV file using reStructured Text style::\r\n\r\n  $ pypstats latest -q -o latest_release.csv --rst ProDy\r\n \r\nThis file can be used in a page prepared using `Sphinx <http://sphinx.pocoo.org/>`_, \r\nsee for an example: http://www.csb.pitt.edu/ProDy/getprody.html\r\n\r\n\r\nUpdates\r\n-------\r\n\r\nLocal statistics file can be updated using **pypstats update** command::\r\n\r\n  $ pypstats update -s ProDy_stats.pkl ProDy\r\n  Fetching content from 'http://pypi.python.org/stats/months/'.\r\n  Parsing monthly statistics file details.\r\n  Nothing to update.\r\n\r\nThis command will make an incremental update by downloading the files that\r\nchanged since the last update.\r\n\r\n\r\nHelp\r\n----\r\n\r\nTo get help, type in a command name with **-h** argument::\r\n\r\n  $ pypstats -h\r\n  usage: pypstats.py [-h] {latest,monthly,total,update,release} ...\r\n\r\n  Fetch package download statistics from Python Package Index (PyPI). Package\r\n  needs to be distributed via PyPI.\r\n\r\n  optional arguments:\r\n    -h, --help            show this help message and exit\r\n\r\n  subcommands:\r\n    {latest,monthly,total,update,release}\r\n      update              retrieve or update download statistics\r\n      latest              retrieve and output latest release information\r\n      monthly             output/plot monthly download statistics\r\n      release             output download statistics by release\r\n      total               output total number of downloads\r\n\r\n  See 'pypstats <command> -h' for more information on a specific command.\r\n\r\n::\r\n\r\n  $ pypstats monthly -h\r\n  usage: pypstats.py monthly [-h] [-q] [-o FILENAME] [-d DELIMITER]\r\n                             [-p FILENAME] [--dpi INT] [--mlabelstep INT]\r\n                             pkl\r\n\r\n  positional arguments:\r\n    pkl               package statistics filename\r\n\r\n  optional arguments:\r\n    -h, --help        show this help message and exit\r\n    -q, --quiet       suppress stderr log messages\r\n    -o FILENAME       output CSV filename, if not provided print to stdout\r\n    -d DELIMITER      output column delimiter (default: ' ')\r\n    -p FILENAME       figure filename, requires Matplotlib\r\n    --dpi INT         figure resolution (default: '72')\r\n    --mlabelstep INT  figure month label step (default: '2')\r\n\r\n\r\nFunctions\r\n---------\r\n\r\n``from pypstats import *`` imports the following functions which can be used \r\ndirectly in Python code:\r\n\r\n* ``pyps_update(package, pkl, cache)`` - update package statistics\r\n* ``pyps_monthly(pkl)`` - return monthly download statistics\r\n* ``pyps_release(pkl)`` - return release download statistics\r\n* ``pyps_total(pkl)`` - return total number of downloads\r\n\r\n\r\nLICENSE\r\n=======\r\n  \r\n*pypstats* is available under GNU General Public License version 3.  See \r\nLICENSE.rst for more details. \r\n\r\n\r\nCHANGES\r\n=======\r\n\r\nv1.3\r\n------\r\n\r\n* Added new functions that can be used directly in Python code. See usage \r\n  section above.\r\n* Using timestamps when saving downloaded stats file so that time zone \r\n  differences do not cause a problem.\r\n\r\nv1.2.1\r\n------\r\n\r\n* Fixed an installation problem.\r\n\r\nv1.2\r\n----\r\n\r\n* Renamed script **pypstats** to **pyps**.\r\n* Downloaded stats files are save to temp folder.  When multiple package stats\r\n  are updated consequently, content is read from this folder.\r\n\r\nv1.1\r\n----\r\n\r\n* Renamed command **current** to **latest**. \r\n\r\n\r\nSOURCE\r\n======\r\n\r\nhttp://github.com/abakan/pypstats\r\n\r\n\r\nREPORT ISSUES\r\n=============\r\n\r\nhttps://github.com/abakan/pypstats/issues",
        "description_content_type": null,
        "docs_url": null,
        "download_url": "UNKNOWN",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/abakan/pypstats",
        "keywords": "monthly,package,download,statistics",
        "license": "GPLv3",
        "maintainer": "",
        "maintainer_email": "",
        "name": "pypstats",
        "package_url": "https://pypi.org/project/pypstats/",
        "platform": "UNKNOWN",
        "project_url": "https://pypi.org/project/pypstats/",
        "project_urls": {
            "Download": "UNKNOWN",
            "Homepage": "https://github.com/abakan/pypstats"
        },
        "release_url": "https://pypi.org/project/pypstats/1.4/",
        "requires_dist": null,
        "requires_python": null,
        "summary": "Retrieve monthly package download statistics from PyPI",
        "version": "1.4"
    },
    "last_serial": 897655,
    "releases": {
        "1.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "9cecb87524ccb8e36a65f5a989b9a94b",
                    "sha256": "a80c0f3ffaa754305c5caf8dfabb31b30af9c770d4b2027906699d00053b8e1f"
                },
                "downloads": -1,
                "filename": "pypstats-1.1.tar.gz",
                "has_sig": false,
                "md5_digest": "9cecb87524ccb8e36a65f5a989b9a94b",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 6649,
                "upload_time": "2012-02-01T03:29:18",
                "url": "https://files.pythonhosted.org/packages/d2/82/70c81accb3978a0fab56f16a4d8842bc3e33edf540f84a7981a3698949a8/pypstats-1.1.tar.gz"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "50192ef642150b1ba89e81f09449ac4a",
                    "sha256": "12e24bfc34f2f85feb1afff9014c1542611441a239c602fedd0818a02b9a4db1"
                },
                "downloads": -1,
                "filename": "pypstats-1.1.zip",
                "has_sig": false,
                "md5_digest": "50192ef642150b1ba89e81f09449ac4a",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 7488,
                "upload_time": "2012-02-01T03:29:19",
                "url": "https://files.pythonhosted.org/packages/23/b8/42d6ad1ce23201ec41e854f0070513dc7be4bf7b239b4fcdeb0361343b09/pypstats-1.1.zip"
            }
        ],
        "1.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "e646ab1e7bb06deab043ff17208e988f",
                    "sha256": "430d1136ed6e5d6f1a87cf8030aa4d57466d3d3163d4cdfbee3182f4aa09bf59"
                },
                "downloads": -1,
                "filename": "pypstats-1.2.tar.gz",
                "has_sig": false,
                "md5_digest": "e646ab1e7bb06deab043ff17208e988f",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 7001,
                "upload_time": "2012-02-05T00:19:26",
                "url": "https://files.pythonhosted.org/packages/41/3f/88a8bc5efdfd698682adefb4c3b6b9a6c71ee028d1b3ed285d1960faac5c/pypstats-1.2.tar.gz"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "5d72e3e65e14d0d7d34a057efc8d9f44",
                    "sha256": "e50bf3a8380072a3f11f6f5c4c76564db8b29d49ecd903ad6b6fdffae03b95b8"
                },
                "downloads": -1,
                "filename": "pypstats-1.2.zip",
                "has_sig": false,
                "md5_digest": "5d72e3e65e14d0d7d34a057efc8d9f44",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 7975,
                "upload_time": "2012-02-05T00:19:26",
                "url": "https://files.pythonhosted.org/packages/b0/b5/7323ee51caef1aee441965caf19441f1e05e31af58308950e958df23ca33/pypstats-1.2.zip"
            }
        ],
        "1.2.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "912dcd491d8b237acba3e924f14f1a7c",
                    "sha256": "1c467b41da653a8efa6b6a83d7042c9b08c64c86349db0d06371f665be44fe07"
                },
                "downloads": -1,
                "filename": "pypstats-1.2.1.tar.gz",
                "has_sig": false,
                "md5_digest": "912dcd491d8b237acba3e924f14f1a7c",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 7708,
                "upload_time": "2012-02-06T16:51:20",
                "url": "https://files.pythonhosted.org/packages/84/f0/42d71e7345eb74f9c7a813225ce710106452a30406d415b35ad580b4e658/pypstats-1.2.1.tar.gz"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "57d85d648d253dd1a43a63c059ae12b7",
                    "sha256": "e1ebdff6cf2ff32c998814ca65094c4b1881ebcb55e36b4c8982ec55e0ed5dc7"
                },
                "downloads": -1,
                "filename": "pypstats-1.2.1.zip",
                "has_sig": false,
                "md5_digest": "57d85d648d253dd1a43a63c059ae12b7",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 11024,
                "upload_time": "2012-02-06T16:51:21",
                "url": "https://files.pythonhosted.org/packages/b2/66/67b617479d565fe95bf8f0af550a4e88ffe521511bc22fbad9b98582452a/pypstats-1.2.1.zip"
            }
        ],
        "1.3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "29d9c5b0a26bf712d250a28a5196e920",
                    "sha256": "9d8b5c5efc8f1503b74eff73d2c9b948e51b9d42d572bc70a880d6b52c25b0c9"
                },
                "downloads": -1,
                "filename": "pypstats-1.3.tar.gz",
                "has_sig": false,
                "md5_digest": "29d9c5b0a26bf712d250a28a5196e920",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 8664,
                "upload_time": "2012-02-11T18:58:06",
                "url": "https://files.pythonhosted.org/packages/20/c3/2280a4a7e53408f4fa477cd7bb438fe01bd4067b5dd602d0f81f6db55682/pypstats-1.3.tar.gz"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "41ecc9d09bbe8947cb13a02733f374f4",
                    "sha256": "9c1e9c01c538b41e79a0ec0eabf7d0eef538ab2efdcf732dc5fe5f42dc902459"
                },
                "downloads": -1,
                "filename": "pypstats-1.3.zip",
                "has_sig": false,
                "md5_digest": "41ecc9d09bbe8947cb13a02733f374f4",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 12082,
                "upload_time": "2012-02-11T18:58:08",
                "url": "https://files.pythonhosted.org/packages/f2/67/a3912c54861fb473f4857711403fe2570e1e682f63cd7de68bc6f9dc4f1c/pypstats-1.3.zip"
            }
        ],
        "1.4": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "b2002fb7d3e9f074ebaeb7e064648559",
                    "sha256": "bb026ece5dabc04124fcfb3cee00e83bfcfcd6bf1298063de25b519b15d4602a"
                },
                "downloads": -1,
                "filename": "pypstats-1.4.tar.gz",
                "has_sig": false,
                "md5_digest": "b2002fb7d3e9f074ebaeb7e064648559",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 8657,
                "upload_time": "2012-05-20T07:06:30",
                "url": "https://files.pythonhosted.org/packages/3d/84/d1c3f6952be5ccbd6f40daac9b6fd707a3b5a2de9fa75299056d1291bd53/pypstats-1.4.tar.gz"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "6be6a04a57bf09d3c79dbbe4ccac4794",
                    "sha256": "d2ef6c6e2bf98e8ed61c7a0470c8487cb6c2451bac8e17818c11ce6ece82cfa5"
                },
                "downloads": -1,
                "filename": "pypstats-1.4.zip",
                "has_sig": false,
                "md5_digest": "6be6a04a57bf09d3c79dbbe4ccac4794",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 12207,
                "upload_time": "2012-05-20T07:06:38",
                "url": "https://files.pythonhosted.org/packages/34/19/82b6baf0c0121ba7e6eee0cf7dd13c63ea0a1fd0ccd46754ca4017727cd2/pypstats-1.4.zip"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "b2002fb7d3e9f074ebaeb7e064648559",
                "sha256": "bb026ece5dabc04124fcfb3cee00e83bfcfcd6bf1298063de25b519b15d4602a"
            },
            "downloads": -1,
            "filename": "pypstats-1.4.tar.gz",
            "has_sig": false,
            "md5_digest": "b2002fb7d3e9f074ebaeb7e064648559",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 8657,
            "upload_time": "2012-05-20T07:06:30",
            "url": "https://files.pythonhosted.org/packages/3d/84/d1c3f6952be5ccbd6f40daac9b6fd707a3b5a2de9fa75299056d1291bd53/pypstats-1.4.tar.gz"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "6be6a04a57bf09d3c79dbbe4ccac4794",
                "sha256": "d2ef6c6e2bf98e8ed61c7a0470c8487cb6c2451bac8e17818c11ce6ece82cfa5"
            },
            "downloads": -1,
            "filename": "pypstats-1.4.zip",
            "has_sig": false,
            "md5_digest": "6be6a04a57bf09d3c79dbbe4ccac4794",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 12207,
            "upload_time": "2012-05-20T07:06:38",
            "url": "https://files.pythonhosted.org/packages/34/19/82b6baf0c0121ba7e6eee0cf7dd13c63ea0a1fd0ccd46754ca4017727cd2/pypstats-1.4.zip"
        }
    ]
}