Skip to main content

Inspect Python package dependencies

Project description

Dependente: Inspect Python package dependencies

Part of the Fatiando a Terra project

Latest release on PyPI Latest release on conda-forge Test coverage report Compatible Python versions


Dependente is a small command-line program for extracting dependencies from Python project files (pyproject.toml and setup.cfg) and converting them into requirements.txt-type files for use with pip and conda.

The main reason to do so is to control and customize the testing environment on continuous integration (CI) while avoiding repeating the list of dependencies in multiple places.


Dependente is available from PyPI:

python -m pip install dependente

and conda-forge:

conda install dependente -c conda-forge


Parse the install (run-time) dependencies from setup.cfg:

$ dependente > requirements.txt
🚀 Extracting dependencies: install
🔎 Parsing setup.cfg
   - 3 dependencies found
🖨  Printing 3 dependencies to the standard output stream
🥳 Done! 🥳

$ cat requirements.txt
# Install (run-time) dependencies from setup.cfg

Pin the dependencies to their oldest supported version (useful for testing in CI):

$ dependente --oldest > requirements-oldest.txt
🚀 Extracting dependencies: install
🔎 Parsing setup.cfg
   - 3 dependencies found
🕰  Pinning dependencies to their oldest versions
🖨  Printing 3 dependencies to the standard output stream
🥳 Done! 🥳

$ cat requirements-oldest.txt
# Install (run-time) dependencies from setup.cfg

Read build dependencies from pyproject.toml:

$ dependente --source build > requirements-build.txt
🚀 Extracting dependencies: build
🔎 Parsing pyproject.toml
   - 3 dependencies found
🖨  Printing 3 dependencies to the standard output stream
🥳 Done! 🥳

$ cat requirements-build.txt
# Build dependencies from pyproject.toml

See a full list of options:

$ dependente --help
Usage: dependente [OPTIONS]

  Dependente: Inspect Python package dependencies

  Reads from the configuration files in the current directory and outputs to
  stdout a list of dependencies into a format accepted by pip.

  Supported formats:

  * pyproject.toml (only build-system > requires)

  * setup.cfg (install_requires and options.extras_require)

  -s, --source TEXT            Which sources of dependency information to
                               extract. Can be any combination of
                               'install,extras,build'.  [default: install]
  -o, --oldest                 If enabled, will pin dependencies to the oldest
                               accepted version.  [default: False]
  -v, --verbose / -q, --quiet  Print information during execution / Don't
                               print  [default: verbose]
  --version                    Show the version and exit.
  -h, --help                   Show this message and exit.


The current implementation is a proof-of-concept and has some limitations:

  • Input files must be in the current working directory.
  • Reads all extra dependencies simultaneously (can't separate between different option.extras_requires fields).
  • Only supports reading from setup.cfg and pyproject.toml (build dependencies only).

Of course, all of these could be addressed if there is enough interest. Issues and PRs are welcome!

Contacting Us

Find out more about how to reach us at


Code of conduct

Please note that this project is released with a Code of Conduct. By participating in this project you agree to abide by its terms.

Contributing Guidelines

Please read our Contributing Guide to see how you can help and give feedback.


Dependente is free and open-source software distributed under the MIT License.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dependente-0.1.0.tar.gz (12.0 kB view hashes)

Uploaded Source

Built Distribution

dependente-0.1.0-py3-none-any.whl (12.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page