1JSONNNET(1) User Commands JSONNNET(1)
2
3
4
6 jsonnet - jsonnet commandline interpreter
7
9 jsonnet [option ...] filename
10
12 In all cases:
13
14 • filename can be - (stdin)
15
16 • Multichar options are expanded e.g. -abc becomes -a -b -c.
17
18 • The -- option suppresses option processing for subsequent argu‐
19 ments.
20
21 • Note that since filenames and jsonnet programs can begin with -,
22 it is advised to use -- if the argument is unknown, e.g. json‐
23 net -- "$FILENAME".
24
25 AVAILABLE OPTIONS
26 -h, --help
27 Print a usage message
28
29 -e, --exec
30 Treat filename as code
31
32 -J, --jpath dir
33 Specify an additional library search directory (right-most wins)
34
35 -o, --output-file file
36 Write to the output file rather than stdout
37
38 -m, --multi dir
39 Write multiple files to the directory, list files on stdout
40
41 -y, --yaml-stream
42 Write output as a YAML stream of JSON documents
43
44 -S, --string
45 Expect a string, manifest as plain text
46
47 -s, --max-stack n
48 Number of allowed stack frames
49
50 -t, --max-trace n
51 Max length of stack trace before cropping
52
53 --gc-min-objects n
54 Do not run garbage collector until this many
55
56 --gc-growth-trigger n
57 Run garbage collector after this amount of object growth
58
59 --version
60 Print version
61
62 AVAILABLE OPTIONS FOR SPECIFYING VALUES OF ‘EXTERNAL’ VARIABLES
63 Provide the value as a string:
64
65 -V, --ext-str var[=val]
66 If val is omitted, get from environment var var
67 --ext-str-file var=file
68 Read the string from the file
69
70 Provide the value as Jsonnet code:
71
72 --ext-code var[=code]
73 If code is omitted, get from environment var var
74
75 --ext-code-file var=file
76 Read the code from the file
77
78 AVAILABLE OPTIONS FOR SPECIFYING VALUES OF ‘TOP-LEVEL ARGUMENTS’
79 Provide the value as a string:
80
81 -V, --tla-str var[=val]
82 If val is omitted, get from environment var var
83 --tla-str-file var=file
84 Read the string from the file
85
86 Provide the value as Jsonnet code:
87
88 --tla-code var[=code]
89 If code is omitted, get from environment var var
90
91 --tla-code-file var=file
92 Read the code from the file
93
95 JSONNET_PATH
96 is a colon (semicolon on Windows) separated list of directories
97 added in reverse order before the paths specified by --jpath
98 (i.e. left-most wins)
99
100 E.g.
101 JSONNET_PATH=a:b jsonnet -J c -J d
102 is equivalent to:
103 JSONNET_PATH=d:c:a:b jsonnet
104 jsonnet -J b -J a -J c -J d
105
107 jsonnetfmt(1)
108
109
110
111 June 2021 JSONNNET(1)