python-calamine 0.8.2__cp314-cp314-pyemscripten_2026_0_wasm32.whl

python_calamine/__init__.py

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

python_calamine/_python_calamine.pyi

@@ -0,0 +1,316 @@
+# Some documentations from upstream under MIT License. See authors in https://github.com/tafia/calamine
+from __future__ import annotations
+
+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 = ...
+    """Visible."""
+    Hidden = ...
+    """Hidden."""
+    VeryHidden = ...
+    """The sheet is hidden and cannot be displayed using the user interface. It is supported only by Excel formats."""
+
+@typing.final
+class SheetMetadata:
+    name: str
+    """Name of sheet."""
+    typ: SheetTypeEnum
+    """Type of sheet.
+
+    Only Excel formats support this. Default value for ODS is `WorkSheet`.
+    """
+    visible: SheetVisibleEnum
+    """Visible of sheet."""
+
+    def __new__(
+        cls, name: str, typ: SheetTypeEnum, visible: SheetVisibleEnum
+    ) -> SheetMetadata: ...
+
+@typing.final
+class CalamineSheet:
+    name: str
+    @property
+    def height(self) -> int:
+        """Get the row height of a sheet data.
+
+        The height is defined as the number of rows between the start and end positions.
+        """
+
+    @property
+    def width(self) -> int:
+        """Get the column width of a sheet data.
+
+        The width is defined as the number of columns between the start and end positions.
+        """
+
+    @property
+    def total_height(self) -> int: ...
+    @property
+    def total_width(self) -> int: ...
+    @property
+    def start(self) -> tuple[int, int] | None:
+        """Get top left cell position of a sheet data."""
+
+    @property
+    def end(self) -> tuple[int, int] | None:
+        """Get bottom right cell position of a sheet data."""
+
+    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
+        ]
+    ]:
+        """Returning 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
+        ]
+    ]:
+        """Returning 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 unsupported format
+        """
+
+@typing.final
+class CalamineTable:
+    name: str
+    """Get the name of the table."""
+    sheet: str
+    """Get the name of the parent worksheet for a table."""
+    columns: list[str]
+    """Get the header names of the table columns.
+
+    In Excel table headers can be hidden but the table will still have
+    column header names.
+    """
+    @property
+    def height(self) -> int:
+        """Get the row height of a table data.
+
+        The height is defined as the number of rows between the start and end positions.
+        """
+
+    @property
+    def width(self) -> int:
+        """Get the column width of a table data.
+
+        The width is defined as the number of columns between the start and end positions.
+        """
+
+    @property
+    def start(self) -> tuple[int, int] | None:
+        """Get top left cell position of a table data."""
+
+    @property
+    def end(self) -> tuple[int, int] | None:
+        """Get bottom right cell position of a table data."""
+
+    def to_python(
+        self,
+    ) -> list[
+        list[
+            int
+            | float
+            | str
+            | bool
+            | datetime.time
+            | datetime.date
+            | datetime.datetime
+            | datetime.timedelta
+        ]
+    ]:
+        """Returning data from table as list of lists."""
+
+@typing.final
+class CalamineWorkbook:
+    path: str | None
+    """Path to file. `None` if bytes was loaded."""
+    sheet_names: list[str]
+    """All sheet names of this workbook, in workbook order."""
+    sheets_metadata: list[SheetMetadata]
+    """All sheets metadata of this workbook, in workbook order."""
+    table_names: list[str] | None
+    """All table names of this workbook."""
+    @classmethod
+    def from_object(
+        cls, path_or_filelike: str | os.PathLike | ReadBuffer, load_tables: bool = False
+    ) -> "CalamineWorkbook":
+        """Determining type of pyobject and reading from it.
+
+        Args:
+            path_or_filelike (str | os.PathLike | ReadBuffer): path to file or IO (must implement read/seek methods).
+            load_tables (bool): load Excel tables (supported for XLSX only).
+        """
+
+    @classmethod
+    def from_path(
+        cls, path: str | os.PathLike, load_tables: bool = False
+    ) -> "CalamineWorkbook":
+        """Reading file from path.
+
+        Args:
+            path (str | os.PathLike): path to file.
+            load_tables (bool): load Excel tables (supported for XLSX only).
+        """
+
+    @classmethod
+    def from_filelike(
+        cls, filelike: ReadBuffer, load_tables: bool = False
+    ) -> "CalamineWorkbook":
+        """Reading file from IO.
+
+        Args:
+            filelike : IO (must implement read/seek methods).
+            load_tables (bool): load Excel tables (supported for XLSX only).
+        """
+
+    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.
+        """
+
+    def get_table_by_name(self, name: str) -> CalamineTable:
+        """Get table by name.
+
+        Args:
+            name(str): name of table
+
+        Returns:
+            CalamineTable
+
+        Raises:
+            WorkbookClosed: If workbook already closed.
+            TableNotFound: If table not found in workbook.
+        """
+
+class CalamineError(Exception): ...
+class PasswordError(CalamineError): ...
+class WorksheetNotFound(CalamineError): ...
+class XmlError(CalamineError): ...
+class ZipError(CalamineError): ...
+class WorkbookClosed(CalamineError): ...
+class TablesNotLoaded(CalamineError): ...
+class TablesNotSupported(CalamineError): ...
+class TableNotFound(CalamineError): ...
+
+def load_workbook(
+    path_or_filelike: str | os.PathLike | ReadBuffer, load_tables: bool = False
+) -> CalamineWorkbook:
+    """Determining type of pyobject and reading from it.
+
+    Args:
+        path_or_filelike (str | os.PathLike | ReadBuffer): path to file or IO (must implement read/seek methods).
+        load_tables (bool): load Excel tables (supported for XLSX only).
+    """
+
+__all__ = [
+    "CalamineError",
+    "CalamineSheet",
+    "CalamineTable",
+    "CalamineWorkbook",
+    "PasswordError",
+    "SheetMetadata",
+    "SheetTypeEnum",
+    "SheetVisibleEnum",
+    "TableNotFound",
+    "TablesNotLoaded",
+    "TablesNotSupported",
+    "WorkbookClosed",
+    "WorksheetNotFound",
+    "XmlError",
+    "ZipError",
+    "load_workbook",
+]

