@port-labs/jq-node-bindings 0.0.13 → 0.0.15-dev1

package/deps/jq/Makefile.am

@@ -5,18 +5,26 @@ LIBJQ_INCS = src/builtin.h src/bytecode.h src/compile.h                 \
         src/exec_stack.h src/jq_parser.h src/jv_alloc.h src/jv_dtoa.h   \
         src/jv_unicode.h src/jv_utf8_tables.h src/lexer.l src/libm.h    \
         src/linker.h src/locfile.h src/opcode_list.h src/parser.y       \
-        src/util.h
+        src/util.h src/decNumber/decContext.h src/decNumber/decNumber.h \
+        src/decNumber/decNumberLocal.h src/jv_dtoa_tsd.h src/jv_thread.h \
+        src/jv_private.h
 
 LIBJQ_SRC = src/builtin.c src/bytecode.c src/compile.c src/execute.c    \
         src/jq_test.c src/jv.c src/jv_alloc.c src/jv_aux.c              \
         src/jv_dtoa.c src/jv_file.c src/jv_parse.c src/jv_print.c       \
         src/jv_unicode.c src/linker.c src/locfile.c src/util.c          \
+        src/decNumber/decContext.c src/decNumber/decNumber.c            \
+        src/jv_dtoa_tsd.c                                               \
         ${LIBJQ_INCS}
 
 ### C build options
 
-AM_CFLAGS = -Wextra -Wall -Wno-missing-field-initializers               \
-        -Wno-unused-parameter -Wno-unused-function
+AM_CFLAGS = -Wextra -Wall -Wno-unused-parameter -Wno-unused-function \
+            -Woverlength-strings
+
+if WIN32
+AM_CFLAGS += -municode
+endif
 
 ACLOCAL_AMFLAGS = -I config/m4
 
@@ -25,23 +33,23 @@ ACLOCAL_AMFLAGS = -I config/m4
 # While there is some autoconf macro support for lex/flex, it doesn't support
 # header file creation so we'll use good old make
 if MAINTAINER_MODE
-BUILT_SOURCES = src/lexer.h src/lexer.c src/parser.h src/parser.c 	\
-		src/builtin.inc src/version.h
+BUILT_SOURCES = src/lexer.h src/lexer.c src/parser.h src/parser.c \
+                src/builtin.inc src/config_opts.inc src/version.h
 src/lexer.c: src/lexer.l
 	$(AM_V_LEX) flex -o src/lexer.c --header-file=src/lexer.h $<
 src/lexer.h: src/lexer.c
 else
-BUILT_SOURCES = src/builtin.inc src/version.h
+BUILT_SOURCES = src/builtin.inc src/config_opts.inc src/version.h
 .y.c:
 	$(AM_V_YACC) echo "NOT building parser.c!"
 .l.c:
 	$(AM_V_LEX) echo "NOT building lexer.c!"
 endif
 
-# Tell YACC (bison) autoconf macros that you want a header file created.
-# If the --warnings=all fails, you probably have an old version of bison
-# OSX ships an old bison, so update with homebrew or macports
-AM_YFLAGS = --warnings=all -d
+# Tell YACC (Bison) autoconf macros that you want a header file created.
+# If the --warnings=all fails, you probably have an old version of Bison
+# macOS ships an old Bison, so update with Homebrew or MacPorts.
+AM_YFLAGS = --warnings=all -Wno-yacc -d
 
 ### libjq
 
@@ -52,6 +60,7 @@ libjq_la_LDFLAGS = $(onig_LDFLAGS) -export-symbols-regex '^j[qv]_' -version-info
 
 if WIN32
 libjq_la_LIBADD += -lshlwapi
+libjq_la_LDFLAGS += -no-undefined
 endif
 
 include_HEADERS = src/jv.h src/jq.h
@@ -60,6 +69,8 @@ if ENABLE_UBSAN
 AM_CFLAGS += -fsanitize=undefined
 endif
 
+AM_CPPFLAGS = -I$(srcdir)/src
+
 ### Running tests under Valgrind
 
 if ENABLE_ASAN
@@ -97,45 +108,88 @@ generate_ver = ver="`{ $(srcdir)/scripts/version || echo '$(VERSION)' ; } | sed
 .remake-version-h: .FORCE
 	@ $(generate_ver); test "x`cat src/version.h 2>/dev/null`" = "x$$ver" || touch .remake-version-h
 src/version.h: .remake-version-h
