Skip to content

docs(compatibility): bump reference to v0.74.0, document gaps#26

Merged
dfa1 merged 1 commit into
mainfrom
worktree-happy-wandering-shamir
Jun 10, 2026
Merged

docs(compatibility): bump reference to v0.74.0, document gaps#26
dfa1 merged 1 commit into
mainfrom
worktree-happy-wandering-shamir

Conversation

@dfa1

@dfa1 dfa1 commented Jun 10, 2026

Copy link
Copy Markdown
Owner

Summary

  • Compatibility doc was pinned to Rust v0.72.0; latest is v0.74.0 (two minor releases ahead).
  • Audit surfaces three concrete wire-format gaps that the doc did not mention:
    • DType::Union (Rust 0.71.0) — Java reader throws on this DType (PostscriptParser.convertDType switch default).
    • vortex.onpair experimental string encoding (Rust 0.74.0) — not registered.
    • vortex.variant write asymmetry — Rust 0.73.0 added write tests (#7945); Java encode still stubbed.
  • S3 fixture matrix flagged as locked to v0.72.0; needs re-run when v0.74.0 fixtures publish.

Test plan

  • Doc-only change; no code touched
  • Reviewer: confirm wording of the new "Known wire-format gaps" section
  • Reviewer: confirm whether v0.74.0 fixture set is available so the S3 section can be refreshed in a follow-up

🤖 Generated with Claude Code

…/Variant gaps

The Rust reference implementation moved from v0.72.0 to v0.74.0 (two minor
releases) while this doc continued to claim v0.72.0 as the tested ceiling.
Audit findings against current Java code:

- `DType::Union` (`fbs.DType.Type.Union = 12`, added in Rust 0.71.0) is not
  decoded — `PostscriptParser.convertDType` switch has no Union case and falls
  through to the default branch, throwing `VortexException("unsupported DType
  typeType=12")`. The sealed `DType` interface in core has no `Union` variant
  either, so adding support is a multi-touch change.
- `vortex.onpair` (experimental in Rust 0.74.0, encodings/onpair/) is not
  registered. Files using it require `Registry.allowUnknown()` to open.
- `vortex.variant`: decode is complete (incl. shredded child); encode still
  throws `"encode not yet implemented"`. Rust 0.73.0 (#7945) added their write
  path + parquet-variant IO tests, widening the asymmetry.

Adds a new "Known wire-format gaps" section above the encoding table for
visibility; adds a row for `vortex.onpair`; rewords the Variant row to call
out the 0.73+ write-side asymmetry; flags the S3 fixture matrix as locked to
v0.72.0 and in need of a re-run when the v0.74.0 fixture set publishes.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@dfa1 dfa1 merged commit cf73887 into main Jun 10, 2026
3 checks passed
@dfa1 dfa1 deleted the worktree-happy-wandering-shamir branch June 10, 2026 19:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant