CfgForge 0.1.0__tar.gz

cfgforge-0.1.0/CfgForge.egg-info/PKG-INFO

@@ -0,0 +1,161 @@
+Metadata-Version: 2.4
+Name: CfgForge
+Version: 0.1.0
+Summary: Multi-source configuration loader and merger for env / json / yaml / toml
+Author: _COME_HERE_
+License: MIT
+Keywords: config,configuration,settings,env,yaml,toml
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Provides-Extra: yaml
+Requires-Dist: pyyaml>=6.0; extra == "yaml"
+Provides-Extra: toml
+Requires-Dist: tomli>=2.0; python_version < "3.11" and extra == "toml"
+Provides-Extra: all
+Requires-Dist: pyyaml>=6.0; extra == "all"
+Requires-Dist: tomli>=2.0; python_version < "3.11" and extra == "all"
+
+# CfgForge
+
+Multi-source configuration loader and merger for Python.
+Supports `env`, `json`, `yaml`, and `toml` — with priority-based merging,
+dot-path access, and type checking.
+
+## Features
+
+- Load multiple config sources in order; later ones override earlier ones
+- Dot-path access: `config.get("db.host")`
+- Type validation: `config.expect("db.port", int)`
+- Required keys: `config.get("api.key", required=True)`
+- Optional dependencies: install only what you need
+- Clear error messages for missing keys, wrong types, and parse failures
+
+## Installation
+
+```bash
+pip install CfgForge
+```
+
+With YAML support:
+
+```bash
+pip install CfgForge[yaml]
+```
+
+With all optional formats:
+
+```bash
+pip install CfgForge[all]
+```
+
+## Quick Start
+
+```python
+from CfgForge import config
+
+# Load sources (later overrides earlier)
+config.load(".env", "config.yaml", defaults={"db.host": "localhost"})
+
+# Read by dot-path
+host = config.get("db.host")                # "localhost"
+port = config.get("db.port", 5432)          # with default
+key  = config.get("api.key", required=True) # raises if missing
+
+# Type check
+port = config.expect("db.port", int)
+```
+
+## Supported Formats
+
+| Format | Extension        | Dependency                    |
+|--------|------------------|-------------------------------|
+| env    | `.env`           | none                          |
+| JSON   | `.json`          | none                          |
+| YAML   | `.yaml` / `.yml` | `pyyaml`                      |
+| TOML   | `.toml`          | `tomllib` (3.11+) or `tomli`  |
+
+## API Reference
+
+### `config.load(*paths, defaults=None)`
+
+Load one or more config files. Later sources override earlier ones.
+`defaults` has the lowest priority.
+
+```python
+config.load(".env", "config.yaml", defaults={"db.host": "localhost"})
+```
+
+### `config.get(key, default=None, required=False)`
+
+Read a value by dot-path.
+
+```python
+config.get("db.host")                 # None if missing
+config.get("db.host", "localhost")    # fallback value
+config.get("db.host", required=True)  # raises if missing
+```
+
+### `config.expect(key, type_)`
+
+Read a value and validate its type.
+
+```python
+port = config.expect("db.port", int)   # raises ConfigTypeError if not int
+```
+
+### `config.has(key)`
+
+Check whether a key exists.
+
+```python
+if config.has("db.password"):
+    ...
+```
+
+### `config.update(data)`
+
+Inject config manually (useful for tests or runtime overrides).
+
+```python
+config.update({"db": {"host": "localhost"}})
+```
+
+### `config.all()`
+
+Return a shallow copy of all config data.
+
+```python
+data = config.all()
+```
+
+## Exception Hierarchy
+
+```
+CfgForgeError
+├── ConfigNotFoundError
+├── ConfigTypeError
+└── ConfigFileError
+```
+
+Catch all at once:
+
+```python
+from CfgForge import CfgForgeError
+
+try:
+    config.load("config.yaml")
+    config.get("db.host", required=True)
+except CfgForgeError as e:
+    print(f"Config error: {e}")
+```
+
+## License
+
+MIT

cfgforge-0.1.0/CfgForge.egg-info/SOURCES.txt

@@ -0,0 +1,7 @@
+README.md
+pyproject.toml
+CfgForge.egg-info/PKG-INFO
+CfgForge.egg-info/SOURCES.txt
+CfgForge.egg-info/dependency_links.txt
+CfgForge.egg-info/requires.txt
+CfgForge.egg-info/top_level.txt

