pysigil 0.2.0

Preferences & secrets manager with layered scopes and tuple-key internals

pysigil

Preference management for small apps.

Quick start

Install pysigil in a virtual environment to make the sigil command available:

python -m venv .venv && source .venv/bin/activate  # Windows: .venv\Scripts\Activate
pip install -e .  # or `pip install .` for a normal install

from pysigil import get_preferences
get_pref, set_pref, launch_gui = get_preferences()

Once installed, try a few commands:

sigil set ui.color blue --app demo
sigil get ui.color --app demo
sigil export --app demo

The CLI stores data under your user config directory (e.g. ~/.config/demo), so you can run these commands right from the source tree without creating a separate project. See tests/manual_tests/README.md for more examples.

Typed helper methods are available for convenient access: Sigil.get_int(), get_float(), get_bool(). For package integration details see docs/integration.md.

Using the GUI

pysigil ships with a simple graphical editor for viewing and editing preferences. After installation launch it with:

sigil-gui