Upref documentation
Upref stores small per-user application configurations through an explicit, typed Python API. Storage, interactive collection, and v1 migration are separate operations, so applications decide exactly when to read, ask, and write.
Start with the overview and quickstart, then use the task-oriented guides below for behavioral details and the API reference for signatures.
Getting started
- Upref
- Configuration model
- Examples
- User preference scenarios
- Practical recipes
- A first store without persistent files
- Boolean and optional input
- Editing current values in a terminal
- Graphical collection
- Editing a nested section
- A custom interface without a terminal
- Application constraints and typed settings
- Versioning an application’s configuration
- Recovering from malformed YAML
User guide
Reference