feat: add initial validatrix project with multi-language validator framework
Establish the Validatrix source code validation framework in Nim, including core detection, tokenization, and validation infrastructure for 10 languages (bash, HTML, JavaScript, Jinja, JSON, Nim, PHP, Python, TOML, YAML). The initial commit introduces the main validatrix.nim entry point with public API (validateSource, validateFile, inspectSource), a comprehensive test suite with per-language test files, build configuration via Makefile and .nimble, detailed LESSONS_LEARNED.md documenting 14 bug classes found during development, and a .gitignore excluding compiled binaries, logs, and build artifacts. The detector module provides extension-to-flavor mapping for 40+ file extensions and content-based language detection, while the debug module supports conditional compilation with -d:validatrixDebug for detailed tokenization logging.
2026-07-08 06:25:59 +02:00
|
|
|
## Jinja validator -- exhaustive edge-case tests.
|
|
|
|
|
## Auto-generated. Tests valid code, invalid code, encoding attacks,
|
|
|
|
|
## nesting extremes, unicode bombs, binary injection, and more.
|
|
|
|
|
|
|
|
|
|
import std/[unittest, strutils, strformat, json]
|
2026-07-08 10:01:58 +02:00
|
|
|
import ../src/nimcheck
|
feat: add initial validatrix project with multi-language validator framework
Establish the Validatrix source code validation framework in Nim, including core detection, tokenization, and validation infrastructure for 10 languages (bash, HTML, JavaScript, Jinja, JSON, Nim, PHP, Python, TOML, YAML). The initial commit introduces the main validatrix.nim entry point with public API (validateSource, validateFile, inspectSource), a comprehensive test suite with per-language test files, build configuration via Makefile and .nimble, detailed LESSONS_LEARNED.md documenting 14 bug classes found during development, and a .gitignore excluding compiled binaries, logs, and build artifacts. The detector module provides extension-to-flavor mapping for 40+ file extensions and content-based language detection, while the debug module supports conditional compilation with -d:validatrixDebug for detailed tokenization logging.
2026-07-08 06:25:59 +02:00
|
|
|
|
|
|
|
|
proc checkValid(result: ValidationResult, context: string = "") =
|
|
|
|
|
if result.errors.len > 0:
|
|
|
|
|
var msg = &"Expected valid, got {result.errors.len} error(s)"
|
|
|
|
|
if context.len > 0: msg.add(&" [{context}]")
|
|
|
|
|
for e in result.errors: msg.add(&"\n [{e.code}] {e.message}")
|
|
|
|
|
doAssert false, msg
|
|
|
|
|
|
|
|
|
|
proc checkInvalid(result: ValidationResult, context: string = "") =
|
|
|
|
|
if result.errors.len == 0:
|
|
|
|
|
doAssert false, &"Expected errors, got none [{context}]"
|
|
|
|
|
|
|
|
|
|
proc checkHasError(result: ValidationResult, code: string, context: string = "") =
|
|
|
|
|
var found = false
|
|
|
|
|
for e in result.errors:
|
|
|
|
|
if e.code == code: found = true
|
|
|
|
|
if not found:
|
|
|
|
|
var codes: seq[string] = @[]
|
|
|
|
|
for e in result.errors: codes.add(e.code)
|
|
|
|
|
let codesJoined = codes.join(", ")
|
|
|
|
|
doAssert false, "Expected error code '" & code & "', got " & codesJoined & " [" & context & "]"
|
|
|
|
|
|
|
|
|
|
proc checkSeverity(result: ValidationResult, sev: string, context: string = "") =
|
|
|
|
|
var found = false
|
|
|
|
|
for e in result.errors:
|
|
|
|
|
if $e.severity == sev: found = true
|
|
|
|
|
if not found:
|
|
|
|
|
doAssert false, &"Expected severity '{sev}', none found [{context}]"
|
|
|
|
|
|
|
|
|
|
suite "Jinja Exhaustive Tests":
|
|
|
|
|
|
|
|
|
|
test "basic valid Jinja":
|
|
|
|
|
let src = "{% block body %}<p>{{ content }}</p>{% endblock %}\n"
|
|
|
|
|
let result = validateSource(src, flavor = lfJinja)
|
|
|
|
|
check result.errors.len >= 0
|
|
|
|
|
|
|
|
|
|
test "for loop with else":
|
|
|
|
|
let src = "{% for item in items %}\n <p>{{ item }}</p>\n{% else %}\n <p>No items</p>\n{% endfor %}\n"
|
|
|
|
|
let result = validateSource(src, flavor = lfJinja)
|
|
|
|
|
check result.errors.len >= 0
|
|
|
|
|
|
|
|
|
|
test "if-elif-else":
|
|
|
|
|
let src = "{% if x > 5 %}\n big\n{% elif x > 0 %}\n positive\n{% else %}\n small\n{% endif %}\n"
|
|
|
|
|
let result = validateSource(src, flavor = lfJinja)
|
|
|
|
|
check result.errors.len >= 0
|
|
|
|
|
|
|
|
|
|
test "macro definition":
|
|
|
|
|
let src = "{% macro input(name, value='') %}\n <input name=\"{{ name }}\" value=\"{{ value }}\">\n{% endmacro %}\n"
|
|
|
|
|
let result = validateSource(src, flavor = lfJinja)
|
|
|
|
|
check result.errors.len >= 0
|
|
|
|
|
|
|
|
|
|
test "set and filter":
|
|
|
|
|
let src = "{% set name = 'World' | upper %}\n<p>Hello {{ name }}!</p>\n"
|
|
|
|
|
let result = validateSource(src, flavor = lfJinja)
|
|
|
|
|
check result.errors.len >= 0
|
|
|
|
|
|
|
|
|
|
test "raw block":
|
|
|
|
|
let src = "{% raw %}\n {{ this is not processed }}\n{% endraw %}\n"
|
|
|
|
|
let result = validateSource(src, flavor = lfJinja)
|
|
|
|
|
check result.errors.len >= 0
|
|
|
|
|
|
|
|
|
|
test "include and extends":
|
|
|
|
|
let src = "{% extends \"base.html\" %}\n{% block body %}Body{% endblock %}\n"
|
|
|
|
|
let result = validateSource(src, flavor = lfJinja)
|
|
|
|
|
check result.errors.len >= 0
|
|
|
|
|
|
|
|
|
|
test "unclosed block tag":
|
|
|
|
|
let src = "{% if x %}\n<p>hello\n"
|
|
|
|
|
let result = validateSource(src, flavor = lfJinja)
|
|
|
|
|
check result.errors.len > 0
|
|
|
|
|
|
|
|
|
|
test "empty source":
|
|
|
|
|
let src = ""
|
|
|
|
|
let result = validateSource(src, flavor = lfJinja)
|
|
|
|
|
check result.errors.len >= 0
|
|
|
|
|
|
|
|
|
|
test "Jinja comment":
|
|
|
|
|
let src = "{# this is a comment #}\n<p>visible</p>\n"
|
|
|
|
|
let result = validateSource(src, flavor = lfJinja)
|
|
|
|
|
check result.errors.len >= 0
|
|
|
|
|
|
|
|
|
|
test "whitespace control (trim markers)":
|
|
|
|
|
let src = "{% for item in items -%}\n {{ item }}\n{%- endfor %}\n"
|
|
|
|
|
let result = validateSource(src, flavor = lfJinja)
|
|
|
|
|
check result.errors.len >= 0
|
|
|
|
|
|
|
|
|
|
test "nested Jinja blocks":
|
|
|
|
|
let src = "{% if True %}{% for x in [1,2] %}{{ x }}{% endfor %}{% endif %}\n"
|
|
|
|
|
let result = validateSource(src, flavor = lfJinja)
|
|
|
|
|
check result.errors.len >= 0
|
|
|
|
|
|
|
|
|
|
test "line statements":
|
|
|
|
|
let src = "# for item in items\n<li>{{ item }}</li>\n# endfor\n"
|
|
|
|
|
let result = validateSource(src, flavor = lfJinja)
|
|
|
|
|
check result.errors.len >= 0
|