navigine/jq
1
0 Fork 0
mirror of https://github.com/jqlang/jq.git synced 2026-10-26 20:16:33 +00:00
Code Issues Packages Projects Releases Wiki Activity

Backfill with references in NEWS.md (#2788)

Browse Source 
Backfill with references to PRs & issues in NEWS.md
This commit is contained in:
Owen Ou authored and GitHub committed 2023-07-29 07:38:08 -07:00
1 parent 70bbd10b0b
commit ee2a215f2e
1 file changed
+102 -79
Download Patch File Download Diff File Expand all files Collapse all files
NEWS.md
+102 -79
View File
@@ -4,9 +4,10 @@ After a five year hiatus we're back with a GitHub organization, with new admins
Since the last stable release many things have happened: Since the last stable release many things have happened:
- jq now lives at https://github.com/jqlang - jq now lives at <https://github.com/jqlang>
- New maintainers, admins, and owners have been recruited. - New maintainers, admins, and owners have been recruited.
- CI, scan builds, release builds etc now use GitHub actions. - A list of [current maintainers](https://github.com/jqlang/jq/blob/70bbd10b0b58e797d03963264fc934879bb44454/AUTHORS#L4-L13)
- CI, scan builds, release builds etc now use GitHub actions. @owenthereal #2596 #2620
- Lots of documentation improvements and fixes. - Lots of documentation improvements and fixes.
- Web site updated with new auto complete, better section ids for linking, dark mode, etc. @itchyny #2628 - Web site updated with new auto complete, better section ids for linking, dark mode, etc. @itchyny #2628
- Release builds for: - Release builds for:
@@ -14,14 +15,16 @@ Since the last stable release many things have happened:
- macOS `amd64` and `arm64` - macOS `amd64` and `arm64`
- Windows `i386` and `amd64` - Windows `i386` and `amd64`
- Docker `linux/386`, `linux/amd64`, `linux/arm64`, `linux/mips64le`, `linux/ppc64le`, `linux/riscv64` and `linux/s390x` - Docker `linux/386`, `linux/amd64`, `linux/arm64`, `linux/mips64le`, `linux/ppc64le`, `linux/riscv64` and `linux/s390x`
- Docker images are now available from `ghcr.io/jqlang/jq` instead of docker hub. - More details see @owenthereal #2665
- OSS-fuzz. - Docker images are now available from `ghcr.io/jqlang/jq` instead of docker hub. @itchyny #2652
- OSS-fuzz. @DavidKorczynski #2760 #2762
Full commit log can be found at https://github.com/jqlang/jq/compare/jq-1.6...jq-1.7 but here are some highlights: Full commit log can be found at <https://github.com/jqlang/jq/compare/jq-1.6...jq-1.7> but here are some highlights:
## CLI changes ## CLI changes
- Make object key color configurable using `JQ_COLORS` environment variable. @itchyny @haguenau @ericpruitt #2703 - Make object key color configurable using `JQ_COLORS` environment variable. @itchyny @haguenau @ericpruitt #2703
```sh ```sh
# this would make "field" yellow (33, the last value) # this would make "field" yellow (33, the last value)
$ JQ_COLORS="1;30:0;37:0;37:0;37:0;32:1;37:1;37:1;33" ./jq -n '{field: 123}' $ JQ_COLORS="1;30:0;37:0;37:0;37:0;32:1;37:1;37:1;33" ./jq -n '{field: 123}'
@@ -29,9 +32,11 @@ Full commit log can be found at https://github.com/jqlang/jq/compare/jq-1.6...jq
"field": 123 "field": 123
} }
``` ```
- Respect `NO_COLOR` environment variable to disable color output. See https://no-color.org for details. @itchyny #2728
- Respect `NO_COLOR` environment variable to disable color output. See <https://no-color.org> for details. @itchyny #2728
- Improved `--help` output. Now mentions all options and nicer order. @itchyny #2747 #2766 - Improved `--help` output. Now mentions all options and nicer order. @itchyny #2747 #2766
- Last output value can now control exit code using `--exit-code`/`-e`. @ryo1kato #1697 - Last output value can now control exit code using `--exit-code`/`-e`. @ryo1kato #1697
```sh ```sh
# true-ish last output value exits with zero # true-ish last output value exits with zero
$ jq -ne true ; echo $? $ jq -ne true ; echo $?
@@ -45,8 +50,10 @@ Full commit log can be found at https://github.com/jqlang/jq/compare/jq-1.6...jq
$ jq -ne empty ; echo $? $ jq -ne empty ; echo $?
4 4
``` ```
- Add `--binary`/`-b` on Windows for binary output. To get `\n` instead of `\r\n` line endings. 0dab2b1 @nicowilliams - Add `--binary`/`-b` on Windows for binary output. To get `\n` instead of `\r\n` line endings. 0dab2b1 @nicowilliams
- Add `--raw-output0` for NUL (zero byte) separated output. @asottile @pabs3 @itchyny #1990 #2235 #2684 - Add `--raw-output0` for NUL (zero byte) separated output. @asottile @pabs3 @itchyny #1990 #2235 #2684
```sh ```sh
# will output a zero byte after each output # will output a zero byte after each output
$ jq -n --raw-output0 '1,2,3' | xxd $ jq -n --raw-output0 '1,2,3' | xxd
@@ -69,12 +76,14 @@ Full commit log can be found at https://github.com/jqlang/jq/compare/jq-1.6...jq
$ jq -n --raw-output0 '"\u0000"' $ jq -n --raw-output0 '"\u0000"'
jq: error (at <unknown>): Cannot dump a string containing NUL with --raw-output0 option jq: error (at <unknown>): Cannot dump a string containing NUL with --raw-output0 option
``` ```
- Fix assert crash and validate JSON for `--jsonarg`. @wader #2658 - Fix assert crash and validate JSON for `--jsonarg`. @wader #2658
- Remove deprecated `--argfile` option. @itchyny #2768 - Remove deprecated `--argfile` option. @itchyny #2768
## Language changes ## Language changes
- Use decimal number literals to preserve precision. Comparison operations respects precision but arithmetic operations might truncate. @leonid-s-usov #1752 - Use decimal number literals to preserve precision. Comparison operations respects precision but arithmetic operations might truncate. @leonid-s-usov #1752
```sh ```sh
# precision is preserved # precision is preserved
$ jq -n '100000000000000000' $ jq -n '100000000000000000'
@@ -86,7 +95,9 @@ Full commit log can be found at https://github.com/jqlang/jq/compare/jq-1.6...jq
$ jq -n '100000000000000000+10' $ jq -n '100000000000000000+10'
100000000000000020 100000000000000020
``` ```
- Adds new builtin `pick(stream)` to emit a projection of the input object or array. @pkoppstein #2656 - Adds new builtin `pick(stream)` to emit a projection of the input object or array. @pkoppstein #2656
```sh ```sh
$ jq -n '{"a": 1, "b": {"c": 2, "d": 3}, "e": 4} | pick(.a, .b.c, .x)' $ jq -n '{"a": 1, "b": {"c": 2, "d": 3}, "e": 4} | pick(.a, .b.c, .x)'
{ {
@@ -97,7 +108,9 @@ Full commit log can be found at https://github.com/jqlang/jq/compare/jq-1.6...jq
"x": null "x": null
} }
``` ```
- Adds new builtin `debug(msgs)` that works like `debug` but applies a filter on the input before writing to stderr. @pkoppstein #2710 - Adds new builtin `debug(msgs)` that works like `debug` but applies a filter on the input before writing to stderr. @pkoppstein #2710
```sh ```sh
$ jq -n '1 as $x | 2 | debug("Entering function foo with $x == \($x)", .) | (.+1)' $ jq -n '1 as $x | 2 | debug("Entering function foo with $x == \($x)", .) | (.+1)'
["DEBUG:","Entering function foo with $x == 1"] ["DEBUG:","Entering function foo with $x == 1"]
@@ -111,15 +124,19 @@ Full commit log can be found at https://github.com/jqlang/jq/compare/jq-1.6...jq
"c": 3 "c": 3
} }
``` ```
- Adds new builtin `scan($re; $flags)`. Was documented but not implemented. @itchyny #1961 - Adds new builtin `scan($re; $flags)`. Was documented but not implemented. @itchyny #1961
```sh ```sh
# look for pattern "ab" in "abAB" ignoring casing # look for pattern "ab" in "abAB" ignoring casing
$ jq -n '"abAB" | scan("ab"; "i")' $ jq -n '"abAB" | scan("ab"; "i")'
"ab" "ab"
"AB" "AB"
``` ```
- Adds new builtin `abs` to get absolute value. This potentially allows the literal value of numbers to be preserved as `length` and `fabs` convert to float. @pkoppstein #2767 - Adds new builtin `abs` to get absolute value. This potentially allows the literal value of numbers to be preserved as `length` and `fabs` convert to float. @pkoppstein #2767
- Allow `if` without `else`-branch. When skipped the `else`-branch will be `.` (identity). @chancez @wader #1825 #2481 - Allow `if` without `else`-branch. When skipped the `else`-branch will be `.` (identity). @chancez @wader #1825 #2481
```sh ```sh
# convert 1 to "one" otherwise keep as is # convert 1 to "one" otherwise keep as is
$ jq -n '1,2 | if . == 1 then "one" end' $ jq -n '1,2 | if . == 1 then "one" end'
@@ -135,7 +152,9 @@ Full commit log can be found at https://github.com/jqlang/jq/compare/jq-1.6...jq
"two" "two"
3 3
``` ```
- Allow use of `$binding` as key in object literals. 8ea4a55 @nicowilliams - Allow use of `$binding` as key in object literals. 8ea4a55 @nicowilliams
```sh ```sh
$ jq -n '"a" as $key | {$key: 123}' $ jq -n '"a" as $key | {$key: 123}'
{ {
@@ -147,7 +166,9 @@ Full commit log can be found at https://github.com/jqlang/jq/compare/jq-1.6...jq
"a": 123 "a": 123
} }
``` ```
- Allow dot between chained indexes when using `.["index"]` @nicowilliams #1168 - Allow dot between chained indexes when using `.["index"]` @nicowilliams #1168
```sh ```sh
$ jq -n '{"a": {"b": 123}} | .a["b"]' $ jq -n '{"a": {"b": 123}} | .a["b"]'
123 123
@@ -155,6 +176,7 @@ Full commit log can be found at https://github.com/jqlang/jq/compare/jq-1.6...jq
$ jq -n '{"a": {"b": 123}} | .a.["b"]' $ jq -n '{"a": {"b": 123}} | .a.["b"]'
123 123
``` ```
- Fix try/catch catches more than it should. @nicowilliams #2750 - Fix try/catch catches more than it should. @nicowilliams #2750
- Speed up and refactor some builtins, also remove `scalars_or_empty/0`. @muhmuhten #1845 - Speed up and refactor some builtins, also remove `scalars_or_empty/0`. @muhmuhten #1845
- Now `halt` and `halt_error` exit immediately instead of continuing to the next input. @emanuele6 #2667 - Now `halt` and `halt_error` exit immediately instead of continuing to the next input. @emanuele6 #2667
@@ -162,11 +184,13 @@ Full commit log can be found at https://github.com/jqlang/jq/compare/jq-1.6...jq
- Make 0 divided by 0 result in NaN consistently. @itchyny #2253 - Make 0 divided by 0 result in NaN consistently. @itchyny #2253
- Fix issue representing large numbers on some platforms causing invalid JSON output. @itchyny #2661 - Fix issue representing large numbers on some platforms causing invalid JSON output. @itchyny #2661
- Fix deletion using assigning empty against arrays. @itchyny #2133 - Fix deletion using assigning empty against arrays. @itchyny #2133
```sh ```sh
# now this works as expected, filter out all values over 2 by assigning empty # now this works as expected, filter out all values over 2 by assigning empty
$ jq -c '(.[] | select(. >= 2)) |= empty' <<< '[1,5,3,0,7]' $ jq -c '(.[] | select(. >= 2)) |= empty' <<< '[1,5,3,0,7]'
[1,0] [1,0]
``` ```
- Fix `stderr/0` to output raw text without any decoration. @itchyny #2751 - Fix `stderr/0` to output raw text without any decoration. @itchyny #2751
- Fix `nth/2` to emit empty on index out of range. @itchyny #2674 - Fix `nth/2` to emit empty on index out of range. @itchyny #2674
- Fix `implode` to not assert and instead replace invalid unicode codepoints. @wader #2646 - Fix `implode` to not assert and instead replace invalid unicode codepoints. @wader #2646
@@ -181,113 +205,112 @@ Full commit log can be found at https://github.com/jqlang/jq/compare/jq-1.6...jq
Release history Release history
* jq version 1.6 was released on Fri Nov 2 2018 - jq version 1.6 was released on Fri Nov 2 2018
* jq version 1.5 was released on Sat Aug 15 2015 - jq version 1.5 was released on Sat Aug 15 2015
* jq version 1.4 was released on Mon Jun 9 2014 - jq version 1.4 was released on Mon Jun 9 2014
* jq version 1.3 was released on Sun May 19 2013 - jq version 1.3 was released on Sun May 19 2013
* jq version 1.2 was released on Thu Dec 20 2012 - jq version 1.2 was released on Thu Dec 20 2012
* jq version 1.1 was released on Sun Oct 21 2012 - jq version 1.1 was released on Sun Oct 21 2012
* jq version 1.0 was released on Sun Oct 21 2012 - jq version 1.0 was released on Sun Oct 21 2012
New features in 1.6 since 1.5: New features in 1.6 since 1.5:
- Destructuring Alternation - Destructuring Alternation
- New Builtins: - New Builtins:
- builtins/0 - builtins/0
- stderr/0 - stderr/0
- halt/0, halt_error/1 - halt/0, halt_error/1
- isempty/1 - isempty/1
- walk/1 - walk/1
- utf8bytelength/1 - utf8bytelength/1
- localtime/0, strflocaltime/1 - localtime/0, strflocaltime/1
- SQL-style builtins - SQL-style builtins
- and more! - and more!
- Add support for ASAN and UBSAN - Add support for ASAN and UBSAN
- Make it easier to use jq with shebangs (8f6f28c) - Make it easier to use jq with shebangs (8f6f28c)
- Add $ENV builtin variable to access environment - Add $ENV builtin variable to access environment
- Add JQ_COLORS env var for configuring the output colors - Add JQ_COLORS env var for configuring the output colors
New features in 1.5 since 1.4: New features in 1.5 since 1.4:
- regular expressions (with Oniguruma) - regular expressions (with Oniguruma)
- a library/module system - a library/module system
- many new builtins - many new builtins
- datetime builtins - datetime builtins
- math builtins - math builtins
- regexp-related builtins - regexp-related builtins
- stream-related builtins (e.g., all/1, any/1) - stream-related builtins (e.g., all/1, any/1)
- minimal I/O builtins (`inputs`, `debug`) - minimal I/O builtins (`inputs`, `debug`)
- new syntactic features, including: - new syntactic features, including:
- destructuring (`. as [$first, $second] | ...`) - destructuring (`. as [$first, $second] | ...`)
- try/catch, generalized `?` operator, and label/break - try/catch, generalized `?` operator, and label/break
- `foreach` - `foreach`
- multiple definitions of a function with different numbers of - multiple definitions of a function with different numbers of
arguments arguments
- command-line arguments - command-line arguments
- --join-lines / -j for raw output - --join-lines / -j for raw output
- --argjson and --slurpfile - --argjson and --slurpfile
- --tab and --indent - --tab and --indent
- --stream (streaming JSON parser) - --stream (streaming JSON parser)
- --seq (RFC7464 JSON text sequence) - --seq (RFC7464 JSON text sequence)
- --run-tests improvements - --run-tests improvements
- optimizations: - optimizations:
- tail-call optimization - tail-call optimization
- reduce and foreach no longer leak a reference to . - reduce and foreach no longer leak a reference to .
New features in 1.4 since 1.3: New features in 1.4 since 1.3:
- command-line arguments - command-line arguments
- jq --arg-file variable file - jq --arg-file variable file
- jq --unbuffered - jq --unbuffered
- jq -e / --exit-status (set exit status based on outputs) - jq -e / --exit-status (set exit status based on outputs)
- jq -S / --sort-keys (now jq no longer sorts object keys by - jq -S / --sort-keys (now jq no longer sorts object keys by
default default
- syntax - syntax
- .. -> like // in XPath (recursive traversal) - .. -> like // in XPath (recursive traversal)
- question mark (e.g., .a?) to suppress errors - question mark (e.g., .a?) to suppress errors
- ."foo" syntax (equivalent to .["foo"]) - ."foo" syntax (equivalent to .["foo"])
- better error handling for .foo - better error handling for .foo
- added % operator (modulo) - added % operator (modulo)
- allow negation without requiring extra parenthesis - allow negation without requiring extra parenthesis
- more function arguments (up to six) - more function arguments (up to six)
- filters: - filters:
- any, all - any, all
- iterables, arrays, objects, scalars, nulls, booleans, numbers, - iterables, arrays, objects, scalars, nulls, booleans, numbers,
strings, values strings, values
- string built-ins: - string built-ins:
- split - split
- join (join an array of strings with a given separator string) - join (join an array of strings with a given separator string)
- ltrimstr, rtrimstr - ltrimstr, rtrimstr
- startswith, endswith - startswith, endswith
- explode, implode - explode, implode
- fromjson, tojson - fromjson, tojson
- index, rindex, indices - index, rindex, indices
- math functions - math functions
- floor, sqrt, cbrt, etcetera (depends on what's available from libm) - floor, sqrt, cbrt, etcetera (depends on what's available from libm)
- libjq -- a C API interface to jq's JSON representation and for - libjq -- a C API interface to jq's JSON representation and for
running jq programs from C applications running jq programs from C applications