Two way configurations mapping helper for Python.
Project description
📄⇄🛠 Two way configurations mapping helper for Python.
Get Started
from biconfigs import Biconfigs
configs = Biconfigs('configs.json')
# Simply change the dict, and it will automatically save the changes to file.
configs['options'] = {'debug': True,
'username': 'Anthony',
'list': [] }
# Access with simple 'x.y.z' style
configs.options.list.append('example')
Content of file configs.json after execution:
{
"options": {
"debug": true,
"list": [
"example"
],
"username": "Anthony"
}
}
Install
pip install biconfigs
Dependencies
No dependencies required 🎉
Tested on Python 2.6, 2.7, 3.3, 3.4, 3.5, pypy, pypy3
Documentation
When to save
Saving when: Item create, item delete, list reorder, value change, ``get_set``, etc.
# All the following single statement will cause saving configs['item'] = 'value' configs['options'] = {} configs.options['list'] = [] configs.options.list.append('example') configs.options['list'] = [] configs.options.clear() value2 = configs.get_set('item2', 45)
Not saving when: Item access, assignment but not changed, etc.
# All the following single statement will NOT cause saving value = configs.item configs['item'] = 'value' # The value of 'item' is not changed value3 = configs.get('item_not_exists', 'default_value')
Non-blocking saving
By default, Biconfigs use asynchronous saving. You can disable the feature by setting async_write to False
# set "async_write=False" if your want to use synchronous saving
# to ensure your data saved to file in time,
# WARNING: In sync mode, your changes will block the incoming statement
# until the file correctly saved.
configs = Biconfigs('configs.json', async_write=False)
configs['item'] = 'value' # Blocking
# Configure file saved already
# Your code...
High frequency update
Normally, Biconfigs will write the changes to file immediately. But sometime you may want to update values frequently, which will result in a IO bottleneck. So you can use ``with`` statement to prevent auto saving for a while.
with configs:
for i in range(1000):
configs['some_key'] = i
# This statement will execute saving process only one time when exiting "with" scope
Reload from file
Simply use reload function to reload from file. Note: reload will discard all present data in Biconfigs-object and loads new ones from file)
configs.reload()
Parsers
Biconfigs use Prettified Json as default parser. You may want to set parser='json' to save as compacted json file.
configs = Biconfigs('configs.json', parser='json')
configs['item'] = 'value'
configs['debug'] = False
configs.json:
{"debug": false, "item": "value"}
Available Parsers
CSON
Biconfigs support CSON by avakar/pycson
from biconfigs import Biconfigs
from biconfigs import parser_cson
configs = Biconfigs('configs.cson', parser='cson')
# Then use biconfigs as you normally would...
Extra requirements
To use CSON, you need to install extra requirement
pip install biconfigs[cson]
Or install cson manually:
pip install cson
CSON problems
Please check avakar/pycson: The Language
YAML
Biconfigs support YAML by PyYAML
from biconfigs import Biconfigs
from biconfigs import parser_yaml
configs = Biconfigs('configs.yml', parser='yaml')
# Then use biconfigs as you normally would...
Extra requirements
To use YAML, you need to install extra requirement
pip install biconfigs[yaml]
Or install PyYAML manually:
pip install PyYAML
License
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for biconfigs-0.1.2-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | eba62e2bf02024e1f4ffd71259b45a37efc58acef7437d5a5be87e57ac7f15a9 |
|
MD5 | 4473e97573bad86896d5c3e4588a9d12 |
|
BLAKE2b-256 | bb77136ab1aa8fc7c90aed6fd28ac1367b404a0b0fc5008e16d63d15b4d0c319 |