diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 8f8cd15..672aff4 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -224,7 +224,7 @@ jobs: fi # The optional Arrow module uses Arrow Java's C Data JNI on the same staged - # release pair. All A1/A2 registration and A5 insert tests must run on rc.3; + # release pair. All Arrow registration and insert tests must run on this baseline; # no local-engine or skipEngineVersionCheck override is allowed in PR CI. if mvn $MAVEN_ARGS -pl chdb-arrow -am test \ -Djvm="$HOME_DIR/bin/java" \ @@ -232,7 +232,7 @@ jobs: -Dchdb.library.path="$LIBS" \ -DargLine=--add-opens=java.base/java.nio=ALL-UNNAMED \ -DfailIfNoTests=true; then - echo "Arrow Java $VERSION passed (see report for the separate core conversion regression)" + echo "Arrow Java $VERSION passed" else echo "::error::Arrow integration tests failed on Java $VERSION" failed="$failed $VERSION-arrow" diff --git a/.github/workflows/rc-release.yml b/.github/workflows/rc-release.yml index 47312b2..6779075 100644 --- a/.github/workflows/rc-release.yml +++ b/.github/workflows/rc-release.yml @@ -72,7 +72,7 @@ jobs: - name: Compile and run unit tests run: | # shellcheck disable=SC2086 - mvn $MAVEN_ARGS -pl chdb-jdbc -am test + mvn $MAVEN_ARGS -pl chdb-arrow -am test - name: Fetch the engine and build the native shim run: | @@ -81,11 +81,29 @@ jobs: *) scripts/build-native.sh '${{ matrix.platform }}' ;; esac + - name: Test Arrow against the staged release pair + run: | + set -eu + exec Status: Draft -> Updated: 2026-09-08 +> Updated: 2026-11-17 > Target repository: `chdb-io/chdb-java` ## 1. Project goal @@ -201,7 +201,8 @@ META-INF/sbom/ ### 4.3 Versioning rules -The binding is versioned on its own, in SemVer — `MAJOR.MINOR.PATCH`, first release `1.0.0`. +The binding is versioned on its own, in SemVer — `MAJOR.MINOR.PATCH`. The first stable +release is `1.1.0` by the release owner's 2026-11-17 decision; `1.0.0` GA is skipped. The number describes the Java API, which is the question a consumer asks it. The engine version is not in it. It is recorded in each native package's @@ -215,21 +216,22 @@ a break in the Java API could ship as a trailing `.2`. | Case | Version | |---|---| -| First release | `1.0.0` | -| Fix in the driver, loader or JNI shim | `1.0.1` | -| New engine baseline, no Java API change | `1.1.0` | +| First stable release | `1.1.0` | +| Fix in the driver, loader or JNI shim after it | `1.1.1` | +| Subsequent engine baseline with new capability | `1.2.0` | | Breaking change to the Java API | `2.0.0` | | First Maven RC / first test version | `1.0.0-rc.1` | Release rules: -- A published artifact is immutable. Never overwrite `1.0.0`; any fix ships as `1.0.1`. -- `chdb-jdbc`, the four platform packages and `chdb-bom` always carry the same version. +- A published artifact is immutable. Never overwrite `1.1.0`; any fix ships as `1.1.1`. +- `chdb-jdbc`, optional `chdb-arrow`, the four platform packages and `chdb-bom` always carry the same version. - An engine change is a `MINOR` bump when it changes what the driver can do and a `PATCH` when it does not. It is never invisible: the manifest and the release notes name the engine. - A binding built on an engine RC is an RC and cannot be V1 GA. - `-SNAPSHOT` is for development and never reaches Maven Central. -- **`-rc.` is the shared-repository pre-release qualifier.** The first test version is - `1.0.0-rc.1`, followed by `1.0.0-rc.2` and then the stable `1.0.0` release. +- **`-rc.` is the shared-repository pre-release qualifier.** `1.0.0-rc.1` and + `1.0.0-rc.2` were published as test versions; there will be no `1.0.0` GA. The next + stable release is `1.1.0`, after the V1 gates below are satisfied. To remove string-parsing ambiguity, every artifact manifest records these separately: @@ -523,7 +525,7 @@ Exit condition: a Java user who knows nothing about the implementation can insta - [ ] Freeze the public Java API and the JNI ABI. - [ ] Write the release notes and the known limitations. - [ ] Publish an RC and hold a soak and external validation window of at least one week. -- [ ] Once every V1 release gate passes, publish the first release, `1.0.0`, built on a stable engine. +- [ ] Once every V1 release gate passes, publish the first stable release, `1.1.0`, built on a stable engine. ## 6. Milestones diff --git a/README.md b/README.md index e3ea449..15b4e48 100644 --- a/README.md +++ b/README.md @@ -6,8 +6,9 @@ streaming, forward-only result sets over ClickHouse SQL. > **Status: release candidate.** The current Maven release candidate is `v1.0.0-rc.2`, built with > chDB Core `26.11.0-rc.2`. RC artifacts are available from the public chDB Maven repository; the -> public API is not frozen. This development branch targets core `26.11.0-rc.3` and adds an -> optional `chdb-arrow` module; those Java artifacts have not been published. See the +> public API is not frozen. This development branch targets stable core `26.11.1` and adds an +> optional `chdb-arrow` module for the planned `v1.1.0` stable release; those artifacts have not +> been published. See the > [Arrow Java getting-started guide](chdb-arrow/README.md#getting-started) for examples > and [What works today](#what-works-today) for the JDBC release status. @@ -26,7 +27,7 @@ try (Connection connection = DriverManager.getConnection("jdbc:chdb::memory:"); ## Support matrix The existing JDBC binding has built and passed its full suite on these four platforms and -Java 11, 17, 21 and 25 in CI. The new Arrow module is added to the PR matrix for rc.3, +Java 11, 17, 21 and 25 in CI. The new Arrow module is added to the PR matrix for `1.1.0`, but is not yet a published-platform claim: | | Linux glibc | macOS | @@ -43,13 +44,11 @@ but is not yet a published-platform claim: engine does. Each package records the figure it was built against in its `manifest.properties`, and CI runs the whole test suite on AlmaLinux 8 to demonstrate the floor rather than infer it from symbol versions. -- **Engine in this source branch:** chDB Core **26.11.0-rc.3**, pinned. Published Java +- **Engine in this source branch:** chDB Core **26.11.1**, pinned. Published Java `1.0.0-rc.2` still uses core `26.11.0-rc.2`. The C ABI is version-locked, so the driver refuses to run against a different engine build rather than risking a struct-layout mismatch. - That release is a chdb-core *pre-release*, pinned to validate the ClickHouse 26.11 baseline; - a binding on an engine RC is itself an RC and is not the V1 GA - ([work plan §4.3](CHDB_JAVA_V1_WORK_PLAN.md)), so the stable chdb-core release has to be - pinned before `1.0.0`. + This stable core meets the engine-release requirement for the planned Java `1.1.0`, but the + remaining Java release gates still apply ([work plan §4.3](CHDB_JAVA_V1_WORK_PLAN.md)). - **Not supported:** Windows, musl (Alpine), 32-bit, GraalVM Native Image, Android. ## Installing @@ -115,14 +114,14 @@ all-platforms package, on purpose: it would be the sum of those four. ### Versioning -SemVer, on the binding alone: `1.0.0` is the first release and a major bump means a breaking +SemVer, on the binding alone: `1.1.0` is the first stable release and a major bump means a breaking change to the Java API. The engine version is not part of it — it is in each package's `manifest.properties`, pinned in [`scripts/engine.properties`](scripts/engine.properties) and -named in the release notes (`26.11.0-rc.2` for the published Java RC, `26.11.0-rc.3` +named in the release notes (`26.11.0-rc.2` for the published Java RC, `26.11.1` in this development branch), and the driver refuses to load any other build. -The first test version is the RC `1.0.0-rc.1`; later candidates increment the final number, and -the first stable Maven release is `1.0.0`. RCs use the permanent `com.clickhouse.chdb` groupId, +The first test versions were `1.0.0-rc.1` and `1.0.0-rc.2`; `1.0.0` GA is intentionally skipped. +The first stable Maven release is planned as `1.1.0`. RCs use the permanent `com.clickhouse.chdb` groupId, so publishing stable releases to Maven Central will not change dependency coordinates. ## Connecting diff --git a/chdb-arrow/README.md b/chdb-arrow/README.md index ffe5ac4..604ff68 100644 --- a/chdb-arrow/README.md +++ b/chdb-arrow/README.md @@ -19,7 +19,7 @@ This module README is the Java binding's Arrow entry point. See the [core owners `chdb-arrow` is **not published yet**. The published Java `1.0.0-rc.2` and its native packages cannot run this branch's Arrow API. To try it now, build the -matching `1.0.0-rc.3-SNAPSHOT` Java and native artifacts from this checkout (see +matching `1.1.0-SNAPSHOT` Java and native artifacts from this checkout (see [Testing from source](#testing-from-source) below). Once a matching set of artifacts is available, a Maven consumer needs the optional Arrow module and **one** native package for its runtime platform, at the same binding version: @@ -29,13 +29,13 @@ artifacts is available, a Maven consumer needs the optional Arrow module and com.clickhouse.chdb chdb-arrow - 1.0.0-rc.3-SNAPSHOT + 1.1.0-SNAPSHOT com.clickhouse.chdb chdb-native-macos-aarch64 - 1.0.0-rc.3-SNAPSHOT + 1.1.0-SNAPSHOT ``` @@ -233,9 +233,9 @@ published Java `1.0.0-rc.2` platform JAR has JNI ABI 2 and cannot run this work- ABI 5 module. Arrow Java 19.0.0 on classpath also requires `--add-opens=java.base/java.nio=ALL-UNNAMED` on supported JDKs. -The current source pins chDB core `26.11.0-rc.3`. For a macOS arm64 release-asset +The current source pins stable chDB core `26.11.1`. For a macOS arm64 release-asset smoke test, compile the Java side (`mvn -pl chdb-jdbc -am compile`), then run -`scripts/build-native.sh macos-aarch64`. That script downloads the exact rc.3 asset, +`scripts/build-native.sh macos-aarch64`. That script downloads the exact v26.11.1 asset, verifies its SHA-256 and stages the engine plus JNI shim in `chdb-native-macos-aarch64/target/native/`. Run the opt-in test with the staged pair: @@ -257,8 +257,8 @@ Choose the corresponding native module if building on another supported platform, and run its `scripts/build-native.sh ` first. The earlier core `26.11.0-rc.2` omitted a `get_schema` release during registration: -a value-correct Java scan left 148 bytes in the Arrow allocator. The rc.3 release -includes that fix, so the Arrow input and insert tests run on this baseline. CI exercises the +a value-correct Java scan left 148 bytes in the Arrow allocator. The later rc.3 fix +is included in v26.11.1, so the Arrow input and insert tests run on this baseline. CI exercises the same suite on all four native platforms and Java 11/17/21/25 without a version override. No production deployment should use a local `--local-engine` package or `chdb.skipEngineVersionCheck`. diff --git a/chdb-arrow/pom.xml b/chdb-arrow/pom.xml index 9823009..e57d104 100644 --- a/chdb-arrow/pom.xml +++ b/chdb-arrow/pom.xml @@ -6,7 +6,7 @@ com.clickhouse.chdb chdb-java-parent - 1.0.0-rc.3-SNAPSHOT + 1.1.0-SNAPSHOT chdb-arrow chDB Arrow diff --git a/chdb-bom/pom.xml b/chdb-bom/pom.xml index 24f9dae..85c0886 100644 --- a/chdb-bom/pom.xml +++ b/chdb-bom/pom.xml @@ -7,7 +7,7 @@ com.clickhouse.chdb chdb-java-parent - 1.0.0-rc.3-SNAPSHOT + 1.1.0-SNAPSHOT chdb-bom diff --git a/chdb-examples/pom.xml b/chdb-examples/pom.xml index e6c2bd0..9b06743 100644 --- a/chdb-examples/pom.xml +++ b/chdb-examples/pom.xml @@ -7,7 +7,7 @@ com.clickhouse.chdb chdb-java-parent - 1.0.0-rc.3-SNAPSHOT + 1.1.0-SNAPSHOT chdb-examples diff --git a/chdb-integration-tests/pom.xml b/chdb-integration-tests/pom.xml index 99180e9..7ff20d7 100644 --- a/chdb-integration-tests/pom.xml +++ b/chdb-integration-tests/pom.xml @@ -7,7 +7,7 @@ com.clickhouse.chdb chdb-java-parent - 1.0.0-rc.3-SNAPSHOT + 1.1.0-SNAPSHOT chdb-integration-tests diff --git a/chdb-jdbc/pom.xml b/chdb-jdbc/pom.xml index 9240602..ed495ca 100644 --- a/chdb-jdbc/pom.xml +++ b/chdb-jdbc/pom.xml @@ -7,7 +7,7 @@ com.clickhouse.chdb chdb-java-parent - 1.0.0-rc.3-SNAPSHOT + 1.1.0-SNAPSHOT chdb-jdbc diff --git a/chdb-jdbc/src/main/java/org/chdb/internal/ChdbNative.java b/chdb-jdbc/src/main/java/org/chdb/internal/ChdbNative.java index c7ac815..97b0b9e 100644 --- a/chdb-jdbc/src/main/java/org/chdb/internal/ChdbNative.java +++ b/chdb-jdbc/src/main/java/org/chdb/internal/ChdbNative.java @@ -58,7 +58,7 @@ private ChdbNative() { /** ABI version the loaded shim was built with. */ public static native int jniAbiVersion(); - /** {@code chdb_version()} of the loaded libchdb, e.g. {@code "26.11.0-rc.3"}. */ + /** {@code chdb_version()} of the loaded libchdb, e.g. {@code "26.11.1"}. */ public static native String engineVersion(); /** Build provenance of the shim: git commit, compiler, engine headers it compiled against. */ @@ -180,7 +180,7 @@ public static native long insertArrowStreamWithOptions( * {@code chdb_classify_query_n}. Decides whether a statement has a result set to stream * without executing it, using the engine's own parser. * - *

