lazyscribe-arrow 0.2.0__py3-none-any.whl → 0.2.1__py3-none-any.whl

lazyscribe_arrow/_meta.py

@@ -1,3 +1,3 @@
 """Version."""
 
-__version__ = "0.2.0"
+__version__ = "0.2.1"

lazyscribe_arrow/csv.py

@@ -12,6 +12,12 @@ from pyarrow import csv
 from pyarrow.interchange import from_dataframe
 from slugify import slugify
 
+from lazyscribe_arrow.protocols import (
+    ArrowArrayExportable,
+    ArrowStreamExportable,
+    SupportsInterchange,
+)
+
 LOG = logging.getLogger(__name__)
 
 
@@ -91,9 +97,9 @@ class CSVArtifact(Artifact):
         """
         if isinstance(obj, pa.Table):
             LOG.debug("Provided object is already a PyArrow table.")
-        elif hasattr(obj, "__arrow_c_array__") or hasattr(obj, "__arrow_c_stream__"):
+        elif isinstance(obj, (ArrowArrayExportable, ArrowStreamExportable)):
             obj = pa.table(obj)
-        elif hasattr(obj, "__dataframe__"):
+        elif isinstance(obj, SupportsInterchange):
             obj = from_dataframe(obj)
         else:
             raise ValueError(

lazyscribe_arrow/parquet.py

@@ -12,6 +12,12 @@ from lazyscribe.artifacts.base import Artifact
 from pyarrow.interchange import from_dataframe
 from slugify import slugify
 
+from lazyscribe_arrow.protocols import (
+    ArrowArrayExportable,
+    ArrowStreamExportable,
+    SupportsInterchange,
+)
+
 LOG = logging.getLogger(__name__)
 
 
@@ -93,9 +99,9 @@ class ParquetArtifact(Artifact):
         """
         if isinstance(obj, pa.Table):
             LOG.debug("Provided object is already a PyArrow table.")
-        elif hasattr(obj, "__arrow_c_array__") or hasattr(obj, "__arrow_c_stream__"):
+        elif isinstance(obj, (ArrowArrayExportable, ArrowStreamExportable)):
             obj = pa.table(obj)
