jq-sys 0.2.0

Generated bindings for libjq.
docs.rs failed to build jq-sys-0.2.0
Please check build logs and if you believe this is docs.rs' fault, report into this issue report.

Generated bindings for jq 1.6.

The bindings were generated with bindgen, which is available via cargo install.

Example:

$ git submodule update --init
$ bindgen modules/jq/src/jq.h -o src/bindings.rs

Building

Using the bundled feature

When the bundled feature is enabled it will add a dependency on jq-src, which will attempt to build and link to the library. This may cover simple cases, but for anything exotic (such as cross-building), you will want to install or build libjq yourself.

Note: when using the bundled feature libjq is provided by the jq-src crate, which requires gcc, autoreconf, make, etc in your PATH to build.

Without the bundled feature

When not using the bundled feature, you'd either have to compile libjq yourself, or use libs furnished by your system package manager.

For example on debian systems, you might install libjq1 libjq-dev libonig4 libonig-dev.

The following env vars can be used to provide hints to the build script.

Name Purpose Notes
JQ_LIB_DIR Path to the location of the library.
JQ_LIB_STATIC Use static linking instead of shared.
JQ_NO_ONIG Disable linking to oniguruma for regex support.
ONIG_LIB_DIR Path to the location of the library. Defaults to JQ_LIB_DIR, ignored if JQ_NO_ONIG is set.
ONIG_LIB_STATIC Use static linking instead of shared. Ignored if JQ_NO_ONIG is set.

Changelog

0.2.0 (2019-02-18)

Additions:

  • New env vars added to allow linkage to libjq and libonig to be customized.
  • Adds pkg-config feature (on by default) to help configure linkage, as a fallback when env vars are not set.

Breaking changes:

  • bundled feature is no longer enabled by default.

0.1.1 (2019-01-13)

Added bundled feature (on by default) to allow dependents to opt in or out from using the jq-src crate for linkage.

0.1.0 (2019-01-13)

Initial release.