cistell 0.0.4

Configuration library for pynenc and piceli projects

Cistell

A comprehensive configuration management library for Python applications

---

Documentation: https://docs.cistell.pynenc.org

Source Code: https://github.com/pynenc/cistell

---

Cistell is a powerful library aimed at simplifying configuration management for Python projects. It allows developers to manage settings across different environments seamlessly, using a structured yet flexible approach. With support for environment variables, configuration files, and direct settings, Cistell makes it easy to maintain a clear and consistent configuration strategy for any Python application.

Key Features

• Flexible Configuration: Supports various sources, including environment variables, configuration files (JSON, YAML, TOML), and direct assignment.
• Hierarchical Configuration: Allows for layered configuration strategies, accommodating different environments and scenarios.
• Type Checking and Error Handling: Offers robust type checking and error handling for secure and reliable configuration management.
• Extensible Framework: Easily extendable with custom field mappers and validators to fit unique project needs.

Installation

Cistell can be quickly installed using pip. Run the following command in your terminal:

pip install cistell

This command will download and install Cistell along with its dependencies. Once installed, Cistell is ready to enhance your Python project with efficient configuration management.

For further installation details and advanced options, refer to the Cistell Documentation.

Quick Start Example

Here's a basic example to get you started with Cistell:

1. Define a Configuration Class:

   Create a file named config.py and define your configuration settings:

   from cistell import ConfigBase, ConfigField
   
   class MyAppConfig(ConfigBase):
       database_url = ConfigField("sqlite:///example.db")
       feature_flag = ConfigField(False)
   

2. Instantiate and Use Your Configuration:

   In your application, create an instance of your configuration class and use the settings:

   from config import MyAppConfig
   
   config = MyAppConfig()
   print(config.database_url)  # Outputs: sqlite:///example.db
   

For detailed examples and further setup, visit the Cistell Quick Start Guide.

Requirements

Cistell requires Python 3.7 or newer. Additional requirements may vary based on your setup and the features you use.

Contact or Support

For assistance with Cistell, suggestions, or general discussion, please use the following resources:

• GitHub Issues: For bug reports, feature requests, or other technical concerns.
• GitHub Discussions: For questions, ideas exchange, or discussions about Cistell usage and development.

Your contributions and feedback are invaluable in helping Cistell improve and evolve.

License

Cistell is available under the MIT License.