Optional symbol: it landed in chdb-core v26.7.2-rc.2, so the pinned v26.11.0-rc.3 + *

Optional symbol: it landed in chdb-core v26.7.2-rc.2, so the pinned v26.11.1 * baseline has it, so it is resolved by {@code dlsym} rather than linked. It is present on * the baseline; the null path is what an older engine gets, and means the caller must fall * back to {@code StatementShape}'s own analysis. @@ -242,7 +242,7 @@ public static native long rowBinaryOpen( * every result destroyed first, and the engine cannot be used again in this process. * *

Optional symbol, like {@link #classifyQuery(long, byte[])}: it landed in chdb-core - * v26.7.2-rc.2, so the pinned v26.11.0-rc.3 baseline has it, and it is resolved by {@code + * v26.7.2-rc.2, so the pinned v26.11.1 baseline has it, and it is resolved by {@code * dlsym} rather than linked. Not having it is not a failure -- the threads it would join are * reaped by process exit either way. * diff --git a/chdb-jdbc/src/main/java/org/chdb/jdbc/ChdbStatement.java b/chdb-jdbc/src/main/java/org/chdb/jdbc/ChdbStatement.java index 843023c..19ac20f 100644 --- a/chdb-jdbc/src/main/java/org/chdb/jdbc/ChdbStatement.java +++ b/chdb-jdbc/src/main/java/org/chdb/jdbc/ChdbStatement.java @@ -365,7 +365,7 @@ private void checkDeadlineSurvivedTheOpen(String sql) throws SQLException { private StatementShape.Route route(String sql) throws SQLException { int[] analysis; try { - // Null when the engine predates chdb_classify_query_n, which the v26.11.0-rc.3 + // Null when the engine predates chdb_classify_query_n, which the v26.11.1 // baseline does not -- but a loader pointed at another libchdb still can, in which // case StatementShape falls back to its keyword scan. analysis = ChdbNative.classifyQuery(connection.handle(), Utf8.encode(sql)); diff --git a/chdb-jdbc/src/main/java/org/chdb/jdbc/StatementShape.java b/chdb-jdbc/src/main/java/org/chdb/jdbc/StatementShape.java index b09b32c..e8333df 100644 --- a/chdb-jdbc/src/main/java/org/chdb/jdbc/StatementShape.java +++ b/chdb-jdbc/src/main/java/org/chdb/jdbc/StatementShape.java @@ -29,7 +29,7 @@ *

    *
  1. {@code chdb_classify_query_n}, which parses the SQL with the engine's own parser and * settings and executes nothing. Available from engine v26.7.2-rc.2, so present on the - * pinned v26.11.0-rc.3 baseline and asked in practice. Authoritative about + * pinned v26.11.1 baseline and asked in practice. Authoritative about * whether there is a result set, but silent on which door delivers it: * {@code CHDB_QUERY_READ_ONLY} covers a {@code SELECT} and a {@code SHOW} alike, so it * cannot tell the two entry points apart. See {@link #route(int[], String)}. diff --git a/chdb-jdbc/src/test/java/org/chdb/jdbc/StatementShapeTest.java b/chdb-jdbc/src/test/java/org/chdb/jdbc/StatementShapeTest.java index 57923c4..34e8297 100644 --- a/chdb-jdbc/src/test/java/org/chdb/jdbc/StatementShapeTest.java +++ b/chdb-jdbc/src/test/java/org/chdb/jdbc/StatementShapeTest.java @@ -13,7 +13,7 @@ * an entry point that refuses it -- which is what issue #12 was -- so all three are covered in * both directions. * - *

    The pinned v26.11.0-rc.3 baseline does export chdb_classify_query_n, so the scan is no + *

    The pinned v26.11.1 baseline does export chdb_classify_query_n, so the scan is no * longer the only thing deciding. It is still what decides whether a result set is streamed or * materialized, because the classifier does not distinguish those, as well as * deciding both halves whenever the classifier is absent or refuses the text -- hence the cases diff --git a/chdb-jni/include/chdb.h b/chdb-jni/include/chdb.h index 2eba9e9..a12d326 100644 --- a/chdb-jni/include/chdb.h +++ b/chdb-jni/include/chdb.h @@ -12,11 +12,11 @@ extern "C" { #define CHDB_EXPORT __attribute__((visibility("default"))) -#define CHDB_VERSION "26.11.0-rc.3" +#define CHDB_VERSION "26.11.1" /** * Returns the version of the linked chDB library. - * @return Null-terminated version string, e.g. "26.7.2" + * @return Null-terminated version string, e.g. "26.11.1" */ CHDB_EXPORT const char * chdb_version(void); diff --git a/chdb-jni/src/chdb_jni.cpp b/chdb-jni/src/chdb_jni.cpp index bda16c5..290b723 100644 --- a/chdb-jni/src/chdb_jni.cpp +++ b/chdb-jni/src/chdb_jni.cpp @@ -1096,7 +1096,7 @@ Java_org_chdb_internal_ChdbNative_classifyQuery(JNIEnv * env, jclass, jlong conn { try { - // Optional symbol: present from v26.7.2-rc.2, so on the pinned v26.11.0-rc.3 baseline, + // Optional symbol: present from v26.7.2-rc.2, so on the pinned v26.11.1 baseline, // absent on anything older. Null tells the Java side to use its own statement-shape // heuristic rather than failing the query. const auto classify = optionalApi().classify_query_n; diff --git a/chdb-jni/src/chdb_optional_api.h b/chdb-jni/src/chdb_optional_api.h index fed0e1d..ac970e9 100644 --- a/chdb-jni/src/chdb_optional_api.h +++ b/chdb-jni/src/chdb_optional_api.h @@ -1,6 +1,6 @@ // chDB C API entry points the shim resolves at runtime rather than linking. // -// The baseline is chdb-core v26.11.0-rc.3 (work plan section 2.1). Both of these arrived in +// The baseline is chdb-core v26.11.1 (work plan section 2.1). Both of these arrived in // v26.7.2-rc.2 -- neither is in v26.7.0 or v26.7.1-rc.1, whose export lists and headers have // neither name -- and both are exported by the current baseline, checked in its release // library rather than in an export list: @@ -44,7 +44,7 @@ struct QueryAnalysisV1 uint32_t query_class; }; -// chdb_query_class values, as of v26.11.0-rc.3. Kept in sync with ChdbNative.classifyQuery's +// chdb_query_class values, as of v26.11.1. Kept in sync with ChdbNative.classifyQuery's // documented return contract. enum QueryClass : uint32_t { diff --git a/chdb-native-linux-aarch64-gnu/pom.xml b/chdb-native-linux-aarch64-gnu/pom.xml index 64331af..db3a655 100644 --- a/chdb-native-linux-aarch64-gnu/pom.xml +++ b/chdb-native-linux-aarch64-gnu/pom.xml @@ -7,7 +7,7 @@ com.clickhouse.chdb chdb-java-parent - 1.0.0-rc.3-SNAPSHOT + 1.1.0-SNAPSHOT chdb-native-linux-aarch64-gnu diff --git a/chdb-native-linux-x86_64-gnu/pom.xml b/chdb-native-linux-x86_64-gnu/pom.xml index 5dc19c2..8be1ffc 100644 --- a/chdb-native-linux-x86_64-gnu/pom.xml +++ b/chdb-native-linux-x86_64-gnu/pom.xml @@ -7,7 +7,7 @@ com.clickhouse.chdb chdb-java-parent - 1.0.0-rc.3-SNAPSHOT + 1.1.0-SNAPSHOT chdb-native-linux-x86_64-gnu diff --git a/chdb-native-macos-aarch64/pom.xml b/chdb-native-macos-aarch64/pom.xml index 7f0f76b..18931f3 100644 --- a/chdb-native-macos-aarch64/pom.xml +++ b/chdb-native-macos-aarch64/pom.xml @@ -7,7 +7,7 @@ com.clickhouse.chdb chdb-java-parent - 1.0.0-rc.3-SNAPSHOT + 1.1.0-SNAPSHOT chdb-native-macos-aarch64 diff --git a/chdb-native-macos-x86_64/pom.xml b/chdb-native-macos-x86_64/pom.xml index 8992452..1a2bbd3 100644 --- a/chdb-native-macos-x86_64/pom.xml +++ b/chdb-native-macos-x86_64/pom.xml @@ -7,7 +7,7 @@ com.clickhouse.chdb chdb-java-parent - 1.0.0-rc.3-SNAPSHOT + 1.1.0-SNAPSHOT chdb-native-macos-x86_64 diff --git a/docs/publishing.md b/docs/publishing.md index 60d06b8..268030b 100644 --- a/docs/publishing.md +++ b/docs/publishing.md @@ -11,7 +11,7 @@ ClickHouse Publisher Pro setup is ready. | | | |---|---| | POM metadata Central requires | **done** — ``, ``, ``, ``, `` | -| Sources and javadoc jars | **done** — real ones for `chdb-jdbc`, empty ones for the native packages | +| Sources and javadoc jars | **done** — real ones for `chdb-jdbc` and `chdb-arrow`, empty ones for the native packages | | GPG signing | **done and verified** — signs jar, sources, javadoc and pom | | Publishing plugin | **done** — `central-publishing-maven-plugin`, `autoPublish=false` | | Third-party licence inventory | **done** — generated from the engine, shipped in the package, drift-tested | @@ -40,7 +40,7 @@ scripts/build-native.sh macos-x86_64 # on an Intel Mac JAVA_HOME=/path/to/linux-jdk scripts/build-native-in-container.sh linux-x86_64-gnu JAVA_HOME=/path/to/linux-jdk scripts/build-native-in-container.sh linux-aarch64-gnu -mvn versions:set -DnewVersion=1.0.0 # a release, not the -SNAPSHOT in the POM +mvn versions:set -DnewVersion=1.1.0 # a release, not the -SNAPSHOT in the POM mvn -Prelease deploy ``` @@ -113,10 +113,11 @@ and the publishing plugin talks to Sonatype. What it adds: - `maven-gpg-plugin` at `verify`, with `--pinentry-mode loopback` so the passphrase can come from a CI secret rather than a terminal. -- `central-publishing-maven-plugin` with `autoPublish=false`. A release here is ~510 MB across - six artifacts and cannot be unpublished; a human confirming the bundle in the portal is worth +- `central-publishing-maven-plugin` with `autoPublish=false`. A release here spans seven + modules plus their parent POM and hundreds of megabytes; it cannot be unpublished. A human + confirming the bundle in the portal is worth the extra step, at least until several releases have gone out uneventfully. -- Sources and javadoc jars. `chdb-jdbc` produces real ones. The four native packages produce +- Sources and javadoc jars. `chdb-jdbc` and `chdb-arrow` produce real ones. The four native packages produce empty ones — Central requires both for every non-`pom` artifact, and a package whose whole content is two shared libraries has no Java to document. They are empty by construction rather than by accident: `maven-source-plugin` would emit nothing at all and the upload would @@ -182,9 +183,9 @@ not available — Sonatype's wording: > namespace. GitHub verification would give `io.github.`, which is a personal -coordinate and the wrong thing to publish an organisation's driver under. **DNS access to -`chdb.org` is therefore a hard prerequisite**, not a convenience, and it is worth confirming -who has it before anything else in this document is started. +coordinate and the wrong thing to publish an organisation's driver under. The remaining +requirement is publisher access to `com.clickhouse.chdb` in the ClickHouse Central workspace; +this document does not assume that access has already been granted. ## 4. Publishing limits — check before the first release @@ -252,7 +253,7 @@ Apache-2.0, `LICENSE` in the repository, declared in the POM. Nothing to do. ### The redistributed engine Each platform package ships a ~326 MB `libchdb.so` verbatim from a chdb-core release. It -statically links ClickHouse and **1081 third-party components** on v26.11.0-rc.3 +statically links ClickHouse and **1081 third-party components** on v26.11.1 and v26.11.0-rc.3 (1082 on v26.11.0-rc.1/rc.2; 968 through v26.7.3). That number, and the licence of each one, comes from the engine itself: @@ -298,6 +299,10 @@ The fifth, for v26.11.0-rc.3, has 1081 entries: `gdeflate` (Apache) is absent. No copyleft entry changed. Generated from the published macOS arm64 binary and checked against that binary by `LicenseInventoryIT`; the other three platform binaries are checked in CI. +The sixth, for stable v26.11.1, was regenerated from its macOS arm64 release binary and is +byte-identical to rc.3: 1081 entries and the same inventory SHA-256. The remaining three +platform binaries still need the Java release CI inventory check. + ### The one open question Reading the inventory rather than guessing at it: most components are permissive, and several diff --git a/docs/release-readiness.md b/docs/release-readiness.md index 9a1fce6..41724c8 100644 --- a/docs/release-readiness.md +++ b/docs/release-readiness.md @@ -5,7 +5,8 @@ part, and which parts need someone else's approval. Written as three separate tracks because they proceed independently and have different blockers: **signing and publishing** is mechanical and self-service, **the namespace** needs -DNS access, and **licences** need a person with authority to say yes. +access through the ClickHouse Central workspace, and **licences** need a person with authority +to say yes. `docs/publishing.md` is the reference — the release profile, the namespace claim, the publishing limits, the licence inventory — and is the only place any of those numbers live. @@ -17,20 +18,24 @@ restating. ## Running order +The release owner selected `v1.1.0` as the first stable Java version on 2026-11-17, +skipping `1.0.0` GA after the published `1.0.0-rc.1` and `rc.2` test versions. The +version decision does not waive any gate below. The development POMs remain +`1.1.0-SNAPSHOT` until step 8 cuts a separate release commit and tag. + The tracks below say *what* and *who*. This says *when*, because each step can invalidate the -next. Eight steps. Four of them need somebody outside this repository — 1 needs DNS access to -`chdb.org`, 2 may need Sonatype support, 5 needs chdb-io, and 6 needs two projects willing to -depend on us — so those are the ones to start asking about early. Steps 3, 4, 7 and 8 are -self-service. +next. Eight steps. Four of them need somebody outside this repository — 1 needs the ClickHouse +Central workspace admin, 2 may need Sonatype support, 5 needs chdb-io, and 6 needs two +projects willing to depend on us — so those are the ones to start asking about early. Steps +3, 4, 7 and 8 are self-service. -### 1. Claim the `org.chdb` namespace — needs DNS access to `chdb.org` +### 1. Confirm `com.clickhouse.chdb` publishing access — needs the ClickHouse Central workspace -Register at , start a namespace claim for `org.chdb`, and hand -the TXT record Sonatype names to whoever administers the `chdb.org` zone. Verified -automatically, no human review, no queue. §1.3 has the detail, including why there is no -fallback. +All POMs use `com.clickhouse.chdb`. The stable release must be published from the ClickHouse +Central workspace by an account with permission for that namespace, not under a personal +fallback coordinate. §1.3 has the detail. -**Done when:** `org.chdb` shows as verified in the portal. +**Done when:** the publisher can see and publish to `com.clickhouse.chdb` in that workspace. ### 2. Read the Usage Center, and ask for an exception if the numbers are tight @@ -155,7 +160,7 @@ seven rows as absent; they were built in #13 and this is the state after it. | Requirement | Status | |---|---| -| `sources` JAR | **done** — a real one for `chdb-jdbc`, empty by construction for the native packages | +| `sources` JAR | **done** — real ones for `chdb-jdbc` and `chdb-arrow`, empty by construction for the native packages | | `javadoc` JAR | **done**, same split | | GPG signature (`.asc`) per file | **done**, verified end to end with a disposable key | | `` in the POM | **done** | @@ -169,10 +174,10 @@ seven rows as absent; they were built in #13 and this is the state after it. | Proof the artifacts work when consumed from a repository | **done locally** — §1.5 | | Portal token in a CI secret | **not started** — running order step 3 | | A GPG key that is the project's rather than a laptop's | **not started** — §1.2 | -| `org.chdb` namespace | **not started**, and the one item with no workaround — §1.3 | +| `com.clickhouse.chdb` workspace permission | **not verified** — §1.3 | So the mechanics are finished and the remaining items in this track are two credentials and -one DNS record. `docs/publishing.md` §1 is the runbook for what the profile does. +the workspace publishing grant. `docs/publishing.md` §1 is the runbook for what the profile does. ### 1.2 The GPG key — self-service, but decide whose key it is @@ -200,30 +205,15 @@ part is the key itself and the four secrets in running-order step 3. Signing loc laptop for the first release is fine and is the faster path to finding out whether the rest works. -### 1.3 The namespace — needs DNS access, approved automatically - -`org.chdb` is **unclaimed**: Maven Central returns zero artifacts for it, and for `io.chdb`, -`com.chdb` and `io.github.chdb-io` as well. So there is no conflict to resolve, only a claim to -make. - -Verification is by DNS. `chdb.org` resolves (13.248.169.48), so whoever administers that zone -adds a TXT record Sonatype names during registration, Sonatype's checker sees it, and the -namespace is granted. No human review, no waiting on a queue. - -**There is no fallback, contrary to what an earlier version of this section said.** It offered -`io.github.chdb-io`, verified by creating a repository under the `chdb-io` GitHub org. That is -not available; Sonatype's wording, quoted in `docs/publishing.md` §3, is that only the GitHub -username used to sign up is supported, so `io.github.` cannot be registered -automatically. GitHub verification would grant `io.github.` — a personal -coordinate, and the wrong thing to publish an organisation's driver under. +### 1.3 The namespace — ClickHouse Central workspace -**So DNS access to `chdb.org` is a hard prerequisite**, not a convenience, and it is worth -confirming who has it before anything else in this document is started. `org.chdb` is also the -coordinate already in every POM, README and document; changing it later is a breaking change -for consumers. +The permanent coordinate in the POMs is `com.clickhouse.chdb`. The publisher must have a +ClickHouse Central workspace account and permission to upload to that namespace. A personal +`io.github.` coordinate is not a substitute: it would change every dependency users +write. See `docs/publishing.md` §3 for the token and workspace setup. -**Action:** register at , start the `org.chdb` namespace claim, -and hand the TXT record to whoever runs `chdb.org` DNS. +**Action:** ask the ClickHouse Central workspace admin to confirm publisher access for +`com.clickhouse.chdb`, then verify it in the portal before attempting the release upload. ### 1.4 Publishing limits — check the org's standing before the first release @@ -340,7 +330,7 @@ statically links the ClickHouse tree. contrib submodules by scanning their licence files and found seven LGPL and eight GPL. That method has since been replaced by querying the binary we actually ship — `SELECT DISTINCT library_name, license_type FROM system.licenses`, which ClickHouse generates -at build time — and the answer is 1081 components on v26.11.0-rc.3, 1082 on +at build time — and the answer is 1081 components on v26.11.1 and v26.11.0-rc.3, 1082 on v26.11.0-rc.1/rc.2 (968 through v26.7.3), of which eleven carry a copyleft licence with no permissive alternative, in two families rather than one. A filename scan calls every @@ -379,7 +369,7 @@ the inventory as a gap and estimated half a day for it; it is done, and |---|---|---| | Apache-2.0 on our own code | already done | no | | Generating and publishing a GPG key | any maintainer | no | -| `org.chdb` namespace claim | whoever runs `chdb.org` DNS | automatic once the TXT record is up | +| `com.clickhouse.chdb` publishing grant | ClickHouse Central workspace admin | required | | Shipping the engine's licence inventory | already done | no | | **Whether redistributing `libchdb.so` under Apache-2.0 discharges the obligations of the eleven copyleft components** | **chdb-io / ClickHouse legal** | **yes, and it is the only real gate in this track** | | Whether chDB counts as "commercial nature" for Central | whoever owns the Sonatype relationship | yes | diff --git a/docs/v1-progress.md b/docs/v1-progress.md index a35b2be..5cc4804 100644 --- a/docs/v1-progress.md +++ b/docs/v1-progress.md @@ -15,8 +15,8 @@ green. The baseline subsequently moved to **engine 26.7.2-rc.2** (issue #8), **26.7.3**, **26.11.0-rc.1** and **26.11.0-rc.2**. This development branch now targets -**26.11.0-rc.3** for Arrow registration fixes. The sixteen-way result above describes -26.7.0; rc.3 still needs the four-platform CI matrix before making that claim. +**26.11.1**, the stable release after the Arrow registration fixes. The sixteen-way result +above describes 26.7.0; the new baseline needs its own four-platform CI matrix. 26.7.3 is a **stable** chdb-core release, which cleared the [work plan §4.3 ](../CHDB_JAVA_V1_WORK_PLAN.md) bar that 26.7.2-rc.2 could not: a binding built on an engine @@ -28,17 +28,17 @@ chdb-core #221 — `scripts/run-signal-window-test.sh measure` reports zero on i 26.11.0-rc.1 is a chdb-core **pre-release** again, pinned to validate the ClickHouse 26.11 baseline ahead of the stable v26.11.1, so the same §4.3 rule applies to it: only `-rc.` versions can be cut while it is the baseline, and the stable release has to be pinned before -`1.0.0`. The signal-handler fix holds on it — `measure` reports zero and `stress` survives 6 of +the first Java GA. The signal-handler fix holds on it — `measure` reports zero and `stress` survives 6 of 6 on Linux x86_64. 26.11.0-rc.2 is the same baseline plus chdb-core #312, a pre-release too, so nothing about §4.3 changes: `1.0.0-rc.2` is cut from it, `1.0.0-rc.1` stays on 26.7.3, and v26.11.1 -has to be pinned before `1.0.0`. The signal-handler fix holds on it too: `measure` reports +has to be pinned before the first stable Java version (now planned as `1.1.0`). The signal-handler fix holds on it too: `measure` reports zero and `stress` survives 6 of 6 on Linux x86_64. 26.11.0-rc.3 includes chdb-core #323's Arrow registration-schema and failed array-wrapper -cleanup fixes. The optional `chdb-arrow` module is under development against this published -core RC; local macOS arm64 tests do not substitute for its four-platform CI run. +cleanup fixes. Stable v26.11.1 includes them. The optional `chdb-arrow` module is being +prepared for the next Java RC; local macOS arm64 tests do not substitute for its four-platform CI run. --- @@ -51,7 +51,7 @@ core RC; local macOS arm64 tests do not substitute for its four-platform CI run. | ✅ | Four glibc/macOS platforms | `Platform`, with musl detected and refused | | ✅ | Direct JNI is the mainline, ADBC the experiment | no Arrow Java dependency anywhere | | ✅ | Engine release, dynamic-library checksum and symbol set pinned | `scripts/engine.properties`, SHA-256 per platform from the GitHub release digests | -| 🟡 | Consistency check across `chdb_version()`, tag and header version | all three agreed on v26.11.0-rc.2. The rc.3 macOS arm64 release tarball header is now vendored and reports `26.11.0-rc.3`; runtime and the other platforms need CI confirmation. The `26.5.1-rc.3` constant blamed on upstream turned out to be ours: the vendored header had been copied from chdb-core's source tree instead of its release tarball — [findings §2](upstream-findings.md). Still enforced against `engine.properties` rather than the header | +| 🟡 | Consistency check across `chdb_version()`, tag and header version | The v26.11.1 macOS arm64 release tarball header is now vendored byte-for-byte and reports `26.11.1`; its runtime agrees. The other platforms need CI confirmation. The `26.5.1-rc.3` constant blamed on upstream turned out to be ours: the vendored header had been copied from chdb-core's source tree instead of its release tarball — [findings §2](upstream-findings.md). Still enforced against `engine.properties` rather than the header | | ✅ | C API split into required and optional symbols | 18 required, linker- and load-checked; `chdb_classify_query_n` and `chdb_shutdown` optional via `dlsym`, and present on the current baseline | | ⬜ | C ABI version and compatibility promise confirmed with Core | needs upstream agreement | | ✅ | Signal-handler requirement raised upstream | reproduced, measured and written up in [findings §1](upstream-findings.md), filed as chdb-core #221, and fixed by chdb-core #224 in engine v26.7.3 — the shim's guard now reports no handler to repair, and `run-signal-window-test.sh measure` reports zero | diff --git a/licenses/engine-third-party-26.11.1.tsv b/licenses/engine-third-party-26.11.1.tsv new file mode 100644 index 0000000..9dcad01 --- /dev/null +++ b/licenses/engine-third-party-26.11.1.tsv @@ -0,0 +1,1081 @@ +abseil-cpp Apache +addr2line Apache-2.0 OR MIT +adler2 0BSD OR MIT OR Apache-2.0 +aead MIT OR Apache-2.0 +aes MIT OR Apache-2.0 +aes-gcm Apache-2.0 OR MIT +ahash MIT OR Apache-2.0 +aho-corasick Unlicense OR MIT +ai-sdk-cpp Apache +alloc-no-stdlib BSD-3-Clause +alloc-stdlib BSD-3-Clause +alloca MIT +allocator-api2 MIT OR Apache-2.0 +alp Apache-2.0 +ambient-authority Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +AMQP-CPP Apache +android_system_properties MIT OR Apache-2.0 +android_system_properties MIT/Apache-2.0 +anes MIT OR Apache-2.0 +anstream MIT OR Apache-2.0 +anstyle MIT OR Apache-2.0 +anstyle-parse MIT OR Apache-2.0 +anstyle-query MIT OR Apache-2.0 +anstyle-wincon MIT OR Apache-2.0 +antlr4-cpp-runtime BSD 2-clause +anyhow MIT OR Apache-2.0 +approx Apache-2.0 +ar_archive_writer Apache-2.0 WITH LLVM-exception +arbitrary MIT OR Apache-2.0 +arboard MIT OR Apache-2.0 +arbtest MIT OR Apache-2.0 +arc-swap MIT OR Apache-2.0 +arcref MIT +ariadne MIT +arrayref BSD-2-Clause +arrayvec MIT OR Apache-2.0 +arrow Apache +arrow Apache-2.0 +arrow-arith Apache-2.0 +arrow-array Apache-2.0 +arrow-array Apache-2.0 AND MIT +arrow-buffer Apache-2.0 +arrow-cast Apache-2.0 +arrow-csv Apache-2.0 +arrow-data Apache-2.0 +arrow-ipc Apache-2.0 +arrow-json Apache-2.0 +arrow-ord Apache-2.0 +arrow-row Apache-2.0 +arrow-schema Apache-2.0 +arrow-select Apache-2.0 +arrow-string Apache-2.0 +ascii Apache-2.0 OR MIT +async-channel Apache-2.0 OR MIT +async-executor Apache-2.0 OR MIT +async-fs Apache-2.0 OR MIT +async-io Apache-2.0 OR MIT +async-lock Apache-2.0 OR MIT +async-net Apache-2.0 OR MIT +async-process Apache-2.0 OR MIT +async-signal Apache-2.0 OR MIT +async-stream MIT +async-stream-impl MIT +async-task Apache-2.0 OR MIT +async-trait MIT OR Apache-2.0 +atoi MIT +atomic-waker Apache-2.0 OR MIT +autocfg Apache-2.0 OR MIT +avro Apache +aws Apache +aws-c-auth Apache +aws-c-cal Apache +aws-c-common Apache +aws-c-compression Apache +aws-c-event-stream Apache +aws-c-http Apache +aws-c-io Apache +aws-c-mqtt Apache +aws-c-s3 Apache +aws-c-sdkutils Apache +aws-checksums Apache +aws-crt-cpp Apache +aws-lc-rs ISC AND (Apache-2.0 OR ISC) +aws-lc-sys ISC AND (Apache-2.0 OR ISC) AND Apache-2.0 AND MIT AND BSD-3-Clause AND (Apache-2.0 OR ISC OR MIT) AND (Apache-2.0 OR ISC OR MIT-0) +aws-lc-sys ISC AND (Apache-2.0 OR ISC) AND OpenSSL +axum MIT +axum-core MIT +azure MIT +backtrace MIT OR Apache-2.0 +base64 MIT OR Apache-2.0 +base64ct Apache-2.0 OR MIT +bech32 MIT +beef MIT OR Apache-2.0 +better_io Apache-2.0 +bincode MIT +bindgen BSD-3-Clause +bit-set Apache-2.0 OR MIT +bit-vec Apache-2.0 OR MIT +bitflags MIT OR Apache-2.0 +bitflags MIT/Apache-2.0 +bitvec MIT +blake3 CC0-1.0 OR Apache-2.0 OR Apache-2.0 WITH LLVM-exception +block-buffer MIT OR Apache-2.0 +block-padding MIT OR Apache-2.0 +blocking Apache-2.0 OR MIT +boost Boost +brotli BSD-3-Clause AND MIT +brotli MIT +brotli-decompressor BSD-3-Clause/MIT +bs-thread-pool MIT +bstr MIT OR Apache-2.0 +bumpalo MIT OR Apache-2.0 +by_address MIT OR Apache-2.0 +bytemuck Zlib OR Apache-2.0 OR MIT +byteorder Unlicense OR MIT +bytes MIT +bytesize Apache-2.0 +bzip2 MIT/Apache-2.0 +bzip2 bzip2 +bzip2-sys MIT/Apache-2.0 +c-ares MIT +camino MIT OR Apache-2.0 +cap-fs-ext Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +cap-net-ext Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +cap-primitives Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +cap-std Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +cap-time-ext Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +capnproto MIT +capstone MIT +capstone-sys MIT +cargo-platform MIT OR Apache-2.0 +cargo_metadata MIT +cast MIT OR Apache-2.0 +castaway MIT +cbc MIT OR Apache-2.0 +cbindgen MPL-2.0 +cc MIT OR Apache-2.0 +cccl Apache +cctz Apache +cexpr Apache-2.0/MIT +cfg-if MIT OR Apache-2.0 +cfg-if MIT/Apache-2.0 +cfg_aliases MIT +chacha20 MIT OR Apache-2.0 +chdig MIT +chrono MIT OR Apache-2.0 +chrono-tz MIT OR Apache-2.0 +chrono-tz-build MIT OR Apache-2.0 +chumsky MIT +chunked_transfer MIT OR Apache-2.0 +ciborium Apache-2.0 +ciborium-io Apache-2.0 +ciborium-ll Apache-2.0 +cipher MIT OR Apache-2.0 +cityhash-rs MIT OR Apache-2.0 +cityhash102 MIT +clang-sys Apache-2.0 +clap MIT OR Apache-2.0 +clap_builder MIT OR Apache-2.0 +clap_complete MIT OR Apache-2.0 +clap_derive MIT OR Apache-2.0 +clap_lex MIT OR Apache-2.0 +cld2 Apache +clickhouse MIT OR Apache-2.0 +clickhouse-derive MIT OR Apache-2.0 +clickhouse-rs-1.1.0 MIT +clickhouse-rs-cityhash-sys MIT +clickstack MIT +clipboard-win BSL-1.0 +cmake MIT OR Apache-2.0 +cobs MIT OR Apache-2.0 +codespan-reporting Apache-2.0 +colorchoice MIT OR Apache-2.0 +combine MIT +comfy-table MIT +compact_str MIT +concurrent-queue Apache-2.0 OR MIT +console-api MIT +console-subscriber MIT +const-random MIT OR Apache-2.0 +const-random-macro MIT OR Apache-2.0 +const_for MIT +constant_time_eq CC0-1.0 +constant_time_eq CC0-1.0 OR MIT-0 OR Apache-2.0 +convert_case MIT +core-foundation MIT OR Apache-2.0 +core-foundation-sys MIT OR Apache-2.0 +corrosion MIT +cpp_demangle MIT OR Apache-2.0 +cppkafka BSD 2-clause +cpufeatures MIT OR Apache-2.0 +crc MIT OR Apache-2.0 +crc-catalog MIT OR Apache-2.0 +crc32-s390x Apache +crc32-vpmsum Apache +crc32c BSD 3-clause +crc32fast MIT OR Apache-2.0 +criterion Apache-2.0 OR MIT +criterion-plot Apache-2.0 OR MIT +criterion-plot MIT/Apache-2.0 +critical-section MIT OR Apache-2.0 +croaring Apache +crossbeam MIT OR Apache-2.0 +crossbeam-channel MIT OR Apache-2.0 +crossbeam-deque MIT OR Apache-2.0 +crossbeam-epoch MIT OR Apache-2.0 +crossbeam-queue MIT OR Apache-2.0 +crossbeam-utils MIT OR Apache-2.0 +crossterm MIT +crossterm_winapi MIT +crunchy MIT +crypto-common MIT OR Apache-2.0 +csv Unlicense/MIT +csv-core Unlicense/MIT +ctr MIT OR Apache-2.0 +cty MIT OR Apache-2.0 +cucascade Apache +cuCollections Apache +cudf Apache +custom-labels Apache-2.0 +cxx MIT OR Apache-2.0 +cxx-build MIT OR Apache-2.0 +cxxbridge-cmd MIT OR Apache-2.0 +cxxbridge-flags MIT OR Apache-2.0 +cxxbridge-macro MIT OR Apache-2.0 +cyrus-sasl BSD 2-clause +darling MIT +darling_core MIT +darling_macro MIT +darts-clone BSD +dashmap MIT +datasketches-cpp Apache +datatest-stable MIT OR Apache-2.0 +debugid Apache-2.0 +defer-drop MPL-2.0 +defmt MIT OR Apache-2.0 +defmt-macros MIT OR Apache-2.0 +defmt-parser MIT OR Apache-2.0 +delta-kernel-rs Apache +der Apache-2.0 OR MIT +deranged MIT OR Apache-2.0 +derive_arbitrary MIT/Apache-2.0 +derive_builder MIT OR Apache-2.0 +derive_builder_core MIT OR Apache-2.0 +derive_builder_macro MIT OR Apache-2.0 +derive_more MIT +derive_more-impl MIT +des MIT OR Apache-2.0 +dhat MIT OR Apache-2.0 +diff MIT OR Apache-2.0 +digest MIT OR Apache-2.0 +directories-next MIT OR Apache-2.0 +dirs-next MIT OR Apache-2.0 +dirs-sys-next MIT OR Apache-2.0 +dispatch2 Zlib OR Apache-2.0 OR MIT +displaydoc MIT OR Apache-2.0 +dlmalloc MIT/Apache-2.0 +dlpack Apache +dmlc-core Apache +dns-lookup MIT/Apache-2.0 +document-features MIT OR Apache-2.0 +double-conversion BSD 3-clause +driftsort Apache +dtype_dispatch Apache-2.0 +dunce CC0-1.0 OR MIT-0 OR Apache-2.0 +dyn-clone MIT OR Apache-2.0 +easy-smt MIT OR Apache-2.0 +egg MIT +either MIT OR Apache-2.0 +embedded-io MIT OR Apache-2.0 +encoding_rs (Apache-2.0 OR MIT) AND BSD-3-Clause +enum-as-inner MIT/Apache-2.0 +enum-iterator 0BSD +enum-iterator-derive 0BSD +env_filter MIT OR Apache-2.0 +env_home MIT OR Apache-2.0 +env_logger MIT OR Apache-2.0 +equivalent Apache-2.0 OR MIT +errno MIT OR Apache-2.0 +error-code BSL-1.0 +escape8259 MIT +event-listener Apache-2.0 OR MIT +event-listener-strategy Apache-2.0 OR MIT +ext-trait Zlib OR MIT OR Apache-2.0 +ext-trait-proc_macros Zlib OR MIT OR Apache-2.0 +extension-traits Zlib OR MIT OR Apache-2.0 +fallible-iterator MIT/Apache-2.0 +fancy-regex MIT +fast_float MIT +fastlanes Apache-2.0 +fastops MIT +fastrand Apache-2.0 OR MIT +fd-lock MIT OR Apache-2.0 +file-per-thread-logger Apache-2.0 WITH LLVM-exception +filecheck Apache-2.0 WITH LLVM-exception +filedescriptor MIT +filetime MIT/Apache-2.0 +find-msvc-tools MIT OR Apache-2.0 +fixedbitset MIT/Apache-2.0 +flagset Apache-2.0 +flamelens MIT +flatbuffers Apache +flatbuffers Apache-2.0 +flate2 MIT OR Apache-2.0 +flexi_logger MIT OR Apache-2.0 +fmtlib MIT +fnv Apache-2.0 / MIT +foldhash Zlib +foreign-types MIT/Apache-2.0 +foreign-types-shared MIT/Apache-2.0 +form_urlencoded MIT OR Apache-2.0 +fortanix-sgx-abi MPL-2.0 +FP16 MIT +fs-set-times Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +fs_extra MIT +fslock MIT +fsst-rs Apache-2.0 +funty MIT +futures MIT OR Apache-2.0 +futures-channel MIT OR Apache-2.0 +futures-core MIT OR Apache-2.0 +futures-executor MIT OR Apache-2.0 +futures-io MIT OR Apache-2.0 +futures-lite Apache-2.0 OR MIT +futures-macro MIT OR Apache-2.0 +futures-sink MIT OR Apache-2.0 +futures-task MIT OR Apache-2.0 +futures-timer MIT/Apache-2.0 +futures-util MIT OR Apache-2.0 +fuzzy-matcher MIT +fxprof-processed-profile MIT OR Apache-2.0 +g2gen MIT/Apache-2.0 +g2p MIT/Apache-2.0 +g2poly MIT/Apache-2.0 +gdbstub MIT OR Apache-2.0 +gdbstub_arch MIT OR Apache-2.0 +generic-array MIT +gethostname Apache-2.0 +getopts MIT OR Apache-2.0 +getrandom MIT OR Apache-2.0 +ghash Apache-2.0 OR MIT +gimli MIT OR Apache-2.0 +glob MIT OR Apache-2.0 +google-benchmark Apache +google-cloud-cpp Apache +google-protobuf BSD 3-clause +googletest BSD 3-clause +grpc Apache +gzip-header MIT/Apache-2.0 +h2 MIT +h3 Apache +half MIT OR Apache-2.0 +hashbrown MIT OR Apache-2.0 +hdfs-native Apache-2.0 +hdfs-native-object-store Apache-2.0 +hdrhistogram MIT/Apache-2.0 +heck MIT OR Apache-2.0 +heks MIT +hermit-abi MIT OR Apache-2.0 +hex MIT OR Apache-2.0 +hive-metastore Apache +hmac MIT OR Apache-2.0 +home MIT OR Apache-2.0 +hostname MIT +http MIT OR Apache-2.0 +http-body MIT +http-body-util MIT +httparse MIT OR Apache-2.0 +httpdate MIT OR Apache-2.0 +httpdate MIT/Apache-2.0 +humansize MIT/Apache-2.0 +humantime MIT OR Apache-2.0 +humantime MIT/Apache-2.0 +hyper MIT +hyper-rustls Apache-2.0 OR ISC OR MIT +hyper-timeout MIT OR Apache-2.0 +hyper-tls MIT/Apache-2.0 +hyper-util MIT +iana-time-zone MIT OR Apache-2.0 +iana-time-zone-haiku MIT OR Apache-2.0 +icu Public Domain +icu_collections Unicode-3.0 +icu_locale_core Unicode-3.0 +icu_locid Unicode-3.0 +icu_locid_transform Unicode-3.0 +icu_locid_transform_data Unicode-3.0 +icu_normalizer Unicode-3.0 +icu_normalizer_data Unicode-3.0 +icu_properties Unicode-3.0 +icu_properties_data Unicode-3.0 +icu_provider Unicode-3.0 +icu_provider_macros Unicode-3.0 +icudata Public Domain +id-arena MIT/Apache-2.0 +ident_case MIT/Apache-2.0 +idna MIT +idna MIT OR Apache-2.0 +idna_adapter Apache-2.0 OR MIT +indexmap Apache-2.0 OR MIT +indoc MIT OR Apache-2.0 +inout MIT OR Apache-2.0 +instability MIT +instant BSD-3-Clause +integer-encoding MIT +inventory MIT OR Apache-2.0 +io-extras Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +io-lifetimes Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +io-uring MIT OR Apache-2.0 +ipcrypt2 ISC +ipnet MIT OR Apache-2.0 +ipnsort Apache +is-terminal MIT +is_terminal_polyfill MIT OR Apache-2.0 +isa-l BSD 3-clause +itertools MIT OR Apache-2.0 +itertools MIT/Apache-2.0 +itoa MIT OR Apache-2.0 +ittapi GPL-2.0-only OR BSD-3-Clause +ittapi-sys GPL-2.0-only OR BSD-3-Clause +jemalloc BSD 2-clause +Jieba-CPP MIT +jiff Unlicense OR MIT +jiff-core Unlicense OR MIT +jiff-static Unlicense OR MIT +jiff-tzdb Unlicense OR MIT +jiff-tzdb-platform Unlicense OR MIT +jni MIT OR Apache-2.0 +jni-macros MIT OR Apache-2.0 +jni-sys MIT OR Apache-2.0 +jni-sys-macros MIT OR Apache-2.0 +jobserver MIT OR Apache-2.0 +js-sys MIT OR Apache-2.0 +json-from-wast Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +jwt-cpp MIT +kanal MIT +kasuari MIT OR Apache-2.0 +krb5 BSD +kvikio Apache +lasso MIT OR Apache-2.0 +lazy_static MIT OR Apache-2.0 +lazy_static MIT/Apache-2.0 +lazycell MIT/Apache-2.0 +leb128 Apache-2.0/MIT +leb128fmt MIT OR Apache-2.0 +lemmagen-c LGPL +lending-iterator Zlib OR MIT OR Apache-2.0 +lending-iterator-proc_macros Zlib OR MIT OR Apache-2.0 +lexical-core MIT/Apache-2.0 +lexical-parse-float MIT/Apache-2.0 +lexical-parse-integer MIT/Apache-2.0 +lexical-util MIT/Apache-2.0 +lexical-write-float MIT/Apache-2.0 +lexical-write-integer MIT/Apache-2.0 +libarchive Apache +libbcrypt Public Domain +libc MIT OR Apache-2.0 +libcotp Apache +libcpuid BSD 2-clause +libdeflate MIT +libdivide Boost +libfarmhash MIT +libfiu Public Domain +libfuzzer-sys (MIT OR Apache-2.0) AND NCSA +libgsasl LGPL +libhdfs3 Apache +libloading ISC +libm MIT +libmetrohash Apache +libpqxx BSD 3-clause +libprotobuf-mutator Apache +librdkafka Apache +libredox MIT +librseq BSD +librtcx Apache +libssh LGPL +libstemmer_c BSD 3-clause +libtest-mimic MIT/Apache-2.0 +libucontext ISC +liburing MIT +libuv BSD +libxml2 MIT +line-clipping MIT OR Apache-2.0 +link-cplusplus MIT OR Apache-2.0 +linux-raw-sys Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +listenfd Apache-2.0 +litemap Unicode-3.0 +litrs MIT OR Apache-2.0 +llvm-project Apache +lock_api MIT OR Apache-2.0 +log MIT OR Apache-2.0 +logos MIT OR Apache-2.0 +logos-codegen MIT OR Apache-2.0 +logos-derive MIT OR Apache-2.0 +lru MIT +lru-slab MIT OR Apache-2.0 OR Zlib +lz4 BSD +lz4 MIT +lz4-sys-1.11.1+lz4 MIT +lz4_flex MIT +mach2 BSD-2-Clause OR MIT OR Apache-2.0 +macro-string MIT OR Apache-2.0 +macro_rules_attribute MIT +macro_rules_attribute-proc_macro MIT +magic_enum MIT +managed 0BSD +mapbox-geometry ISC +mariadb-connector-c LGPL +match_cfg MIT/Apache-2.0 +matchers MIT +matchit MIT AND BSD-3-Clause +matrixmultiply MIT/Apache-2.0 +maybe-owned MIT OR Apache-2.0 +md-5 MIT OR Apache-2.0 +MeCab BSD +memchr Unlicense OR MIT +memfd MIT OR Apache-2.0 +memmap2 MIT OR Apache-2.0 +memmap2 MIT/Apache-2.0 +mime MIT OR Apache-2.0 +minimal-lexical MIT/Apache-2.0 +miniselect Boost +miniz_oxide MIT OR Zlib OR Apache-2.0 +minizip-ng zLib +mintex Apache-2.0 +mio MIT +moka (MIT OR Apache-2.0) AND Apache-2.0 +mongo-c-driver Apache +mongo-cxx-driver Apache +morton-nd MIT +moto-rt MIT OR Apache-2.0 +msgpack-c Boost +murmurhash Public Domain +musl Public Domain +mutatis MIT OR Apache-2.0 +mutatis-derive MIT OR Apache-2.0 +nanoarrow Apache +native-tls MIT OR Apache-2.0 +nats-io Apache +ndarray MIT OR Apache-2.0 +never-say-never Zlib OR MIT OR Apache-2.0 +nix MIT +nlohmann-json MIT +nom MIT +nougat Zlib OR MIT OR Apache-2.0 +nougat-proc_macros Zlib OR MIT OR Apache-2.0 +nu-ansi-term MIT +num-bigint MIT OR Apache-2.0 +num-complex MIT OR Apache-2.0 +num-conv MIT OR Apache-2.0 +num-integer MIT OR Apache-2.0 +num-traits MIT OR Apache-2.0 +num_cpus MIT OR Apache-2.0 +num_enum BSD-3-Clause OR MIT OR Apache-2.0 +num_enum_derive BSD-3-Clause OR MIT OR Apache-2.0 +num_threads MIT OR Apache-2.0 +NuRaft Apache +nvtx Apache +objc2 MIT +objc2-app-kit Zlib OR Apache-2.0 OR MIT +objc2-core-foundation Zlib OR Apache-2.0 OR MIT +objc2-core-graphics Zlib OR Apache-2.0 OR MIT +objc2-encode MIT +objc2-foundation MIT +objc2-io-surface Zlib OR Apache-2.0 OR MIT +object Apache-2.0 OR MIT +object_store MIT/Apache-2.0 +ocaml-boxroot-sys MIT +ocaml-interop MIT +ocaml-sys ISC +once_cell MIT OR Apache-2.0 +once_cell_polyfill MIT OR Apache-2.0 +oneshot MIT OR Apache-2.0 +onig MIT +onig_sys MIT +onpair Apache-2.0 +oorandom MIT +opaque-debug MIT OR Apache-2.0 +openldap OpenLDAP Version 2.8 +openssl Apache +openssl Apache-2.0 +openssl-macros MIT/Apache-2.0 +openssl-probe MIT OR Apache-2.0 +openssl-probe MIT/Apache-2.0 +openssl-sys MIT +openvino Apache-2.0 +openvino-finder Apache-2.0 +openvino-sys Apache-2.0 +optimized-routines Apache +ordered-float MIT +ort-2.0.0 MIT OR Apache-2.0 +ort-sys-2.0.0 MIT OR Apache-2.0 +page_size MIT/Apache-2.0 +palette MIT OR Apache-2.0 +palette_derive MIT OR Apache-2.0 +palette_math MIT OR Apache-2.0 +parking Apache-2.0 OR MIT +parking_lot MIT OR Apache-2.0 +parking_lot_core MIT OR Apache-2.0 +parquet Apache-2.0 +parquet-testing Apache +parse-zoneinfo MIT +password-hash MIT OR Apache-2.0 +paste MIT OR Apache-2.0 +pastey MIT OR Apache-2.0 +pbkdf2 MIT OR Apache-2.0 +pco Apache-2.0 +pcodec Apache +pdqsort zLib +pem-rfc7468 Apache-2.0 OR MIT +percent-encoding MIT OR Apache-2.0 +perfetto_protos Apache-2.0 +petgraph MIT OR Apache-2.0 +phf MIT +phf_codegen MIT +phf_generator MIT +phf_shared MIT +pin-project Apache-2.0 OR MIT +pin-project-internal Apache-2.0 OR MIT +pin-project-lite Apache-2.0 OR MIT +pin-utils MIT OR Apache-2.0 +piper MIT OR Apache-2.0 +pkg-config MIT OR Apache-2.0 +plain MIT/Apache-2.0 +plotters MIT +plotters-backend MIT +plotters-svg MIT +pocketfft BSD 3-clause +poco Boost +polling Apache-2.0 OR MIT +polonius-the-crab Zlib OR MIT OR Apache-2.0 +polyglot-sql MIT +polyval Apache-2.0 OR MIT +portable-atomic Apache-2.0 OR MIT +portable-atomic-util Apache-2.0 OR MIT +postcard MIT OR Apache-2.0 +postgres PostgreSQL +potential_utf Unicode-3.0 +powerfmt MIT OR Apache-2.0 +ppv-lite86 MIT OR Apache-2.0 +ppv-lite86 MIT/Apache-2.0 +pretty_assertions MIT OR Apache-2.0 +prettyplease MIT OR Apache-2.0 +proc-macro-crate MIT OR Apache-2.0 +proc-macro2 MIT OR Apache-2.0 +prometheus-protobufs Apache +prometheus-protobufs-gogo BSD 3-clause +proptest MIT OR Apache-2.0 +prost Apache-2.0 +prost-derive Apache-2.0 +prost-types Apache-2.0 +protobuf MIT +protobuf-codegen MIT +protobuf-parse MIT +protobuf-support MIT +protoc-bin-vendored MIT +protoc-bin-vendored-linux-aarch_64 MIT +protoc-bin-vendored-linux-ppcle_64 MIT +protoc-bin-vendored-linux-s390_64 MIT +protoc-bin-vendored-linux-x86_32 MIT +protoc-bin-vendored-linux-x86_64 MIT +protoc-bin-vendored-macos-aarch_64 MIT +protoc-bin-vendored-macos-x86_64 MIT +protoc-bin-vendored-win32 MIT +prqlc Apache-2.0 +prqlc-parser Apache-2.0 +psm MIT OR Apache-2.0 +pulldown-cmark MIT +pybind11 BSD 3-clause +pybind11-upstream BSD 3-clause +quick-error MIT/Apache-2.0 +quick-xml MIT +quinn MIT OR Apache-2.0 +quinn-proto MIT OR Apache-2.0 +quinn-udp MIT OR Apache-2.0 +quote MIT OR Apache-2.0 +r-efi MIT OR Apache-2.0 OR LGPL-2.1-or-later +r-efi-alloc MIT OR Apache-2.0 OR LGPL-2.1-or-later +radium MIT +rand MIT OR Apache-2.0 +rand_chacha MIT OR Apache-2.0 +rand_core MIT OR Apache-2.0 +rand_xorshift MIT OR Apache-2.0 +rand_xoshiro MIT OR Apache-2.0 +rapidjson BSD +rapids-logger Apache +ratatui MIT +ratatui-core MIT +ratatui-crossterm MIT +ratatui-widgets MIT +raw-cpuid MIT +rawpointer MIT/Apache-2.0 +rayon MIT OR Apache-2.0 +rayon-core MIT OR Apache-2.0 +re2 BSD 3-clause +recursive MIT +recursive-proc-macro-impl MIT +redox_syscall MIT +redox_users MIT +ref-cast MIT OR Apache-2.0 +ref-cast-impl MIT OR Apache-2.0 +regalloc2 Apache-2.0 WITH LLVM-exception +regex MIT OR Apache-2.0 +regex-automata MIT OR Apache-2.0 +regex-syntax MIT OR Apache-2.0 +region MIT +relative-path MIT OR Apache-2.0 +replace_with MIT OR Apache-2.0 +replxx BSD 3-clause +reqwest MIT OR Apache-2.0 +ring Apache-2.0 AND ISC +rmm Apache +roaring MIT OR Apache-2.0 +rocksdb BSD 3-clause +roxmltree MIT OR Apache-2.0 +rstest MIT OR Apache-2.0 +rstest_macros MIT OR Apache-2.0 +rstest_reuse MIT OR Apache-2.0 +rustc-demangle MIT/Apache-2.0 +rustc-hash Apache-2.0 OR MIT +rustc-hash Apache-2.0/MIT +rustc-literal-escaper Apache-2.0 OR MIT +rustc_version MIT OR Apache-2.0 +rustix Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +rustix-linux-procfs Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +rustls Apache-2.0 OR ISC OR MIT +rustls-native-certs Apache-2.0 OR ISC OR MIT +rustls-pemfile Apache-2.0 OR ISC OR MIT +rustls-pki-types MIT OR Apache-2.0 +rustls-platform-verifier MIT OR Apache-2.0 +rustls-platform-verifier-android MIT OR Apache-2.0 +rustls-webpki ISC +rustversion MIT OR Apache-2.0 +rusty-fork MIT/Apache-2.0 +ryu Apache-2.0 OR BSL-1.0 +s2geometry Apache +safetensors Apache-2.0 +same-file Unlicense/MIT +schannel MIT +schemars MIT +schemars_derive MIT +scopeguard MIT OR Apache-2.0 +scratch MIT OR Apache-2.0 +sealed MIT OR Apache-2.0 +security-framework MIT OR Apache-2.0 +security-framework-sys MIT OR Apache-2.0 +semver MIT OR Apache-2.0 +seq-macro MIT OR Apache-2.0 +serde MIT OR Apache-2.0 +serde_bytes MIT OR Apache-2.0 +serde_core MIT OR Apache-2.0 +serde_derive MIT OR Apache-2.0 +serde_derive_internals MIT OR Apache-2.0 +serde_json MIT OR Apache-2.0 +serde_spanned MIT OR Apache-2.0 +serde_urlencoded MIT/Apache-2.0 +serde_yaml MIT OR Apache-2.0 +sha1 MIT OR Apache-2.0 +sha2 MIT OR Apache-2.0 +SHA3IUF MIT +sharded-slab MIT +shell-quote Apache-2.0 +shlex MIT OR Apache-2.0 +shuffling-allocator MPL-2.0 +signal-hook Apache-2.0/MIT +signal-hook-mio MIT OR Apache-2.0 +signal-hook-registry Apache-2.0/MIT +signal-hook-registry MIT OR Apache-2.0 +silk Apache +simd-adler32 MIT +simd_cesu8 Apache-2.0 OR MIT +simdcomp BSD 3-clause +simdjson MIT +simdutf MIT +simdutf8 MIT OR Apache-2.0 +similar Apache-2.0 +SimSIMD Apache +siphasher MIT OR Apache-2.0 +siphasher MIT/Apache-2.0 +size MIT +sketches-ddsketch Apache-2.0 +skim MIT +skim-common MIT +skim-tuikit MIT +slab MIT +smallvec MIT OR Apache-2.0 +smallvec-2.0.0 MIT OR Apache-2.0 +smol Apache-2.0 OR MIT +snap BSD-3-Clause +snappy BSD 3-clause +socket2 MIT OR Apache-2.0 +socks MIT/Apache-2.0 +souper-ir MIT OR Apache-2.0 +sparsehash-c11 BSD 3-clause +spdlog MIT +spin MIT +spmc MIT OR Apache-2.0 +sqids-cpp MIT +sql-console Apache +sqlformat MIT OR Apache-2.0 +sqlite-amalgamation BSD 3-clause +sqlparser Apache-2.0 +stable_deref_trait MIT OR Apache-2.0 +stable_deref_trait MIT/Apache-2.0 +stacker MIT OR Apache-2.0 +static_assertions MIT OR Apache-2.0 +strfmt MIT +string-interner MIT/Apache-2.0 +StringZilla Apache +strsim MIT +strum MIT +strum_macros MIT +substrait Apache +subtle BSD-3-Clause +symbolic_expressions MIT/Apache-2.0 +syn MIT OR Apache-2.0 +sync_wrapper Apache-2.0 +synstructure MIT +syntect MIT +system-configuration MIT OR Apache-2.0 +system-configuration-sys MIT OR Apache-2.0 +system-interface Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +sz3 BSD +tagptr MIT/Apache-2.0 +tap MIT +tar MIT OR Apache-2.0 +target-lexicon Apache-2.0 WITH LLVM-exception +target-triple MIT OR Apache-2.0 +tch MIT/Apache-2.0 +tempfile MIT OR Apache-2.0 +term MIT OR Apache-2.0 +term MIT/Apache-2.0 +termcolor Unlicense OR MIT +terminal_size MIT OR Apache-2.0 +termtree MIT +test-case MIT +test-case-core MIT +test-case-macros MIT +test-log Apache-2.0 OR MIT +test-log-core Apache-2.0 OR MIT +test-log-macros Apache-2.0 OR MIT +thiserror MIT OR Apache-2.0 +thiserror-impl MIT OR Apache-2.0 +thousands MIT/Apache-2.0 +thread_local Apache-2.0/MIT +thread_local MIT OR Apache-2.0 +thrift Apache +thrift Apache-2.0 +time MIT OR Apache-2.0 +time-core MIT OR Apache-2.0 +time-macros MIT OR Apache-2.0 +timer MPL-2.0 +tiny-keccak CC0-1.0 +tiny_http MIT OR Apache-2.0 +tinystr Unicode-3.0 +tinytemplate Apache-2.0 OR MIT +tinyvec Zlib OR Apache-2.0 OR MIT +tinyvec_macros MIT OR Apache-2.0 OR Zlib +tokio MIT +tokio-macros MIT +tokio-native-tls MIT +tokio-openssl MIT/Apache-2.0 +tokio-rustls MIT OR Apache-2.0 +tokio-stream MIT +tokio-util MIT +toml MIT OR Apache-2.0 +toml-0.9.12+spec MIT OR Apache-2.0 +toml-1.1.2+spec MIT OR Apache-2.0 +toml_datetime MIT OR Apache-2.0 +toml_datetime-0.7.5+spec MIT OR Apache-2.0 +toml_datetime-1.1.1+spec MIT OR Apache-2.0 +toml_edit-0.25.11+spec MIT OR Apache-2.0 +toml_parser MIT OR Apache-2.0 +toml_parser-1.1.2+spec MIT OR Apache-2.0 +toml_writer MIT OR Apache-2.0 +toml_writer-1.1.1+spec MIT OR Apache-2.0 +tonic MIT +tonic-prost MIT +torch-sys MIT/Apache-2.0 +tower MIT +tower-http MIT +tower-layer MIT +tower-service MIT +tracing MIT +tracing-attributes MIT +tracing-core MIT +tracing-log MIT +tracing-serde MIT +tracing-subscriber MIT +try-lock MIT +trybuild MIT OR Apache-2.0 +tui-input MIT +twox-hash MIT +typenum MIT OR Apache-2.0 +unarray MIT OR Apache-2.0 +unicase MIT OR Apache-2.0 +unicode-ident (MIT OR Apache-2.0) AND Unicode-3.0 +unicode-segmentation MIT OR Apache-2.0 +unicode-segmentation MIT/Apache-2.0 +unicode-truncate MIT OR Apache-2.0 +unicode-width MIT OR Apache-2.0 +unicode-width MIT/Apache-2.0 +unicode-xid MIT OR Apache-2.0 +unicode_categories MIT OR Apache-2.0 +universal-hash MIT OR Apache-2.0 +unsafe-libyaml MIT +untrusted ISC +unwinding MIT OR Apache-2.0 +ureq MIT OR Apache-2.0 +ureq-proto MIT OR Apache-2.0 +url MIT OR Apache-2.0 +usearch Apache +utf-8 MIT OR Apache-2.0 +utf16_iter Apache-2.0 OR MIT +utf8-zero MIT OR Apache-2.0 +utf8_iter Apache-2.0 OR MIT +utf8parse Apache-2.0 OR MIT +utf8proc MIT +uuid Apache-2.0 OR MIT +v8 MIT +valuable MIT +vcpkg MIT/Apache-2.0 +vectorscan Boost +vergen MIT OR Apache-2.0 +vergen-gitcl MIT OR Apache-2.0 +vergen-lib MIT OR Apache-2.0 +version_check MIT/Apache-2.0 +vex-sdk MIT +vortex Apache-2.0 +vortex-alp Apache-2.0 +vortex-array Apache-2.0 +vortex-array-macros Apache-2.0 +vortex-arrow Apache-2.0 +vortex-btrblocks Apache-2.0 +vortex-buffer Apache-2.0 +vortex-bytebool Apache-2.0 +vortex-compressor Apache-2.0 +vortex-compute Apache-2.0 +vortex-datetime-parts Apache-2.0 +vortex-decimal-byte-parts Apache-2.0 +vortex-edition Apache-2.0 +vortex-error Apache-2.0 +vortex-fastlanes Apache-2.0 +vortex-file Apache-2.0 +vortex-flatbuffers Apache-2.0 +vortex-fsst Apache-2.0 +vortex-io Apache-2.0 +vortex-ipc Apache-2.0 +vortex-layout Apache-2.0 +vortex-mask Apache-2.0 +vortex-metrics Apache-2.0 +vortex-onpair Apache-2.0 +vortex-pco Apache-2.0 +vortex-proto Apache-2.0 +vortex-runend Apache-2.0 +vortex-scan Apache-2.0 +vortex-sequence Apache-2.0 +vortex-session Apache-2.0 +vortex-sparse Apache-2.0 +vortex-utils Apache-2.0 +vortex-zigzag Apache-2.0 +vortex-zstd Apache-2.0 +vte Apache-2.0 OR MIT +wagyu Boost +wait-timeout MIT/Apache-2.0 +waker-fn Apache-2.0 OR MIT +walkdir Unlicense/MIT +want MIT +wasi-0.11.0+wasi-snapshot Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +wasi-0.11.1+wasi-snapshot Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +wasi-0.13.3+wasi Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +wasi-0.14.2+wasi Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +wasi-0.14.4+wasi Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +wasi-nn Apache-2.0 +wasip1 Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +wasip2-1.0.0+wasi Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +wasip2-1.0.3+wasi Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +wasip2-1.0.4+wasi Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +wasip3-0.4.0+wasi-0.3.0-rc-2026-01 Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +wasite Apache-2.0 OR BSL-1.0 OR MIT +wasm-bindgen MIT OR Apache-2.0 +wasm-bindgen-backend MIT OR Apache-2.0 +wasm-bindgen-futures MIT OR Apache-2.0 +wasm-bindgen-macro MIT OR Apache-2.0 +wasm-bindgen-macro-support MIT OR Apache-2.0 +wasm-bindgen-shared MIT OR Apache-2.0 +wasm-compose Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +wasm-encoder Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +wasm-metadata Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +wasm-mutate Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +wasm-smith Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +wasm-streams MIT OR Apache-2.0 +wasm-wave Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +wasmi MIT/Apache-2.0 +wasmi_collections MIT/Apache-2.0 +wasmi_core MIT/Apache-2.0 +wasmi_ir MIT/Apache-2.0 +wasmparser Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +wasmprinter Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +wasmtime Apache +wast Apache-2.0 WITH LLVM-exception +wast Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +wat Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +web-sys MIT OR Apache-2.0 +web-time MIT OR Apache-2.0 +webpki-root-certs CDLA-Permissive-2.0 +webpki-roots CDLA-Permissive-2.0 +webpki-roots MPL-2.0 +which MIT +whoami Apache-2.0 OR BSL-1.0 OR MIT +winapi MIT/Apache-2.0 +winapi-i686-pc-windows-gnu MIT/Apache-2.0 +winapi-util Unlicense OR MIT +winapi-util Unlicense/MIT +winapi-x86_64-pc-windows-gnu MIT/Apache-2.0 +windows MIT OR Apache-2.0 +windows-core MIT OR Apache-2.0 +windows-implement MIT OR Apache-2.0 +windows-interface MIT OR Apache-2.0 +windows-link MIT OR Apache-2.0 +windows-registry MIT OR Apache-2.0 +windows-result MIT OR Apache-2.0 +windows-strings MIT OR Apache-2.0 +windows-sys MIT OR Apache-2.0 +windows-targets MIT OR Apache-2.0 +windows_aarch64_gnullvm MIT OR Apache-2.0 +windows_aarch64_msvc MIT OR Apache-2.0 +windows_i686_gnu MIT OR Apache-2.0 +windows_i686_gnullvm MIT OR Apache-2.0 +windows_i686_msvc MIT OR Apache-2.0 +windows_x86_64_gnu MIT OR Apache-2.0 +windows_x86_64_gnullvm MIT OR Apache-2.0 +windows_x86_64_msvc MIT OR Apache-2.0 +winnow MIT +winsafe MIT +winx Apache-2.0 WITH LLVM-exception +wit-bindgen Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +wit-bindgen-core Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +wit-bindgen-rt Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +wit-bindgen-rust Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +wit-bindgen-rust-macro Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +wit-component Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +wit-parser Apache-2.0 WITH LLVM-exception OR Apache-2.0 OR MIT +witx Apache-2.0 +write16 Apache-2.0 OR MIT +writeable Unicode-3.0 +wstd Apache-2.0 WITH LLVM-exception +wstd-macro Apache-2.0 WITH LLVM-exception +wyhash Public Domain +wyz MIT +x11rb MIT OR Apache-2.0 +x11rb-protocol MIT OR Apache-2.0 +xattr MIT OR Apache-2.0 +xdg Apache-2.0 OR MIT +xgboost Apache +xsimd BSD 3-clause +xxHash BSD +xz LGPL +yaml-cpp MIT +yansi MIT OR Apache-2.0 +yoke Unicode-3.0 +yoke-derive Unicode-3.0 +z85 MIT/Apache-2.0 +zerocopy BSD-2-Clause OR Apache-2.0 OR MIT +zerocopy-derive BSD-2-Clause OR Apache-2.0 OR MIT +zerofrom Unicode-3.0 +zerofrom-derive Unicode-3.0 +zeroize Apache-2.0 OR MIT +zerotrie Unicode-3.0 +zerovec Unicode-3.0 +zerovec-derive Unicode-3.0 +zigzag MIT +zip MIT +zlib-ng zLib +zlib-rs Zlib +zmij MIT +zstd BSD +zstd MIT +zstd-safe MIT OR Apache-2.0 +zstd-safe MIT/Apache-2.0 +zstd-sys MIT/Apache-2.0 +zxc BSD diff --git a/pom.xml b/pom.xml index aa8ec56..323eaa6 100644 --- a/pom.xml +++ b/pom.xml @@ -6,7 +6,7 @@ com.clickhouse.chdb chdb-java-parent - 1.0.0-rc.3-SNAPSHOT + 1.1.0-SNAPSHOT pom chDB Java Binding (parent) @@ -65,7 +65,7 @@ mirrors them for the shell/CMake side. Changing engine.version requires a new Maven version (work plan section 4.3) and a full platform re-test. --> - 26.11.0-rc.3 + 26.11.1 1 5 @@ -218,8 +218,9 @@ central false diff --git a/scripts/engine.properties b/scripts/engine.properties index 1110ebc..8f18e05 100644 --- a/scripts/engine.properties +++ b/scripts/engine.properties @@ -6,20 +6,17 @@ # keep this file in sync with in the root pom.xml. # # Checksums are the release asset digests published by GitHub for the tag below -# (gh api repos/chdb-io/chdb-core/releases/tags/v26.11.0-rc.3 --jq '.assets[].digest'), and +# (gh api repos/chdb-io/chdb-core/releases/tags/v26.11.1 --jq '.assets[].digest'), and # the release's SHA256SUMS asset agrees with them. # # engine.version is what chdb_version() returns from the shared library, not the tag with # its 'v' stripped and not the version in the wheel file names. The loader compares the two -# and refuses a mismatch. The macOS arm64 rc.3 tarball's header reports -# CHDB_VERSION "26.11.0-rc.3"; the runtime version and other three platforms must also -# pass the real-JAR matrix before a release claim. Do not infer it from a wheel filename. +# and refuses a mismatch. The vendored header must come from a v26.11.1 release +# tarball; the runtime version and all four platforms must pass the real-JAR matrix. # -# v26.11.0-rc.3 is a chdb-core PRE-RELEASE (published 2026-11-12), based on commit -# 574f212fb5ee0eca9dec68a92f890eaf9941c262 which includes #323's Arrow -# registration-schema and failed array-registration cleanup fixes. A Java binding -# pinned to this core RC is itself an RC candidate, not 1.0.0 GA. The previous -# 1.0.0-rc.2 binding and v26.11.0-rc.2 core remain separate releases. +# v26.11.1 is a stable chdb-core release (published 2026-11-16), tag commit +# bc9c42e6edf4f394884a6a0458aa49abff85f1b6. It follows the rc.3 Arrow fixes. +# The previous published Java 1.0.0-rc.2 remains pinned to v26.11.0-rc.2. # # chdb-core #224, the fix for the signal-handler window reported as chdb-core #221 and # tracked here as issue #14, arrived in v26.7.3: scripts/run-signal-window-test.sh measure @@ -30,12 +27,12 @@ # over ~1.08M samples a run, and stress 6 survived 6 of 6 with 0 killed. # Re-run on v26.11.0-rc.2, on linux-x86_64: measure 3 reported hostHandlersAtSigDfl=0/0/0 # over ~1.11-1.25M samples a run, and stress 6 survived 6 of 6 with 0 killed. -# v26.11.0-rc.3 must be retested in the four-platform CI before release. +# v26.11.1 must be retested in the four-platform CI before a Java release. -engine.version=26.11.0-rc.3 -engine.tag=v26.11.0-rc.3 +engine.version=26.11.1 +engine.tag=v26.11.1 engine.repo=chdb-io/chdb-core -engine.asset.base=https://github.com/chdb-io/chdb-core/releases/download/v26.11.0-rc.3 +engine.asset.base=https://github.com/chdb-io/chdb-core/releases/download/v26.11.1 # platform id -> release asset name asset.macos-aarch64=macos-arm64-libchdb.tar.gz @@ -44,10 +41,10 @@ asset.linux-x86_64-gnu=linux-x86_64-libchdb.tar.gz asset.linux-aarch64-gnu=linux-aarch64-libchdb.tar.gz # platform id -> SHA-256 of the release asset -sha256.macos-aarch64=7b0ea049efcf75a851e744c7d74325d7a9b143227f9b72097e5df252564e3d58 -sha256.macos-x86_64=f3be47d0e2d2bef19c65ed6f9837fc5d38888995d4e1fe1750dbb08a64e12cc9 -sha256.linux-x86_64-gnu=51ebb27abf2d7579941932b6ddbda23c1d25b8108be30142c9d99882f60a7ec6 -sha256.linux-aarch64-gnu=a7c1024125f3696b99395c568dcc9f226edf41061f35bcc55cceb348179adcf8 +sha256.macos-aarch64=c0a4df14c10369ce86b5e58f6b9cfade30b155cea6908cc7556c2a73ef18cd08 +sha256.macos-x86_64=ace512c37c673075b59b551574d3c77edf159a8bf2d1b9d829ef0721a9ececd8 +sha256.linux-x86_64-gnu=210f34d85596f8580176bee4c58b688e05d9389d87eb51f4ff94ae08294c65a7 +sha256.linux-aarch64-gnu=86a618b092036ceca5f41b2bfdb6b38253ab2d704a1dd577a3cbb351a0256698 # platform id -> the libchdb file name inside the extracted tarball / the name we ship libname.macos-aarch64=libchdb.so @@ -59,10 +56,10 @@ libname.linux-aarch64-gnu=libchdb.so # # Must not exceed what the engine supports, or the package refuses to load for users in # between. These are the versions chdb-core's own release wheels declare -# (chdb_core-26.11.0-cp39-abi3-macosx_11_0_arm64.whl and ...-macosx_10_15_x86_64.whl), and +# (chdb_core-26.11.1-cp39-abi3-macosx_11_0_arm64.whl and ...-macosx_10_15_x86_64.whl), and # build-native.sh fails the build if the shim ends up above the engine's. # -# These targets were measured against v26.11.0-rc.2. Build-native.sh checks the rc.3 +# These targets were measured against earlier 26.11 builds. Build-native.sh checks the v26.11.1 # assets on their respective CI runners and refuses a shim whose minimum exceeds its engine. # # Left unset, the target follows the build machine's SDK: an unpinned build on a macOS 26 @@ -81,7 +78,7 @@ deployment.target.macos-x86_64=10.15 # below it is out of support: RHEL 7 (2.17) ended June 2024 and Amazon Linux 2 (2.26) June # 2026. Everything above it is already covered. # -# The last v26.11.0-rc.2 measurements had room under this ceiling. The rc.3 +# The last v26.11.0-rc.2 measurements had room under this ceiling. The v26.11.1 # engine and newly linked shim are remeasured by build-native.sh in Linux CI. # # What this cannot check from a macOS host is the *shim's* floor, which is the thing the diff --git a/scripts/verify-consumer.sh b/scripts/verify-consumer.sh index a0c41cb..81edcfe 100755 --- a/scripts/verify-consumer.sh +++ b/scripts/verify-consumer.sh @@ -167,7 +167,7 @@ step "Deploying to a throwaway file:// repository" ( cd "$ROOT" mvn "${MVN_FLAGS[@]}" deploy \ - -pl ".,chdb-bom,chdb-jdbc,${MODULE}" \ + -pl ".,chdb-bom,chdb-jdbc,chdb-arrow,${MODULE}" \ -DskipTests \ -Dmaven.install.skip=true \ -DaltDeploymentRepository="chdb-verify::file://${REPO}" @@ -179,12 +179,13 @@ for coord in \ "com/clickhouse/chdb/chdb-java-parent/${VERSION}" \ "com/clickhouse/chdb/chdb-bom/${VERSION}" \ "com/clickhouse/chdb/chdb-jdbc/${VERSION}" \ + "com/clickhouse/chdb/chdb-arrow/${VERSION}" \ "com/clickhouse/chdb/${MODULE}/${VERSION}"; do [ -d "${REPO}/${coord}" ] || die "nothing published at ${coord}" # A JAR with no POM resolves for a direct dependency and then quietly brings in nothing. compgen -G "${REPO}/${coord}/*.pom" > /dev/null || die "no POM published at ${coord}" done -ok "parent, BOM, driver and ${MODULE} are in the repository, each with a POM" +ok "parent, BOM, driver, Arrow and ${MODULE} are in the repository, each with a POM" case "$VERSION" in *-SNAPSHOT) @@ -229,34 +230,13 @@ cat > "${CONSUMER}/pom.xml" <true truealways - + central - file://${WORK}/there-is-no-such-repository - false + https://repo.maven.apache.org/maven2 + true false @@ -288,6 +268,18 @@ cat > "${CONSUMER}/pom.xml" <${MODULE} + + + + arrow + + + com.clickhouse.chdb + chdb-arrow + + + + EOF @@ -302,6 +294,10 @@ EOF CP="$(cat "${WORK}/cp.txt")" ok "resolved with no version declared, so the imported BOM supplied it" +case "$CP" in + *"/com/clickhouse/chdb/chdb-arrow/"*.jar*) + die "the platform-only graph unexpectedly contains chdb-arrow; it cannot prove the native POM brings JDBC" ;; +esac # The point of the whole exercise: these bytes came out of a repository. # Split on the classpath separator rather than piping into a loop: a `die` inside a pipeline @@ -325,7 +321,7 @@ done # # Maven writes _remote.repositories beside each downloaded file, recording the repository that # served it. Anything other than chdb-verify means this run did not test what it claims to: -# most likely the `central` block above stopped being disabled, or a * in +# most likely Central served a chDB coordinate, or a * in # the caller's settings.xml intercepted the file repository. Both are reasons to stop rather # than to report a pass. # @@ -340,31 +336,33 @@ sha1_of_string() { else printf '%s' "$1" | shasum -a 1 | cut -d' ' -f1; fi } REPO_KEY_HURL="chdb-verify-$(sha1_of_string "file://${REPO}")" -PROVENANCE_LINES=0 -while IFS= read -r record; do - while IFS= read -r line; do - case "$line" in - \#*|"") continue ;; - esac - PROVENANCE_LINES=$((PROVENANCE_LINES + 1)) - case "$line" in - *">chdb-verify="*) ;; - *">${REPO_KEY_HURL}="*) ;; - *) - die "a com.clickhouse.chdb artifact was served by a repository other than the throwaway one: +verify_chdb_provenance() { + local provenance_lines=0 record line + while IFS= read -r record; do + while IFS= read -r line; do + case "$line" in + \#*|"") continue ;; + esac + provenance_lines=$((provenance_lines + 1)) + case "$line" in + *">chdb-verify="*|*">${REPO_KEY_HURL}="*) ;; + *) + die "a com.clickhouse.chdb artifact was served by a repository other than the throwaway one: ${record} ${line} Only 'chdb-verify' (or, on Maven 3.10+, '${REPO_KEY_HURL}') proves the artifact under test is the one this run deployed. If a mirror in your settings.xml claims '*', run this with -s pointing at a settings file that does not." - ;; - esac - done < "$record" -done < <(find "${CONSUMER_M2}/com/clickhouse/chdb" -name '_remote.repositories' -type f) -[ "$PROVENANCE_LINES" -gt 0 ] \ - || die "no _remote.repositories entries under ${CONSUMER_M2}/com/clickhouse/chdb: nothing was actually + ;; + esac + done < "$record" + done < <(find "${CONSUMER_M2}/com/clickhouse/chdb" -name '_remote.repositories' -type f) + [ "$provenance_lines" -gt 0 ] \ + || die "no _remote.repositories entries under ${CONSUMER_M2}/com/clickhouse/chdb: nothing was actually downloaded, so this run proved nothing about resolving from a repository." -ok "all ${PROVENANCE_LINES} downloaded com.clickhouse.chdb files came from the throwaway repository, not from Central" + ok "all ${provenance_lines} downloaded com.clickhouse.chdb files came from the throwaway repository, not from Central" +} +verify_chdb_provenance # Located by its repository path rather than by a file name, and this matters more than it # looks. A snapshot exists under two names at once: the remote repository holds # chdb-jdbc-26.7.2-rc.2.1-20260909.081309-1.jar, and Maven's local repository ends up with @@ -513,6 +511,54 @@ ${WRONG_OUT}" ok "names chdb-native-${OTHER_PLATFORM}, and says which package is on the classpath instead" printf '%s\n' "$WRONG_OUT" | grep -A6 'No chDB native runtime' | sed 's/^/ | /' +# ---------------------------------------------------------------- 5. the separate Arrow dependency graph + +step "Resolving Arrow as an optional dependency" +( + cd "$CONSUMER" + mvn "${MVN_FLAGS[@]}" -Dmaven.repo.local="$CONSUMER_M2" -Parrow \ + dependency:build-classpath -Dmdep.outputFile="${WORK}/cp-arrow.txt" +) > "${WORK}/resolve-arrow.log" 2>&1 \ + || { tail -40 "${WORK}/resolve-arrow.log"; die "the Arrow consumer could not resolve its dependencies"; } +ARROW_CP="$(cat "${WORK}/cp-arrow.txt")" +case "$ARROW_CP" in + *"/com/clickhouse/chdb/chdb-arrow/"*.jar*) ;; + *) die "chdb-arrow is not on the optional consumer classpath from the file repository" ;; +esac +verify_chdb_provenance + +cat > "${CONSUMER}/src/ArrowConsumer.java" <<'EOF' +import org.apache.arrow.memory.RootAllocator; +import org.apache.arrow.vector.BigIntVector; +import org.chdb.arrow.ArrowQuery; +import org.chdb.arrow.ArrowSession; + +public final class ArrowConsumer { + public static void main(String[] args) throws Exception { + try (RootAllocator allocator = new RootAllocator(); + ArrowSession session = ArrowSession.openInMemory(); + ArrowQuery query = session.queryArrow("SELECT toInt64(42) AS id", allocator)) { + if (!query.loadNextBatch()) { + throw new IllegalStateException("No Arrow batch"); + } + long id = ((BigIntVector) query.getVectorSchemaRoot().getVector("id")).get(0); + if (id != 42 || query.loadNextBatch()) { + throw new IllegalStateException("Wrong Arrow result: " + id); + } + System.out.println("arrow=" + id); + } + } +} +EOF +"$JAVAC" -cp "$ARROW_CP" -d "${CONSUMER}/classes" "${CONSUMER}/src/ArrowConsumer.java" +step "Reading Arrow from the JAR in the local repository" +ARROW_OUT="$("$JAVA" --add-opens=java.base/java.nio=ALL-UNNAMED \ + -cp "${ARROW_CP}:${CONSUMER}/classes" -Dchdb.cache.dir="$CACHE" ArrowConsumer 2>&1)" \ + || die "the consumer could not read Arrow: ${ARROW_OUT}" +printf '%s\n' "$ARROW_OUT" | grep -q 'arrow=42' \ + || die "the Arrow consumer returned the wrong result: ${ARROW_OUT}" +ok "Arrow reader returned 42 from the packaged JNI/engine pair" + printf '\n\033[1mAll consumer checks passed for %s at %s.\033[0m\n' "$PLATFORM" "$VERSION" printf 'Not covered here: whether a %s MB artifact survives a real upload and download.\n' \ "$(( $(wc -c < "$NATIVE_JAR") / 1024 / 1024 ))"