+	mkdir -p src
 	$(AM_V_GEN) $(generate_ver); echo "$$ver" > $@
-src/main.c: src/version.h
-
-src/builtin.inc: src/builtin.jq
-	$(AM_V_GEN) sed -e 's/\\/\\\\/g' -e 's/"/\\"/g' -e 's/^/"/' -e 's/$$/\\n"/' $^ > $@
+src/config_opts.inc:
+	mkdir -p src
+	$(AM_V_GEN) if test -x ./config.status; then \
+	  ./config.status --config; \
+	else echo "(unknown)"; \
+	fi | sed -e 's/\\/\\\\/g' -e 's/"/\\"/g' -e 's/^/"/' -e 's/$$/"/' -e 's/^/#define JQ_CONFIG /' > $@
+src/main.c: src/version.h src/config_opts.inc
+
+src/builtin.inc: $(srcdir)/src/builtin.jq
+	mkdir -p src
+	$(AM_V_GEN) od -v -A n -t o1 -- $< | \
+	sed -e 's/$$/ /' \
+	    -e 's/\([0123456789]\) /\1, /g' \
+	    -e 's/ $$//' \
+	    -e 's/ 0/  0/g' \
+	    -e 's/ \([123456789]\)/ 0\1/g' > $@
 src/builtin.o: src/builtin.inc
 
+CLEANFILES = src/version.h .remake-version-h src/builtin.inc src/config_opts.inc
+
 bin_PROGRAMS = jq
 jq_SOURCES = src/main.c src/version.h
 jq_LDFLAGS = -static-libtool-libs
 jq_LDADD = libjq.la -lm
 
-if WIN32
-jq_LDADD += -lshlwapi
-endif
-
 if ENABLE_ALL_STATIC
 jq_LDFLAGS += -all-static
 endif
 
 ### Tests (make check)
 
-TESTS = tests/optionaltest tests/mantest tests/jqtest tests/onigtest tests/shtest tests/utf8test tests/base64test
-TESTS_ENVIRONMENT = NO_VALGRIND=$(NO_VALGRIND)
-
+TESTS = tests/mantest tests/jqtest tests/shtest tests/utf8test tests/base64test tests/uritest
+if !WIN32
+TESTS += tests/optionaltest
+endif
+AM_TESTS_ENVIRONMENT = JQ=$(abs_builddir)/jq NO_VALGRIND=$(NO_VALGRIND)
+
+# This is a magic make variable that causes it to treat tests/man.test as a
+# DATA-type dependency for the check target. As a result, it will attempt to
+# run any defined targets for tests/man.test as a dependency for check. This
+# allows us to ensure that the tests are up-to-date if the manual has been updated
+check_DATA = tests/man.test
+
+### Building the man tests
+
+# We use the examples in the manual as additional tests, to ensure they always work.
+# As a result, we need to rebuild the tests if the manual has been updated.
+# Making changes to the manpage without having the python deps means your
+# tests won't run. If you aren't making changes to the examples, you probably
+# don't care. But if you are, then you need to run the tests anyway.
+tests/man.test tests/manonig.test: $(srcdir)/docs/content/manual/dev/manual.yml
+if ENABLE_DOCS
+	$(AM_V_GEN) ( cd ${abs_srcdir}/docs && \
+	  $(PIPENV) run python validate_manual_schema.py content/manual/dev/manual.yml && \
+	  $(PIPENV) run python build_mantests.py )
+else
+	@echo Changes to the manual.yml require docs to be enabled to update the manual test.
+	@echo As a result, the manual test is out of date.
+endif
 
 ### Building the manpage
 
+# We build the docs from the manpage yml. If no changes have been made to the
+# manpage, then we'll end up using the cached version. Otherwise, we need to
+# rebuild it.
 man_MANS = jq.1
+jq.1.prebuilt: $(srcdir)/docs/content/manual/dev/manual.yml
 if ENABLE_DOCS
-jq.1: $(srcdir)/docs/content/3.manual/manual.yml
-	$(AM_V_GEN) ( cd ${abs_srcdir}/docs; '$(BUNDLER)' exec rake manpage ) > $@ || { rm -f $@; false; }
-jq.1.prebuilt: jq.1
-	$(AM_V_GEN) cp $^ $@ || { rm -f $@; false; }
+	$(AM_V_GEN) ( cd ${abs_srcdir}/docs && \
+	  $(PIPENV) run python validate_manual_schema.py content/manual/dev/manual.yml && \
+	  $(PIPENV) run python build_manpage.py ) > $@
 else
