Envision

A (simple) environment variables manager for Python projects. The goal is to have declarative, explicitly defined settings variables in synchronicity both in development and production modes.

Installation

Use the package manager pip to install foobar.

pip install envision

Usage:

First in the root of your project just initialize envision:

envision init --token="YOURCUSTOMKEY"

Note: If your token argument is not set, a key will be automatically generated for you.

Three files will be created: .envision, .envision.lock and .envision.key file. If you pretend to use envision in a git project please add .envision and .envision.key to .gitignored; otherwise a warning messages will be displayed.

Secondly just add desired environment-like variables using the commands:

envision add

or remove with:

envision remove

The variables can se also manually set in the .envision file, just lock the file with:

envision lock

In production mode, you only have to declare one environment variable ENVISION with the key provided or generated, such as:

export ENVISION = 'YOURCUSTOMKEY'

The .envision.lock file containing the locked and encrypted key-values can then be accessed in production. In order to have access to the remaining key-values encrypted just do the following in your project:

from envison import envision

envision().get('A')

FAQ

How can I use the command line arguments in a directory outside my current directory?

• Every CLI function has the --root parameter, which defines the target root of the project. The envision constructor acepts exactly the same argument.

How to change the key password?

• On CLI just do:

envision lock --token="MYNEWCUSTOMKEY"

or manually by changing the .envision.key file entry and then lock the project.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. Please make sure to update tests as appropriate.

License

MIT