Repository navigation
Conversation
He-Pin
force-pushed
the
fix/cli-missing-input-file
branch
from
June 25, 2026 04:48
5cd11b6 to
a23a523
Compare
He-Pin
marked this pull request as draft
June 25, 2026 17:57
He-Pin
marked this pull request as ready for review
June 25, 2026 18:05
He-Pin
force-pushed
the
fix/cli-missing-input-file
branch
from
June 25, 2026 19:04
4e8555a to
56bc273
Compare
Motivation: Missing or invalid input files and binding files could print stack traces. Modification: Catch file and path errors at CLI boundaries and add regression coverage. Result: Input failures now return user-facing errors without internal traces.
He-Pin
force-pushed
the
fix/cli-missing-input-file
branch
from
June 27, 2026 02:42
56bc273 to
b42da8a
Compare
Contributor
Author
|
Superseded by combined CLI PR #1032 |
stephenamar-db
pushed a commit
that referenced
this pull request
Jun 28, 2026
…y bindings (#1032) ## Motivation Several CLI error paths leaked Java exception names (`NoSuchFileException`, `InvalidPathException`, `upickle.core.Abort`) or stack traces to end users. The `-V` short flag was ambiguously bound to `--ext-str`, `--ext-code`, and `--tla-code`. The `--string` flag produced internal errors for non-string results instead of a clean type mismatch message. Binding file paths with invalid characters (e.g. null bytes) were silently accepted. Reference implementations (C++ jsonnet, go-jsonnet, jrsonnet) reserve `-V` exclusively for `--ext-str`. This PR combines the following fixes into a single cohesive CLI hardening change: | Original PR | Fix | | --- | --- | | #1032 | Reserve `-V` exclusively for `--ext-str` | | #1034 | Report undefined CLI binding env vars with clean error | | #1035 | Make `--ext-str-file`/`--ext-code-file` lazy via importstr/import | | #1036 | Report missing input files without stack traces | | #1038 | Report output file write failures cleanly | | #1039 | Fix `--string` non-string error reporting | ## Modification ### Config / CLI parsing - Remove `short = 'V'` from `--ext-code` and `--tla-code` `@arg` annotations in `Config.scala` - Keep `short = 'V'` on `--ext-str` only - Update README help snapshot ### Error handling (`SjsonnetMainBase.scala`) - Add `CliError` class with no stack trace for clean CLI error messages - Add `handleRenderError` to wrap Jsonnet evaluation errors - Add `handleWriteFile` to wrap file I/O errors with C++/go-jsonnet-style messages - Rewrite `parseBindings` to use `HashMap` with eager `InvalidPathException` validation - Make `--ext-str-file` and `--ext-code-file` lazy (`importstr`/`import`) while still validating path syntax eagerly - Add clean type error for `--string` with non-string results (matching C++/go-jsonnet format) - Wrap output file write and multi/yaml-stream render paths with error handling ### Tests - 18 new CLI integration tests covering all error paths - `ConfigTests` verifies `-V` binds only to `--ext-str` - 24 new test resource files (jsonnet inputs + golden outputs) ## Result - All CLI errors produce clean messages matching C++/go-jsonnet conventions - `-V` binds only to `--ext-str`, matching reference implementations - `--string` rejects non-string types with clear `expected string result, got: <type>` error - Malformed binding file paths fail eagerly with clean error - Unused `--ext-str-file` bindings are lazy (file not read unless referenced) - 45/45 MainTests pass, 0 regressions in full test suite ## CLI Superset Status sjsonnet is now a superset of go-jsonnet and C++ jsonnet CLI features, with these extras: - `--yaml-out`, `--yaml-debug`, `--debug-importer`, `--debug-stats` - `--profile`, `--strict`, `--preserve-order`, `--indent` - `--fatal-warnings`, `--throw-error-for-invalid-sets` - `--max-stack`, `--max-parser-recursion-depth` - `--reverse-jpaths-priority`, `--no-trailing-newline` - `--broken-assertion-logic` (backwards compat)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Motivation
Missing CLI input files and binding files could leak raw Java exceptions or stack traces instead of clean user-facing errors. Malformed paths could also escape the normal error path.
NoSuchFileExceptionstack traceOpening input file: missing.jsonnet: no such file or directoryOpening binding file: missing.jsonnet: no such file or directoryInvalidPathException/IllegalArgumentExceptiondetailOpening binding file: <message>Modification
mainConfigured.parseBindingscalls for ext-vars and TLAs.NoSuchFileException,IOException, and malformed-pathIllegalArgumentExceptionin the relevant error paths.Result
--execpaths are unchanged.Verification
./mill --no-daemon 'sjsonnet.jvm[3.3.8].test' sjsonnet.MainTests./mill --no-daemon 'sjsonnet.jvm[3.3.8].checkFormat'