gruff-py 0.1.0__tar.gz

gruff_py-0.1.0/.editorconfig

@@ -0,0 +1,20 @@
+root = true
+
+[*]
+end_of_line = lf
+indent_style = space
+indent_size = 4
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.py]
+indent_style = space
+indent_size = 4
+max_line_length = 100
+
+[*.{md,toml,yaml,yml,json}]
+indent_size = 2
+
+[Makefile]
+indent_style = tab

gruff_py-0.1.0/.gitattributes

@@ -0,0 +1,38 @@
+# Normalize text files to LF on commit; let git decide what's text.
+* text=auto eol=lf
+
+# Per-extension overrides (explicit > auto for source/config).
+*.py           text eol=lf
+*.pyi          text eol=lf
+*.sh           text eol=lf
+*.yml          text eol=lf
+*.yaml         text eol=lf
+*.md           text eol=lf
+*.ini          text eol=lf
+*.toml         text eol=lf
+*.cfg          text eol=lf
+*.json         text eol=lf
+.editorconfig  text eol=lf
+
+# Windows-only files: keep CRLF.
+*.bat          text eol=crlf
+*.cmd          text eol=crlf
+*.ps1          text eol=crlf
+
+# Binary files — don't normalize, don't diff.
+*.png          binary
+*.jpg          binary
+*.jpeg         binary
+*.gif          binary
+*.ico          binary
+*.pdf          binary
+*.whl          binary
+*.zip          binary
+*.gz           binary
+*.tar          binary
+*.tar.gz       binary
+*.7z           binary
+*.exe          binary
+*.dll          binary
+*.so           binary
+*.dylib        binary

gruff_py-0.1.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,35 @@
+---
+name: Bug report
+about: Report incorrect behaviour in gruff-py
+title: ""
+labels: bug
+assignees: ""
+---
+
+## Version
+
+- gruff-py:
+- Python:
+- OS:
+
+## Command
+
+```bash
+
+```
+
+## Expected Behaviour
+
+
+## Actual Behaviour
+
+
+## Minimal Reproduction
+
+```python
+
+```
+
+## Notes
+
+

gruff_py-0.1.0/.github/ISSUE_TEMPLATE/false_positive.md

@@ -0,0 +1,33 @@
+---
+name: False positive
+about: Report a finding that should not be emitted
+title: ""
+labels: false-positive
+assignees: ""
+---
+
+## Rule
+
+Rule id:
+
+## Version
+
+- gruff-py:
+- Python:
+- OS:
+
+## Code Sample
+
+```python
+
+```
+
+## Finding
+
+```text
+
+```
+
+## Why This Should Be Allowed
+
+

gruff_py-0.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,22 @@
+---
+name: Feature request
+about: Suggest a rule, reporter, config option, or workflow
+title: ""
+labels: enhancement
+assignees: ""
+---
+
+## Problem
+
+
+## Proposed Behaviour
+
+
+## Alternatives Considered
+
+
+## Compatibility Notes
+
+Does this change any schema fields, rule ids, fingerprints, exit-code behaviour,
+or report format names?
+

gruff_py-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,18 @@
+## Summary
+
+- 
+
+## Verification
+
+- [ ] `uv run ruff check src tests`
+- [ ] `uv run ruff format --check src tests`
+- [ ] `uv run mypy src`
+- [ ] `uv run pytest`
+
+## Compatibility Checklist
+
+- [ ] No unintended schema string changes
+- [ ] No unintended fingerprint changes
+- [ ] No unintended public rule id changes
+- [ ] Docs updated where behaviour changed
+

gruff_py-0.1.0/.github/git-commit-instructions.md

@@ -0,0 +1,5 @@
+# Git Commit Instructions
+
+Use concise conventional commits when practical, for example `feat: add size rule` or `fix: preserve fingerprint compatibility`.
+
+Keep commits focused by boundary: runtime code with its tests, GOAT Flow setup docs, and generated package artifacts should not be mixed unless the user explicitly asks for a single combined commit. Do not commit `node_modules/`, `dist/`, `.venv/`, or local cache directories.

