@port-labs/jq-node-bindings 1.0.1 → 1.0.3

package/deps/jq/jq.1.prebuilt

@@ -1,5 +1,5 @@
 .
-.TH "JQ" "1" "November 2024" "" ""
+.TH "JQ" "1" "December 2023" "" ""
 .
 .SH "NAME"
 \fBjq\fR \- Command\-line JSON processor
@@ -163,13 +163,13 @@ Implies \fB\-\-stream\fR\. Invalid JSON inputs produce no error values when \fB\
 Use the \fBapplication/json\-seq\fR MIME type scheme for separating JSON texts in jq\'s input and output\. This means that an ASCII RS (record separator) character is printed before each value on output and an ASCII LF (line feed) is printed after every output\. Input JSON texts that fail to parse are ignored (but warned about), discarding all subsequent input until the next RS\. This mode also parses the output of jq without the \fB\-\-seq\fR option\.
 .
 .TP
-\fB\-f\fR / \fB\-\-from\-file\fR:
+\fB\-f filename\fR / \fB\-\-from\-file filename\fR:
 .
 .IP
-Read the filter from a file rather than from a command line, like awk\'s \-f option\. This changes the filter argument to be interpreted as a filename, instead of the source of a program\.
+Read filter from the file rather than from a command line, like awk\'s \-f option\. You can also use \'#\' to make comments\.
 .
 .TP
-\fB\-L directory\fR / \fB\-\-library\-path directory\fR:
+\fB\-L directory\fR:
 .
 .IP
 Prepend \fBdirectory\fR to the search list for modules\. If this option is used then no builtin search list is used\. See the section on modules below\.
@@ -181,7 +181,7 @@ Prepend \fBdirectory\fR to the search list for modules\. If this option is used
 This option passes a value to the jq program as a predefined variable\. If you run jq with \fB\-\-arg foo bar\fR, then \fB$foo\fR is available in the program and has the value \fB"bar"\fR\. Note that \fBvalue\fR will be treated as a string, so \fB\-\-arg foo 123\fR will bind \fB$foo\fR to \fB"123"\fR\.
 .
 .IP
-Named arguments are also available to the jq program as \fB$ARGS\.named\fR\. When the name is not a valid identifier, this is the only way to access it\.
+Named arguments are also available to the jq program as \fB$ARGS\.named\fR\.
 .
 .TP
 \fB\-\-argjson name JSON\-text\fR:
@@ -286,16 +286,13 @@ Although the identity filter never modifies the value of its input, jq processin
 produces \fB1\.7976931348623157e+308\fR on at least one platform\. This is because, in the process of parsing the number, this particular version of jq has converted it to an IEEE754 double\-precision representation, losing precision\.
 .
 .P
-The way in which jq handles numbers has changed over time and further changes are likely within the parameters set by the relevant JSON standards\. Moreover, build configuration options can alter how jq processes numbers\.
-.
-.P
-The following remarks are therefore offered with the understanding that they are intended to be descriptive of the current version of jq and should not be interpreted as being prescriptive:
+The way in which jq handles numbers has changed over time and further changes are likely within the parameters set by the relevant JSON standards\. The following remarks are therefore offered with the understanding that they are intended to be descriptive of the current version of jq and should not be interpreted as being prescriptive:
 .
 .P
 (1) Any arithmetic operation on a number that has not already been converted to an IEEE754 double precision representation will trigger a conversion to the IEEE754 representation\.
 .
 .P
-(2) jq will attempt to maintain the original decimal precision of number literals (if the \fB\-\-disable\-decnum\fR build configuration option was not used), but in expressions such \fB1E1234567890\fR, precision will be lost if the exponent is too large\.
+(2) jq will attempt to maintain the original decimal precision of number literals, but in expressions such \fB1E1234567890\fR, precision will be lost if the exponent is too large\.
 .
 .P
 (3) In jq programs, a leading minus sign will trigger the conversion of the number to an IEEE754 representation\.
@@ -303,9 +300,6 @@ The following remarks are therefore offered with the understanding that they are
 .P
 (4) Comparisons are carried out using the untruncated big decimal representation of numbers if available, as illustrated in one of the following examples\.
 .
