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

excel_dbapi-0.3.0/.editorconfig

@@ -0,0 +1,9 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+indent_size = 4
+trim_trailing_whitespace = true
+insert_final_newline = true

excel_dbapi-0.3.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,69 @@
+name: Bug Report
+description: Report a bug or unexpected behavior in excel-dbapi
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug in `excel-dbapi`!
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: A clear description of the bug
+      placeholder: What happened? What did you expect to happen?
+    validations:
+      required: true
+
+  - type: textarea
+    id: current-state
+    attributes:
+      label: Current State
+      description: Describe the current behavior and any relevant context
+      placeholder: |
+        - What is happening now?
+        - Any error messages or logs?
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps-to-reproduce
+    attributes:
+      label: Steps to Reproduce
+      description: How can we reproduce this issue?
+      placeholder: |
+        1. Install package...
+        2. Run query...
+        3. See error...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected-outcome
+    attributes:
+      label: Expected Outcome
+      description: What should happen instead?
+    validations:
+      required: true
+
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: Your environment details
+      placeholder: |
+        - Python version:
+        - Package version:
+        - OS:
+    validations:
+      required: false
+
+  - type: textarea
+    id: references
+    attributes:
+      label: References
+      description: Any related files, links, or resources
+    validations:
+      required: false

excel_dbapi-0.3.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Documentation
+    url: https://github.com/yeongseon/excel-dbapi#readme
+    about: Check our README for usage guides and examples
+  - name: Security Advisories
+    url: https://github.com/yeongseon/excel-dbapi/security/advisories/new
+    about: Report security issues privately via GitHub Security Advisories

excel_dbapi-0.3.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,65 @@
+name: Feature Request
+description: Suggest a new feature or enhancement for excel-dbapi
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a feature for `excel-dbapi`!
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What problem does this feature solve?
+      placeholder: Describe the problem or limitation you're facing
+    validations:
+      required: true
+
+  - type: textarea
+    id: current-state
+    attributes:
+      label: Current State
+      description: How does the project currently handle this (if at all)?
+      placeholder: |
+        - Current behavior
+        - Current limitations
+    validations:
+      required: false
+
+  - type: textarea
+    id: proposed-solution
+    attributes:
+      label: Proposed Solution
+      description: How would you like this to work?
+      placeholder: Describe your ideal solution
+    validations:
+      required: true
+
+  - type: textarea
+    id: tasks
+    attributes:
+      label: Tasks
+      description: Break down the implementation into tasks (if known)
+      placeholder: |
+        - [ ] Task 1
+        - [ ] Task 2
+    validations:
+      required: false
+
+  - type: textarea
+    id: expected-outcome
+    attributes:
+      label: Expected Outcome
+      description: What should be the end result?
+    validations:
+      required: true
+
+  - type: textarea
+    id: references
+    attributes:
+      label: References
+      description: Any related files, links, documentation, or examples
+    validations:
+      required: false

excel_dbapi-0.3.0/.github/ISSUE_TEMPLATE/task.yml

