Repository navigation
Lance Go v0.1.0-preview.1
Pre-releaseLance Go v0.1.0-preview.1
Root tag: v0.1.0-preview.1, source 0e186d62d0fe3758e190502f9273df7dd7409c55
(tree 8816f47b6112dbf9812a978cbae2e0f56862ecb7), merged through PR 48.
Post-tag consumer acceptance passed on all six targets: 18/18 default,
namespace-only and external modes. Exact run and artifact evidence is below.
Initial preview of the Go SDK for Lance, with native companions for Linux,
macOS and Windows on amd64 and arm64. Default consumers use CGO_ENABLED=0;
no local Rust or C build is required.
go get github.com/lance-format/lance-go@v0.1.0-preview.1The API covers dataset writes and immutable snapshots, scans, row selection,
vector/full-text queries, staged fragments and transactions, Blob/raw-file
operations, maintenance, and directory/REST namespaces. See the repository
README for examples and the lance_external_lib option.
Source and native provenance
- Root module:
github.com/lance-format/lance-go. - Accepted premerge documentation candidate:
956bee25817c4973190a946a3898bfea75910d5b
(tree8816f47b6112dbf9812a978cbae2e0f56862ecb7), publicly accepted as
pseudo-versionv0.0.0-20261113081403-956bee25817c. - Accepted SDK source:
807cb84305302dc3ff3b40809d817a876efd2909from PR 47.
That source was merged to main as0e0d0ef4f898f5baf461e6a66ec3eea96629e491
with an identical tree. - The source delta from
807cb84to956bee2is Markdown-only:PREVIEW.md,
README.md,RELEASING.md,artifacts/README.md,compat/README.mdand
scripts/public-consumer/WINDOWS.md. Runtime code, selectors, module
metadata, immutable companion bytes and acceptance drivers are unchanged. - Native pin: lance-c
ac2634c553b450c7787577ffe964fc2b283b8334; header
SHA-256c19789e9e003930c6065181b5cd9f6f7b464e08a5dc4daca8b21ad82d5160f5b.
It declares 878 C exports; the SDK binds 603. This exact commit has no
matching lance-c release tag and is not thev0.1.9release. Do not relabel
the pin asv0.1.9.
Companion payloads
The six immutable module versions below are the exact requirements in the
root go.mod and go.sum at 956bee2. Sizes are in bytes.
Publication commits are ac5955a095d097eef87cfad39d3abc4eef0743f8 for
linux/amd64, 43fcbbee5161f1e461cbd2804ef47f243b872795 for the other three
Unix targets, and 9496baf852b1b3ffa7570eaad53f91dbd112e48f for both Windows
targets. The compressed payloads are the published module data; the
uncompressed bytes below are the extracted libraries, packaged from the exact
lance-c pin in the preceding section.
| Target | Library | Module version | Compressed bytes | Uncompressed bytes |
|---|---|---|---|---|
darwin/amd64 |
liblance_c.dylib |
v0.0.0-20261112064406-43fcbbee5161 |
81328057 | 293866120 |
darwin/arm64 |
liblance_c.dylib |
v0.0.0-20261112064406-43fcbbee5161 |
76784146 | 272228496 |
linux/amd64 |
liblance_c.so |
v0.0.0-20261111235843-ac5955a095d0 |
85696976 | 322099824 |
linux/arm64 |
liblance_c.so |
v0.0.0-20261112064406-43fcbbee5161 |
82574957 | 286825888 |
windows/amd64 |
lance_c.dll |
v0.0.0-20261112113154-9496baf852b1 |
97196491 | 375912448 |
windows/arm64 |
lance_c.dll |
v0.0.0-20261112113154-9496baf852b1 |
87342219 | 308929024 |
| Target | Compressed SHA-256 | Uncompressed SHA-256 |
|---|---|---|
darwin/amd64 |
c44cccfe51d70d955e9ee1887f20994bb7a5ac8deca39e0f80f781fa779b0805 |
e377468f7d0f5afd13a6ab4d18f9cf17dc544a38a68da04fb1a5557839260bc7 |
darwin/arm64 |
80e2e23985ec20955ce8ab67e6267a206de16af9dfab7b32296157455f7b395d |
f214c238b890bd02427ecc260231f4f886997a396e050c951978f81270e25200 |
linux/amd64 |
e933fc867b2a9ee404d01959aaef8dc8378ddf0b582d7bb2367ed3dbfe46c5b5 |
e5571d6da16e81a0434f2509ade5262785b63df0b37ff7155537642841dd9378 |
linux/arm64 |
4bb00ab7cc52a6f693b0fd79daf2b94bf5afa1e17ffc65a6b634747609eb1fdb |
c03b4d69f4597d71d99971606f250e2b11bb69f50a01492cdf82c02c8413d879 |
windows/amd64 |
4ef5995d123eb0d99b93e50e775148b0a74b654579720ec65457128d99e7b2af |
cb037c4ce8fba99e7d1abbe6f1a64b4ccb46d94a4cf9530af217a07e83a4c3ef |
windows/arm64 |
95743d5e4c7c2878029136400ac1b3238167926b0fa266086c69de9de3cfaf6a |
92bf49041f94df45dc5114303c0236a8bbd1aa1e487db11e54a51c791924609f |
Module paths, go.sum and go.mod checksums
| Target | Module path | go.sum |
go.mod sum |
|---|---|---|---|
darwin/amd64 |
github.com/lance-format/lance-go/artifacts/darwin-amd64 |
h1:k9THEJvMXXVgasCtC1wqUVppJlgz2YailpCdinni19Q= |
h1:TWlgbElRVPSHSmHyYB2t72wsrmxkk9kZ/8Z44usQADg= |
darwin/arm64 |
github.com/lance-format/lance-go/artifacts/darwin-arm64 |
h1:MSG2Tmn7eF7tgeGA0QUyocHIzb8kMrYZ4O7UkI3B3rw= |
h1:fQfHodK/kxZC5w9/Q3YPXfAFpacMYvc2TshI9luW6Xw= |
linux/amd64 |
github.com/lance-format/lance-go/artifacts/linux-amd64 |
h1:tOJ/owlrb9wrZ1Yr18N3yXakU0+JCuSNutOu3sREkJ4= |
h1:hmgfCi9X6+yByjEXjF26x8U4yNmD+NK5tFKAPQ2JXtI= |
linux/arm64 |
github.com/lance-format/lance-go/artifacts/linux-arm64 |
h1:6+r4uU8wQO1pX1EBr3ntyJ/O2Ors5tQL5JE01Cu1+I0= |
h1:/PZX6MQ09uUxT+97jTAFTnOmBb8Eaya+Fo6/Cx8oR10= |
windows/amd64 |
github.com/lance-format/lance-go/artifacts/windows-amd64 |
h1:uKNwfL0ytkCRfT0Y97krIpFTyX6MFt1iBBMuu1k589I= |
h1:poapOGoG8Ov6b55dD9mnGnIvYAtPMZorCUDbhiWhodQ= |
windows/arm64 |
github.com/lance-format/lance-go/artifacts/windows-arm64 |
h1:/RMEB1MVif5TE3S83Vm/TnSZsBr5vtO3T+5aexOfcS8= |
h1:0TJauP68uQ0eNmpLzDvdN9HDjzS1DzYQXcElTM/mqYE= |
Public pre-tag acceptance
The documentation candidate 956bee2 passed public default, namespace-only
and external consumers on all six targets: 18 executions, 96 verifier reports
and 18 literal runtime outputs. The retained runs are
Unix run 43391643769
and Windows run 43391643713.
All runs used Go 1.23.0 with CGO_ENABLED=0.
Consumers resolved the root and companion modules through proxy.golang.org
and sum.golang.org; the root archive matched 300 checked-out files with the
six nested module directories excluded. Tracked metadata, selector choices,
exact payload sizes and hashes, extracted libraries and real native calls all
matched. Windows additionally verified loaded DLL path/hash, OS-only imports
and no redistributable CRT modules. Cold target caches were fresh; external
mode excludes artifact linkage and extraction without making a zero-download
claim.
Six retained API ZIPs
| Target | ZIP file | Bytes | SHA-256 |
|---|---|---|---|
darwin/amd64 |
public-consumer-darwin-amd64.zip |
28482 | 20c7f3fe0cf1b605aba8482ab08c52a75a9399b00b5644cc0e8f2b119f163c4d |
darwin/arm64 |
public-consumer-darwin-arm64.zip |
28128 | f8bacb96d4a36ea26fd1dfbffe97cb5709f76ce914fa6fdfda2596fc62214248 |
linux/amd64 |
public-consumer-linux-amd64.zip |
28747 | 84b54a393db42cfc8a4d7e8fc5b61ae0784acc2f9b6ab32b85d5bb7cb3865a43 |
linux/arm64 |
public-consumer-linux-arm64.zip |
28398 | 0dfdcb02558024c6dae94686efab942b99a38651203e846e312c03e4bda88faa |
windows/amd64 |
windows-public-consumer-windows-amd64.zip |
53585 | 0628f3948f73a12f5c9ba777c52f649fa54f1c947cb3545b829fd2c8aac608f0 |
windows/arm64 |
windows-public-consumer-windows-arm64.zip |
53168 | 62749bebad1850680efc66821ff280c47077b838240bc3a360f9ff64c5845661 |
Evidence attachments
| File | Bytes | SHA-256 | Scope |
|---|---|---|---|
lance-go-956bee2-premerge-public-evidence.tar.gz |
287216 | 982f1812d89afa06d931d0db0b27f4b5a6d661e966f413064b12f6d350816827 |
Current 956bee2 premerge public evidence |
lance-go-956bee2-premerge-public-evidence.sha256 |
115 | 50be123e39fb00cedaa153dbfe2f63a8db6a01de78702575f4c1e21783d4d48f |
Archive-only checksum; no self-reference |
lance-go-807cb84-accepted-source-evidence.tar.gz |
288528 | 38bdf3dc03284758f26237c22f6c54a4bec90cfffefe8212f75dc8544e0fdcf1 |
Immutable historical 807cb84 evidence |
The current archive has 280 tar entries: all 279 files listed by the retained
public-956bee2/MANIFEST.sha256, plus that manifest itself. It contains the
six API ZIPs, source/runtime audits, run/job/artifact JSON and all consumer
outputs. A clean extraction reported 279/279 manifest entries OK; all six ZIPs
passed unzip -t; the archive passed gzip -t; no symlinks were present.
The historical archive remains byte-for-byte unchanged. Its embedded release
record has old approval fields that are superseded by
CURRENT-RELEASE-RECORD.json and the current user authority; those historical
fields are not an active release gate.
Historical and current evidence boundaries
- The
956bee2evidence is accepted premerge public pseudo-version evidence.
It does not establish final tag resolution, post-tag consumer acceptance or
a merge commit identity. The actual merged source is bound above and its tree
matches the accepted documentation candidate. - The
807cb84archive is immutable historical evidence for the prior accepted
SDK source and its earlier compatibility record. It is retained for
traceability and is not relabeled as current tag acceptance. - Native
ac2634chas no matching release tag. The exact commit and header hash
above are the provenance; nov0.1.9equivalence is claimed. - The release record binds the actual merged source and publication metadata.
Final post-tag acceptance is recorded only after both tag workflows finish. - Both maintained workflows ran against the actual tag with fresh target
caches and passed all 18 modes. The pre-tag pseudo-version runs remain
separate historical evidence.
Platform and limitations
Tested hosts are Ubuntu 24.04/glibc 2.39, macOS 15.x, Windows Server 2022 amd64
and Windows 11 arm64. These results do not claim older OS or musl support.
Windows DLLs passed OS-only import and loaded-module checks. Windows amd64
race/checkptr is accepted; Go does not support Windows arm64 race builds.
Current-ac263 storage 2.1 compatibility passed 56/56 cells on Linux amd64 at
accepted SDK 807cb84, across Go, Python, Rust and Java. This does not
establish storage 2.2 or a cross-platform compatibility matrix.
- RTree non-finite-bound reload and raw storage 2.2 Blob-reader acceptance
remain tracked in lance-c #153
and lance-c #167. No
fork/backport is included. - The 30-minute current-ac263 lifecycle run had zero workload errors and
callback-handle delta, but growing RSS is not proof of leak absence. - Real S3 refresh evidence is from the previously accepted native88
implementation. The current-ac263 runner is built, but live cloud acceptance
remains unexecuted because scoped credential issuance is unavailable. - This preview does not complete the entire
SDK roadmap.
Public tag acceptance
Published tag v0.1.0-preview.1 passed all six targets and 18 modes on
Unix run 43404796150
and Windows run 43404798900.
Both runs completed on attempt 1 at source
0e186d62d0fe3758e190502f9273df7dd7409c55, with the tag as both workflow ref
and consumer revision. Terminal exits were zero; exact tag/source/root-module
identity, cold target caches, native outputs, external-library boundaries and
cleanup passed. All six targets reported the same root module sum.
Six API ZIPs matched GitHub SHA-256 digests and byte sizes. All 262 extracted
files matched their ZIP members byte-for-byte with exact member sets. The
retained 283-file collection manifest verifies. The audit reports 96 verifier
objects with a kind field; including 12 root download/archive objects, the
collector inspected 108 JSON evidence reports. Neither count is a runtime
execution count.
| Post-tag attachment | Bytes | SHA-256 |
|---|
| lance-go-v0.1.0-preview.1-public-evidence.sha256 | 115 | b5d21f9d71c756c51825342a816f9a06ac7892e80f5b12c33c9b994531e843be |
| lance-go-v0.1.0-preview.1-public-evidence.tar.gz | 313280 | 11b16611b17f5cbb5911720934e4e7581c4b2f2f9591bf2fea90cd0e01519209 |
The post-tag archive contains 291 regular files, including a 290-entry
manifest, both workflow API snapshots, all six artifact ZIPs and extracted
outputs, the exact-tag audit and the independent ZIP/member-byte audit.