Skip to content

v0.1.0

Latest

Choose a tag to compare

@Xuanwo Xuanwo released this 19 Nov 21:16
· 1 commit to main since this release
562eb87

lance-go v0.1.0 is the first stable release of the pure-Go Lance SDK. It reads, writes and searches Lance datasets from Go with CGO_ENABLED=0, using the official prebuilt lance-c shared library.

Native bundle

  • lance-c v0.2.0: annotated tag object 84a7d564a961a6de6d68e6fef206e91d9363ab0a, peeled commit facb369c9fa98b7a3e5ce2ed12e2d8be090627ce, canonical LF header SHA-256 947a912a14cb53f97237dbc7c03e5c09ef4337d46b459edc600d4d3c2c888d5c.
  • Built against Lance v15.0.0-beta.25 (f5dbd55dd79f1f0412f897ed1917128300fb8c1a).
  • 890 lance_* exports; all 607 Go bindings verify against the header.

Five data-only companion modules are published at v0.1.0:

Target Payload SHA-256 Library SHA-256
linux/amd64 8a6af22b6604a2525a04416ddd76441bd020a8cba0a2c3e50ad7fce003ce1b7f 4617c425e7e7660ef6d0d77f2e14dba48359400d78261b0072cd46e48e87e2ac
linux/arm64 e0565b2beacf5a77d06202e6b53c4d022d25a7bbd0694c2f40b4e284ab7938b1 24d3ab583b6ba60c82c49db946cc641309ca3eb3b519250eda23e2a1ff837146
darwin/arm64 586eb4b804b796e343b22f904bed3d7356dbe14f85e302f121373e43b248aa4c 818c0a912c13b756b84907edeaa0e51319cc123360a813d4cdd4ce1a85600463
windows/amd64 800876361b44256e2480217d57810a95d75663cd1e9a54a67b9936eb19790faf 8e825f7a0b7d0f5facfc1e62a379884236010e8d681955810eb48a643f430e1a
windows/arm64 faa3ac6549172cccd33f8637d32ba281e2f91b590e6493273cbe4f4bed8b6ed9 51e927bf7660862331884115c7205c04a44d85c961b4e03cddefcbbf285c7f12

Companion payloads and metadata live at 45a631d866d419d3046fdf3a70a801ebf8b7e87f (Unix) and b0990720744a7ad9de644bf018f3a80496e205cc (Windows), tagged artifacts/<target>/v0.1.0. Each module resolves through proxy.golang.org and sum.golang.org; the published ZIP payload is byte-identical to the generated payload.

Install

$ CGO_ENABLED=0 go run github.com/lance-format/lance-go/examples/roundtrip@v0.1.0
Created, reopened and scanned 3 rows: [10 20 30]

In an application module, run go get github.com/lance-format/lance-go@v0.1.0. Go 1.23+ is required. The README covers the loader, the cache root (LANCE_CACHE_DIR), and a read-only deployment recipe with LANCE_LIB_PATH.

Compatibility

  • Bundled targets: linux/amd64, linux/arm64 (generic glibc 2.28 floor), darwin/arm64 (deployment target 11.0), windows/amd64 and windows/arm64 (static CRT). There is no musl companion; Intel macOS is retired for new releases.
  • 0.1.x patch releases preserve source compatibility for published Go APIs. Necessary breaking changes move to the next minor release, 0.2, with migration notes.

Changes since v0.1.0-preview.2

  • Stable native bundle: lance-c v0.2.0 replaces v0.2.0-beta.1.
  • lance.RuntimeInfo() reports the observed runtime state without side effects.
  • Scanner.ExplainPlan, AnalyzePlan, AnalyzeCountPlan and CountRows expose native plan diagnostics and counting.
  • LANCE_CACHE_DIR relocates the extracted-library cache.
  • Full-text query constructors and the index-segment optimize path return typed *lance.Error invalid-argument errors.
  • Consumer docs and runnable examples for vector search, full-text search, mutations and versions, cloud storage and namespaces, plus a root CHANGELOG.

See CHANGELOG.md for details.

Verification

  • Pre-merge native lanes on the exact objects: Unix native 44603962255 (linux/amd64, linux/arm64, darwin/arm64) and Windows native 44603966063 (windows/amd64, windows/arm64), including the native-library check, 607/607 ABI, OS-only import closure, CRT guards and the windows/amd64 tagged race suite.
  • Merged-main CI at 562eb877f7bbee5318f61fbc28675f2b9d578861: CI 44613849470, Unix native 44613849422, Windows 44613849423.
  • Exact-tag public consumers passed on all five targets in default, namespace-only and explicit LANCE_LIB_PATH modes: Unix run 44617059393 (linux/amd64, linux/arm64, darwin/arm64) and Windows run 44617063012 (windows/amd64, windows/arm64). Each run resolved v0.1.0 through proxy.golang.org/sum.golang.org, selected the v0.1.0 companion, and verified the payload, extracted library and cache contract.
  • The checksummed evidence archive lance-go-v0.1.0-post-tag-agorkfto.tar.gz is attached (SHA-256 b885c973f9502392ad0cb603967fcf2d52fc6be87f4ba8ebd60aafd1c298163a).

Boundaries

  • RTree scalar indexes and raw storage 2.2 Blob reads are verified for this release as recorded in artifacts/README.md. Broader RTree and core parity work remains outside this release.
  • The historical S3 record is scoped to its tested source and native library; it is not a claim of commercial namespace-service or production-account support.
  • This release does not complete the broader roadmap tracked by issue #1.