@@ -0,0 +1,56 @@
+name: Task
+description: A general task or chore (refactoring, maintenance, etc.)
+title: "[Task]: "
+labels: ["chore"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Use this template for maintenance tasks, refactoring, or other chores.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: Why is this task needed?
+      placeholder: Describe the motivation for this task
+    validations:
+      required: true
+
+  - type: textarea
+    id: current-state
+    attributes:
+      label: Current State
+      description: What is the current situation?
+      placeholder: |
+        - Current code/config state
+        - Any issues or limitations
+    validations:
+      required: true
+
+  - type: textarea
+    id: tasks
+    attributes:
+      label: Tasks
+      description: Break down the work into actionable items
+      placeholder: |
+        - [ ] Task 1
+        - [ ] Task 2
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected-outcome
+    attributes:
+      label: Expected Outcome
+      description: What should be the result when this is complete?
+    validations:
+      required: true
+
+  - type: textarea
+    id: references
+    attributes:
+      label: References
+      description: Any related files, documentation, or resources
+    validations:
+      required: false

excel_dbapi-0.3.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,33 @@
+## Summary
+
+<!-- Brief description of changes -->
+
+## Changes
+
+<!-- List the specific changes made -->
+
+-
+
+## Type of Change
+
+<!-- Check the relevant option -->
+
+- [ ] Bug fix (non-breaking change that fixes an issue)
+- [ ] New feature (non-breaking change that adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to change)
+- [ ] Documentation update
+- [ ] Refactoring (no functional changes)
+- [ ] Chore (maintenance, dependencies, CI, etc.)
+
+## Checklist
+
+- [ ] My code follows the project's code style
+- [ ] I have run `make check-all`
+- [ ] I have run `make test` and all tests pass
+- [ ] I have added tests for new functionality (if applicable)
+- [ ] I have updated documentation (if applicable)
+- [ ] My changes do not introduce new warnings
+
+## Related Issues
+
+<!-- Link to related issues: Closes #123, Fixes #456 -->

excel_dbapi-0.3.0/.github/RELEASE_CHECKLIST.md

@@ -0,0 +1,10 @@
+# Release Checklist
+
+- [ ] Verify CI is green on `main`
+- [ ] Run local quality gate with `make check-all`
+- [ ] Build distribution artifacts with `make build`
+- [ ] Update version in `pyproject.toml`
+- [ ] Update `CHANGELOG.md` for the release
+- [ ] Tag release `vX.Y.Z`
+- [ ] Verify package publish succeeded
+- [ ] Publish GitHub Release notes

excel_dbapi-0.3.0/.github/RELEASE_NOTES_TEMPLATE.md

@@ -0,0 +1,25 @@
+# Release Notes
+
+## Highlights
+
+-
+
+## Breaking Changes
+
+-
+
+## Features
+
+-
+
+## Fixes
+
+-
+
+## Documentation
+
+-
+
+## Notes
+
+-

excel_dbapi-0.3.0/.github/dependabot.yml

@@ -0,0 +1,22 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    commit-message:
+      prefix: "chore(deps)"
+    labels:
+      - "dependencies"
+    open-pull-requests-limit: 10
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    commit-message:
+      prefix: "chore(deps)"
+    labels:
+      - "dependencies"
+      - "github-actions"
+    open-pull-requests-limit: 10

excel_dbapi-0.3.0/.github/labels.yml

@@ -0,0 +1,47 @@
+- name: "dependencies"
+  color: "0075ca"
+  description: "Pull requests that update a dependency file"
+
+- name: "github-actions"
+  color: "e4e669"
+  description: "Pull requests that update GitHub Actions"
+
+- name: "bug"
+  color: "d73a4a"
+  description: "Something isn't working"
+
+- name: "enhancement"
+  color: "a2eeef"
+  description: "New feature or request"
+
+- name: "documentation"
+  color: "0075ca"
+  description: "Improvements or additions to documentation"
+
+- name: "question"
+  color: "d876e3"
+  description: "Further information is requested"
+
+- name: "good first issue"
+  color: "7057ff"
+  description: "Good for newcomers"
+
+- name: "help wanted"
+  color: "008672"
+  description: "Extra attention is needed"
+
+- name: "security"
+  color: "e11d48"
+  description: "Security-related issue or pull request"
+
+- name: "duplicate"
+  color: "cfd3d7"
+  description: "This issue or pull request already exists"
+
+- name: "wontfix"
+  color: "ffffff"
+  description: "This will not be worked on"
+
+- name: "invalid"
+  color: "e4e669"
+  description: "This doesn't seem right"

excel_dbapi-0.3.0/.github/release.yml

@@ -0,0 +1,21 @@
+changelog:
+  categories:
+    - title: "🚀 Features"
+      labels:
+        - enhancement
+    - title: "🐛 Bug Fixes"
+      labels:
+        - bug
+    - title: "📖 Documentation"
+      labels:
+        - documentation
+    - title: "🧹 Maintenance"
+      labels:
+        - dependencies
+        - chore
+    - title: "Other Changes"
+      labels:
+        - "*"
+  exclude:
+    labels:
+      - skip-changelog

{excel_dbapi-0.2.0 → excel_dbapi-0.3.0}/.github/workflows/ci.yml

@@ -11,9 +11,9 @@ jobs:
       matrix:
         python-version: ["3.10", "3.11", "3.12", "3.13"]
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
       - name: Install dependencies
@@ -24,7 +24,7 @@ jobs:
         run: pytest tests/ -v --cov=excel_dbapi --cov-report=xml --cov-report=term-missing
       - name: Upload coverage to Codecov
         if: matrix.python-version == '3.12'
-        uses: codecov/codecov-action@v5
+        uses: codecov/codecov-action@v6
         with:
           files: coverage.xml
           fail_ci_if_error: false

{excel_dbapi-0.2.0 → excel_dbapi-0.3.0}/.github/workflows/publish-pypi.yml

@@ -11,10 +11,10 @@ jobs:
     permissions:
       id-token: write
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.12"
 
@@ -24,5 +24,8 @@ jobs:
       - name: Build package
         run: python -m build
 
+      - name: Validate package
+        run: pip install twine && twine check dist/*
+
       - name: Publish to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1

{excel_dbapi-0.2.0 → excel_dbapi-0.3.0}/.gitignore

@@ -22,6 +22,13 @@ build/
 dist/
 *.egg-info/
 
+# Docs
+site/
+
+# Review
+.venv-review/
+.venv-review-cli/
+
 # Data files
 *.xlsx
 !tests/data/*.xlsx

excel_dbapi-0.3.0/.pre-commit-config.yaml

@@ -0,0 +1,21 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.6
+    hooks:
+      - id: ruff-format
+      - id: ruff
+        args: ["--fix"]
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.19.1
+    hooks:
+      - id: mypy
+        language: python
+        files: "^src/"
+        pass_filenames: false
+        args:
+          [
+            "--config-file=pyproject.toml",
+            "--install-types",
+            "--non-interactive"
+          ]

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.3.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,56 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior:
+
+* The use of sexualized language or imagery and unwelcome sexual attention
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information without explicit permission
+* Other conduct which could reasonably be considered inappropriate
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+yeongseon.choe@gmail.com.
+
+All complaints will be reviewed and investigated promptly and fairly.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.0, available at
+https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+
+[homepage]: https://www.contributor-covenant.org

excel_dbapi-0.3.0/CONTRIBUTING.md

@@ -0,0 +1,64 @@
+# Contributing Guide
+
+We welcome contributions to the `excel-dbapi` project.
+
+## Branch Strategy
+
+Use GitHub Flow and branch from `main`.
+
+Recommended branch prefixes:
+
+- `feat/` for new features
+- `fix/` for bug fixes
+- `docs/` for documentation-only changes
+- `chore/` for tooling and maintenance
+- `ci/` for workflow updates
+
+## Development Workflow
+
+1. Create a branch from `main`.
+   ```bash
+   git checkout main
+   git pull origin main
+   git checkout -b feat/your-feature-name
+   ```
+2. Write code and tests.
+3. Run the local quality gate.
+   ```bash
+   make check-all
+   ```
+4. Push and create a pull request.
+   ```bash
+   git push origin feat/your-feature-name
+   ```
+
+## Project Commands
+
+```bash
+make format      # Format code with ruff
+make lint        # Lint with ruff
+make typecheck   # Type check with mypy
+make test        # Run tests
+make cov         # Run tests with coverage
+make check-all   # Run the full local gate
+```
+
+## Commit Message Guidelines
+
+We follow the [Conventional Commits](https://www.conventionalcommits.org/) specification.
+
+### Examples
+
+```bash
+git commit -m "feat: add LIKE operator support"
+git commit -m "fix: handle empty IN clause gracefully"
+git commit -m "docs: improve quickstart documentation"
+git commit -m "refactor: extract SQL parser logic"
+git commit -m "chore: update dev dependencies"
+```
+
+Use imperative present tense and keep the message concise.
+
+## Code of Conduct
+
+Be respectful and inclusive. See our [Code of Conduct](CODE_OF_CONDUCT.md) for details.