ezcf stands for easy configuration, it allows you to import JSON/YAML/INI/XML like .py files. It is useful whenever you need to read from these formats, especially for reading configuration files.
OK, stop talking, show us some code!
without extension.** Nothing else!
For instance, here we want to load file config.json
. With a single
line of code import config
, everything is done and you're happy.
pip install ezcf
If you run into error: yaml.h: No such file or directory
, don't
worry, you can still use ezcf without any problem.
ezcf supports JSON
, YAML
, INI
and XML
with extension
json
, yaml
, yml
, ini
, xml
.
ezcf supports all kinds of valid import statements, here's an example:
├── subdir │ ├── __init__.py │ └── sample_yaml.yaml ├── test_normal.py └── sample_json.json
Various ways to use configurations in sample_yaml.yaml
and
sample_json.json
:
import ezcf
from subdir.sample_yaml import *
# or
from subdir.sample_yaml import something
# or
import subdir.sample_yaml as sy
print(sy.something)
from sample_json import *
# or
from sample_json import something
# or
import sample_json as sj
print(sj.something)
You can assume they're just regular python files.(Currently ezcf only supports files with utf-8 encoding)
What about relative import? Yes, ezcf supports relative import, as long as you use it correctly.
Something to note before using ezcf:
- ezcf is still in developement. If you find any bug, please report it in issues;
- Be careful importing YAML which contains multiple documents: if there exists keys with the same name, only one of them will be loaded. So it's better not to use multiple documents;
- All values in
.ini
files are kept as it is and loaded as a string; - Since XML only allows single root, the whole xml will be loaded as one dict with root's name as variable name;
- Namespace package is not supported yet, pull requests are welcome.
- Use **valid variable names**, this means key strings in JSON/YAML/INI/XML should be valid Python variable name. Invalid variable name won't do any harm to your program nor will it crash, but you can't use them as expected.
python setup.py test
- [x] Use dot to seperate folder/subfolder/file
- [x] Unicode support
- [x] JSON support
- [x] YAML support
- [x] INI support
- [x] XML support
- [ ] Auto encoding detect?
- [x] CI
- [x] coverage
- [x] pypi
MMIT