xlinject 0.2.0a1__tar.gz

xlinject-0.2.0a1/.github/workflows/ci.yml

@@ -0,0 +1,46 @@
+name: CI
+
+on:
+  push:
+    branches: ["**"]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  quality:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Sync dependencies
+        run: uv sync --dev
+
+      - name: Pre-commit
+        run: uv run pre-commit run --all-files
+
+      - name: Ruff
+        run: uv run ruff check .
+
+      - name: MyPy
+        run: uv run mypy .
+
+      - name: Pytest
+        run: uv run pytest -q
+
+      - name: Build package
+        run: uv build
+
+      - name: Twine check
+        run: uv run twine check dist/*

xlinject-0.2.0a1/.github/workflows/publish-pypi.yml

@@ -0,0 +1,57 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Sync dependencies
+        run: uv sync --dev
+
+      - name: Build
+        run: uv build
+
+      - name: Twine check
+        run: uv run twine check dist/*
+
+      - name: Upload dist artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    environment:
+      name: pypi
+      url: https://pypi.org/p/xlinject
+    steps:
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish package to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

xlinject-0.2.0a1/.gitignore

@@ -0,0 +1,24 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+*.so
+*.egg-info/
+
+# Virtual/env
+.venv/
+
+# Tooling caches
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# Editors/OS
+.vscode/
+.idea/
+.DS_Store
+
+# Build artifacts
+dist/
+build/

xlinject-0.2.0a1/.pre-commit-config.yaml

@@ -0,0 +1,16 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: check-merge-conflict
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
+
+  - repo: local
+    hooks:
+      - id: plain-text-style
+        name: plain-text-style (no em dash, no emoji)
+        entry: python scripts/check_plain_text_style.py
+        language: python
+        types_or: [markdown, text, python, toml, yaml, json]
+        exclude: ^scripts/check_plain_text_style.py$

xlinject-0.2.0a1/AGENTS.md

@@ -0,0 +1,37 @@
+# AGENTS.md
+
+This repository is prepared for human + AI collaboration.
+
+## Current phase
+
+- API-first library phase with generalized cell-injection helpers.
+- One optional generic CLI command is available (`xlinject-write-cells`).
+- Recalculation safety policy is part of default high-level write behavior.
+- Contributors should avoid adding unplanned code paths without first updating `docs/ROADMAP.md`.
+
+## Working agreements for coding agents
+
+1. Keep edits surgical and scope-limited to the requested task.
+2. Prefer preserving existing structure and naming.
+3. Do not introduce broad refactors during feature work.
+4. When touching behavior, update docs in `docs/` in the same change.
+5. If changing workbook XML write logic in future phases, include tests that validate unchanged neighboring XML structure.
+6. Do not add dependencies without documenting rationale in PR description.
+7. Avoid em dashes (`--`) and avoid emoji usage in repository text/docs.
+8. Keep the library API as the primary interface; avoid adding task-specific wrappers in CLI.
+
+## Implementation guardrails (future code)
+
+- Prioritize XML node-level mutation over full workbook reconstruction.
+- Preserve unsupported/unknown tags and attributes exactly.
+- Keep generated XML ordering deterministic and Excel-compatible.
+- Treat dynamic array and formula metadata as immutable unless explicitly targeted.
+- Preserve `mc:Ignorable` namespace compatibility on all worksheet rewrites.
+- Maintain recalculation safety (`calcChain` handling + workbook `calcPr` policy).
+
+## Release and packaging expectations
+
+- Use `uv` for dependency and environment management.
+- Keep the package install/build flow in `pyproject.toml`.
+- Prefer small, incremental PRs aligned with roadmap phases.
+- Keep PyPI release workflow healthy (CI build + twine checks + trusted publisher flow).

xlinject-0.2.0a1/CONTRIBUTING.md

@@ -0,0 +1,51 @@
+# Contributing
+
+Thanks for contributing to `xlinject`.
+
+Current direction: API-first Python library with one optional generic CLI command.
+
+## License and contributions
+
+This project is licensed under GPLv3 (or later).
+By submitting contributions, you agree your changes are provided under the same license.
+
+## Setup
+
+```bash
+uv sync --dev
+```
+
+## Before opening a PR
+
+```bash
+uv run ruff check .
+uv run mypy .
+uv run pytest -q
+uv build
+uv run twine check dist/*
+```
+
+## Contribution rules
+
+- Keep changes focused and small.
+- Update relevant docs under `docs/` when behavior or plan changes.
+- Add tests with behavior changes.
+- Avoid unrelated cleanup in feature PRs.
+- Prefer extending reusable high-level helpers over adding app-specific logic.
+- Keep CLI changes minimal and generic. The library API is the primary interface.
+- Use anonymized/synthetic data only in docs, tests, and issue reports.
+
+## API-first guidance
+
+- Favor `inject_cells` + helper functions (`build_column_cell_map`, `merge_cell_maps`, `to_excel_serial`).
+- Preserve formula and workbook metadata safety guarantees.
+- If recalculation behavior changes, include tests covering workbook `calcPr` and cache behavior.
+
+## Branch naming
+
+Suggested prefixes:
+
+- `feat/`
+- `fix/`
+- `docs/`
+- `chore/`