-        elif hasattr(obj, "__dataframe__"):
+        elif isinstance(obj, SupportsInterchange):
             obj = from_dataframe(obj)
         else:
             raise ValueError(

lazyscribe_arrow/protocols.py

@@ -0,0 +1,38 @@
+"""Arrow exportable protocols."""
+
+from __future__ import annotations
+
+from typing import Protocol, runtime_checkable
+
+
+@runtime_checkable
+class ArrowArrayExportable(Protocol):
+    """Type protocol for Arrow C Data Interface via Arrow PyCapsule Interface."""
+
+    def __arrow_c_array__(
+        self, requested_schema: object | None = None
+    ) -> tuple[object, object]:
+        """Export the object as a pair of ArrowSchema and ArrowArray structures."""
+        ...
+
+
+@runtime_checkable
+class ArrowStreamExportable(Protocol):
+    """Type protocol for Arrow C Stream Interface via Arrow PyCapsule Interface."""
+
+    def __arrow_c_stream__(self, requested_schema: object | None = None) -> object:
+        """Export the object as an ArrowArrayStream."""
+        ...
+
+
+@runtime_checkable
+class SupportsInterchange(Protocol):
+    """Dataframe that supports conversion into an interchange dataframe object."""
+
+    def __dataframe__(
+        self,
+        nan_as_null: bool = False,
+        allow_copy: bool = True,
+    ) -> SupportsInterchange:
+        """Convert to a dataframe object implementing the dataframe interchange protocol."""
+        ...

{lazyscribe_arrow-0.2.0.dist-info → lazyscribe_arrow-0.2.1.dist-info}/METADATA

@@ -1,49 +1,46 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.3
 Name: lazyscribe-arrow
-Version: 0.2.0
+Version: 0.2.1
 Summary: Arrow-based artifact handlers for Lazyscribe
+Author: Akshay Gupta
 Author-email: Akshay Gupta <akgcodes@gmail.com>
 License: MIT license
-Project-URL: Documentation, https://github.com/lazyscribe/lazyscribe-arrow
-Project-URL: Repository, https://github.com/lazyscribe/lazyscribe-arrow
 Classifier: Development Status :: 3 - Alpha
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Natural Language :: English
-Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: attrs>=21.2,<=25.3
+Requires-Dist: lazyscribe>=1,<=1.2
+Requires-Dist: pyarrow>=14.0.1,<=21
+Requires-Dist: python-slugify>=5,<=8.0.4
+Requires-Dist: commitizen ; extra == 'build'
+Requires-Dist: uv ; extra == 'build'
+Requires-Dist: lazyscribe-arrow[build] ; extra == 'dev'
+Requires-Dist: lazyscribe-arrow[qa] ; extra == 'dev'
+Requires-Dist: lazyscribe-arrow[tests] ; extra == 'dev'
+Requires-Dist: edgetest ; extra == 'qa'
+Requires-Dist: mypy ; extra == 'qa'
+Requires-Dist: pre-commit ; extra == 'qa'
+Requires-Dist: pyproject-fmt ; extra == 'qa'
+Requires-Dist: ruff ; extra == 'qa'
+Requires-Dist: types-python-slugify ; extra == 'qa'
+Requires-Dist: uv ; extra == 'qa'
+Requires-Dist: pandas ; extra == 'tests'
+Requires-Dist: pytest ; extra == 'tests'
+Requires-Dist: pytest-cov ; extra == 'tests'
+Requires-Dist: time-machine ; extra == 'tests'
 Requires-Python: >=3.10.0
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: attrs<=25.1.0,>=21.2.0
-Requires-Dist: lazyscribe<=1.1.0,>=1.0.0
-Requires-Dist: pyarrow<=19.0.1,>=14.0.1
-Requires-Dist: python-slugify<=8.0.4,>=5.0.0
+Project-URL: Documentation, https://github.com/lazyscribe/lazyscribe-arrow
+Project-URL: Repository, https://github.com/lazyscribe/lazyscribe-arrow
 Provides-Extra: build
-Requires-Dist: build; extra == "build"
-Requires-Dist: commitizen; extra == "build"
-Requires-Dist: twine; extra == "build"
-Requires-Dist: wheel; extra == "build"
+Provides-Extra: dev
 Provides-Extra: qa
-Requires-Dist: edgetest; extra == "qa"
-Requires-Dist: mypy; extra == "qa"
-Requires-Dist: pre-commit; extra == "qa"
-Requires-Dist: ruff; extra == "qa"
-Requires-Dist: types-python-slugify; extra == "qa"
-Requires-Dist: uv; extra == "qa"
 Provides-Extra: tests
-Requires-Dist: pandas; extra == "tests"
-Requires-Dist: pytest; extra == "tests"
-Requires-Dist: pytest-cov; extra == "tests"
-Requires-Dist: time-machine; extra == "tests"
-Provides-Extra: dev
-Requires-Dist: lazyscribe-arrow[build]; extra == "dev"
-Requires-Dist: lazyscribe-arrow[qa]; extra == "dev"
-Requires-Dist: lazyscribe-arrow[tests]; extra == "dev"
-Dynamic: license-file
+Description-Content-Type: text/markdown
 
 [![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) [![PyPI](https://img.shields.io/pypi/v/lazyscribe-arrow)](https://pypi.org/project/lazyscribe-arrow/) [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/lazyscribe-arrow)](https://pypi.org/project/lazyscrib-arrow/) [![codecov](https://codecov.io/gh/lazyscribe/lazyscribe-arrow/graph/badge.svg?token=W5TPK7GX7G)](https://codecov.io/gh/lazyscribe/lazyscribe-arrow)
 

lazyscribe_arrow-0.2.1.dist-info/RECORD

@@ -0,0 +1,9 @@
+lazyscribe_arrow/__init__.py,sha256=YwnXVqIllCJKZakHtTtDsWh_raw0HGqG8lgsUfCH9FQ,199
+lazyscribe_arrow/_meta.py,sha256=5ldinxF7m6V5dgpN2M5yw54r8bPkiGNJFgWiMlNj7Ag,38
+lazyscribe_arrow/csv.py,sha256=55GIciGtui9sd2l0GdhSXpGaLTenMwxtUbJjboqMDi4,3278
+lazyscribe_arrow/parquet.py,sha256=C_MofzAUqG5UlOG8NW4odlK_rTm0a4HjlhOZed94Row,3413
+lazyscribe_arrow/protocols.py,sha256=VsG6t1em4qsTRwrDvph1aQdTKjFXCjjAcuvwFuay-8Y,1147
+lazyscribe_arrow-0.2.1.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
+lazyscribe_arrow-0.2.1.dist-info/entry_points.txt,sha256=OZeI9uVR1xkCYghXAwtsGStl5ItRE3UZ-BgabZufeyc,106
+lazyscribe_arrow-0.2.1.dist-info/METADATA,sha256=6-F4cGUJ6-QqlJSRcZiQ13hIWW-IUHoCa8veRMUwTqs,3237
+lazyscribe_arrow-0.2.1.dist-info/RECORD,,

lazyscribe_arrow-0.2.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.8.24
+Root-Is-Purelib: true
+Tag: py3-none-any

{lazyscribe_arrow-0.2.0.dist-info → lazyscribe_arrow-0.2.1.dist-info}/entry_points.txt

@@ -1,3 +1,4 @@
 [lazyscribe.artifact_type]
 csv = lazyscribe_arrow:CSVArtifact
 parquet = lazyscribe_arrow:ParquetArtifact
+

lazyscribe_arrow-0.2.0.dist-info/RECORD

@@ -1,10 +0,0 @@
-lazyscribe_arrow/__init__.py,sha256=YwnXVqIllCJKZakHtTtDsWh_raw0HGqG8lgsUfCH9FQ,199
-lazyscribe_arrow/_meta.py,sha256=tkM0F11odKeRd4ewZf6_GEIFshm_W68xXAjlwEu59xQ,38
-lazyscribe_arrow/csv.py,sha256=cyMcFC9S0tR2U7C5EWTsvQZETgU54fronafmn2LQbSA,3158
-lazyscribe_arrow/parquet.py,sha256=J3AqMvV77wSDW8FQYJE8xjidC5v8Zg4tvgCYh11_1LM,3293
-lazyscribe_arrow-0.2.0.dist-info/licenses/LICENSE,sha256=CbVwVKAq7TtkHhzCxwB5N86wxbkcn2VMP5UTxj3NgZo,1067
-lazyscribe_arrow-0.2.0.dist-info/METADATA,sha256=TqG43wfVq499R4vLnaNUjs5wnEhga6NOcl5BLoN33a0,3347
-lazyscribe_arrow-0.2.0.dist-info/WHEEL,sha256=0CuiUZ_p9E4cD6NyLD6UG80LBXYyiSYZOKDm5lp32xk,91
-lazyscribe_arrow-0.2.0.dist-info/entry_points.txt,sha256=GBZx4whc5e9t2mDuCxaBlYX0yHJKmnNwqczLob2TFfI,105
-lazyscribe_arrow-0.2.0.dist-info/top_level.txt,sha256=C_ElBcqIKkSjUmMQPDECDhhP54M7muep1KLnEiFJ61I,17
-lazyscribe_arrow-0.2.0.dist-info/RECORD,,

lazyscribe_arrow-0.2.0.dist-info/WHEEL

@@ -1,5 +0,0 @@
-Wheel-Version: 1.0
-Generator: setuptools (80.3.1)
-Root-Is-Purelib: true
-Tag: py3-none-any
-

lazyscribe_arrow-0.2.0.dist-info/licenses/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 lazyscribe
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

lazyscribe_arrow-0.2.0.dist-info/top_level.txt

@@ -1 +0,0 @@
-lazyscribe_arrow