Skip to content

Releases

Lance Go v0.1.0-preview.1

Pre-release

Choose a tag to compare

@Xuanwo Xuanwo released this 13 Nov 09:52
v0.1.0-preview.1
0e186d6

Lance 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.1

The 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
    (tree 8816f47b6112dbf9812a978cbae2e0f56862ecb7), publicly accepted as
    pseudo-version v0.0.0-20261113081403-956bee25817c.
  • Accepted SDK source: 807cb84305302dc3ff3b40809d817a876efd2909 from PR 47.
    That source was merged to main as 0e0d0ef4f898f5baf461e6a66ec3eea96629e491
    with an identical tree.
  • The source delta from 807cb84 to 956bee2 is Markdown-only: PREVIEW.md,
    README.md, RELEASING.md, artifacts/README.md, compat/README.md and
    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-256 c19789e9e003930c6065181b5cd9f6f7b464e08a5dc4daca8b21ad82d5160f5b.
    It declares 878 C exports; the SDK binds 603. This exact commit has no
    matching lance-c release tag and is not the v0.1.9 release. Do not relabel
    the pin as v0.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 956bee2 evidence 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 807cb84 archive 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 ac2634c has no matching release tag. The exact commit and header hash
    above are the provenance; no v0.1.9 equivalence 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-on...

Read more