openexcel-c 0.1.1__tar.gz

openexcel_c-0.1.1/.github/workflows/publish.yml

@@ -0,0 +1,76 @@
+name: Build and publish
+
+on:
+  push:
+    tags:
+      - "v*"
+  pull_request:        # also build (but don't publish) on every PR to catch compile errors early
+  workflow_dispatch:   # allow manual trigger from GitHub UI
+
+jobs:
+  build_wheels:
+    name: Build wheels on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up QEMU
+        if: runner.os == 'Linux'
+        uses: docker/setup-qemu-action@v3
+        with:
+          platforms: arm64
+
+      - name: Build wheels
+        uses: pypa/cibuildwheel@v2.21.3
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.os }}
+          path: ./wheelhouse/*.whl
+
+  build_sdist:
+    name: Build source distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install build
+        run: pip install build
+
+      - name: Build sdist
+        run: python -m build --sdist
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+
+  publish:
+    name: Publish to PyPI
+    needs: [build_wheels, build_sdist]
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+    environment:
+      name: pypi
+      url: https://pypi.org/p/openexcel-c
+    permissions:
+      id-token: write   # required for Trusted Publisher (OIDC)
+
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-*
+          merge-multiple: true
+          path: dist/
+
+      - uses: actions/download-artifact@v4
+        with:
+          name: sdist
+          path: dist/
+
+      - uses: pypa/gh-action-pypi-publish@release/v1

openexcel_c-0.1.1/.gitignore

@@ -0,0 +1,16 @@
+__pycache__/
+*.py[cod]
+*.so
+*.dylib
+*.dll
+build/
+dist/
+*.egg-info/
+.eggs/
+_skbuild/
+_cmake_test_compile/
+CMakeFiles/
+CMakeCache.txt
+cmake_install.cmake
+Makefile
+tests/fixtures/large_100k.xlsx

openexcel_c-0.1.1/CMakeLists.txt

@@ -0,0 +1,50 @@
+cmake_minimum_required(VERSION 3.20)
+project(openexcel C)
+
+find_package(Python REQUIRED COMPONENTS Interpreter Development.Module)
+find_package(EXPAT REQUIRED)
+
+set(OPENEXCEL_SOURCES
+    src/_openexcel/module.c
+    src/_openexcel/workbook.c
+    src/_openexcel/worksheet.c
+    src/_openexcel/cell.c
+    src/_openexcel/string_table.c
+    src/_openexcel/styles.c
+    src/_openexcel/reader/reader.c
+    src/_openexcel/reader/zip_reader.c
+    src/_openexcel/reader/xml_workbook.c
+    src/_openexcel/reader/xml_sst.c
+    src/_openexcel/reader/xml_styles.c
+    src/_openexcel/reader/xml_sheet.c
+    src/_openexcel/writer/writer.c
+    src/_openexcel/writer/zip_writer.c
+    src/_openexcel/writer/xml_gen.c
+    src/_openexcel/writer/sheet_writer.c
+    src/_openexcel/writer/sst_writer.c
+    src/_openexcel/third_party/miniz.c
+    src/_openexcel/third_party/miniz_tdef.c
+    src/_openexcel/third_party/miniz_tinfl.c
+    src/_openexcel/third_party/miniz_zip.c
+)
+
+python_add_library(_openexcel MODULE WITH_SOABI ${OPENEXCEL_SOURCES})
+
+target_include_directories(_openexcel PRIVATE
+    src/_openexcel
+    src/_openexcel/third_party
+)
+
+target_link_libraries(_openexcel PRIVATE EXPAT::EXPAT)
+
+target_compile_options(_openexcel PRIVATE
+    -O3
+    -Wall
+    -Wextra
+    -Wno-unused-parameter
+    -Wno-cast-function-type
+    -Wno-missing-field-initializers
+    $<$<C_COMPILER_ID:GNU,Clang>:-fvisibility=hidden>
+)
+
+install(TARGETS _openexcel DESTINATION openexcel)

openexcel_c-0.1.1/LICENSE

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

openexcel_c-0.1.1/PKG-INFO

@@ -0,0 +1,193 @@
+Metadata-Version: 2.2
+Name: openexcel-c
+Version: 0.1.1
+Summary: High-performance .xlsx reader/writer (C extension)
+Keywords: xlsx,excel,spreadsheet,openpyxl,performance
+Author-Email: Karun Gopal <karun.gopal@gmail.com>
+License: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: C
+Classifier: Programming Language :: Python :: 3
+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: Topic :: Office/Business :: Financial :: Spreadsheet
+Classifier: Operating System :: OS Independent
+Project-URL: Homepage, https://github.com/karungop/openexCel
+Project-URL: Repository, https://github.com/karungop/openexCel
+Project-URL: Issues, https://github.com/karungop/openexCel/issues
+Requires-Python: >=3.10
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-benchmark; extra == "dev"
+Requires-Dist: openpyxl; extra == "dev"
+Description-Content-Type: text/markdown
+
+# openexcel
+
+A high-performance Python library for reading and writing `.xlsx` files, implemented as a C extension. Designed as a drop-in accelerator for workloads where [openpyxl](https://openpyxl.readthedocs.io/) is too slow.
+
+## Why
+
+openpyxl is pure Python. For large files (100k+ rows), the bottlenecks are ZIP extraction, XML parsing, and per-cell object allocation — all done in the Python interpreter. openexcel moves these to C:
+
+- **Streaming SAX parsing** via libexpat — never loads the full XML into memory
+- **Flat sorted cell array** — O(1) append during parse, O(1) sequential iteration
+- **GIL released** during read and write — other threads run freely
+- **Vendored miniz** — no external ZIP dependency
+
+Typical speedups: **10–30× faster reads**, **5–15× faster writes** on 100k-row sheets.
+
+## Installation
+
+```bash
+pip install openexcel-c
+```
+
+Pre-built wheels are available for macOS (arm64, x86_64) and Linux (x86_64, aarch64) for Python 3.10–3.13.
+
+### Building from source
+
+You need CMake ≥ 3.20, a C11 compiler, and libexpat development headers.
+
+```bash
+# macOS
+brew install expat cmake
+
+# Ubuntu/Debian
+sudo apt-get install libexpat1-dev cmake
+
+pip install openexcel-c --no-binary openexcel-c
+```
+
+## Usage
+
+### Reading
+
+```python
+import openexcel
+
+wb = openexcel.load_workbook("data.xlsx")
+ws = wb.active   # first sheet
+
+# Iterate rows — returns tuples of Python values
+for row in ws.iter_rows():
+    print(row)   # e.g. (1, "hello", 3.14, True, datetime.date(2024, 6, 1))
+
+# Slice a range
+for row in ws.iter_rows(min_row=2, max_row=100, min_col=1, max_col=5):
+    print(row)
+```
+
+Cell values map to Python types:
+
+| Excel type | Python type |
+|---|---|
+| Number | `float` |
+| String | `str` |
+| Boolean | `bool` |
+| Date / datetime | `datetime.date` / `datetime.datetime` |
+| Empty | `None` |
+| Error | `str` (e.g. `"#DIV/0!"`) |
+
+### Writing
+
+```python
+import openexcel
+import datetime
+
+wb = openexcel.Workbook()
+ws = wb.create_sheet("Sheet1")
+
+ws.append(["Name", "Score", "Date"])
+ws.append(["Alice", 98.5, datetime.date(2024, 6, 1)])
+ws.append(["Bob",   72.0, datetime.date(2024, 6, 2)])
+
+wb.save("output.xlsx")
+```
+
+### Multiple sheets
+
+```python
+wb = openexcel.load_workbook("multi.xlsx")
+
+# By index
+ws = wb[0]
+
+# By name
+ws = wb["Summary"]
+
+# Iterate all sheets
+for ws in wb:
+    print(ws.title, ws.max_row, ws.max_column)
+```
+
+### Context manager
+
+```python
+with openexcel.load_workbook("data.xlsx") as wb:
+    ws = wb.active
+    data = [row for row in ws.iter_rows()]
+# file resources released on exit
+```
+
+## API reference
+
+### `openexcel.load_workbook(path: str) -> Workbook`
+
+Open an existing `.xlsx` file for reading. Parses the entire file on load; subsequent access is from memory.
+
+### `openexcel.Workbook()`
+
+Create a new empty workbook.
+
+### `Workbook.create_sheet(name: str) -> Worksheet`
+
+Add a new sheet and return it.
+
+### `Workbook.save(path: str)`
+
+Write the workbook to an `.xlsx` file. GIL is released during write.
+
+### `Workbook.active -> Worksheet`
+
+Returns the first sheet.
+
+### `Worksheet.iter_rows(min_row=None, max_row=None, min_col=None, max_col=None)`
+
+Yields one tuple per row. Indices are 1-based and inclusive, matching openpyxl's convention.
+
+### `Worksheet.append(row: list | tuple)`
+
+Append a row of values. Accepts `int`, `float`, `str`, `bool`, `None`, `datetime.date`, `datetime.datetime`.
+
+### `Worksheet.max_row -> int`
+
+### `Worksheet.max_column -> int`
+
+### `Worksheet.title -> str`
+
+## Differences from openpyxl
+
+| Feature | openexcel | openpyxl |
+|---|---|---|
+| Read speed | **Fast** (C, SAX) | Slow (pure Python) |
+| Write speed | **Fast** (C, arena buffer) | Slow (pure Python) |
+| Cell objects | Not exposed (values only) | Full `Cell` with font/fill/border |
+| Formulas | Read result value only | Read formula string |
+| Styles / formatting | Date detection only | Full style API |
+| Merged cells | Not supported | Supported |
+| Charts / images | Not supported | Supported |
+
+openexcel is optimized for **data workloads** — reading and writing large tables of values. If you need full formatting control or chart support, use openpyxl.
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+Vendored dependencies:
+- [miniz](https://github.com/richgel999/miniz) — public domain
+- [khash](https://github.com/attractivechaos/klib) — MIT

openexcel_c-0.1.1/README.md

@@ -0,0 +1,165 @@
+# openexcel
+
+A high-performance Python library for reading and writing `.xlsx` files, implemented as a C extension. Designed as a drop-in accelerator for workloads where [openpyxl](https://openpyxl.readthedocs.io/) is too slow.
+
+## Why
+
+openpyxl is pure Python. For large files (100k+ rows), the bottlenecks are ZIP extraction, XML parsing, and per-cell object allocation — all done in the Python interpreter. openexcel moves these to C:
+
+- **Streaming SAX parsing** via libexpat — never loads the full XML into memory
+- **Flat sorted cell array** — O(1) append during parse, O(1) sequential iteration
+- **GIL released** during read and write — other threads run freely
+- **Vendored miniz** — no external ZIP dependency
+
+Typical speedups: **10–30× faster reads**, **5–15× faster writes** on 100k-row sheets.
+
+## Installation
+
+```bash
+pip install openexcel-c
+```
+
+Pre-built wheels are available for macOS (arm64, x86_64) and Linux (x86_64, aarch64) for Python 3.10–3.13.
+
+### Building from source
+
+You need CMake ≥ 3.20, a C11 compiler, and libexpat development headers.
+
+```bash
+# macOS
+brew install expat cmake
+
+# Ubuntu/Debian
+sudo apt-get install libexpat1-dev cmake
+
+pip install openexcel-c --no-binary openexcel-c
+```
+
+## Usage
+
+### Reading
+
+```python
+import openexcel
+
+wb = openexcel.load_workbook("data.xlsx")
+ws = wb.active   # first sheet
+
+# Iterate rows — returns tuples of Python values
+for row in ws.iter_rows():
+    print(row)   # e.g. (1, "hello", 3.14, True, datetime.date(2024, 6, 1))
+
+# Slice a range
+for row in ws.iter_rows(min_row=2, max_row=100, min_col=1, max_col=5):
+    print(row)
+```
+
+Cell values map to Python types:
+
+| Excel type | Python type |
+|---|---|
+| Number | `float` |
+| String | `str` |
+| Boolean | `bool` |
+| Date / datetime | `datetime.date` / `datetime.datetime` |
+| Empty | `None` |
+| Error | `str` (e.g. `"#DIV/0!"`) |
+
+### Writing
+
+```python
+import openexcel
+import datetime
+
+wb = openexcel.Workbook()
+ws = wb.create_sheet("Sheet1")
+
+ws.append(["Name", "Score", "Date"])
+ws.append(["Alice", 98.5, datetime.date(2024, 6, 1)])
+ws.append(["Bob",   72.0, datetime.date(2024, 6, 2)])
+
+wb.save("output.xlsx")
+```
+
+### Multiple sheets
+
+```python
+wb = openexcel.load_workbook("multi.xlsx")
+
+# By index
+ws = wb[0]
+
+# By name
+ws = wb["Summary"]
+
+# Iterate all sheets
+for ws in wb:
+    print(ws.title, ws.max_row, ws.max_column)
+```
+
+### Context manager
+
+```python
+with openexcel.load_workbook("data.xlsx") as wb:
+    ws = wb.active
+    data = [row for row in ws.iter_rows()]
+# file resources released on exit
+```
+
+## API reference
+
+### `openexcel.load_workbook(path: str) -> Workbook`
+
+Open an existing `.xlsx` file for reading. Parses the entire file on load; subsequent access is from memory.
+
+### `openexcel.Workbook()`
+
+Create a new empty workbook.
+
+### `Workbook.create_sheet(name: str) -> Worksheet`
+
+Add a new sheet and return it.
+
+### `Workbook.save(path: str)`
+
+Write the workbook to an `.xlsx` file. GIL is released during write.
+
+### `Workbook.active -> Worksheet`
+
+Returns the first sheet.
+
+### `Worksheet.iter_rows(min_row=None, max_row=None, min_col=None, max_col=None)`
+
+Yields one tuple per row. Indices are 1-based and inclusive, matching openpyxl's convention.
+
+### `Worksheet.append(row: list | tuple)`
+
+Append a row of values. Accepts `int`, `float`, `str`, `bool`, `None`, `datetime.date`, `datetime.datetime`.
+
+### `Worksheet.max_row -> int`
+
+### `Worksheet.max_column -> int`
+
+### `Worksheet.title -> str`
+
+## Differences from openpyxl
+
+| Feature | openexcel | openpyxl |
+|---|---|---|
+| Read speed | **Fast** (C, SAX) | Slow (pure Python) |
+| Write speed | **Fast** (C, arena buffer) | Slow (pure Python) |
+| Cell objects | Not exposed (values only) | Full `Cell` with font/fill/border |
+| Formulas | Read result value only | Read formula string |
+| Styles / formatting | Date detection only | Full style API |
+| Merged cells | Not supported | Supported |
+| Charts / images | Not supported | Supported |
+
+openexcel is optimized for **data workloads** — reading and writing large tables of values. If you need full formatting control or chart support, use openpyxl.
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+Vendored dependencies:
+- [miniz](https://github.com/richgel999/miniz) — public domain
+- [khash](https://github.com/attractivechaos/klib) — MIT

openexcel_c-0.1.1/pyproject.toml

@@ -0,0 +1,58 @@
+[build-system]
+requires = ["scikit-build-core>=0.9"]
+build-backend = "scikit_build_core.build"
+
+[project]
+name = "openexcel-c"
+version = "0.1.1"
+description = "High-performance .xlsx reader/writer (C extension)"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+authors = [
+    { name = "Karun Gopal", email = "karun.gopal@gmail.com" }
+]
+keywords = ["xlsx", "excel", "spreadsheet", "openpyxl", "performance"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: C",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Office/Business :: Financial :: Spreadsheet",
+    "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://github.com/karungop/openexCel"
+Repository = "https://github.com/karungop/openexCel"
+Issues = "https://github.com/karungop/openexCel/issues"
+
+[project.optional-dependencies]
+dev = ["pytest", "pytest-benchmark", "openpyxl"]
+
+[tool.scikit-build]
+cmake.build-type = "Release"
+wheel.packages = ["src/openexcel"]
+
+[tool.cibuildwheel]
+# Build CPython 3.10-3.13 only (no PyPy — C extension relies on CPython internals)
+build = "cp310-* cp311-* cp312-* cp313-*"
+# Skip 32-bit builds and musl libc (Alpine) — not worth the effort for v0.1
+skip = "*-manylinux_i686 *-musllinux*"
+
+[tool.cibuildwheel.linux]
+# expat-devel is available in the manylinux2014 image via yum
+before-build = "yum install -y expat-devel || (apt-get update && apt-get install -y libexpat1-dev)"
+# Build for both x86_64 and arm64 using QEMU emulation
+archs = ["x86_64", "aarch64"]
+
+[tool.cibuildwheel.macos]
+# Homebrew expat is installed in the macos-latest runner image
+before-build = "brew install expat || true"
+# Build native arm64 and cross-compile x86_64
+archs = ["arm64", "x86_64"]

openexcel_c-0.1.1/src/_openexcel/cell.c

@@ -0,0 +1,103 @@
+#include "cell.h"
+#include <stdlib.h>
+#include <string.h>
+
+/* Excel's 1900 date system has a deliberate bug: it treats 1900 as a leap year.
+   Day 1 = 1900-01-01, Day 60 = 1900-02-29 (doesn't exist), Day 61 = 1900-03-01. */
+
+static int is_leap(int y) {
+    return (y % 4 == 0 && y % 100 != 0) || (y % 400 == 0);
+}
+
+static int days_in_month(int m, int y) {
+    static const int dim[] = {31,28,31,30,31,30,31,31,30,31,30,31};
+    if (m == 2 && is_leap(y)) return 29;
+    return dim[m - 1];
+}
+
+OxlDate oxl_serial_to_date(double serial, int date1904) {
+    OxlDate d = {0};
+    if (serial < 0.0) return d;
+
+    long day_part;
+    double frac;
+
+    if (date1904) {
+        /* 1904 system: day 0 = 1904-01-01 */
+        day_part = (long)serial;
+        frac = serial - day_part;
+        int year = 1904, month = 1, day = 1;
+        while (day_part > 0) {
+            int dim = days_in_month(month, year);
+            if (day_part <= dim) { day = (int)day_part; break; }
+            day_part -= dim;
+            month++;
+            if (month > 12) { month = 1; year++; }
+        }
+        d.year = (int16_t)year;
+        d.month = (uint8_t)month;
+        d.day = (uint8_t)day;
+    } else {
+        /* 1900 system: skip the phantom day 60 (1900-02-29) */
+        if (serial >= 60.0) serial -= 1.0;
+        day_part = (long)serial;
+        frac = serial - (double)(long)serial;
+        /* day 1 = 1899-12-31; so day_part days after that */
+        int year = 1899, month = 12, day = 31;
+        while (day_part > 0) {
+            int dim = days_in_month(month, year);
+            int remaining = dim - day;
+            if (day_part <= remaining) { day += (int)day_part; day_part = 0; }
+            else {
+                day_part -= remaining + 1;
+                day = 1;
+                month++;
+                if (month > 12) { month = 1; year++; }
+            }
+        }
+        d.year = (int16_t)year;
+        d.month = (uint8_t)month;
+        d.day = (uint8_t)day;
+    }
+
+    /* time from fractional part */
+    long total_sec = (long)(frac * 86400.0 + 0.5);
+    d.hour = (uint8_t)(total_sec / 3600);
+    d.min  = (uint8_t)((total_sec % 3600) / 60);
+    d.sec  = (uint8_t)(total_sec % 60);
+    return d;
+}
+
+double oxl_date_to_serial(OxlDate d, int date1904) {
+    /* Count days from epoch to d.year-d.month-d.day */
+    long days = 0;
+    int base_year, base_month, base_day;
+
+    if (date1904) {
+        base_year = 1904; base_month = 1; base_day = 1;
+    } else {
+        base_year = 1899; base_month = 12; base_day = 31;
+    }
+
+    int y = base_year, m = base_month, day = base_day;
+    while (y < d.year || (y == d.year && m < d.month) ||
+           (y == d.year && m == d.month && day < d.day)) {
+        days++;
+        day++;
+        if (day > days_in_month(m, y)) { day = 1; m++; }
+        if (m > 12) { m = 1; y++; }
+    }
+
+    if (!date1904 && days >= 59) days++; /* re-insert the phantom day 60 */
+
+    double frac = d.hour / 24.0 + d.min / 1440.0 + d.sec / 86400.0;
+    return (double)days + frac;
+}
+
+void oxl_cell_free(OxlCell *c) {
+    if (!c) return;
+    if (c->type == OXL_CELL_INLINE_STR || c->type == OXL_CELL_ERROR) {
+        free(c->v.s_inline);
+        c->v.s_inline = NULL;
+    }
+}