This project helps you to import config file writen by YAML to Python Data Classes.
- Type safe import from YAML to Data Classes
- Global access and easy unit testing
When using pyyaml to import YAML, values be dict and list objects. Using dict or list object will cause such confuses:
- Reference non exist properties for unexpected instance type
- Typo of index or key name
To prevent these confuse, one of good way is to use object as model, and python has a good module Data Classes for this purpose.
You will want to refer config as global because it's troublesome to pass config value as argument over and over like a bucket brigade.
However, when unit testing, if YAML file was loaded automatically on importing global definition, you will face problem that you can't replace config YAML file with the one for unit testing. YAML Data Class Config can divide timings between definition global instance and loading YAML file so you can replace YAML file for unit testing.
pip install yamldataclassconfigPut config.yml
YAML Data class Config loads config.yml on Python execution directory by default.
property_a: 1
property_b: '2'
part_config:
property_c: '2019-06-25 13:33:30'Anywhere is OK, for example, I prefer to place on myproduct/config.py
from dataclasses import dataclass, field
from datetime import datetime
from dataclasses_json import DataClassJsonMixin
from marshmallow import fields
from yamldataclassconfig.config import YamlDataClassConfig
@dataclass
class PartConfig(DataClassJsonMixin):
property_c: datetime = field(metadata={'dataclasses_json': {
'encoder': datetime.isoformat,
'decoder': datetime.fromisoformat,
'mm_field': fields.DateTime(format='iso')
}})
@dataclass
class Config(YamlDataClassConfig):
property_a: int = None
property_b: str = None
part_config: PartConfig = field(
default=None,
metadata={'dataclasses_json': {'mm_field': PartConfig}}
)Also, anywhere is OK, for example, I prefer to place on myproduct/__init__.py
from myproduct.config import Config
CONFIG: Config = Config()from myproduct import CONFIG
def main():
CONFIG.load()
print(CONFIG.property_a)
print(CONFIG.property_b)
print(CONFIG.part_config.property_c)
if __name__ == '__main__':
main()override FILE_PATH property.
Ex:
from dataclasses import dataclass
from pathlib import Path
from yamldataclassconfig import create_file_path_field
from yamldataclassconfig.config import YamlDataClassConfig
@dataclass
class Config(YamlDataClassConfig):
some_property: str = None
# ...
FILE_PATH: Path = create_file_path_field(Path(__file__).parent.parent / 'config.yml')When setup on unit testing, you can call Config.load() with argument.
Case when unittest:
from pathlib import Path
import unittest
from yourproduct import CONFIG
class ConfigurableTestCase(unittest.TestCase):
def setUp(self):
CONFIG.load(Path('path/to/yaml'))Case when pytest:
from pathlib import Path
import pytest
from yourproduct import CONFIG
@pytest.fixture
def yaml_config():
CONFIG.load(Path('path/to/yaml'))
yield
def test_something(yaml_config):
"""test something"""fixturefilehandler
can replace config.yml with tests/config.yml.dist easily.
Please call all DeployerFactory.create with YamlConfigFilePathBuilder instance argument
to create ConfigDeployer.
Then, set target directory which config.yml should be placed into path_target_directory.
Case when unittest:
from pathlib import Path
import unittest
from fixturefilehandler.factories import DeployerFactory
from fixturefilehandler.file_paths import YamlConfigFilePathBuilder
from yourproduct import CONFIG
ConfigDeployer = DeployerFactory.create(YamlConfigFilePathBuilder(path_target_directory=Path(__file__).parent.parent))
class ConfigurableTestCase(unittest.TestCase):
def setUp(self):
ConfigDeployer.setup()
CONFIG.load()
def doCleanups(self):
ConfigDeployer.teardown()Case when pytest:
from pathlib import Path
import pytest
from fixturefilehandler.factories import DeployerFactory
from fixturefilehandler.file_paths import YamlConfigFilePathBuilder
from yourproduct import CONFIG
ConfigDeployer = DeployerFactory.create(YamlConfigFilePathBuilder(path_target_directory=Path(__file__).parent.parent))
@pytest.fixture
def yaml_config():
ConfigDeployer.setup()
CONFIG.load()
yield
ConfigDeployer.teardown()
def test_something(yaml_config):
"""test something"""
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent