Skip to main content

PyGeoArrayReader

Struct PyGeoArrayReader 

Source
pub struct PyGeoArrayReader { /* private fields */ }
Expand description

Python wrapper for a GeoArrow array reader (stream).

This type represents a stream of GeoArrow arrays that can be read incrementally. It implements the Arrow C Stream Interface, allowing zero-copy data exchange with Arrow-compatible Python libraries.

The reader can be iterated over to yield individual PyGeoArray chunks, or materialized into a PyGeoChunkedArray using the into_chunked_array() method. For stream processing, prefer into_reader().

Implementations§

Source§

impl PyGeoArrayReader

Source

pub fn new(reader: Box<dyn GeoArrowArrayReader + Send>) -> Self

Create a new PyGeoArrayReader from a GeoArrow array reader.

Source

pub fn from_arrow_pycapsule( capsule: &Bound<'_, PyCapsule>, ) -> PyGeoArrowResult<Self>

Import from a raw Arrow C Stream capsule

Source

pub fn data_type(&self) -> &GeoArrowType

Get the GeoArrow data type of arrays in this stream.

Source

pub fn into_reader(self) -> PyResult<Box<dyn GeoArrowArrayReader + Send>>

Consume this reader and convert into a ArrayReader.

The reader can only be consumed once. Calling into_reader

Source

pub fn into_chunked_array(self) -> PyGeoArrowResult<PyGeoChunkedArray>

Consume this reader and create a PyGeoChunkedArray object

Source

pub fn to_geoarrow_py<'py>( &'py self, py: Python<'py>, ) -> PyResult<Bound<'py, PyAny>>

Export to a geoarrow.rust.core.GeoArrowArrayReader.

This requires that you depend on geoarrow-rust-core from your Python package.

Source

pub fn into_geoarrow_py(self, py: Python<'_>) -> PyResult<Bound<'_, PyAny>>

Export to a geoarrow.rust.core.GeoArrowArrayReader.

This requires that you depend on geoarrow-rust-core from your Python package.

Trait Implementations§

Source§

impl<'py> FromPyObject<'_, 'py> for PyGeoArrayReader

Source§

type Error = PyErr

The type returned in the event of a conversion error. Read more
Source§

fn extract(ob: Borrowed<'_, 'py, PyAny>) -> PyResult<Self>

Extracts Self from the bound smart pointer obj. Read more
Source§

impl<'py> IntoPyObject<'py> for PyGeoArrayReader

Source§

type Target = PyGeoArrayReader

The Python output type
Source§

type Output = Bound<'py, <PyGeoArrayReader as IntoPyObject<'py>>::Target>

The smart pointer type to use. Read more
Source§

type Error = PyErr

The type returned in the event of a conversion error.
Source§

fn into_pyobject( self, py: Python<'py>, ) -> Result<<Self as IntoPyObject<'_>>::Output, <Self as IntoPyObject<'_>>::Error>

Performs the conversion.
Source§

impl PyClass for PyGeoArrayReader

Source§

const NAME: &str = "GeoArrayReader"

Name of the class. Read more
Source§

type Frozen = True

Whether the pyclass is frozen. Read more
Source§

impl PyClassBaseType for PyGeoArrayReader

Source§

type LayoutAsBase = <PyGeoArrayReader as PyClassImpl>::Layout

Source§

type BaseNativeType = <PyGeoArrayReader as PyClassImpl>::BaseNativeType

Source§

type Initializer = PyClassInitializer<PyGeoArrayReader>

Source§

type PyClassMutability = <PyGeoArrayReader as PyClassImpl>::PyClassMutability

Source§

type Layout<T: PyClassImpl> = <<PyGeoArrayReader as PyClassBaseType>::BaseNativeType as PyClassBaseType>::Layout<T>

The type of object layout to use for ancestors or descendants of this type.
Source§

impl PyClassImpl for PyGeoArrayReader

Source§

const MODULE: Option<&str>

Module which the class will be associated with. Read more
Source§

const IS_BASETYPE: bool = true

#[pyclass(subclass)]
Source§

const IS_SUBCLASS: bool = false

#[pyclass(extends=…)]
Source§

const IS_MAPPING: bool = false

#[pyclass(mapping)]
Source§

const IS_SEQUENCE: bool = false

#[pyclass(sequence)]
Source§

const IS_IMMUTABLE_TYPE: bool = false

#[pyclass(immutable_type)]
Source§

const RAW_DOC: &'static CStr = /// Python wrapper for a GeoArrow array reader (stream). /// /// This type represents a stream of GeoArrow arrays that can be read incrementally. It implements /// the Arrow C Stream Interface, allowing zero-copy data exchange with Arrow-compatible Python /// libraries. /// /// The reader can be iterated over to yield individual [`PyGeoArray`] chunks, or materialized /// into a [`PyGeoChunkedArray`] using the [`into_chunked_array()`][Self::into_chunked_array] /// method. For stream processing, prefer [`into_reader()`][Self::into_reader].

Docstring for the class provided on the struct or enum. Read more
Source§

const DOC: &'static CStr

Fully rendered class doc, including the text_signature if a constructor is defined. Read more
Source§

type Layout = <<PyGeoArrayReader as PyClassImpl>::BaseNativeType as PyClassBaseType>::Layout<PyGeoArrayReader>

Description of how this class is laid out in memory
Source§

type BaseType = PyAny

Base class
Source§

type ThreadChecker = NoopThreadChecker

This handles following two situations: Read more
Source§

type PyClassMutability = <<PyAny as PyClassBaseType>::PyClassMutability as PyClassMutability>::ImmutableChild

Immutable or mutable
Source§

type Dict = PyClassDummySlot

Specify this class has #[pyclass(dict)] or not.
Source§

type WeakRef = PyClassDummySlot

Specify this class has #[pyclass(weakref)] or not.
Source§

type BaseNativeType = PyAny

The closest native ancestor. This is PyAny by default, and when you declare #[pyclass(extends=PyDict)], it’s PyDict.
Source§

fn items_iter() -> PyClassItemsIter

Source§

fn lazy_type_object() -> &'static LazyTypeObject<Self>

Source§

fn dict_offset() -> Option<PyObjectOffset>

Used to provide the dictoffset slot (equivalent to tp_dictoffset)
Source§

fn weaklist_offset() -> Option<PyObjectOffset>

Used to provide the weaklistoffset slot (equivalent to tp_weaklistoffset
Source§

impl PyMethods<PyGeoArrayReader> for PyClassImplCollector<PyGeoArrayReader>

Source§

fn py_methods(self) -> &'static PyClassItems

Source§

impl PyTypeInfo for PyGeoArrayReader

Source§

const NAME: &str = <Self as ::pyo3::PyClass>::NAME

👎Deprecated since 0.28.0:

prefer using ::type_object(py).name() to get the correct runtime value

Class name.
Source§

const MODULE: Option<&str> = <Self as ::pyo3::impl_::pyclass::PyClassImpl>::MODULE

👎Deprecated since 0.28.0:

prefer using ::type_object(py).module() to get the correct runtime value

Module name, if any.
Source§

fn type_object_raw(py: Python<'_>) -> *mut PyTypeObject

Returns the PyTypeObject instance for this type.
Source§

fn type_object(py: Python<'_>) -> Bound<'_, PyType>

Returns the safe abstraction over the type object.
Source§

fn is_type_of(object: &Bound<'_, PyAny>) -> bool

Checks if object is an instance of this type or a subclass of this type.
Source§

fn is_exact_type_of(object: &Bound<'_, PyAny>) -> bool

Checks if object is an instance of this type.
Source§

impl TryFrom<Box<dyn ArrayReader<Item = Result<Arc<dyn Array>, ArrowError>> + Send>> for PyGeoArrayReader

Source§

type Error = PyGeoArrowError

The type returned in the event of a conversion error.
Source§

fn try_from(value: Box<dyn ArrayReader + Send>) -> Result<Self, Self::Error>

Performs the conversion.
Source§

impl TryFrom<PyArrayReader> for PyGeoArrayReader

Source§

type Error = PyGeoArrowError

The type returned in the event of a conversion error.
Source§

fn try_from(value: PyArrayReader) -> Result<Self, Self::Error>

Performs the conversion.
Source§

impl DerefToPyAny for PyGeoArrayReader

Source§

impl ExtractPyClassWithClone for PyGeoArrayReader

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<'py, T> IntoPyObjectExt<'py> for T
where T: IntoPyObject<'py>,

Source§

fn into_bound_py_any(self, py: Python<'py>) -> Result<Bound<'py, PyAny>, PyErr>

Converts self into an owned Python object, dropping type information.
Source§

fn into_py_any(self, py: Python<'py>) -> Result<Py<PyAny>, PyErr>

Converts self into an owned Python object, dropping type information and unbinding it from the 'py lifetime.
Source§

fn into_pyobject_or_pyerr(self, py: Python<'py>) -> Result<Self::Output, PyErr>

Converts self into a Python object. Read more
Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> PyErrArguments for T
where T: for<'py> IntoPyObject<'py> + Send + Sync,

Source§

fn arguments(self, py: Python<'_>) -> Py<PyAny>

Arguments for exception
Source§

impl<T> PyTypeCheck for T
where T: PyTypeInfo,

Source§

const NAME: &'static str = T::NAME

👎Deprecated since 0.27.0:

Use ::classinfo_object() instead and format the type name at runtime. Note that using built-in cast features is often better than manual PyTypeCheck usage.

Name of self. This is used in error messages, for example.
Source§

fn type_check(object: &Bound<'_, PyAny>) -> bool

Checks if object is an instance of Self, which may include a subtype. Read more
Source§

fn classinfo_object(py: Python<'_>) -> Bound<'_, PyAny>

Returns the expected type as a possible argument for the isinstance and issubclass function. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<G1, G2> Within<G2> for G1
where G2: Contains<G1>,

Source§

fn is_within(&self, b: &G2) -> bool

Source§

impl<T> Allocation for T
where T: RefUnwindSafe + Send + Sync,

Source§

impl<'py, T> FromPyObjectOwned<'py> for T
where T: for<'a> FromPyObject<'a, 'py>,

Source§

impl<T> Ungil for T
where T: Send,