python-calamine 0.5.4__cp314-cp314-win_amd64.whl

python_calamine/__init__.py

@@ -0,0 +1,29 @@
+from ._python_calamine import (
+    CalamineError,
+    CalamineSheet,
+    CalamineWorkbook,
+    PasswordError,
+    SheetMetadata,
+    SheetTypeEnum,
+    SheetVisibleEnum,
+    WorkbookClosed,
+    WorksheetNotFound,
+    XmlError,
+    ZipError,
+    load_workbook,
+)
+
+__all__ = (
+    "CalamineError",
+    "CalamineSheet",
+    "CalamineWorkbook",
+    "PasswordError",
+    "SheetMetadata",
+    "SheetTypeEnum",
+    "SheetVisibleEnum",
+    "WorksheetNotFound",
+    "XmlError",
+    "ZipError",
+    "WorkbookClosed",
+    "load_workbook",
+)

python_calamine/_python_calamine.pyi

@@ -0,0 +1,194 @@
+from __future__ import annotations
+
+import contextlib
+import datetime
+import enum
+import os
+import types
+import typing
+
+@typing.type_check_only
+class ReadBuffer(typing.Protocol):
+    def seek(self, __offset: int, __whence: int = ...) -> int: ...
+    def read(self, __size: int = ...) -> bytes | None: ...
+
+@typing.final
+class SheetTypeEnum(enum.Enum):
+    WorkSheet = ...
+    DialogSheet = ...
+    MacroSheet = ...
+    ChartSheet = ...
+    Vba = ...
+
+@typing.final
+class SheetVisibleEnum(enum.Enum):
+    Visible = ...
+    Hidden = ...
+    VeryHidden = ...
+
+@typing.final
+class SheetMetadata:
+    name: str
+    typ: SheetTypeEnum
+    visible: SheetVisibleEnum
+
+    def __init__(
+        self, name: str, typ: SheetTypeEnum, visible: SheetVisibleEnum
+    ) -> None: ...
+
+@typing.final
+class CalamineSheet:
+    name: str
+    @property
+    def height(self) -> int: ...
+    @property
+    def width(self) -> int: ...
+    @property
+    def total_height(self) -> int: ...
+    @property
+    def total_width(self) -> int: ...
+    @property
+    def start(self) -> tuple[int, int] | None: ...
+    @property
+    def end(self) -> tuple[int, int] | None: ...
+    def to_python(
+        self, skip_empty_area: bool = True, nrows: int | None = None
+    ) -> list[
+        list[
+            int
+            | float
+            | str
+            | bool
+            | datetime.time
+            | datetime.date
+            | datetime.datetime
+            | datetime.timedelta
+        ]
+    ]:
+        """Retunrning data from sheet as list of lists.
+
+        Args:
+            skip_empty_area (bool):
+                By default, calamine skips empty rows/cols before data.
+                For suppress this behaviour, set `skip_empty_area` to `False`.
+        """
+
+    def iter_rows(
+        self,
+    ) -> typing.Iterator[
+        list[
+            int
+            | float
+            | str
+            | bool
+            | datetime.time
+            | datetime.date
+            | datetime.datetime
+            | datetime.timedelta
+        ]
+    ]:
+        """Retunrning data from sheet as iterator of lists."""
+
+    @property
+    def merged_cell_ranges(
+        self,
+    ) -> list[tuple[tuple[int, int], tuple[int, int]]] | None:
+        """Return a copy of merged cell ranges.
+
+        Support only for xlsx/xls.
+
+        Returns:
+            list of merged cell ranges (tuple[start coordinate, end coordinate]) or None for unsuported format
+        """
+
+@typing.final
+class CalamineWorkbook(contextlib.AbstractContextManager):
+    path: str | None
+    sheet_names: list[str]
+    sheets_metadata: list[SheetMetadata]
+    @classmethod
+    def from_object(
+        cls, path_or_filelike: str | os.PathLike | ReadBuffer
+    ) -> "CalamineWorkbook":
+        """Determining type of pyobject and reading from it.
+
+        Args:
+            path_or_filelike (str | os.PathLike | ReadBuffer): path to file or IO (must imlpement read/seek methods).
+        """
+
+    @classmethod
+    def from_path(cls, path: str | os.PathLike) -> "CalamineWorkbook":
+        """Reading file from path.
+
+        Args:
+            path (str | os.PathLike): path to file.
+        """
+
+    @classmethod
+    def from_filelike(cls, filelike: ReadBuffer) -> "CalamineWorkbook":
+        """Reading file from IO.
+
+        Args:
+            filelike : IO (must imlpement read/seek methods).
+        """
+
+    def close(self) -> None:
+        """Close the workbook.
+
+        Drop internal rust structure from workbook (and close the file under the hood).
+        `get_sheet_by_name`/`get_sheet_by_index` will raise WorkbookClosed after calling that method.
+
+        Raises:
+            WorkbookClosed: If workbook already closed.
+        """
+
+    def __enter__(self) -> "CalamineWorkbook": ...
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: types.TracebackType | None,
+    ) -> None: ...
+    def get_sheet_by_name(self, name: str) -> CalamineSheet:
+        """Get worksheet by name.
+
+        Args:
+            name(str): name of worksheet
+
+        Returns:
+            CalamineSheet
+
+        Raises:
+            WorkbookClosed: If workbook already closed.
+            WorksheetNotFound: If worksheet not found in workbook.
+        """
+
+    def get_sheet_by_index(self, index: int) -> CalamineSheet:
+        """Get worksheet by index.
+
+        Args:
+            index(int): index of worksheet
+
+        Returns:
+            CalamineSheet
+
+        Raises:
+            WorkbookClosed: If workbook already closed.
+            WorksheetNotFound: If worksheet not found in workbook.
+        """
+
+class CalamineError(Exception): ...
+class PasswordError(CalamineError): ...
+class WorksheetNotFound(CalamineError): ...
+class XmlError(CalamineError): ...
+class ZipError(CalamineError): ...
+class WorkbookClosed(CalamineError): ...
+
+def load_workbook(
+    path_or_filelike: str | os.PathLike | ReadBuffer,
+) -> CalamineWorkbook:
+    """Determining type of pyobject and reading from it.
+
+    Args:
+        path_or_filelike (str | os.PathLike | ReadBuffer): path to file or IO (must imlpement read/seek methods).
+    """

