easyconfig


Nameeasyconfig JSON
Version 0.3.2 PyPI version JSON
download
home_pagehttps://github.com/spacemanspiff2007/easyconfig
SummaryEasy application configuration with yaml files
upload_time2024-01-10 08:09:42
maintainer
docs_urlNone
authorspaceman_spiff
requires_python>=3.8
license
keywords yaml configuration pydantic settings config yml
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # easyconfig
![Tests Status](https://github.com/spacemanspiff2007/easyconfig/workflows/Tests/badge.svg)
[![Updates](https://pyup.io/repos/github/spacemanspiff2007/easyconfig/shield.svg)](https://pyup.io/repos/github/spacemanspiff2007/easyconfig/)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/easyconfig)
![PyPI](https://img.shields.io/pypi/v/easyconfig)
[![Downloads](https://pepy.tech/badge/easyconfig/month)](https://pepy.tech/project/easyconfig)

_Easy application configuration with yaml files_

## Description
Easyconfig simplifies the configuration management for (small) applications.

Validation and parsing of the configuration file is done through [pydantic](https://pydantic-docs.helpmanual.io/)
and easyconfig builds on that.
It's possible to use all pydantic features and model features so every exotic use case should be covered.
If you have previously worked with pydantic you should feel right at home

## Documentation
[The documentation can be found at here](https://easyconfig.readthedocs.io)

## Features

- Default `.yml` file generation
- Environment variable expansion
- Support for docker secrets
- Callbacks when values of the configuration change

## Why not pydantic settings
A pydantic settings object is a non-mutable object.
With easyconfig you can create a global configuration and just import it into your modules.
When your application starts you can read the configuration e.g. from a settings file and the object values
will change the values accordingly.

Additionally, easyconfig can create a default configuration file with the specified default
values and comments of the pydantic models.
That way the users can have some guidance how to change the program behaviour.


### Expansion
It's possible to use environment variable or files for expansion. Easyconfig will load all values

# Changelog
#### 0.3.2 (2024-01-10)
- Updated CI and code linters

#### 0.3.1 (2023-11-10)
- Updated dependencies and code linters

#### 0.3.0 (2023-03-17)
- Breaking: requires pydantic 2.0
- Added support for variable expansion through environment variables and docker secrets

#### 0.2.8 (2023-02-08)
- Fix for StrictBool

#### 0.2.7 (2023-01-09)
- Fixed default generation for data types that inherit from python base types

#### 0.2.6 (2022-12-21)
- Fixed an issue where the default yaml file would not be created properly when using aliases in container

#### 0.2.5 (2022-10-21)
- Marked package as PEP 561 compatible (py.typed)

#### 0.2.4 (2022-04-19)
- Default values get validated, too

#### 0.2.3 (2022-04-08)
- Added extra kwargs check for pydantic fields
- Added option to get generated yaml as a string

#### 0.2.2 (2022-03-31)
- Added convenience base classes ``AppBaseModel`` and ``BaseModel``
- Works with private attributes and class functions
- Fixed an issue where multiline comments would not be created properly
- Added an option to exclude entries from config file

#### 0.2.1 (2022-03-25)
- Allow callbacks for file defaults

#### 0.2.0 (2022-03-25)
- Switched to new and more flexible API
- File default and config default are now separated

#### 0.1.2 (2022-03-08)
- Comments get nicely intended
- Fixed an issue with nested data structures
- Allow to specify a different value for file creation

#### 0.1.1 (2022-02-26)
- Fixed an issue with dynamic defaults
- Optional values with default None will not be created in the yaml file

#### 0.1.0 (2022-01-10)
- Updated requirements

#### 0.0.2 (2021-09-16)
- Validate user defaults
- Use json representation of values to get native yaml data types
- Use enum values instead of enum types

#### 0.0.1 (2021-09-14)
- Initial release

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/spacemanspiff2007/easyconfig",
    "name": "easyconfig",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": "",
    "keywords": "yaml,configuration,pydantic,settings,config,yml",
    "author": "spaceman_spiff",
    "author_email": "",
    "download_url": "https://files.pythonhosted.org/packages/4c/75/ed8932acb2f2b83a403f3008641fbb1897d7e47d68f49486078b28ef233c/easyconfig-0.3.2.tar.gz",
    "platform": null,
    "description": "# easyconfig\n![Tests Status](https://github.com/spacemanspiff2007/easyconfig/workflows/Tests/badge.svg)\n[![Updates](https://pyup.io/repos/github/spacemanspiff2007/easyconfig/shield.svg)](https://pyup.io/repos/github/spacemanspiff2007/easyconfig/)\n![PyPI - Python Version](https://img.shields.io/pypi/pyversions/easyconfig)\n![PyPI](https://img.shields.io/pypi/v/easyconfig)\n[![Downloads](https://pepy.tech/badge/easyconfig/month)](https://pepy.tech/project/easyconfig)\n\n_Easy application configuration with yaml files_\n\n## Description\nEasyconfig simplifies the configuration management for (small) applications.\n\nValidation and parsing of the configuration file is done through [pydantic](https://pydantic-docs.helpmanual.io/)\nand easyconfig builds on that.\nIt's possible to use all pydantic features and model features so every exotic use case should be covered.\nIf you have previously worked with pydantic you should feel right at home\n\n## Documentation\n[The documentation can be found at here](https://easyconfig.readthedocs.io)\n\n## Features\n\n- Default `.yml` file generation\n- Environment variable expansion\n- Support for docker secrets\n- Callbacks when values of the configuration change\n\n## Why not pydantic settings\nA pydantic settings object is a non-mutable object.\nWith easyconfig you can create a global configuration and just import it into your modules.\nWhen your application starts you can read the configuration e.g. from a settings file and the object values\nwill change the values accordingly.\n\nAdditionally, easyconfig can create a default configuration file with the specified default\nvalues and comments of the pydantic models.\nThat way the users can have some guidance how to change the program behaviour.\n\n\n### Expansion\nIt's possible to use environment variable or files for expansion. Easyconfig will load all values\n\n# Changelog\n#### 0.3.2 (2024-01-10)\n- Updated CI and code linters\n\n#### 0.3.1 (2023-11-10)\n- Updated dependencies and code linters\n\n#### 0.3.0 (2023-03-17)\n- Breaking: requires pydantic 2.0\n- Added support for variable expansion through environment variables and docker secrets\n\n#### 0.2.8 (2023-02-08)\n- Fix for StrictBool\n\n#### 0.2.7 (2023-01-09)\n- Fixed default generation for data types that inherit from python base types\n\n#### 0.2.6 (2022-12-21)\n- Fixed an issue where the default yaml file would not be created properly when using aliases in container\n\n#### 0.2.5 (2022-10-21)\n- Marked package as PEP 561 compatible (py.typed)\n\n#### 0.2.4 (2022-04-19)\n- Default values get validated, too\n\n#### 0.2.3 (2022-04-08)\n- Added extra kwargs check for pydantic fields\n- Added option to get generated yaml as a string\n\n#### 0.2.2 (2022-03-31)\n- Added convenience base classes ``AppBaseModel`` and ``BaseModel``\n- Works with private attributes and class functions\n- Fixed an issue where multiline comments would not be created properly\n- Added an option to exclude entries from config file\n\n#### 0.2.1 (2022-03-25)\n- Allow callbacks for file defaults\n\n#### 0.2.0 (2022-03-25)\n- Switched to new and more flexible API\n- File default and config default are now separated\n\n#### 0.1.2 (2022-03-08)\n- Comments get nicely intended\n- Fixed an issue with nested data structures\n- Allow to specify a different value for file creation\n\n#### 0.1.1 (2022-02-26)\n- Fixed an issue with dynamic defaults\n- Optional values with default None will not be created in the yaml file\n\n#### 0.1.0 (2022-01-10)\n- Updated requirements\n\n#### 0.0.2 (2021-09-16)\n- Validate user defaults\n- Use json representation of values to get native yaml data types\n- Use enum values instead of enum types\n\n#### 0.0.1 (2021-09-14)\n- Initial release\n",
    "bugtrack_url": null,
    "license": "",
    "summary": "Easy application configuration with yaml files",
    "version": "0.3.2",
    "project_urls": {
        "GitHub": "https://github.com/spacemanspiff2007/easyconfig",
        "Homepage": "https://github.com/spacemanspiff2007/easyconfig"
    },
    "split_keywords": [
        "yaml",
        "configuration",
        "pydantic",
        "settings",
        "config",
        "yml"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "dfd1968dbb60a8781b785c45d4147aa0fbbcd61b79c4d5049150ffd134fa999a",
                "md5": "3adaaa7602f21e357ccdce0e9e1beb70",
                "sha256": "76425ad2147b5b4412b88b735cc452b2e190643d713c84459137949a5d0d8568"
            },
            "downloads": -1,
            "filename": "easyconfig-0.3.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "3adaaa7602f21e357ccdce0e9e1beb70",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 23049,
            "upload_time": "2024-01-10T08:09:40",
            "upload_time_iso_8601": "2024-01-10T08:09:40.345896Z",
            "url": "https://files.pythonhosted.org/packages/df/d1/968dbb60a8781b785c45d4147aa0fbbcd61b79c4d5049150ffd134fa999a/easyconfig-0.3.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "4c75ed8932acb2f2b83a403f3008641fbb1897d7e47d68f49486078b28ef233c",
                "md5": "7ea67e064ec7c2dd4cee7b5f3b67d35c",
                "sha256": "4a00954e13835a92fdd00a26d9ed1e713e576879fe3654a2163f7a08356a6b68"
            },
            "downloads": -1,
            "filename": "easyconfig-0.3.2.tar.gz",
            "has_sig": false,
            "md5_digest": "7ea67e064ec7c2dd4cee7b5f3b67d35c",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 19633,
            "upload_time": "2024-01-10T08:09:42",
            "upload_time_iso_8601": "2024-01-10T08:09:42.191479Z",
            "url": "https://files.pythonhosted.org/packages/4c/75/ed8932acb2f2b83a403f3008641fbb1897d7e47d68f49486078b28ef233c/easyconfig-0.3.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-01-10 08:09:42",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "spacemanspiff2007",
    "github_project": "easyconfig",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [],
    "tox": true,
    "lcname": "easyconfig"
}
        
Elapsed time: 0.16450s