pyya 0.1.3

Convert YAML configuration files to Python objects

pyya - Simple tool that converts YAML configuration files to Python objects

Features

• Very lightweight and simple API (currently it contains only one function)
• Easy to use
• Based on popular and well-tested libraries (like camel-converter, PyYAML and munch)
• Automatically merge default and production configuration files
• Convert keys in configuration files to snake_case

Installation

pip install pyya

Usage

Example

Create YAML configuration files for your project:

# default.config.yaml - this file usually goes to version control system
database:   
    host: localhost
    port: 5432
    username: postgres
    password: postgres

# config.yaml - this file for production usage
database:   
    username: username
    password: password

Import configuration files in your Python code with pyya:

import json

from pyya import init_config

config = init_config(
    'config.yaml', 'default.config.yaml', 
    convert_keys_to_snake_case = False,
    add_underscore_prefix_to_keywords = False
    raise_error_non_identifiers = False)
print(json.dumps(config.database))

# Output:
# {"host": "localhost", "port": 5432, "username": "username", "password": "password"}

As you can see, pyya automatically merges default config file with production config file.

Under the hood pyya uses PyYAML to parse YAML files and munch library to create attribute-stylish dictionaries.

and can be configured to .

Flags

convert_keys_to_snake_case=True 
# `pyya` converts `camelCase` or `PascalCase` keys to `snake_case`

add_underscore_prefix_to_keywords=True 
# `pyya` adds underscore prefix to keys that are Python keywords

raise_error_non_identifiers=True 
# `pyya` raises error if key name is not valid Python identifier

Contributing

Are you a developer?

• Fork the repository https://github.com/shadowy-pycoder/pyya/fork
• Clone the repository: git clone https://github.com/<your-username>/pyya.git && cd pyya
• Create your feature branch: git switch -c my-new-feature
• Commit your changes: git commit -am 'Add some feature'
• Push to the branch: git push origin my-new-feature
• Submit a pull request