Skip to content

feat(python): Python binding for iceberg-rust Schema#3

Draft
abnobdoss wants to merge 8 commits into
mainfrom
schema-binding-poc
Draft

feat(python): Python binding for iceberg-rust Schema#3
abnobdoss wants to merge 8 commits into
mainfrom
schema-binding-poc

Conversation

@abnobdoss

@abnobdoss abnobdoss commented May 24, 2026

Copy link
Copy Markdown
Owner

Status:
Deferred fork-only draft.

Summary:
Adds a Python binding for iceberg-rust Schema as an opaque pyiceberg_core schema handle constructed from Iceberg schema JSON.

Scope:
Runtime binding only. Typing stubs are handled separately.

No external issue references.

Abanoub Doss added 8 commits May 24, 2026 16:45
Add serde_json dep (needed for from_json/to_json in schema.rs) and
register the schema submodule in lib.rs alongside the existing modules.
Parse once via Schema.from_json(); Arc<Schema> shared across callers.
Exposes schema_id, highest_field_id, column_names, identifier_field_ids,
find_field_by_name, field_by_id, to_json, to_arrow_schema,
__arrow_c_schema__ (Arrow PyCapsule Interface), and _capsule (Rust→Rust
handoff via PyCapsule named "iceberg_core_schema").
Covers all public methods with full docstrings, including the
__arrow_c_schema__ PyCapsule dunder and the _capsule() Rust handoff.
Covers construction (V1/V2 JSON, error cases), all getter methods,
case-sensitive field lookup, to_json round-trips, PyCapsule lifecycle,
__arrow_c_schema__ PyCapsule Interface, and to_arrow_schema with
PARQUET:field_id preservation.
@abnobdoss abnobdoss force-pushed the schema-binding-poc branch from 5db80bd to f12678d Compare June 3, 2026 00:31
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