-.P
-The examples below use the builtin function \fBhave_decnum\fR in order to demonstrate the expected effects of using / not using the \fB\-\-disable\-decnum\fR build configuration option, and also to allow automated tests derived from these examples to pass regardless of whether that option is used\.
-.
 .IP "" 4
 .
 .nf
@@ -318,21 +312,21 @@ jq \'\.\'
    0\.12345678901234567890123456789
 => 0\.12345678901234567890123456789
 
-jq \'[\., tojson] | \. == if have_decnum then [12345678909876543212345,"12345678909876543212345"] else [12345678909876543000000,"12345678909876543000000"] end\'
+jq \'[\., tojson]\'
    12345678909876543212345
-=> true
+=> [12345678909876543212345,"12345678909876543212345"]
 
 jq \'\. < 0\.12345678901234567890123456788\'
    0\.12345678901234567890123456789
 => false
 
-jq \'map([\., \. == 1]) | tojson | \. == if have_decnum then "[[1,true],[1\.000,true],[1\.0,true],[1\.00,true]]" else "[[1,true],[1,true],[1,true],[1,true]]" end\'
+jq \'map([\., \. == 1]) | tojson\'
    [1, 1\.000, 1\.0, 100e\-2]
-=> true
+=> "[[1,true],[1\.000,true],[1\.0,true],[1\.00,true]]"
 
-jq \'\. as $big | [$big, $big + 1] | map(\. > 10000000000000000000000000000000) | \. == if have_decnum then [true, false] else [false, false] end\'
+jq \'\. as $big | [$big, $big + 1] | map(\. > 10000000000000000000000000000000)\'
    10000000000000000000000000000001
-=> true
+=> [true, false]
 .
 .fi
 .
@@ -496,7 +490,7 @@ Like \fB\.[]\fR, but no errors will be output if \. is not an array or object\.
 If two filters are separated by a comma, then the same input will be fed into both and the two filters\' output value streams will be concatenated in order: first, all of the outputs produced by the left expression, and then all of the outputs produced by the right\. For instance, filter \fB\.foo, \.bar\fR, produces both the "foo" fields and "bar" fields as separate outputs\.
 .
 .P
-The \fB,\fR operator is one way to construct generators\.
+The \fB,\fR operator is one way to contruct generators\.
 .
 .IP "" 4
 .
@@ -1010,7 +1004,7 @@ When the input to \fBmap_values(f)\fR is an object, the output object has the sa
 The key difference between \fBmap(f)\fR and \fBmap_values(f)\fR is that the former simply forms an array from all the values of \fB($x|f)\fR for each value, $x, in the input array or object, but \fBmap_values(f)\fR only uses \fBfirst($x|f)\fR\.
 .
 .P
-Specifically, for object inputs, \fBmap_values(f)\fR constructs the output object by examining in turn the value of \fBfirst(\.[$k]|f)\fR for each key, $k, of the input\. If this expression produces no values, then the corresponding key will be dropped; otherwise, the output object will have that value at the key, $k\.
+Specifically, for object inputs, \fBmap_value(f)\fR constructs the output object by examining in turn the value of \fBfirst(\.[$k]|f)\fR for each key, $k, of the input\. If this expression produces no values, then the corresponding key will be dropped; otherwise, the output object will have that value at the key, $k\.
 .
 .P
 Here are some examples to clarify the behavior of \fBmap\fR and \fBmap_values\fR when applied to arrays\. These examples assume the input is \fB[1]\fR in all cases:
@@ -1340,15 +1334,12 @@ jq \'[paths(type == "number")]\'
 .
 .IP "" 0
 .
-.SS "add, add(generator)"
+.SS "add"
 The filter \fBadd\fR takes as input an array, and produces as output the elements of the array added together\. This might mean summed, concatenated or merged depending on the types of the elements of the input array \- the rules are the same as those for the \fB+\fR operator (described above)\.
 .
 .P
 If the input is an empty array, \fBadd\fR returns \fBnull\fR\.
 .
-.P
-\fBadd(generator)\fR operates on the given generator rather than the input\.
-.
 .IP "" 4
 .
 .nf
@@ -1364,10 +1355,6 @@ jq \'add\'
 jq \'add\'
    []
 => null
-
-jq \'add(\.[]\.a)\'
-   [{"a":3}, {"a":5}, {"b":6}]
-=> 8
 .
 .fi
 .
