serieux

(The README is a work in progress)

Serieux is a very extensible composable serialization/configuration library for Python. Based on ovld's extensive multiple dispatch and code generation, Serieux has many features and makes it possible to define many more with little interference with the rest of the system.

📋 Documentation

Features

Configuration

Serieux has many features that pertain directly to human-writable configuration:

Merge multiple sources: seamlessly merge information from multiple files, formats, dictionaries
Include files: (optional) include configuration files from configuration files to better separate concerns
Variable interpolation: (optional) interpolate and environment variables and data from elsewhere in the configuration
Encrypt fields: fields marked as Secret[T] can be set directly in the configuration and encrypted using the command serieux patch <file>
Dotted notation: (optional) allow keys of the form x.y.z instead of nesting data

All of the aforementioned features should work with each other (although there may still be some bugs, the more of them you combine). For instance, you can merge and encrypt fields through file inclusions, you can determine which file to include through a variable interpolation, and so on.

Types

Tagged types: tagged types use the $class property to determine the deserialization type
- TaggedUnion[T1, T2, ...]: Define auto-named tagged unions of multiple types (type information goes in $class)
- TaggedSubclass[T]: Point to any subclass of T
- TaggedSubclass[Any]: Point to any constructor at all
Referenced[T]: Deserialize some_module:some_symbol into the referenced symbol
Lazy[T]: Proxy data of type T so that it is only loaded when accessed
Comment[DT, CT]: Allow data of type DT to be commented by data with type CT

Metadata

Release files for serieux 0.3.15

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for serieux 0.3.15
File	Size	Uploaded
serieux-0.3.15.tar.gz	195.7 kB	Sep 19, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for serieux 0.3.15
File	Interpreter	ABI	Platform	Reset
serieux-0.3.15-py3-none-any.whl 58.3 kB Sep 19, 2026	Python 3	none	any	Details

Total release size: 254.0 kB

Release files / serieux-0.3.15.tar.gz

Download URL	serieux-0.3.15.tar.gz
Size	195.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`8206d744ac4fd3e123147936f4e23a68db0950ca8aec0c51bd08e08530006cb6`
BLAKE2b-256 checksum How to use checksums	`99236b0a848a4326331439968f51ff334eae7b4ff0efb3064acb5c9d20cd30bc`
Upload date	Sep 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/breuleux/serieux
Publishing commit: github.com/breuleux/serieux/tree/f66a6f199e895ae0ad6ad855e39d02d675549499

Workflow

Publishing configuration: github.com/breuleux/serieux/blob/f66a6f199e895ae0ad6ad855e39d02d675549499/.github/workflows/publish.yml
Publishing logs: github.com/breuleux/serieux/actions/runs/35424585882/attempts/1

Artifact

Subject: serieux-0.3.15.tar.gz
SHA-256 checksum: 8206d744ac4fd3e123147936f4e23a68db0950ca8aec0c51bd08e08530006cb6 Verifying attestations

Release files / serieux-0.3.15-py3-none-any.whl

Download URL	serieux-0.3.15-py3-none-any.whl
Size	58.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`cd8c1022961f8a11eb58c489068c0fbffb497fb67120f2b9e6f12d2407ebd226`
BLAKE2b-256 checksum How to use checksums	`a0d73c64c12c6cd925a139a8eccf8b1d23bea4f2e6a6d8479810e1381beb8ca1`
Upload date	Sep 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/breuleux/serieux
Publishing commit: github.com/breuleux/serieux/tree/f66a6f199e895ae0ad6ad855e39d02d675549499

Workflow

Publishing configuration: github.com/breuleux/serieux/blob/f66a6f199e895ae0ad6ad855e39d02d675549499/.github/workflows/publish.yml
Publishing logs: github.com/breuleux/serieux/actions/runs/35424585882/attempts/1

Artifact

Subject: serieux-0.3.15-py3-none-any.whl
SHA-256 checksum: cd8c1022961f8a11eb58c489068c0fbffb497fb67120f2b9e6f12d2407ebd226 Verifying attestations