cfgforge-0.1.0/CfgForge.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

cfgforge-0.1.0/CfgForge.egg-info/requires.txt

@@ -0,0 +1,14 @@
+
+[all]
+pyyaml>=6.0
+
+[all:python_version < "3.11"]
+tomli>=2.0
+
+[toml]
+
+[toml:python_version < "3.11"]
+tomli>=2.0
+
+[yaml]
+pyyaml>=6.0

cfgforge-0.1.0/CfgForge.egg-info/top_level.txt

@@ -0,0 +1 @@
+

cfgforge-0.1.0/PKG-INFO

@@ -0,0 +1,161 @@
+Metadata-Version: 2.4
+Name: CfgForge
+Version: 0.1.0
+Summary: Multi-source configuration loader and merger for env / json / yaml / toml
+Author: _COME_HERE_
+License: MIT
+Keywords: config,configuration,settings,env,yaml,toml
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Provides-Extra: yaml
+Requires-Dist: pyyaml>=6.0; extra == "yaml"
+Provides-Extra: toml
+Requires-Dist: tomli>=2.0; python_version < "3.11" and extra == "toml"
+Provides-Extra: all
+Requires-Dist: pyyaml>=6.0; extra == "all"
+Requires-Dist: tomli>=2.0; python_version < "3.11" and extra == "all"
+
+# CfgForge
+
+Multi-source configuration loader and merger for Python.
+Supports `env`, `json`, `yaml`, and `toml` — with priority-based merging,
+dot-path access, and type checking.
+
+## Features
+
+- Load multiple config sources in order; later ones override earlier ones
+- Dot-path access: `config.get("db.host")`
+- Type validation: `config.expect("db.port", int)`
+- Required keys: `config.get("api.key", required=True)`
+- Optional dependencies: install only what you need
+- Clear error messages for missing keys, wrong types, and parse failures
+
+## Installation
+
+```bash
+pip install CfgForge
+```
+
+With YAML support:
+
+```bash
+pip install CfgForge[yaml]
+```
+
+With all optional formats:
+
+```bash
+pip install CfgForge[all]
+```
+
+## Quick Start
+
+```python
+from CfgForge import config
+
+# Load sources (later overrides earlier)
+config.load(".env", "config.yaml", defaults={"db.host": "localhost"})
+
+# Read by dot-path
+host = config.get("db.host")                # "localhost"
+port = config.get("db.port", 5432)          # with default
+key  = config.get("api.key", required=True) # raises if missing
+
+# Type check
+port = config.expect("db.port", int)
+```
+
+## Supported Formats
+
+| Format | Extension        | Dependency                    |
+|--------|------------------|-------------------------------|
+| env    | `.env`           | none                          |
+| JSON   | `.json`          | none                          |
+| YAML   | `.yaml` / `.yml` | `pyyaml`                      |
+| TOML   | `.toml`          | `tomllib` (3.11+) or `tomli`  |
+
+## API Reference
+
+### `config.load(*paths, defaults=None)`
+
+Load one or more config files. Later sources override earlier ones.
+`defaults` has the lowest priority.
+
+```python
+config.load(".env", "config.yaml", defaults={"db.host": "localhost"})
+```
+
+### `config.get(key, default=None, required=False)`
+
+Read a value by dot-path.
+
+```python
+config.get("db.host")                 # None if missing
+config.get("db.host", "localhost")    # fallback value
+config.get("db.host", required=True)  # raises if missing
+```
+
+### `config.expect(key, type_)`
+
+Read a value and validate its type.
+
+```python
+port = config.expect("db.port", int)   # raises ConfigTypeError if not int
+```
+
+### `config.has(key)`
+
+Check whether a key exists.
+
+```python
+if config.has("db.password"):
+    ...
+```
+
+### `config.update(data)`
+
+Inject config manually (useful for tests or runtime overrides).
+
+```python
+config.update({"db": {"host": "localhost"}})
+```
+
+### `config.all()`
+
+Return a shallow copy of all config data.
+
+```python
+data = config.all()
+```
+
+## Exception Hierarchy
+
+```
+CfgForgeError
+├── ConfigNotFoundError
+├── ConfigTypeError
+└── ConfigFileError
+```
+
+Catch all at once:
+
+```python
+from CfgForge import CfgForgeError
+
+try:
+    config.load("config.yaml")
+    config.get("db.host", required=True)
+except CfgForgeError as e:
+    print(f"Config error: {e}")
+```
+
+## License
+
+MIT

