PyPI Stats

A simple analytics dashboard for aggregate data on PyPI downloads. PyPI Stats is built using Flask with plotly.js.

PyPI Stats

GitHub OAuth

PyPI Stats has an integration with GitHub so you can track install data on the packages you maintain.

User page

JSON API

PyPI Stats provides a simple JSON API to retrieve aggregate download stats and time histories of pypi packages.

JSON API

Development

Prerequisites:

• Docker
• Docker Compose, available as the docker compose command used by the Makefile
• Make

1. Copy .env.example to .env and configure your environment variables:

   cp .env.example .env
   # Edit .env with your configuration

2. Run make pypistats to launch a complete development environment. The target stops any existing containers, rebuilds the images, and starts the Docker Compose services for the app:

   make pypistats

Functional tests

After setting up .env as above, run:

make test

This runs the tests in Docker Compose using isolated PostgreSQL databases and reports code coverage in the terminal and at htmlcov/index.html. PostgreSQL remains running afterward.