python_calamine-0.8.2.dist-info/METADATA

@@ -0,0 +1,94 @@
+Metadata-Version: 2.4
+Name: python-calamine
+Version: 0.8.2
+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.8.2.dist-info/RECORD

@@ -0,0 +1,9 @@
+python_calamine/__init__.py,sha256=u_sVBmGMWv0DVSE_RrGrIUe0tCYKlb4IxS9G5bvNFoo,705
+python_calamine/_python_calamine.cpython-314-wasm32-emscripten.so,sha256=DPYg6eif_KYiOLkeNV0yzyIEyQ4ThtnNZMEYDeT2d1M,1208972
+python_calamine/_python_calamine.pyi,sha256=6mXUIWf-DEP4MuhHtjBsPyzqiwp5NaaBOjaqTcI2l7g,8737
+python_calamine/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+python_calamine-0.8.2.dist-info/METADATA,sha256=3Jf7vXAo8yXPOCWS3cJoEAUaKdL_i6bcALZM17qzSs4,3097
+python_calamine-0.8.2.dist-info/WHEEL,sha256=GQD9tGGc3KqnnBNGVglyttmwhVEMgEcjJQVH4Tkcdks,114
+python_calamine-0.8.2.dist-info/licenses/LICENSE,sha256=bO1GQBYjM6fIgNRdNGrohAl0Zwn6_s5hMDdovIfYC_A,1065
+python_calamine-0.8.2.dist-info/sboms/python-calamine.cyclonedx.json,sha256=R9Gm5X5RkgpBoLYJth8ZE9-oqe3g27mLKdupmAu5sLI,49748
+python_calamine-0.8.2.dist-info/RECORD,,

python_calamine-0.8.2.dist-info/WHEEL

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

python_calamine-0.8.2.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.