# Error Codes

URL: /docs/errors/
Section: docs
Tags: reference, errors, troubleshooting

--------------------------------------------------------------------------------

Error Codes Every Kida exception carries an ErrorCode that categorizes the error and links to this page. Use exc.code.value to get the code string (e.g. &quot;K-RUN-001&quot;). For full error handling guidance, see Error Handling. Lexer Errors (K-LEX-xxx) Lexer errors occur during tokenization of template source. k-lex-001 Unclosed tag — A &#123;% or {{ or {# was not closed. Fix: Ensure every &#123;% has a matching %&#125;, every &#123;&#123; ` has ` &#125;&#125;, and every {# has #}. k-lex-002 Unclosed comment — A comment block {# ... #} was not closed. Fix: Add the closing #} to the comment. k-lex-003 Unclosed variable — An output block &#123;&#123; ... &#125;&#125; was not closed. Fix: Add the closing }} to the expression. k-lex-004 Token limit exceeded — The template exceeded the maximum token count. Fix: Split the template into smaller includes or simplify the template. Parser Errors (K-PAR-xxx) Parser errors occur when building the template AST from tokens. k-par-001 Unexpected token — The parser encountered a token it did not expect at this position. Fix: Check syntax around the reported line. Common causes: misplaced &#123;% end %&#125;, invalid tag name, or malformed expression. k-par-002 Unclosed block — A block tag (e.g. &#123;% if %&#125;, &#123;% for %&#125;) was not closed with &#123;% end %&#125;. Fix: Add &#123;% end %&#125; for every opening block tag. k-par-003 Invalid expression — An expression could not be parsed. Fix: Check the expression syntax. Ensure proper operator usage, balanced parentheses, and valid filter/test syntax. k-par-004 Invalid filter — A filter name or filter arguments are invalid. Fix: Use a valid built-in or registered filter name. Check filter argument types. k-par-005 Invalid test — A test name or test arguments are invalid. Fix: Use a valid built-in or registered test name. Check test argument types. Runtime Errors (K-RUN-xxx) Runtime errors occur during template rendering. k-run-001 Undefined variable — A variable or attribute was accessed that does not exist. Fix: Pass the variable in the render context, use | default(fallback), or check with &#123;% if var is defined %&#125;. k-run-002 Filter execution error — A filter raised an exception during execution. Fix: Check the filter's input type and arguments. Use | default() for optional values. k-run-003 Test execution error — A test raised an exception during execution. Fix: Check the test's input type and arguments. k-run-004 Required value was None — A required value (e.g. from | require) was None or missing. Fix: Ensure the value is present in context or pass a valid default. k-run-005 None comparison (sorting) — sort or sortattr encountered None in a comparison. Fix: Enable strict_none=True to raise, or filter out None values before sorting. k-run-006 Include depth exceeded — Too many nested &#123;% include %&#125; calls. Fix: Reduce include nesting. Check for circular includes. k-run-007 Generic runtime error — A Python exception occurred during rendering. Fix: Check the traceback for the underlying cause. Ensure context values have expected types. Template Loading Errors (K-TPL-xxx) Template loading errors occur when resolving or loading template files. k-tpl-001 Template not found — The loader could not find the requested template. Fix: Check the template name and path. Verify the loader configuration (e.g. FileSystemLoader paths). k-tpl-002 Syntax error in template — The template file contains invalid syntax. Fix: Fix the syntax error at the reported line. See parser and lexer errors above for related codes. See Also Error Handling — Exception types, format_compact(), SourceSnippet Undefined Variable — Debugging K-RUN-001 Template Not Found — Debugging K-TPL-001

--------------------------------------------------------------------------------

Metadata:
- Word Count: 576
- Reading Time: 3 minutes