Repository navigation
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 object84a7d564a961a6de6d68e6fef206e91d9363ab0a, peeled commitfacb369c9fa98b7a3e5ce2ed12e2d8be090627ce, canonical LF header SHA-256947a912a14cb53f97237dbc7c03e5c09ef4337d46b459edc600d4d3c2c888d5c.- 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/amd64andwindows/arm64(static CRT). There is no musl companion; Intel macOS is retired for new releases. 0.1.xpatch 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.0replacesv0.2.0-beta.1. lance.RuntimeInfo()reports the observed runtime state without side effects.Scanner.ExplainPlan,AnalyzePlan,AnalyzeCountPlanandCountRowsexpose native plan diagnostics and counting.LANCE_CACHE_DIRrelocates the extracted-library cache.- Full-text query constructors and the index-segment optimize path return typed
*lance.Errorinvalid-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_PATHmodes: Unix run 44617059393 (linux/amd64, linux/arm64, darwin/arm64) and Windows run 44617063012 (windows/amd64, windows/arm64). Each run resolvedv0.1.0throughproxy.golang.org/sum.golang.org, selected thev0.1.0companion, and verified the payload, extracted library and cache contract. - The checksummed evidence archive
lance-go-v0.1.0-post-tag-agorkfto.tar.gzis attached (SHA-256b885c973f9502392ad0cb603967fcf2d52fc6be87f4ba8ebd60aafd1c298163a).
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.