paleolimbot commented on code in PR #340:
URL: https://github.com/apache/arrow-nanoarrow/pull/340#discussion_r1447966863
##########
python/src/nanoarrow/_lib.pyx:
##########
@@ -233,39 +218,23 @@ cdef class Error:
raise NanoarrowException(what, code, "")
-cdef class Schema:
- """ArrowSchema wrapper
-
- This class provides a user-facing interface to access the fields of
- an ArrowSchema as defined in the Arrow C Data interface. These objects
- are usually created using `nanoarrow.schema()`. This Python wrapper
- allows access to schema fields but does not automatically deserialize
- their content: use `.view()` to validate and deserialize the content
- into a more easily inspectable object.
-
- Examples
- --------
-
- >>> import pyarrow as pa
- >>> import nanoarrow as na
- >>> schema = na.schema(pa.int32())
- >>> schema.is_valid()
- True
- >>> schema.format
- 'i'
- >>> schema.name
- ''
- >>> schema_view = schema.view()
- >>> schema_view.type
- 'int32'
+cdef class CSchema:
+ """Low-level ArrowSchema wrapper
+
+ This object is a literal wrapper around a read-only ArrowSchema. It
provides field accessors
+ that return Python objects and handles the C Data interface lifecycle
(i.e., initialized
+ ArrowSchema structures are always released).
+
+ See `nanoarrow.c_schema()` for construction and usage examples.
"""
cdef object _base
Review Comment:
It is, although I'm not sure that it always will be (I added a comment).
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
