inspari_config 0.1.5

Inspari configuration utilities

This repository provides Python configuration utilities.

Usage

The most common usage pattern is to create a config.py file that defines the configuration. The configuration itself is parsed from environment variables. They are typically read from a .env file during local development.

A minimal example is bundled, with the configuration defined in example_config.py, a few variables in example.env, and the typical access pattern (i.e. how settings are access in application code) illustrated in example_usage.py.

Development

Create a new Python environment with all dependencies installed,

poetry install

That's it! You can validate that the environment is setup correctly by running the tests,

poetry run coverage run -m pytest

Deployment

Update the version in pyproject.toml, run poetry lock, and add a new entry in CHANGELOG.md.

Automatic (preferred)

Merge the changes into master (using PRs). Create a new tag. If the new version is 1.1.1, the new tag would be v1.1.1.

The tag creation will trigger automated deployment of the package to PyPi, as well as synchronization of the code with the public GitHub mirror repository.

Manual (not recommended)

Build the project via Poetry,

poetry build

and push it to pypi,

poetry publish -u __token__ -p $INSPARI_PYPI_TOKEN