Netsuke aims for clear and actionable error messages.
-
YAML Errors: If
Netsukefileis invalid YAML,serde-saphyrprovides location info (line, column). Netsuke may add hints for common issues (e.g., tabs vs spaces). -
Schema Errors: If the YAML structure doesn't match the expected schema (e.g., missing
targets, unknown keys), errors indicate the structural problem. -
Template Errors: Jinja errors during
foreach,when, or string rendering include context (e.g., undefined variable, invalid filter usage) and potentially location information. -
IR Validation Errors: Errors found during graph construction (e.g., missing rules, duplicate outputs, circular dependencies) are reported before execution.
-
Build Failures: If a command run by Ninja fails, Netsuke reports the failure, typically showing the command's output/error streams captured by Ninja.
Use the -v flag for more detailed error context or internal logging.