config without the vowels, or, simple Python config in your home directory
Python
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
cnfg
example
.gitignore
.travis.yml
README.rst
requirements-dev2.txt
setup.py

README.rst

Build Status Test Coverage Documentation Status

cnfg

Simple configuration should be simple. Here's example.py:

import cnfg
settings = cnfg.load('.examplerc')
print(settings['message'])

Relative paths are awful. Not all systems have /etc. The only reasonable place to put configuration is in your home directory.

JSON and YAML are not Python. eval is not so bad. Here's .examplerc:

# It's Python, so you can use comments (and more)
{"message": "My custom message."}

Now all of these work, with relative directories as implied:

./example.py
python ../example.py
cat example/example.py | python

What about default settings?

It's up to you, but it's easy, especially if you're keeping all your configuration in a dict:

settings = {"message": "Default message!"}
settings.update(cnfg.load('.examplerc'))

What about environment variables?

It's up to you, but it's easy:

import os
some_var = os.getenv("SOME_VAR", "some default value")

What about “from config import settings,” like confire?

It's up to you, but it's easy. Just make a file called config.py and define settings in it.

Where's my home directory?

On a Mac or Linux machine, echo ~. On Windows, echo %userprofile%.

This is so abstract!

Check out the example.

This is so trivial!

Yes, it's as simple as possible, and it's useful all over the place and the right level of complexity for a lot of projects.