-jq.1: $(srcdir)/jq.1.prebuilt
-	$(AM_V_GEN) cp $^ $@
+	@echo Changes to the manual.yml require docs to be enabled to update the manpage.
+	@echo As a result, the manpage is out of date.
 endif
 
+jq.1: jq.1.prebuilt
+	$(AM_V_GEN) cp $(srcdir)/jq.1.prebuilt $@
+
+CLEANFILES += jq.1
 
 ### Build oniguruma
 
@@ -146,43 +200,49 @@ endif
 
 AM_CFLAGS += $(onig_CFLAGS)
 
-### Packaging
+if WITH_ONIGURUMA
+TESTS += tests/onigtest tests/manonigtest
+endif
 
-docs/site.yml: configure.ac
-	sed 's/^jq_version: .*/jq_version: "$(VERSION)"/' $@ > $@.new
-	mv $@.new $@
+### Packaging
 
 install-binaries: $(BUILT_SOURCES)
 	$(MAKE) $(AM_MAKEFLAGS) install-exec
 
-DOC_FILES = docs/content docs/public docs/templates docs/site.yml       \
-        docs/Gemfile docs/Gemfile.lock docs/Rakefile docs/README.md     \
-        jq.1.prebuilt
+DOC_FILES = docs/content docs/public docs/templates                     \
+        docs/Pipfile docs/Pipfile.lock docs/build_manpage.py            \
+        docs/build_mantests.py docs/build_website.py docs/README.md     \
+        docs/validate_manual_schema.py docs/manual_schema.yml
 
 EXTRA_DIST = $(DOC_FILES) $(man_MANS) $(TESTS) $(TEST_LOG_COMPILER)     \
         jq.1.prebuilt jq.spec src/lexer.c src/lexer.h src/parser.c      \
-        src/parser.h src/version.h src/builtin.jq                       \
-        scripts/version tests/jq.test tests/modules/.jq                 \
+        src/parser.h src/version.h src/builtin.jq scripts/version       \
+        libjq.pc                                                        \
         tests/modules/a.jq tests/modules/b/b.jq tests/modules/c/c.jq    \
         tests/modules/c/d.jq tests/modules/data.json                    \
+        tests/modules/home1/.jq tests/modules/home2/.jq/g.jq            \
         tests/modules/lib/jq/e/e.jq tests/modules/lib/jq/f.jq           \
+        tests/modules/shadow1.jq tests/modules/shadow2.jq               \
         tests/modules/syntaxerror/syntaxerror.jq                        \
         tests/modules/test_bind_order.jq                                \
         tests/modules/test_bind_order0.jq                               \
         tests/modules/test_bind_order1.jq                               \
-        tests/modules/test_bind_order2.jq tests/onig.supp               \
-        tests/onig.test tests/setup tests/torture/input0.json		\
-        tests/optional.test tests/optionaltest				\
-	tests/utf8-truncate.jq tests/utf8test				\
-	tests/base64.test tests/base64test 				\
-	tests/jq-f-test.sh tests/shtest
+        tests/modules/test_bind_order2.jq                               \
+        tests/onig.supp tests/local.supp                                \
+        tests/setup tests/torture/input0.json                           \
+        tests/optional.test tests/man.test tests/manonig.test           \
+        tests/jq.test tests/onig.test tests/base64.test tests/uri.test  \
+        tests/utf8-truncate.jq tests/jq-f-test.sh                       \
+        tests/no-main-program.jq tests/yes-main-program.jq
 
+AM_DISTCHECK_CONFIGURE_FLAGS=--with-oniguruma=builtin
 
-
-# README.md is expected in Github projects, good stuff in it, so we'll
+# README.md is expected in GitHub projects, good stuff in it, so we'll
 # distribute it and install it with the package in the doc directory.
-docdir = ${datadir}/doc/${PACKAGE}
-dist_doc_DATA = README.md COPYING AUTHORS README
+dist_doc_DATA = README.md NEWS.md COPYING AUTHORS
+
+pkgconfigdir = $(libdir)/pkgconfig
+pkgconfig_DATA = libjq.pc
 
 RELEASE ?= 1
 rpm: dist jq.spec
