excel-dbapi 0.2.1__tar.gz → 0.3.0__tar.gz

excel_dbapi-0.3.0/CHANGELOG.md

@@ -0,0 +1,66 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.3.0] - 2026-04-12
+
+### Added
+- Formal SQL subset specification (`docs/SQL_SPEC.md`) with EBNF grammar
+- Parser golden tests for all statement families (SELECT, INSERT, UPDATE, DELETE, DDL)
+- Reflection helpers unit tests
+- Comprehensive low-coverage module tests (executor, backends, graph engine)
+
+### Changed
+- README restructured: limitations-first layout, Graph API moved to experimental section
+- Test coverage: 84% → 98% (397 tests)
+
+### Fixed
+- Parser tokenizer: quoted strings with embedded spaces now handled correctly
+- Parser: escaped quotes (`''`, `""`) parsed correctly in all contexts
+
+## [0.2.1] - 2026-04-12
+
+### Added
+- Project logo (modern minimalist SVG)
+- Comprehensive README documentation (WHERE operators section, Related Projects)
+- Contributing guide, Code of Conduct, Security and Support policies
+- Development tooling: Makefile, .editorconfig, pre-commit-config, codecov.yml, git-cliff config
+- GitHub issue/PR templates and project management files
+- py.typed marker for PEP 561 compliance
+- twine check step in publish workflow
+
+### Changed
+- Classifier updated from Alpha to Beta
+- Homepage metadata updated
+- Version bumped to 0.2.1
+
+### Fixed
+- Oracle review findings: rollback docs, absolute logo URLs, metadata alignment
+
+## [0.2.0] - 2026-04-12
+
+### Added
+- IN, BETWEEN, LIKE operators for SQL parser and executor
+- Test coverage reporting with Codecov CI integration
+
+### Changed
+- Version bumped from 0.1.x to 0.2.0 (skipping reserved PyPI versions)
+
+### Fixed
+- All mypy strict errors resolved; strict mode enabled in CI
+- CI: install pandas extra for test suite
+
+## [0.1.0] - 2026-04-12
+
+### Added
+- PEP 249 (DB-API 2.0) compliant driver for Excel files
+- SQL support: SELECT, INSERT, UPDATE, DELETE, CREATE TABLE, DROP TABLE
+- WHERE clauses with AND/OR, comparison operators, LIKE, IN, IS NULL/IS NOT NULL
+- ORDER BY and LIMIT for SELECT queries
+- Openpyxl engine (default) for local .xlsx files
+- Pandas engine (optional) for DataFrame-based operations
+- Microsoft Graph API engine (optional) for remote Excel files
+- Formula injection defense (enabled by default)
+- Transaction simulation (commit/rollback)
+- Reflection helpers for dialect integration
+- Metadata sheet support for schema persistence

