القائمة
Use Kida static analysis for pre-render validation, incremental builds, block caching. Use when validating template context, optimizing build times, or implementing caching.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | kida-static-analysis |
| description | Use Kida static analysis for pre-render validation, incremental builds, block caching. Use when validating template context, optimizing build times, or implementing caching. |
Kida analyzes compiled templates without rendering. Use for validation, incremental builds, and caching.
| Method | Returns |
|---|---|
required_context() | Top-level variable names needed |
depends_on() | Dotted paths: page.title, site.menu |
validate_context(ctx) | List of missing variable names |
block_metadata() | Per-block purity, dependencies, cache scope |
template_metadata() | Full analysis including inheritance |
is_cacheable(block_name) | Whether block can be safely cached |
Catch missing variables before rendering:
missing = template.validate_context(user_context)
if missing:
raise ValueError(f"Missing template variables: {missing}")
result = template.render(**user_context)
>>> template.required_context()
frozenset({'page', 'site'})
>>> template.depends_on()
frozenset({'page.title', 'page.content', 'site.menu'})
Results are conservative: may over-approximate, never miss a used path.
>>> meta = template.block_metadata()
>>> nav = meta["nav"]
>>> nav.depends_on
frozenset({'site.menu'})
>>> nav.is_pure
'pure'
>>> nav.cache_scope
'site'
>>> nav.is_cacheable()
True
| Value | Meaning | Cacheable? |
|---|---|---|
"pure" | Deterministic output | Yes |
"impure" | Uses random, shuffle, etc. | No |
"unknown" | Cannot determine | Treat as impure |
| Scope | Meaning | Example |
|---|---|---|
"site" | Same for every page | Nav, footer |
"page" | Varies per page | Content, title |
"none" | Impure | Random quotes |
"unknown" | Cannot determine | Mixed deps |
if template.is_cacheable("nav"):
html = cache.get_or_render("nav", lambda: template.render_block("nav", site=site))
else:
html = template.render_block("nav", site=site)
Analysis requires preserve_ast=True (default). Templates loaded from bytecode cache without source may return empty metadata.
name, depends_on, is_pure, cache_scopeemits_html, emits_landmarks, inferred_rolename, extends, blocks, top_level_depends_onall_dependencies(), get_block(name), cacheable_blocks(), site_cacheable_blocks()Convert Jinja2 templates to Kida syntax. Use when migrating from Jinja2, Django templates, or similar engines.
Use Kida with Chirp for HTMX partials, fragment rendering, block validation. Use when building Chirp web apps.
Write correct Kida templates from scratch. Use when creating templates, writing views, or authoring template content.
Use Kida with Bengal SSG: block caching, incremental builds, template context. Use when building Bengal sites or optimizing build performance.
Add custom Kida filters with proper type coercion. Use when adding filters, extending templates, or handling YAML/config int/str.
Understand Kida expression behavior: `+` operator, list vs string, export accumulation. Use when debugging unexpected output or expression behavior.