python_calamine-0.5.4.dist-info/METADATA

@@ -0,0 +1,94 @@
+Metadata-Version: 2.4
+Name: python-calamine
+Version: 0.5.4
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Rust
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+License-File: LICENSE
+Summary: Python binding for Rust's library for reading excel and odf file - calamine
+Author-email: Dmitriy <dimastbk@proton.me>
+License-Expression: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: homepage, https://github.com/dimastbk/python-calamine
+Project-URL: source, https://github.com/dimastbk/python-calamine
+
+# python-calamine
+[![PyPI - Version](https://img.shields.io/pypi/v/python-calamine)](https://pypi.org/project/python-calamine/)
+[![Conda Version](https://img.shields.io/conda/vn/conda-forge/python-calamine.svg)](https://anaconda.org/conda-forge/python-calamine)
+![Python Version from PEP 621 TOML](https://img.shields.io/python/required-version-toml?tomlFilePath=https%3A%2F%2Fraw.githubusercontent.com%2Fdimastbk%2Fpython-calamine%2Fmaster%2Fpyproject.toml)
+
+
+Python binding for beautiful Rust's library for reading excel and odf file - [calamine](https://github.com/tafia/calamine).
+
+### Is used
+* [calamine](https://github.com/tafia/calamine)
+* [pyo3](https://github.com/PyO3/pyo3)
+* [maturin](https://github.com/PyO3/maturin)
+
+### Installation
+Pypi:
+```
+pip install python-calamine
+```
+Conda:
+```
+conda install -c conda-forge python-calamine
+```
+
+### Example
+```python
+from python_calamine import CalamineWorkbook
+
+workbook = CalamineWorkbook.from_path("file.xlsx")
+workbook.sheet_names
+# ["Sheet1", "Sheet2"]
+
+workbook.get_sheet_by_name("Sheet1").to_python()
+# [
+# ["1",  "2",  "3",  "4",  "5",  "6",  "7"],
+# ["1",  "2",  "3",  "4",  "5",  "6",  "7"],
+# ["1",  "2",  "3",  "4",  "5",  "6",  "7"],
+# ]
+```
+
+By default, calamine skips empty rows/cols before data. For suppress this behaviour, set `skip_empty_area` to `False`.
+```python
+from python_calamine import CalamineWorkbook
+
+workbook = CalamineWorkbook.from_path("file.xlsx").get_sheet_by_name("Sheet1").to_python(skip_empty_area=False)
+# [
+# [",  ",  ",  ",  ",  ",  "],
+# ["1",  "2",  "3",  "4",  "5",  "6",  "7"],
+# ["1",  "2",  "3",  "4",  "5",  "6",  "7"],
+# ["1",  "2",  "3",  "4",  "5",  "6",  "7"],
+# ]
+```
+
+Pandas 2.2 and above have built-in support of python-calamine.
+
+Also, you can find additional examples in [tests](https://github.com/dimastbk/python-calamine/blob/master/tests/test_base.py).
+
+### Development
+
+You'll need rust [installed](https://rustup.rs/).
+
+```shell
+# clone this repo or your fork
+git clone git@github.com:dimastbk/python-calamine.git
+cd python-calamine
+# create a new virtual env
+python3 -m venv env
+source env/bin/activate
+# install dev dependencies and install python-calamine
+pip install --group dev -e .  # required pip 25.1 and above
+# lint code
+pre-commit run --all-files
+# test code
+pytest
+```
+

python_calamine-0.5.4.dist-info/RECORD

@@ -0,0 +1,8 @@
+python_calamine-0.5.4.dist-info/METADATA,sha256=4qIwE4vvK-7u-ECbM6mLTJCrz2QgoXocJBqmpruUw7g,3171
+python_calamine-0.5.4.dist-info/WHEEL,sha256=tZ3VAZ5HuUzziFCJ2lDsDJnJO-xy4omAQIa7TJCFCZk,96
+python_calamine-0.5.4.dist-info/licenses/LICENSE,sha256=cYURXgSnjCTOT2jQ_McTGn-AhDycRqzJa11QzR38Sn4,1086
+python_calamine/__init__.py,sha256=evxSwIkpatTkygn2mRmWUYPslvdj08q_pNkayyyptfI,560
+python_calamine/_python_calamine.cp314-win_amd64.pyd,sha256=m5M3gdbQYn74t4EeJhCrmm2uGWLUyk1h8jfOl_q_XJ4,1607168
+python_calamine/_python_calamine.pyi,sha256=4kE2AwHusUij-T6XtSVhujFlPuZVm9Ywz3eIFi_yIBc,5330
+python_calamine/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+python_calamine-0.5.4.dist-info/RECORD,,

python_calamine-0.5.4.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.9.6)
+Root-Is-Purelib: false
+Tag: cp314-cp314-win_amd64

python_calamine-0.5.4.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 dimastbk
+
+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.