condastats 0.4.0

Conda package stats CLI

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.