Skip to content

Query download statistics for conda packages from the Anaconda public dataset

License

Notifications You must be signed in to change notification settings

conda-incubator/condastats

Repository files navigation

condastats

PyPI Version Conda Version Python Versions CI Status Documentation Status License

A command-line tool and Python library to query download statistics for conda packages from the Anaconda public dataset.

Features

  • Query overall download counts for any conda package
  • Filter by time period (specific month or date range)
  • Group statistics by platform, Python version, package version, or data source
  • Support for multiple packages in a single query
  • Works with historical data from 2017 onwards

Installation

Using conda / mamba / pixi (recommended):

conda install -c conda-forge condastats
# or
mamba install -c conda-forge condastats
# or
pixi add condastats
# or, to install as a global tool
pixi global install condastats

Using pip / uv / pipx:

pip install condastats
# or
uv pip install condastats
# or, run without installing
uvx condastats overall pandas --month 2024-01
pipx run condastats overall pandas --month 2024-01
# or, install as a global tool
pipx install condastats

Usage

Command Line

Get overall download counts for a package:

condastats overall pandas --month 2024-01

Get downloads grouped by platform:

condastats pkg_platform numpy --month 2024-01

Get downloads grouped by data source (anaconda vs conda-forge):

condastats data_source scipy --month 2024-01

Query multiple packages:

condastats overall pandas numpy dask --month 2024-01

Python API

from condastats import overall, pkg_platform, data_source

# Get total downloads for pandas in January 2024
downloads = overall("pandas", month="2024-01")
print(downloads)

# Get downloads by platform
by_platform = pkg_platform("pandas", month="2024-01")
print(by_platform)

# Get downloads over a date range
downloads = overall("numpy", start_month="2024-01", end_month="2024-06")
print(downloads)

Documentation

Full documentation is available at https://condastats.readthedocs.io

License

  • Free software: BSD-3-Clause license

Credits

Created by Sophia Man Yang.

Maintained by the conda-incubator community.

About

Query download statistics for conda packages from the Anaconda public dataset

Topics

Resources

License

Stars

Watchers

Forks

Contributors 8

Languages