@@ -1943,30 +1930,6 @@ jq \'[\.[]|rtrimstr("foo")]\'
 .
 .IP "" 0
 .
-.SS "trim, ltrim, rtrim"
-\fBtrim\fR trims both leading and trailing whitespace\.
-.
-.P
-\fBltrim\fR trims only leading (left side) whitespace\.
-.
-.P
-\fBrtrim\fR trims only trailing (right side) whitespace\.
-.
-.P
-Whitespace characters are the usual \fB" "\fR, \fB"\en"\fR \fB"\et"\fR, \fB"\er"\fR and also all characters in the Unicode character database with the whitespace property\. Note that what considers whitespace might change in the future\.
-.
-.IP "" 4
-.
-.nf
-
-jq \'trim, ltrim, rtrim\'
-   " abc "
-=> "abc", "abc ", " abc"
-.
-.fi
-.
-.IP "" 0
-.
 .SS "explode"
 Converts an input string into an array of the string\'s codepoint numbers\.
 .
@@ -2189,17 +2152,11 @@ jq \'walk( if type == "object" then with_entries( \.key |= sub( "^_+"; "") ) els
 .
 .IP "" 0
 .
-.SS "have_literal_numbers"
-This builtin returns true if jq\'s build configuration includes support for preservation of input number literals\.
-.
-.SS "have_decnum"
-This builtin returns true if jq was built with "decnum", which is the current literal number preserving numeric backend implementation for jq\.
-.
 .SS "$JQ_BUILD_CONFIGURATION"
 This builtin binding shows the jq executable\'s build configuration\. Its value has no particular format, but it can be expected to be at least the \fB\./configure\fR command\-line arguments, and may be enriched in the future to include the version strings for the build tooling used\.
 .
 .P
-Note that this can be overridden in the command\-line with \fB\-\-arg\fR and related options\.
+Note that this can be overriden in the command\-line with \fB\-\-arg\fR and related options\.
 .
 .SS "$ENV, env"
 \fB$ENV\fR is an object representing the environment variables as set when the jq program started\.
@@ -2330,12 +2287,6 @@ Applies HTML/XML escaping, by mapping the characters \fB<>&\'"\fR to their entit
 Applies percent\-encoding, by mapping all reserved URI characters to a \fB%XX\fR sequence\.
 .
 .TP
-\fB@urid\fR:
-.
-.IP
-The inverse of \fB@uri\fR, applies percent\-decoding, by mapping all \fB%XX\fR sequences to their corresponding URI characters\.
-.
-.TP
 \fB@csv\fR:
 .
 .IP
@@ -2446,7 +2397,7 @@ The \fBlocaltime\fR builtin works like the \fBgmtime\fR builtin, but using the l
 The \fBmktime\fR builtin consumes "broken down time" representations of time output by \fBgmtime\fR and \fBstrptime\fR\.
 .
 .P
-The \fBstrptime(fmt)\fR builtin parses input strings matching the \fBfmt\fR argument\. The output is in the "broken down time" representation consumed by \fBmktime\fR and output by \fBgmtime\fR\.
+The \fBstrptime(fmt)\fR builtin parses input strings matching the \fBfmt\fR argument\. The output is in the "broken down time" representation consumed by \fBgmtime\fR and output by \fBmktime\fR\.
 .
 .P
 The \fBstrftime(fmt)\fR builtin formats a time (GMT) with the given format\. The \fBstrflocaltime\fR does the same, but using the local timezone setting\.
@@ -2733,7 +2684,7 @@ label $out | \.\.\. break $out \.\.\.
 .IP "" 0
 .
 .P
-The \fBbreak $label_name\fR expression will cause the program to act as though the nearest (to the left) \fBlabel $label_name\fR produced \fBempty\fR\.
+The \fBbreak $label_name\fR expression will cause the program to to act as though the nearest (to the left) \fBlabel $label_name\fR produced \fBempty\fR\.
 .
 .P
 The relationship between the \fBbreak\fR and corresponding \fBlabel\fR is lexical: the label has to be "visible" from the break\.
@@ -3435,14 +3386,14 @@ jq \'isempty(\.[])\'
 .
 .IP "" 0
 .
