From install to a working snapshot

01

Install the package

Add django_gc, then declare categories and keys in settings.

02

Migrate

post_migrate creates missing rows and never overwrites live values.

03

Read through the service

Call get_value(). A cache miss rebuilds the full typed snapshot under a lock.

Why Django-GC

Code-declared keys

Categories and definitions live in Django settings and are synchronized after migrate.

Full cache snapshot

get_value() never falls back to a single-row ORM read. One parse failure aborts publish.

Stock Django Admin

Edit values with standard ModelAdmin and Django LogEntry history. No Tabler dependency.

Strongly typed

The package ships py.typed so editors and type checkers can follow the public contracts.

Guides

How it works

Snapshot, lock, parse, and the read path.

Definitions

CategoryDefinition, SettingDefinition, and post_migrate.

Types

Every SettingType and its stored format.

Admin

Stock ModelAdmin, read-only keys, and forms.

History

Django Admin LogEntry history.

Cache

Django cache keys, readiness, and lock.

Settings

Settings, encryption key, and optional Celery.