@@ -192,22 +252,3 @@ rpm: dist jq.spec
 	rpmbuild -tb --define "_topdir ${PWD}/rpm" --define "_prefix /usr" --define "myver $(VERSION)" --define "myrel ${RELEASE}" rpm/SOURCES/jq-$(VERSION).tar.gz
 	find rpm/RPMS/ -name "*.rpm" -exec mv {} ./ \;
 	rm -rf rpm
-
-dist-clean-local:
-	rm -f ${BUILT_SOURCES}
-
-# Not sure why this doesn't get cleaned up automatically, guess
-# automake used to man pages which are hand coded?
-# 'make clean' doesn't delete the manpage if it can't be rebuilt
-clean-local-docs:
-if ENABLE_DOCS
-	rm -f jq.1
-endif
-
-clean-local-gcov:
-	rm -f src/*.gcno src/*.gcda src/*.gcov
-
-clean-local: clean-local-docs clean-local-gcov
-	rm -f src/version.h .remake-version-h
-
-.PHONY: clean-local-docs clean-local-gcov

package/deps/jq/NEWS.md

@@ -0,0 +1,391 @@
+# 1.7.1
+
+## Security
+
+- CVE-2023-50246: Fix heap buffer overflow in jvp\_literal\_number\_literal
+- CVE-2023-50268: fix stack-buffer-overflow if comparing nan with payload
+
+## CLI changes
+
+- Make the default background color more suitable for bright backgrounds. @mjarosie @taoky @nicowilliams @itchyny #2904
+- Allow passing the inline jq script after `--`. @emanuele6 #2919
+- Restrict systems operations on OpenBSD and remove unused `mkstemp`. @klemensn #2934
+- Fix possible uninitialised value dereference if `jq_init()` fails. @emanuele6 @nicowilliams #2935
+
+## Language changes
+
+- Simplify `paths/0` and `paths/1`. @asheiduk @emanuele6 #2946
+- Reject `U+001F` in string literals. @torsten-schenk @itchyny @wader #2911
+- Remove unused nref accumulator in `block_bind_library`. @emanuele6 #2914
+- Remove a bunch of unused variables, and useless assignments. @emanuele6 #2914
+- main.c: Remove unused EXIT\_STATUS\_EXACT option. @emanuele6 #2915
+- Actually use the number correctly casted from double to int as index. @emanuele6 #2916
+- src/builtin.c: remove unnecessary jv\_copy-s in type\_error/type\_error2. @emanuele6 #2937
+- Remove undefined behavior caught by LLVM 10 UBSAN. @Gaelan @emanuele6 #2926
+- Convert decnum to binary64 (double) instead of decimal64. This makes jq behave like the JSON specification suggests and more similar to other languages. @wader @leonid-s-usov #2949
+- Fix memory leaks on invalid input for `ltrimstr/1` and `rtrimstr/1`. @emanuele6 #2977
+- Fix memory leak on failed get for `setpath/2`. @emanuele6 #2970
+- Fix nan from json parsing also for nans with payload that start with 'n'. @emanuele6 #2985
+- Allow carriage return characters in comments. @emanuele6 #2942 #2984
+
+## Documentation changes
+
+- Generate links in the man page. @emanuele6 #2931
+- Standardize arch types to AMD64 & ARM64 from index page download dropdown. @owenthereal #2884
+
+## libjq
+
+- Add extern C for C++. @rockwotj #2953
+
+## Build and test changes
+
+- Fix incorrect syntax for checksum file. @kamontat @wader #2899
+- Remove `-dirty` version suffix for windows release build. @itchyny #2888
+- Make use of `od` in tests more compatible. @nabijaczleweli @emanuele6 @nicowilliams #2922
+- Add dependabot. @yeikel #2889
+- Extend fuzzing setup to fuzz parser and JSON serializer. @DavidKorczynski @emanuele6 #2952
+- Keep releasing executables with legacy names. @itchyny #2951
+
+# 1.7
+
+After a five year hiatus we're back with a GitHub organization, with new admins and new maintainers who have brought a great deal of energy to make a long-awaited and long-needed new release.  We're very grateful for all the new owners, admins, and maintainers.  Special thanks go to Owen Ou (@owenthereal) for pushing to set up a new GitHub organization for jq, Stephen Dolan (@stedolan) for transferring the jq repository to the new organization, @itchyny for doing a great deal of work to get the release done, Mattias Wadman (@wader) and Emanuele Torre (@emanuele6) for many PRs and code reviews.  Many others also contributed PRs, issues, and code reviews as well, and you can find their contributions in the Git log and on the [closed issues and PRs page](https://github.com/jqlang/jq/issues?q=is%3Aclosed+sort%3Aupdated-desc).
+
+Since the last stable release many things have happened:
+
+- jq now lives at <https://github.com/jqlang>
+- New maintainers, admins, and owners have been recruited.
+  - A list of [current maintainers](https://github.com/jqlang/jq/blob/jq-1.7/AUTHORS#L4-L14)
+- NEWS file is replaced by NEWS.md with Markdown format. @wader #2599
+- CI, scan builds, release, website builds etc now use GitHub actions. @owenthereal @wader @itchyny #2596 #2603 #2620 #2723
+- Lots of documentation improvements and fixes.
+- Website updated with new section search box, better section ids for linking, dark mode, etc. @itchyny #2628
+- Release builds for:
+  - Linux `amd64`, `arm64`, `armel`, `armhf`, `i386`, `mips`, `mips64`, `mips64el`, `mips64r6`, `mips64r6el`, `mipsel`, `mipsr6`, `mipsr6el`, `powerpc`, `ppc64el`, `riscv64` and `s390x`
+  - macOS `amd64` and `arm64`
+  - Windows `i386` and `amd64`
+  - Docker `linux/386`, `linux/amd64`, `linux/arm64`, `linux/mips64le`, `linux/ppc64le`, `linux/riscv64` and `linux/s390x`
+  - More details see @owenthereal #2665
+- Docker images are now available from `ghcr.io/jqlang/jq` instead of Docker Hub. @itchyny #2652 #2686
+- 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:
+
+## CLI changes
+
+- Make object key color configurable using `JQ_COLORS` environment variable. @itchyny @haguenau @ericpruitt #2703
+
+  ```sh
+  # this would make "field" bold yellow (`1;33`, the last value)
+  $ JQ_COLORS="0;90:0;37:0;37:0;37:0;32:1;37:1;37:1;33" ./jq -n '{field: 123}'
+  {
+    "field": 123
+  }
+  ```
+
+- Change the default color of null to Bright Black. @itchyny #2824
+- 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 @wader #2747 #2766 #2799
+- Fix multiple issues of exit code using `--exit-code`/`-e` option. @ryo1kato #1697
+
+  ```sh
+  # true-ish last output value exits with zero
+  $ jq -ne true ; echo $?
+  true
+  0
+  # false-ish last output value (false and null) exits with 1
+  $ jq -ne false ; echo $?
+  false
+  1
+  # no output value exists with 4
+  $ jq -ne empty ; echo $?
+  4
+  ```
+
+- Add `--binary`/`-b` on Windows for binary output. To get `\n` instead of `\r\n` line endings. @nicowilliams 0dab2b1
+- Add `--raw-output0` for NUL (zero byte) separated output. @asottile @pabs3 @itchyny #1990 #2235 #2684
+
+  ```sh
+  # will output a zero byte after each output
+  $ jq -n --raw-output0 '1,2,3' | xxd
+  00000000: 3100 3200 3300                           1.2.3.
+  # can be used with xargs -0
+  $ jq -n --raw-output0 '"a","b","c"' | xargs -0 -n1
+  a
+  b
+  c
+  $ jq -n --raw-output0 '"a b c", "d\ne\nf"' | xargs -0 printf '[%s]\n'
+  [a b c]
+  [d
+  e
+  f]
+  # can be used with read -d ''
+  $ while IFS= read -r -d '' json; do
+  >   jq '.name' <<< "$json"
+  > done < <(jq -n --raw-output0 '{name:"a b c"},{name:"d\ne\nf"}')
+  "a b c"
+  "d\ne\nf"
+  # also it's an error to output a string containing a NUL when using NUL separator
+  $ jq -n --raw-output0 '"\u0000"'
+  jq: error (at <unknown>): Cannot dump a string containing NUL with --raw-output0 option
+  ```
+
+- Fix assert crash and validate JSON for `--jsonarg`. @wader #2658
+- Remove deprecated `--argfile` option. @itchyny #2768
+- Enable stack protection. @nicowilliams #2801
+
+## Language changes
+
+- Use decimal number literals to preserve precision. Comparison operations respects precision but arithmetic operations might truncate. @leonid-s-usov #1752
+
+  ```sh
+  # precision is preserved
+  $ echo '100000000000000000' | jq .
+  100000000000000000
+  # comparison respects precision (this is false in JavaScript)
+  $ jq -n '100000000000000000 < 100000000000000001'
+  true
+  # sort/0 works
+  $ jq -n -c '[100000000000000001, 100000000000000003, 100000000000000004, 100000000000000002] | sort'
+  [100000000000000001,100000000000000002,100000000000000003,100000000000000004]
+  # arithmetic operations might truncate (same as JavaScript)
+  $ jq -n '100000000000000000 + 10'
+  100000000000000020
+  ```
+
+- Adds new builtin `pick(stream)` to emit a projection of the input object or array. @pkoppstein #2656 #2779
+
+  ```sh
+  $ jq -n '{"a": 1, "b": {"c": 2, "d": 3}, "e": 4} | pick(.a, .b.c, .x)'
+  {
+    "a": 1,
+    "b": {
+      "c": 2
+    },
+    "x": null
+  }
+  ```
+
+- Adds new builtin `debug(msgs)` that works like `debug` but applies a filter on the input before writing to stderr. @pkoppstein #2710
+
+  ```sh
+  $ jq -n '1 as $x | 2 | debug("Entering function foo with $x == \($x)", .) | (.+1)'
+  ["DEBUG:","Entering function foo with $x == 1"]
+  ["DEBUG:",2]
+  3
+  $ jq -n '{a: 1, b: 2, c: 3} | debug({a, b, sum: (.a+.b)})'
+  ["DEBUG:",{"a":1,"b":2,"sum":3}]
+  {
+    "a": 1,
+    "b": 2,
+    "c": 3
+  }
+  ```
+
+- Adds new builtin `scan($re; $flags)`. Was documented but not implemented. @itchyny #1961
+
+  ```sh
+  # look for pattern "ab" in "abAB" ignoring casing
+  $ jq -n '"abAB" | scan("ab"; "i")'
+  "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
+- Allow `if` without `else`-branch. When skipped the `else`-branch will be `.` (identity). @chancez @wader #1825 #2481
+
+  ```sh
+  # convert 1 to "one" otherwise keep as is
+  $ jq -n '1,2 | if . == 1 then "one" end'
+  "one"
+  2
+  # behaves the same as
+  $ jq -n '1,2 | if . == 1 then "one" else . end'
+  "one"
+  2
+  # also works with elif
+  $ jq -n '1,2,3 | if . == 1 then "one" elif . == 2 then "two" end
+  "one"
+  "two"
+  3
+  ```
+
+- Allow use of `$binding` as key in object literals. @nicowilliams 8ea4a55
+
+  ```sh
+  $ jq -n '"a" as $key | {$key: 123}'
+  {
+    "a": 123
+  }
+  # previously parentheses were needed
+  $ jq -n '"a" as $key | {($key): 123}'
+  {
+    "a": 123
+  }
+  ```
+
+- Allow dot between chained indexes when using `.["index"]` @nicowilliams #1168
+
+  ```sh
+  $ jq -n '{"a": {"b": 123}} | .a["b"]'
+  123
+  # now this also works
+  $ jq -n '{"a": {"b": 123}} | .a.["b"]'
+  123
+  ```
+
+- Allow dot for chained value iterator `.[]`, `.[]?` @wader #2650
+
+  ```sh
+  $ jq -n '{"a": [123]} | .a[]'
+  123
+  # now this also works
+  $ jq -n '{"a": [123]} | .a.[]'
+  123
+  ```
+
+- Fix try/catch catches more than it should. @nicowilliams #2750
+- 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
+- Fix issue converting string to number after previous convert error. @thalman #2400
+- Fix issue representing large numbers on some platforms causing invalid JSON output. @itchyny #2661
+- Fix deletion using assigning empty against arrays. @itchyny #2133
+
+  ```sh
+  # now this works as expected, filter out all values over 2 by assigning empty
+  $ jq -c '(.[] | select(. >= 2)) |= empty' <<< '[1,5,3,0,7]'
+  [1,0]
+  ```
+
+- Allow keywords to be used as binding name in more places. @emanuele6 #2681
+- Allow using `nan` as NaN in JSON. @emanuele6 #2712
+- Expose a module's function names in `modulemeta`. @mrwilson #2837
+- Fix `contains/1` to handle strings with NUL. @nicowilliams 61cd6db
+- 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 `implode` to not assert and instead replace invalid Unicode codepoints. @wader #2646
+- Fix `indices/1` and `rindex/1` in case of overlapping matches in strings. @emanuele6 #2718
+- Fix `sub/3` to resolve issues involving global search-and-replace (gsub) operations. @pkoppstein #2641
+- Fix `significand/0`, `gamma/0` and `drem/2` to be available on macOS. @itchyny #2756 #2775
+- Fix empty regular expression matches. @itchyny #2677
+- Fix overflow exception of the modulo operator. @itchyny #2629
+- Fix string multiplication by 0 (and less than 1) to emit empty string. @itchyny #2142
+- Fix segfault when using libjq and threads. @thalman #2546
+- Fix constant folding of division and reminder with zero divisor. @itchyny #2797
+- Fix `error/0`, `error/1` to throw null error. @emanuele6 #2823
+- Simpler and faster `transpose`. @pkoppstein #2758
+- Simple and efficient implementation of `walk/1`. @pkoppstein #2795
+- Remove deprecated filters `leaf_paths`, `recurse_down`. @itchyny #2666
+
+# Previous releases
+
+Release history
+
+- 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.4 was released on Mon Jun 9 2014
+- 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.1 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:
+
+- Destructuring Alternation
+
+- New Builtins:
+  - builtins/0
+  - stderr/0
+  - halt/0, halt_error/1
+  - isempty/1
+  - walk/1
+  - utf8bytelength/1
+  - localtime/0, strflocaltime/1
+  - SQL-style builtins
+  - and more!
+
+- Add support for ASAN and UBSAN
+
+- Make it easier to use jq with shebangs (8f6f28c)
+
+- Add $ENV builtin variable to access environment
+
+- Add JQ_COLORS env var for configuring the output colors
+
+New features in 1.5 since 1.4:
+
+- regular expressions (with Oniguruma)
+
+- a library/module system
+
+- many new builtins
+
+  - datetime builtins
+  - math builtins
+  - regexp-related builtins
+  - stream-related builtins (e.g., all/1, any/1)
+  - minimal I/O builtins (`inputs`, `debug`)
+
+- new syntactic features, including:
+
+  - destructuring (`. as [$first, $second] | ...`)
+  - try/catch, generalized `?` operator, and label/break
+  - `foreach`
+  - multiple definitions of a function with different numbers of
+      arguments
+
+- command-line arguments
+
+  - --join-lines / -j for raw output
+  - --argjson and --slurpfile
+  - --tab and --indent
+  - --stream (streaming JSON parser)
+  - --seq (RFC7464 JSON text sequence)
+  - --run-tests improvements
+
+- optimizations:
+
+  - tail-call optimization
+  - reduce and foreach no longer leak a reference to .
+
+New features in 1.4 since 1.3:
+
+- command-line arguments
+
+  - jq --arg-file variable file
+  - jq --unbuffered
+  - jq -e / --exit-status (set exit status based on outputs)
+  - jq -S / --sort-keys (now jq no longer sorts object keys by
+      default
+
+- syntax
+
+  - .. -> like // in XPath (recursive traversal)
+  - question mark (e.g., .a?) to suppress errors
+  - ."foo" syntax (equivalent to .["foo"])
+  - better error handling for .foo
+  - added % operator (modulo)
+  - allow negation without requiring extra parenthesis
+  - more function arguments (up to six)
+
+- filters:
+
+  - any, all
+  - iterables, arrays, objects, scalars, nulls, booleans, numbers,
+      strings, values
+
+- string built-ins:
+
+  - split
+  - join (join an array of strings with a given separator string)
+  - ltrimstr, rtrimstr
+  - startswith, endswith
+  - explode, implode
+  - fromjson, tojson
+  - index, rindex, indices
+
+- math functions
+
+  - floor, sqrt, cbrt, etcetera (depends on what's available from libm)
+
+- libjq -- a C API interface to jq's JSON representation and for
+   running jq programs from C applications