-.SS "limit(n; expr)"
-The \fBlimit\fR function extracts up to \fBn\fR outputs from \fBexpr\fR\.
+.SS "limit(n; exp)"
+The \fBlimit\fR function extracts up to \fBn\fR outputs from \fBexp\fR\.
 .
 .IP "" 4
 .
 .nf
 
-jq \'[limit(3; \.[])]\'
+jq \'[limit(3;\.[])]\'
    [0,1,2,3,4,5,6,7,8,9]
 => [0,1,2]
 .
@@ -3450,21 +3401,6 @@ jq \'[limit(3; \.[])]\'
 .
 .IP "" 0
 .
-.SS "skip(n; expr)"
-The \fBskip\fR function skips the first \fBn\fR outputs from \fBexpr\fR\.
-.
-.IP "" 4
-.
-.nf
-
-jq \'[skip(3; \.[])]\'
-   [0,1,2,3,4,5,6,7,8,9]
-=> [3,4,5,6,7,8,9]
-.
-.fi
-.
-.IP "" 0
-.
 .SS "first(expr), last(expr), nth(n; expr)"
 The \fBfirst(expr)\fR and \fBlast(expr)\fR functions extract the first and last values from \fBexpr\fR, respectively\.
 .
@@ -3475,13 +3411,9 @@ The \fBnth(n; expr)\fR function extracts the nth value output by \fBexpr\fR\. No
 .
 .nf
 
-jq \'[first(range(\.)), last(range(\.)), nth(5; range(\.))]\'
+jq \'[first(range(\.)), last(range(\.)), nth(\./2; range(\.))]\'
    10
 => [0,9,5]
-
-jq \'[first(empty), last(empty), nth(5; empty)]\'
-   null
-=> []
 .
 .fi
 .
@@ -3666,7 +3598,7 @@ Besides simple arithmetic operators such as \fB+\fR, jq also has most standard m
 Availability of standard math functions depends on the availability of the corresponding math functions in your operating system and C math library\. Unavailable math functions will be defined but will raise an error\.
 .
 .P
-One\-input C math functions: \fBacos\fR \fBacosh\fR \fBasin\fR \fBasinh\fR \fBatan\fR \fBatanh\fR \fBcbrt\fR \fBceil\fR \fBcos\fR \fBcosh\fR \fBerf\fR \fBerfc\fR \fBexp\fR \fBexp10\fR \fBexp2\fR \fBexpm1\fR \fBfabs\fR \fBfloor\fR \fBgamma\fR \fBj0\fR \fBj1\fR \fBlgamma\fR \fBlog\fR \fBlog10\fR \fBlog1p\fR \fBlog2\fR \fBlogb\fR \fBnearbyint\fR \fBrint\fR \fBround\fR \fBsignificand\fR \fBsin\fR \fBsinh\fR \fBsqrt\fR \fBtan\fR \fBtanh\fR \fBtgamma\fR \fBtrunc\fR \fBy0\fR \fBy1\fR\.
+One\-input C math functions: \fBacos\fR \fBacosh\fR \fBasin\fR \fBasinh\fR \fBatan\fR \fBatanh\fR \fBcbrt\fR \fBceil\fR \fBcos\fR \fBcosh\fR \fBerf\fR \fBerfc\fR \fBexp\fR \fBexp10\fR \fBexp2\fR \fBexpm1\fR \fBfabs\fR \fBfloor\fR \fBgamma\fR \fBj0\fR \fBj1\fR \fBlgamma\fR \fBlog\fR \fBlog10\fR \fBlog1p\fR \fBlog2\fR \fBlogb\fR \fBnearbyint\fR \fBpow10\fR \fBrint\fR \fBround\fR \fBsignificand\fR \fBsin\fR \fBsinh\fR \fBsqrt\fR \fBtan\fR \fBtanh\fR \fBtgamma\fR \fBtrunc\fR \fBy0\fR \fBy1\fR\.
 .
 .P
 Two\-input C math functions: \fBatan2\fR \fBcopysign\fR \fBdrem\fR \fBfdim\fR \fBfmax\fR \fBfmin\fR \fBfmod\fR \fBfrexp\fR \fBhypot\fR \fBjn\fR \fBldexp\fR \fBmodf\fR \fBnextafter\fR \fBnexttoward\fR \fBpow\fR \fBremainder\fR \fBscalb\fR \fBscalbln\fR \fByn\fR\.