gruff_py-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,57 @@
+name: ci
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install project
+        run: uv sync --all-extras --dev --python ${{ matrix.python-version }}
+
+      - name: Bash syntax
+        run: bash -n scripts/*.sh
+
+      - name: Shellcheck
+        uses: ludeeus/action-shellcheck@master
+        with:
+          scandir: ./scripts
+
+      - name: Lint
+        run: uv run ruff check src tests
+
+      - name: Format check
+        run: uv run ruff format --check src tests
+
+      - name: Typecheck
+        run: uv run mypy src
+
+      - name: Rule docs
+        run: uv run python -m gruffpy.command.rule_docs --check docs/RULES.md
+
+      - name: Test
+        run: uv run pytest
+
+      - name: Gruff self-check
+        run: uv run gruff-py analyse src tests --fail-on advisory
+
+      - name: Package build
+        run: uv build

gruff_py-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,60 @@
+name: publish
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+
+permissions: {}
+
+jobs:
+  publish:
+    name: Build and publish to PyPI
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/gruff-py/
+    permissions:
+      id-token: write
+      contents: read
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.11
+
+      - name: Install project
+        run: uv sync --all-extras --dev --python 3.11
+
+      - name: Verify tag matches project version
+        run: |
+          tag="${GITHUB_REF_NAME#v}"
+          pyver=$(uv run python -c 'import tomllib, pathlib; print(tomllib.loads(pathlib.Path("pyproject.toml").read_text())["project"]["version"])')
+          if [[ "$tag" != "$pyver" ]]; then
+            echo "::error::Tag '${GITHUB_REF_NAME}' does not match pyproject.toml version '$pyver'"
+            exit 1
+          fi
+
+      - name: Lint
+        run: uv run ruff check src tests
+
+      - name: Format check
+        run: uv run ruff format --check src tests
+
+      - name: Typecheck
+        run: uv run mypy src
+
+      - name: Test
+        run: uv run pytest
+
+      - name: Build sdist and wheel
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

gruff_py-0.1.0/.gitignore

@@ -0,0 +1,88 @@
+# ----- Build artifacts -----
+build/
+dist/
+*.egg-info/
+*.egg
+*.whl
+
+# ----- Python bytecode and shared objects -----
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.pyd
+
+# ----- Virtual environments -----
+.venv/
+venv/
+env/
+ENV/
+__pypackages__/
+
+# ----- Local config and secrets (dotenv-style files) -----
+# (Note: NOT a virtualenv. `.env` is almost always a KEY=value file with secrets.)
+.env
+.env.local
+.env.*.local
+.envrc.local
+
+# ----- Coverage and test caches -----
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.pytest_cache/
+.hypothesis/
+coverage.xml
+*.cover
+
+# ----- Type checker / linter / formatter caches -----
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pyre/
+.pytype/
+.ruff_cache/
+cython_debug/
+
+# ----- Publishing -----
+.pypirc
+
+# ----- Logs and pip artifacts -----
+*.log
+pip-log.txt
+pip-delete-this-directory.txt
+
+# ----- IDE / editor -----
+.idea/
+.vscode/
+.spyderproject
+.spyproject
+.ropeproject
+*.swp
+*.swo
+.*.swp
+.*.swo
+*~
+*.bak
+
+# ----- OS files -----
+.DS_Store
+Thumbs.db
+
+# ----- Performance harness output -----
+perf-out/
+
+# ----- Claude Code (per-user overrides; shared .claude/settings.json stays tracked) -----
+.claude/settings.local.json
+
+# ----- Codex (per-user overrides; shared .codex/config.toml stays tracked) -----
+.codex/config.local.toml
+
+/node_modules
+
+# ----- Not ignored on purpose (keep tracked) -----
+# uv.lock          → committed: gruff is a CLI app; lock = reproducible installs.
+# gruff-baseline.json, .gruff-history.json → committed: project-level state.
+# .python-version  → if present, used for team Python pinning.