Theme
Version
GitHub PyPI Discord

API reference

The citry public API, by area.

  • Component - The base class every component subclasses.
  • Component introspection - Frozen metadata records for component catalogs, schemas, assets, and extensions.
  • Component libraries - Engine-neutral component definitions, explicit manifests, and per-Citry installations.
  • Citry instance and config - The Citry instance that scopes components, settings, and caches.
  • Rendering - The three-phase render pipeline and its output structs.
  • Slots - The slot value and fill types.
  • Nodes - The runtime node classes the compiled template instantiates.
  • Extensions - The plugin system: the extension base, its commands, and the hook context objects.
  • Dependencies - The JS/CSS dependency types collected and placed at serialize time, and the built-in citry.ext.dependencies extension that owns them.
  • Render cache keys - Exact key helpers and errors for component and named-fragment render caches.
  • Events - Event handlers declared on components: the class Events: contract, the typed base for it, and the built-in citry.ext.events extension that owns it.
  • Browser APIs - Component JavaScript, Citry's Alpine magics, and page-wide browser methods.
  • HTML attributes - Helpers for Vue-like class/style merging on HTML elements.
  • Web integration - The route table a web framework mounts, and the request/response types handlers use (see citry.contrib).
  • Contrib integrations - Adapters mounting citry into web frameworks, and cache adapters for shared stores (the citry.contrib.<name> modules).
  • Built-in tags - The built-in <c-*> tags every component can use.