@@ -4023,74 +3955,6 @@ The paths provided by this operation point to each of the posts that "stedolan"
 .
 .IP "" 0
 .
-.SH "COMMENTS"
-You can write comments in your jq filters using \fB#\fR\.
-.
-.P
-A \fB#\fR character (not part of a string) starts a comment\. All characters from \fB#\fR to the end of the line are ignored\.
-.
-.P
-If the end of the line is preceded by an odd number of backslash characters, the following line is also considered part of the comment and is ignored\.
-.
-.P
-For example, the following code outputs \fB[1,3,4,7]\fR
-.
-.IP "" 4
-.
-.nf
-
-[
-  1,
-  # foo \e
-  2,
-  # bar \e\e
-  3,
-  4, # baz \e\e\e
-  5, \e
-  6,
-  7
-  # comment \e
-    comment \e
-    comment
-]
-.
-.fi
-.
-.IP "" 0
-.
-.P
-Backslash continuing the comment on the next line can be useful when writing the "shebang" for a jq script:
-.
-.IP "" 4
-.
-.nf
-
-#!/bin/sh \-\-
-# total \- Output the sum of the given arguments (or stdin)
-# usage: total [numbers\.\.\.]
-# \e
-exec jq \-\-args \-MRnf \-\- "$0" "$@"
-
-$ARGS\.positional |
-reduce (
-  if \. == []
-    then inputs
-    else \.[]
-  end |
-  \. as $dot |
-  try tonumber catch false |
-  if not or isnan then
-    @json "total: Invalid number \e($dot)\.\en" | halt_error(1)
-  end
-) as $n (0; \. + $n)
-.
-.fi
-.
-.IP "" 0
-.
-.P
-The \fBexec\fR line is considered a comment by jq, so it is ignored\. But it is not ignored by \fBsh\fR, since in \fBsh\fR a backslash at the end of the line does not continue the comment\. With this trick, when the script is invoked as \fBtotal 1 2\fR, \fB/bin/sh \-\- /path/to/total 1 2\fR will be run, and \fBsh\fR will then run \fBexec jq \-\-args \-MRnf \-\- /path/to/total 1 2\fR replacing itself with a \fBjq\fR interpreter invoked with the specified options (\fB\-M\fR, \fB\-R\fR, \fB\-n\fR, \fB\-\-args\fR), that evaluates the current file (\fB$0\fR), with the arguments (\fB$@\fR) that were passed to \fBsh\fR\.
-.
 .SH "MODULES"
 jq has a library/module system\. Modules are files whose names end in \fB\.jq\fR\.
 .
@@ -4098,7 +3962,7 @@ jq has a library/module system\. Modules are files whose names end in \fB\.jq\fR
 Modules imported by a program are searched for in a default search path (see below)\. The \fBimport\fR and \fBinclude\fR directives allow the importer to alter this path\.
 .
 .P
-Paths in the search path are subject to various substitutions\.
+Paths in the a search path are subject to various substitutions\.
 .
 .P
 For paths starting with \fB~/\fR, the user\'s home directory is substituted for \fB~\fR\.
@@ -4128,7 +3992,7 @@ Consecutive components with the same name are not allowed to avoid ambiguities (
 For example, with \fB\-L$HOME/\.jq\fR a module \fBfoo\fR can be found in \fB$HOME/\.jq/foo\.jq\fR and \fB$HOME/\.jq/foo/foo\.jq\fR\.
 .
 .P
-If \fB\.jq\fR exists in the user\'s home directory, and is a file (not a directory), it is automatically sourced into the main program\.
+If \fB$HOME/\.jq\fR is a file, it is sourced into the main program\.
 .
 .SS "import RelativePathString as NAME [<metadata>];"
 Imports a module found at the given path relative to a directory in a search path\. A \fB\.jq\fR suffix will be added to the relative path string\. The module\'s symbols are prefixed with \fBNAME::\fR\.

package/deps/jq/jq.spec

@@ -6,7 +6,7 @@ Version: %{myver}
 Release: %{myrel}%{?dist}
 Source0: jq-%{myver}.tar.gz
 URL: https://jqlang.github.io/jq
-License: MIT AND ICU AND CC-BY-3.0
+License: BSD
 AutoReqProv: no
 #BuildPrereq: autoconf, libtool, automake, flex, bison, python