{excel_dbapi-0.2.1 → excel_dbapi-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: excel-dbapi
-Version: 0.2.1
+Version: 0.3.0
 Summary: PEP 249 compliant DB-API driver for Excel files
 Project-URL: Homepage, https://github.com/yeongseon/excel-dbapi
 Project-URL: Repository, https://github.com/yeongseon/excel-dbapi
@@ -45,40 +45,36 @@ Description-Content-Type: text/markdown
 
 ![CI](https://github.com/yeongseon/excel-dbapi/actions/workflows/ci.yml/badge.svg)
 [![codecov](https://codecov.io/gh/yeongseon/excel-dbapi/branch/main/graph/badge.svg)](https://codecov.io/gh/yeongseon/excel-dbapi)
+[![PyPI](https://img.shields.io/pypi/v/excel-dbapi.svg)](https://pypi.org/project/excel-dbapi/)
 [![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![Docs](https://img.shields.io/badge/docs-GitHub-blue.svg)](https://github.com/yeongseon/excel-dbapi/tree/main/docs)
 
-A lightweight, Python DB-API 2.0 compliant connector for Excel files.
+A **local-first** Python DB-API 2.0 connector for Excel files.
 Use SQL to query, insert, update, and delete rows in `.xlsx` workbooks — no database server required.
 
-## Who is this for?
+## Limitations
 
-- **Data analysts** who want to query Excel files with SQL instead of manual filtering
-- **Citizen developers** automating small workflows with familiar SQL syntax
-- **Educators** teaching SQL concepts without setting up a database
-- **Prototypers** building quick data pipelines before moving to a real database
+Before you begin, understand what excel-dbapi is **not**:
+
+- **No JOIN, GROUP BY, HAVING, DISTINCT, or subqueries** — single-table operations only
+- **No concurrent writes** — use a single-writer model
+- **Not for large datasets** — if your Excel file has 100k+ rows, use pandas directly or a database
+- **No transactional rollback guarantees** — rollback restores an in-memory snapshot, not a WAL
+- **PandasEngine rewrites workbooks** — formatting, charts, images, and formulas are dropped
 
-### Who is this NOT for?
+If you need relational features, use SQLite or PostgreSQL.
 
-- If you need JOINs, GROUP BY, subqueries, or advanced SQL → use SQLite or PostgreSQL
-- If you need concurrent writes from multiple processes → use a real database
-- If your Excel file has 100k+ rows → use pandas directly or a database
+See the full [SQL Specification](docs/SQL_SPEC.md) for the exact SQL subset supported.
 
 ---
 
-## Features
+## Who is this for?
 
-- Python DB-API 2.0 compliant interface (PEP 249)
-- Query Excel files using SQL syntax
-- Supports SELECT, INSERT, UPDATE, DELETE
-- Basic DDL support (CREATE TABLE, DROP TABLE)
-- WHERE conditions with AND/OR and comparison operators
-- IN, BETWEEN, LIKE operators in WHERE clauses
-- ORDER BY and LIMIT for SELECT
-- Sheet-to-Table mapping
-- Pandas & Openpyxl engine selector
-- Formula injection defense (enabled by default)
-- Transaction simulation (commit/rollback)
+- **Data analysts** who want to query Excel files with SQL instead of manual filtering
+- **Citizen developers** automating small workflows with familiar SQL syntax
+- **Educators** teaching SQL concepts without setting up a database
+- **Prototypers** building quick data pipelines before moving to a real database
 
 ---
 
@@ -264,36 +260,52 @@ The Pandas engine preserves Python types. If a column contains integers,
 
 ---
 
-## Limitations and Operational Guidance
+## Experimental: Remote Excel via Microsoft Graph API
 
-- `PandasEngine` rewrites workbooks and may drop formatting, charts, and formulas.
-- `OpenpyxlEngine` loads with `data_only=True`, so formulas are evaluated to values when reading.
-- Use a **single-writer model** for writes. Avoid writing to the same file from multiple processes.
-- Save is implemented with a temporary file + atomic replace (`os.replace`) for safer persistence.
-- No support for JOIN, GROUP BY, HAVING, or subqueries.
+> **Status**: Experimental — API may change in future releases.
 
-## Roadmap
+excel-dbapi can access remote Excel files on OneDrive/SharePoint via the Microsoft Graph API.
 
-- Remote file connection improvements
+```bash
+pip install excel-dbapi[graph]
+```
 
-See [Project Roadmap](docs/ROADMAP.md) for details.
+```python
+from excel_dbapi.connection import ExcelConnection
 
----
+conn = ExcelConnection(
+    "msgraph://drives/{drive_id}/items/{item_id}",
+    engine="graph",
+    credential=your_credential,
+    autocommit=True,
+)
+cursor = conn.cursor()
+cursor.execute("SELECT * FROM Sheet1")
+print(cursor.fetchall())
+conn.close()
+```
+
+The Graph backend is **read-only by default**. Write operations require explicit opt-in
+and a valid Azure credential with appropriate Graph API permissions.
 
+For details, see the [Usage Guide](docs/USAGE.md).
+
+---
 
 ## Related Projects
 
 - [sqlalchemy-excel](https://github.com/yeongseon/sqlalchemy-excel) — SQLAlchemy dialect that uses excel-dbapi as its DB-API 2.0 driver. Use `create_engine("excel:///file.xlsx")` for full ORM support.
+
 ---
 
 ## Documentation
 
+- [SQL Specification](docs/SQL_SPEC.md)
 - [Usage Guide](docs/USAGE.md)
 - [Development Guide](docs/DEVELOPMENT.md)
 - [Project Roadmap](docs/ROADMAP.md)
 - [10-Minute Quickstart](docs/QUICKSTART_10_MIN.md)
 - [Operations Notes](docs/OPERATIONS.md)
-- [Public Roadmap](docs/PUBLIC_ROADMAP.md)
 
 ## Examples
 

{excel_dbapi-0.2.1 → excel_dbapi-0.3.0}/README.md

@@ -5,40 +5,36 @@
 
 ![CI](https://github.com/yeongseon/excel-dbapi/actions/workflows/ci.yml/badge.svg)
 [![codecov](https://codecov.io/gh/yeongseon/excel-dbapi/branch/main/graph/badge.svg)](https://codecov.io/gh/yeongseon/excel-dbapi)
+[![PyPI](https://img.shields.io/pypi/v/excel-dbapi.svg)](https://pypi.org/project/excel-dbapi/)
 [![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![Docs](https://img.shields.io/badge/docs-GitHub-blue.svg)](https://github.com/yeongseon/excel-dbapi/tree/main/docs)
 
-A lightweight, Python DB-API 2.0 compliant connector for Excel files.
+A **local-first** Python DB-API 2.0 connector for Excel files.
 Use SQL to query, insert, update, and delete rows in `.xlsx` workbooks — no database server required.
 
-## Who is this for?
+## Limitations
 
-- **Data analysts** who want to query Excel files with SQL instead of manual filtering
-- **Citizen developers** automating small workflows with familiar SQL syntax
-- **Educators** teaching SQL concepts without setting up a database
-- **Prototypers** building quick data pipelines before moving to a real database
+Before you begin, understand what excel-dbapi is **not**:
+
+- **No JOIN, GROUP BY, HAVING, DISTINCT, or subqueries** — single-table operations only
+- **No concurrent writes** — use a single-writer model
+- **Not for large datasets** — if your Excel file has 100k+ rows, use pandas directly or a database
+- **No transactional rollback guarantees** — rollback restores an in-memory snapshot, not a WAL
+- **PandasEngine rewrites workbooks** — formatting, charts, images, and formulas are dropped
 
-### Who is this NOT for?
+If you need relational features, use SQLite or PostgreSQL.
 
-- If you need JOINs, GROUP BY, subqueries, or advanced SQL → use SQLite or PostgreSQL
-- If you need concurrent writes from multiple processes → use a real database
-- If your Excel file has 100k+ rows → use pandas directly or a database
+See the full [SQL Specification](docs/SQL_SPEC.md) for the exact SQL subset supported.
 
 ---
 
-## Features
+## Who is this for?
 
-- Python DB-API 2.0 compliant interface (PEP 249)
-- Query Excel files using SQL syntax
-- Supports SELECT, INSERT, UPDATE, DELETE
-- Basic DDL support (CREATE TABLE, DROP TABLE)
-- WHERE conditions with AND/OR and comparison operators
-- IN, BETWEEN, LIKE operators in WHERE clauses
-- ORDER BY and LIMIT for SELECT
-- Sheet-to-Table mapping
-- Pandas & Openpyxl engine selector
-- Formula injection defense (enabled by default)
-- Transaction simulation (commit/rollback)
+- **Data analysts** who want to query Excel files with SQL instead of manual filtering
+- **Citizen developers** automating small workflows with familiar SQL syntax
+- **Educators** teaching SQL concepts without setting up a database
+- **Prototypers** building quick data pipelines before moving to a real database
 
 ---
 
@@ -224,36 +220,52 @@ The Pandas engine preserves Python types. If a column contains integers,
 
 ---
 
-## Limitations and Operational Guidance
+## Experimental: Remote Excel via Microsoft Graph API
 
-- `PandasEngine` rewrites workbooks and may drop formatting, charts, and formulas.
-- `OpenpyxlEngine` loads with `data_only=True`, so formulas are evaluated to values when reading.
-- Use a **single-writer model** for writes. Avoid writing to the same file from multiple processes.
-- Save is implemented with a temporary file + atomic replace (`os.replace`) for safer persistence.
-- No support for JOIN, GROUP BY, HAVING, or subqueries.
+> **Status**: Experimental — API may change in future releases.
 
-## Roadmap
+excel-dbapi can access remote Excel files on OneDrive/SharePoint via the Microsoft Graph API.
 
-- Remote file connection improvements
+```bash
+pip install excel-dbapi[graph]
+```
 
-See [Project Roadmap](docs/ROADMAP.md) for details.
+```python
+from excel_dbapi.connection import ExcelConnection
 
----
+conn = ExcelConnection(
+    "msgraph://drives/{drive_id}/items/{item_id}",
+    engine="graph",
+    credential=your_credential,
+    autocommit=True,
+)
+cursor = conn.cursor()
+cursor.execute("SELECT * FROM Sheet1")
+print(cursor.fetchall())
+conn.close()
+```
+
+The Graph backend is **read-only by default**. Write operations require explicit opt-in
+and a valid Azure credential with appropriate Graph API permissions.
 
+For details, see the [Usage Guide](docs/USAGE.md).
+
+---
 
 ## Related Projects
 
 - [sqlalchemy-excel](https://github.com/yeongseon/sqlalchemy-excel) — SQLAlchemy dialect that uses excel-dbapi as its DB-API 2.0 driver. Use `create_engine("excel:///file.xlsx")` for full ORM support.
+
 ---
 
 ## Documentation
 
+- [SQL Specification](docs/SQL_SPEC.md)
 - [Usage Guide](docs/USAGE.md)
 - [Development Guide](docs/DEVELOPMENT.md)
 - [Project Roadmap](docs/ROADMAP.md)
 - [10-Minute Quickstart](docs/QUICKSTART_10_MIN.md)
 - [Operations Notes](docs/OPERATIONS.md)
-- [Public Roadmap](docs/PUBLIC_ROADMAP.md)
 
 ## Examples