Fully typed configuration management, powered by Pydantic
Project description
nshconfig
Fully typed configuration management, powered by Pydantic.
📚 Documentation | 🔧 Installation Guide
Overview
nshconfig is a Python library that enhances Pydantic with additional features for configuration management, particularly useful for machine learning experiments and other applications requiring strongly typed configurations.
Installation
pip install nshconfig
To install all optional dependencies, use:
pip install nshconfig[extra]
Please see the Installation Guide for more details.
Quick Start
import nshconfig as C
class MyConfig(C.Config):
field1: int
field2: str
field3: C.AllowMissing[float] = C.MISSING
config = MyConfig.draft()
config.field1 = 42
config.field2 = "hello"
final_config = config.finalize()
Key Features
- Draft configs for intuitive configuration creation
- Singleton pattern support (both descriptor and global styles)
- Multiple configuration formats (Python, JSON, YAML)
- Dynamic type registry for plugin systems
- Configuration code generation tools
- Built-in PyTorch Lightning integration
- MISSING constant for optional fields
For detailed examples and API reference, please visit the documentation.
Contributing
Contributions are welcome! Please see our Contributing Guide for details.
Credit
Built on top of the excellent pydantic library.
License
MIT License
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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file nshconfig-0.55.0.tar.gz.
File metadata
- Download URL: nshconfig-0.55.0.tar.gz
- Upload date:
- Size: 43.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fc4fa36773ae92d2f662e6b3fcc44e13c4bfb232487479f0d02c07e5b25227f2
|
|
| MD5 |
09f34d43ee73c750a61fd08ddbb663e8
|
|
| BLAKE2b-256 |
5fbf1957607a257586040803dfb10f4fe2383c9c3b92e8c116e5f00bfa75c0d8
|
File details
Details for the file nshconfig-0.55.0-py3-none-any.whl.
File metadata
- Download URL: nshconfig-0.55.0-py3-none-any.whl
- Upload date:
- Size: 50.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ceca3fb825cfeeec93a78b06687ed740527f8b9b45d197c72460a14710601546
|
|
| MD5 |
e2628ecfadbc15d09238eec66e040d08
|
|
| BLAKE2b-256 |
e11acfdd4e18c498699d7c1d70a92d141f4a93b627301069a7c42bbb4d7036b4
|
