Metadata-Version: 2.1
Name: bestconfig
Version: 1.1.0
Summary: Setup your project config easily
Home-page: https://github.com/fivol/bestconfig
Author: Boris Bondarenko
Author-email: borisoffficial@gmail.com
License: MIT
Platform: UNKNOWN
Description-Content-Type: text/markdown
Requires-Dist: PyYAML (>=5.0.0)

# bestconfig
### *Python модуль для работы с файлами конфигурации проекта*

## Installation
```
pip install bestconfig
```

## A Simple Example
Предположим у вас такая структура проекта
```
root/
    main.py
    config.yaml
    .env
```
`/main.py`
```python
from bestconfig import Config

config = Config("myconfig.json")
print(dict(config))
# Примеры использования класса
logger = config.logger
logger = config['logger']
mode = config.logger.mode
mode = config.get('logger.mode', 'DEBUG')
mode = config['__unknown__'] # raise KeyError
mode = config.get('__unknown__') # return None
```
Содержимое файлов:

`.env`
```editorconfig
DATABASE_PASSWOD=postgres
```
`/config.yaml`
```yaml
HOST: http://localhost
PORT: 5050
logger:
  mode: WARNING
```
`myconfig.json`
```editorconfig
{
    "VERSION": "1.23.4",
    "BUILD": 5563
}
```
Вывод будет следующим
```editorconfig
{
    "logger": {
        "mode": "DEBUG"       
     }
    "PORT": 5050,
    "HOST": "http://localhost",
    "DATABASE_PASSWOD": "postgres"
}
```
## Что произошло?
1. Класс `Config` просканировал текущую дирикторию, вплоть до корня проекта
2. Нашел все указанные в аргументах файлы и те, что в списке по умолчанию 
   (например `.env`, `env_file`, `config.yaml`, `configuration.ini` и тд)


## Какие источники конфигов поддерживаются?
- Файлы следующих типов:
  - `.json`
  - `.yaml`
  - `.ini`
  - `.py` (если в нем нет инициализации `Config()` во избежании рекурсии)
  - `.cfg`
- Файлы в формате `CONFIG_NAME=CONFIG_VALUE`
- Уже существующие и новые переменные окружения
- Обычные `python` словари


### Файлы для поиска по умолчанию
- Все комбинации имени

  `config` `configuration` `settings` `conf`

  и расширений

  `.json` `.yaml` `.ini` `.env` `.cfg`
- Выеденные, часто используемые названия
    - `env_file`
    - `.env`
    - `config.py`

## Доступ к данным
1. Через точку `config.name`
1. Нотация `python dict` `config['name']`
Бросает исключение при отсутствии
1. `config.get('name', 'default_value', raise_absent=False)`   

**Если после документации остались вопросы, 
код подробно документирован, можно смело смотреть в исходники**

## Запланированные обновления
- Поддержка загрузки из базы данных
- Поддержка загрузки с config сервера
- Перевод документации и комментариев на английский




