pitstop lets you move tightly coupled configuration file parsing, secrets retrieval, and other configuration related administrivia logic out of your application, improving maintainability, reducing complexity, and encouraging better configuration management practices.



pitstop stands on the shoulders of mature, feature-rich, and well tested Python libraries, and merely provides a convenience layer so you don’t have to write the same configuration parsing and normalization scaffolding with every new library or application.

pitstop’s main features:

  • Schema-driven configuration validation and normalization, powered by Cerberus.
  • Nested, path-based key access and transformation, powered by glom.
  • Multi-tiered, prioritized configuration loading strategies.
  • Easily extensible backends and encoding providers via entry points.


pitstop has a hard minimum requirement of Python 3.7.

In general, the Python package can be installed with pip, which will include the pitstop command line utility.

$ pip install pitstop

However, if you are only going to be using the CLI, it is highly recommended to use pipsi instead:

$ pipsi install pitstop