config-as-json 0.3

Read, write, validate, and migrate JSON-backed config classes.

config-as-json

config-as-json helps an application keep its configuration schema in a Python class while storing actual configuration data in JSON files.

The intended usage model is:

• Derive an application-specific class from config_as_json.Config.
• Add one instance attribute per supported configuration parameter. An instance attribute can also be a dict or list, optionally with nested dicts and lists.
• Let the values assigned in the derived constructor act as the default configuration.
• Use the library to write those defaults as JSON and to read JSON back into the derived configuration object.

The library is designed to support evolving configuration formats by letting applications define:

• custom parsers for values that should become richer Python types
• optional keys that receive default values when omitted
• backward-compatible key renames for older configuration files
• hooks that can warn or report when automatic compatibility changes were needed

Installation

config-as-json requires Python 3.12 or newer.

pip install --upgrade config-as-json

Main entry points

• config_as_json.Config Base class for JSON-backed configuration objects.
• config_as_json.config_factory_from_json Select the correct configuration class by inspecting JSON input.
• config_as_json.ConfigAutoChangeHook Receive notifications about automatic changes during parsing.
• config_as_json.MigrateCfgWarnHook Warn when backward compatibility was used.
• config_as_json.migrate_cfg Read an older configuration file and write it back in the newest supported format.

The generated API reference also shows the implementation modules where these public objects are defined.

Documentation and examples

• Example directory: example/src/example/README.md
• Public API notes: doc/api.md
• Protected/internal API notes: doc/protected_api.md
• Source repository: config_as_json

The example directory contains worked examples for new users. It is not included in the package installed from PyPI.

Project status

This package originated as configuration code from a larger application and has been refactored into a stand-alone reusable library. The public API reference and worked examples are maintained in the source repository.

License

MIT

Test summary

• Test result: 3563 passed in 9s
• No flake8 warnings.
• No mypy errors found.
• Built version(s): 0.3
• Build and test using Python 3.14.3