Skip to main content

Create generic any easy way to manage Configs for your project

Project description

cornflakes logo

PyPI Python Version License Read the documentation at https://cornflakes.readthedocs.io Build Package Status Run Tests Status Codecov

pip install cornflakes
pip install git+https://github.com/semmjon/cornflakes

Information

The Python module “cornflakes” was started as a hobby project and offers an alternative to Pydantic for managing configurations and data structures. It allows creating generic and easy to manage configurations for your project. Unlike Pydantic, which is based on inheritance, “cornflakes” uses a decorator (similar to dataclass) to map data structures.

In addition to a dataclass decorator with additional functionality, there is also a config decorator. This makes it possible to read the dataclass from configuration files. This can be very useful if you want to save your application configurations to a file.

The module also has a click wrapper that simplifies the implementation of command line applications. By integrating the Rich module, the application is additionally equipped with colors and other functions.

There are other useful methods in the base of the module that are generally useful for Python development. These can help you develop your projects faster and more efficiently.

Short Term RoadMap:

  • Add autocompletion support for click CLI (automatically)

  • Change Code Annotations
    • remove Any annotations if possible

    • change Protocol Annotations to specific type classes

  • Enrich json methods

  • Fix / Test the to_<file-format> Methods (specially yaml)

Development

Prerequisites

  • A compiler with C++17 support

  • Pip 10+ or CMake >= 3.4 (or 3.8+ on Windows, which was the first version to support VS 2015)

  • Python 3.8+

  • doxygen

  • cppcheck

  • clang-tools-extra or clang-tidy

Commands

Just clone this repository and pip install. Note the --recursive option which is needed for the pybind11 submodule:

git clone --recursive https://gitlab.blubblub.tech/sgeist/cornflakes.git

Install the package using makefiles:

make install

Build dist using makefiles:

make dist

Run tests (pytest) using makefiles:

make test

Run all tests using makefiles:

make test-all

Run lint using makefiles:

make lint

Create dev venv:

python -m venv .venv
source .venv/bin/activate
pip install ninja pre-commit poetry

Install pre-commit:

pre-commit install

Update pre-commit:

pre-commit update -a

Run pre-commit:

pre-commit run -a

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

cornflakes-3.3.12.tar.gz (3.2 MB view hashes)

Uploaded Source

Built Distributions

cornflakes-3.3.12-cp311-cp311-win_amd64.whl (269.7 kB view hashes)

Uploaded CPython 3.11 Windows x86-64

cornflakes-3.3.12-cp311-cp311-manylinux_2_35_x86_64.whl (400.2 kB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.35+ x86-64

cornflakes-3.3.12-cp311-cp311-manylinux_2_28_x86_64.manylinux_2_24_x86_64.whl (404.0 kB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.24+ x86-64 manylinux: glibc 2.28+ x86-64

cornflakes-3.3.12-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (424.2 kB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.17+ x86-64

cornflakes-3.3.12-cp311-cp311-macosx_12_0_x86_64.whl (569.9 kB view hashes)

Uploaded CPython 3.11 macOS 12.0+ x86-64

cornflakes-3.3.12-cp310-cp310-win_amd64.whl (268.5 kB view hashes)

Uploaded CPython 3.10 Windows x86-64

cornflakes-3.3.12-cp310-cp310-manylinux_2_35_x86_64.whl (398.4 kB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.35+ x86-64

cornflakes-3.3.12-cp310-cp310-manylinux_2_28_x86_64.manylinux_2_24_x86_64.whl (402.4 kB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.24+ x86-64 manylinux: glibc 2.28+ x86-64

cornflakes-3.3.12-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (422.4 kB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ x86-64

cornflakes-3.3.12-cp310-cp310-macosx_12_0_x86_64.whl (342.2 kB view hashes)

Uploaded CPython 3.10 macOS 12.0+ x86-64

cornflakes-3.3.12-cp39-cp39-win_amd64.whl (268.6 kB view hashes)

Uploaded CPython 3.9 Windows x86-64

cornflakes-3.3.12-cp39-cp39-manylinux_2_35_x86_64.whl (398.7 kB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.35+ x86-64

cornflakes-3.3.12-cp39-cp39-manylinux_2_28_x86_64.manylinux_2_24_x86_64.whl (402.4 kB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.24+ x86-64 manylinux: glibc 2.28+ x86-64

cornflakes-3.3.12-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (422.4 kB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.17+ x86-64

cornflakes-3.3.12-cp39-cp39-macosx_12_0_x86_64.whl (342.3 kB view hashes)

Uploaded CPython 3.9 macOS 12.0+ x86-64

cornflakes-3.3.12-cp38-cp38-win_amd64.whl (268.6 kB view hashes)

Uploaded CPython 3.8 Windows x86-64

cornflakes-3.3.12-cp38-cp38-manylinux_2_35_x86_64.whl (397.9 kB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.35+ x86-64

cornflakes-3.3.12-cp38-cp38-manylinux_2_28_x86_64.manylinux_2_24_x86_64.whl (402.2 kB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.24+ x86-64 manylinux: glibc 2.28+ x86-64

cornflakes-3.3.12-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (422.2 kB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.17+ x86-64

cornflakes-3.3.12-cp38-cp38-macosx_12_0_x86_64.whl (342.2 kB view hashes)

Uploaded CPython 3.8 macOS 12.0+ x86-64

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page