Skip to content

Use Python properties for Cython descriptors#2056

Open
kkraus14 wants to merge 5 commits intoNVIDIA:mainfrom
kkraus14:codex/cython-python-properties
Open

Use Python properties for Cython descriptors#2056
kkraus14 wants to merge 5 commits intoNVIDIA:mainfrom
kkraus14:codex/cython-python-properties

Conversation

@kkraus14
Copy link
Copy Markdown
Collaborator

@kkraus14 kkraus14 commented May 8, 2026

Summary

  • Add a shared python_property decorator that creates real Python property descriptors inside Cython cdef class bodies.
  • Convert the known public Cython descriptors that may raise or perform CUDA/NVML work during completion to use @python_property instead of generated getset_descriptors.
  • Add regression coverage that checks those public descriptors are property instances and not getset_descriptor objects.

Testing

  • pixi run ruff check cuda_core/cuda/core/_utils/properties.py cuda_core/tests/test_cython_property_descriptors.py
  • pixi run --manifest-path cuda_core -e cu13 pytest cuda_core/tests/test_cython_property_descriptors.py (blocked locally because cuda_core/pixi.toml on this branch still has the known python_version < "3.11" package target parse error; the pixi fix is intentionally left to the separate PR)
  • commit hooks: ruff, SPDX, toml, cython-lint, and other pre-commit checks passed

@kkraus14 kkraus14 added this to the cuda.core next milestone May 8, 2026
@kkraus14 kkraus14 added the cuda.core Everything related to the cuda.core module label May 8, 2026
@leofang leofang added bug Something isn't working P0 High priority - Must do! labels May 8, 2026
@leofang leofang requested review from leofang, mdboom and shwina May 8, 2026 16:26
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 8, 2026

Copy link
Copy Markdown
Contributor

@mdboom mdboom left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

One suggestion is just a micro-op for startup time that ultimately doesn't matter.

It would be nice to simplify the testing (if possible) though. My concern is corner case syntactic constructions that might not get caught.

Comment thread cuda_core/cuda/core/_utils/properties.py Outdated
descriptor = inspect.getattr_static(cls, cython_property.name)

assert isinstance(descriptor, property)
assert not isinstance(descriptor, types.GetSetDescriptorType)
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It seems kind of brittle to do a source-level analysis here.

Could we just iterate over all classes and assert that they don't have any GetSetDescriptorType's? It's possible I'm missing something (maybe there are implicit descriptors always that we can't remove), but that seems less complicated.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good call. I replaced the source-level parser with runtime introspection over the cuda-core modules/classes.

A literal “no GetSetDescriptorType anywhere” check still needs filtering because Cython also emits getset descriptors for non-property things like __dict__, __weakref__, and typed cdef fields such as option dataclass fields. The updated test now allows those known field descriptors, but fails on any unexpected getset descriptor exposed by cuda-core classes.

@leofang
Copy link
Copy Markdown
Member

leofang commented May 8, 2026

All Linux-64 CI segfaulted. (Ignored linux-arm64 CIs, there seems to be a widespread outage.)

Comment on lines +21 to +34
_OPTIONAL_IMPORT_FAILURES = {"cuda.core._tensor_bridge"}

_GETSET_FIELD_ALLOWLIST = {
("cuda.core._kernel_arg_handler", "ParamHolder", "ptr"),
("cuda.core._layout", "_StridedLayout", "itemsize"),
("cuda.core._layout", "_StridedLayout", "slice_offset"),
("cuda.core._memoryview", "StridedMemoryView", "device_id"),
("cuda.core._memoryview", "StridedMemoryView", "exporting_obj"),
("cuda.core._memoryview", "StridedMemoryView", "is_device_accessible"),
("cuda.core._memoryview", "StridedMemoryView", "ptr"),
("cuda.core._memoryview", "StridedMemoryView", "readonly"),
("cuda.core._memoryview", "_StridedMemoryViewProxy", "has_dlpack"),
("cuda.core._memoryview", "_StridedMemoryViewProxy", "obj"),
}
Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This still feels very brittle where I'm not too happy about this and don't want to have to maintain a list like this.

Comment on lines +60 to +68
def _is_allowed_getset_descriptor(cls, name, descriptor) -> bool:
if name in {"__dict__", "__weakref__"}:
return True
# Typed cdef fields generate getset descriptors too, but their docs follow
# this compact "field: type" form rather than a property docstring.
doc = descriptor.__doc__
if doc is not None and doc.startswith(f"{name}:"):
return True
return (cls.__module__, cls.__qualname__, name) in _GETSET_FIELD_ALLOWLIST
Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This also feels quite brittle

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working cuda.core Everything related to the cuda.core module P0 High priority - Must do!

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants