jsdc-loader 0.0.6

JSON Data Class Loader

JSDC Loader (JSON Data Class Loader)

JSDC Loader is a Python utility for loading JSON configuration files into dataclass objects. It provides a simple and type-safe way to manage configuration data in your Python applications by forcing the use of dataclass and type hinting.

Features

• Load JSON configuration files into dataclass objects
• Support for nested dataclass structures
• Type checking and conversion for configuration values
• Easy updating of configuration from different files
• Ability to dump modified configurations back to JSON

Installation

To install JSDC Loader, you can use pip:

pip install jsdc_loader

Usage

Here's an example of how to use JSDC Loader:

Example 1

from dataclasses import dataclass
from jsdc_loader import JSDC_Loader

@dataclass
class DatabaseConfig:
    host: str = 'localhost'  # default value must be provided
    port: int = 3306
    user: str = 'root'
    password: str = 'password'

# Create an instance of JSDC_Loader to load configuration from 'config.json'
config_loader = JSDC_Loader('config.json', DatabaseConfig)
# Access the host attribute from the loaded configuration
print(config_loader.data.host)  # Accessing the host attribute from the loaded data

Example 2

from dataclasses import dataclass, field
from jsdc_loader import JSDC_Loader

@dataclass
class UserConfig:
    name: str = 'John Doe'
    age: int = 30

@dataclass
class AppConfig:
    user: UserConfig = field(default_factory=lambda: UserConfig())
    database: DatabaseConfig = field(default_factory=lambda: DatabaseConfig())

# Create an instance of JSDC_Loader to load configuration from 'config.json'
app_config_loader = JSDC_Loader('config.json', AppConfig)
# Access the name attribute from the user configuration
print(app_config_loader.data.user.name)  # Accessing the name attribute from the loaded data

Example 3

from dataclasses import dataclass, field
from enum import Enum, auto
from jsdc_loader import JSDC_Loader

@dataclass
class UserType(Enum):
    ADMIN = auto()
    USER = auto()

@dataclass
class UserConfig:
    name: str = 'John Doe'
    age: int = 30
    married: bool = False
    user_type: UserType = field(default_factory=lambda: UserType.USER)

@dataclass
class AppConfig:
    user: UserConfig = field(default_factory=lambda: UserConfig())
    database: DatabaseConfig = field(default_factory=lambda: DatabaseConfig())

# Create an instance of JSDC_Loader to load configuration from 'config.json'
app_config_loader = JSDC_Loader('config.json', AppConfig)
# Access the user type attribute from the user configuration
print(app_config_loader.data.user.user_type)  # Accessing the user type attribute from the loaded data

Example 4

from dataclasses import dataclass, field
from jsdc_loader import JSDC_Loader

@dataclass
class ControllerConfig:
    controller_id: str = 'controller_01'
    controller_type: str = 'controller_type_01'
    controller_version: str = 'controller_version_01'
    utc_offset: float = 0.0
    app: AppConfig = field(default_factory=lambda: AppConfig())

# Create an instance of JSDC_Loader to load configuration from 'config.json'
controller_config_loader = JSDC_Loader('config.json', ControllerConfig)
# Access the controller_id attribute from the loaded configuration
print(controller_config_loader.data.controller_id)  # Accessing the controller_id attribute from the loaded data

License

This project is licensed under the MIT License. See the LICENSE file for more details.