Changelog¶

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[0.3.5] - 2026-03-11¶

All protocol builder def_* methods that return PythonObject now also accept handler functions that return any type satisfying ConvertibleToPython & ImplicitlyCopyable. The correct overload is resolved at compile time with no runtime overhead.

All protocol builder def_* methods now accept value-receiver handler functions (e.g. fn(self: MyStruct) -> Int) in addition to the existing pointer-receiver (UnsafePointer[T, MutAnyOrigin]) overloads. Both raising and non-raising value-receiver handlers are accepted via a single overload (Mojo coerces fn(T) -> R to fn(T) raises -> R automatically for value types).

Protocol builder def_* methods now accept non-raising handler functions (e.g. fn(...) -> T without raises), in addition to the existing raising overloads. The correct overload is selected automatically at compile time with no runtime overhead.

All four protocol builders (TypeProtocolBuilder, MappingProtocolBuilder, NumberProtocolBuilder, SequenceProtocolBuilder) now take a self_type compile-time parameter (e.g. MappingProtocolBuilder[DataFrame](tb)).
Handler functions registered via def_len, def_getitem, def_richcompare, etc. now receive UnsafePointer[T, MutAnyOrigin] as their first argument instead of a raw PythonObject, eliminating the per-method downcast_value_ptr / _get_self_ptr boilerplate.
Added internal _unwrap_self[T] helper in adapters.mojo that performs the typed downcast and aborts with a clear message on type mismatch.

Release under the modular-community channel.

Build debug.

Build debug.

Focused integration tests for all four protocol builders: mapping, number, sequence, and type protocol (tests/)
pixi run test-all task and per-protocol test-* / build-test-* tasks

Builder method chains now use parenthesised multi-line style, consistent with the Mojo formatter

Renamed internal modules: protocols.mojo → utils.mojo, protocol_adapters.mojo → adapters.mojo, protocol_type_builder.mojo → builders.mojo
Replaced PontoneerTypeBuilder with four focused builders: TypeProtocolBuilder, MappingProtocolBuilder, NumberProtocolBuilder, SequenceProtocolBuilder

Fix pixi.lock and debug prefix.dev release process.

PyTypeObjectSlot tag struct with slot constants: mp_length, mp_getitem, mp_setitem, tp_richcompare
NotImplementedError — raise from a rich compare handler to return Py_NotImplemented
RichCompareOps constants: Py_LT, Py_LE, Py_EQ, Py_NE, Py_GT, Py_GE
PontoneerTypeBuilder — wraps PythonTypeBuilder and adds def_method overloads for all four protocol slots
Columnar DataFrame example demonstrating all four slots (examples/columnar/)