cfgforge-0.1.0/README.md

@@ -0,0 +1,137 @@
+# CfgForge
+
+Multi-source configuration loader and merger for Python.
+Supports `env`, `json`, `yaml`, and `toml` — with priority-based merging,
+dot-path access, and type checking.
+
+## Features
+
+- Load multiple config sources in order; later ones override earlier ones
+- Dot-path access: `config.get("db.host")`
+- Type validation: `config.expect("db.port", int)`
+- Required keys: `config.get("api.key", required=True)`
+- Optional dependencies: install only what you need
+- Clear error messages for missing keys, wrong types, and parse failures
+
+## Installation
+
+```bash
+pip install CfgForge
+```
+
+With YAML support:
+
+```bash
+pip install CfgForge[yaml]
+```
+
+With all optional formats:
+
+```bash
+pip install CfgForge[all]
+```
+
+## Quick Start
+
+```python
+from CfgForge import config
+
+# Load sources (later overrides earlier)
+config.load(".env", "config.yaml", defaults={"db.host": "localhost"})
+
+# Read by dot-path
+host = config.get("db.host")                # "localhost"
+port = config.get("db.port", 5432)          # with default
+key  = config.get("api.key", required=True) # raises if missing
+
+# Type check
+port = config.expect("db.port", int)
+```
+
+## Supported Formats
+
+| Format | Extension        | Dependency                    |
+|--------|------------------|-------------------------------|
+| env    | `.env`           | none                          |
+| JSON   | `.json`          | none                          |
+| YAML   | `.yaml` / `.yml` | `pyyaml`                      |
+| TOML   | `.toml`          | `tomllib` (3.11+) or `tomli`  |
+
+## API Reference
+
+### `config.load(*paths, defaults=None)`
+
+Load one or more config files. Later sources override earlier ones.
+`defaults` has the lowest priority.
+
+```python
+config.load(".env", "config.yaml", defaults={"db.host": "localhost"})
+```
+
+### `config.get(key, default=None, required=False)`
+
+Read a value by dot-path.
+
+```python
+config.get("db.host")                 # None if missing
+config.get("db.host", "localhost")    # fallback value
+config.get("db.host", required=True)  # raises if missing
+```
+
+### `config.expect(key, type_)`
+
+Read a value and validate its type.
+
+```python
+port = config.expect("db.port", int)   # raises ConfigTypeError if not int
+```
+
+### `config.has(key)`
+
+Check whether a key exists.
+
+```python
+if config.has("db.password"):
+    ...
+```
+
+### `config.update(data)`
+
+Inject config manually (useful for tests or runtime overrides).
+
+```python
+config.update({"db": {"host": "localhost"}})
+```
+
+### `config.all()`
+
+Return a shallow copy of all config data.
+
+```python
+data = config.all()
+```
+
+## Exception Hierarchy
+
+```
+CfgForgeError
+├── ConfigNotFoundError
+├── ConfigTypeError
+└── ConfigFileError
+```
+
+Catch all at once:
+
+```python
+from CfgForge import CfgForgeError
+
+try:
+    config.load("config.yaml")
+    config.get("db.host", required=True)
+except CfgForgeError as e:
+    print(f"Config error: {e}")
+```
+
+## License
+
+MIT

cfgforge-0.1.0/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "CfgForge"
+version = "0.1.0"
+description = "Multi-source configuration loader and merger for env / json / yaml / toml"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [
+    { name = "_COME_HERE_" }
+]
+keywords = ["config", "configuration", "settings", "env", "yaml", "toml"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+
+[project.optional-dependencies]
+yaml = ["pyyaml>=6.0"]
+toml = ["tomli>=2.0; python_version < '3.11'"]
+all = ["pyyaml>=6.0", "tomli>=2.0; python_version < '3.11'"]
+
+[tool.setuptools.packages.find]
+include = ["CfgForge*"]

cfgforge-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+