pytest-eo 0.5.1__tar.gz

pytest_eo-0.5.1/.claude/hooks/eo-gate.sh

@@ -0,0 +1,53 @@
+#!/usr/bin/env bash
+# Claude Code hook: run `pytest --eo` and, when it is red, give the
+# findings back to Claude (exit code 2) so it fixes them before going on.
+# Used for PostToolUse (after editing a Python or config file) and Stop.
+set -u
+
+payload=$(cat)
+root="${CLAUDE_PROJECT_DIR:-$PWD}"
+cd "$root" || exit 0
+python=".venv/bin/python"
+if [ ! -x "$python" ]; then
+  echo "pytest --eo gate skipped: no .venv here, run python3 -m venv .venv && .venv/bin/pip install -e ." >&2
+  exit 1
+fi
+
+field() {
+  printf '%s' "$payload" | "$python" -I -c '
+import json, sys
+value = json.load(sys.stdin)
+for key in sys.argv[1].split("."):
+    value = value.get(key, "") if isinstance(value, dict) else ""
+print(value)
+' "$1"
+}
+
+event=$(field hook_event_name)
+if [ "$event" = "PostToolUse" ]; then
+  case "$(field tool_input.file_path)" in
+    *.py|*.toml|*.ini|*.cfg) ;;
+    *) exit 0 ;;
+  esac
+fi
+
+report=$("$python" -m pytest --eo -q --tb=short 2>&1)
+if [ $? -eq 0 ]; then
+  exit 0
+fi
+
+findings=$(printf '%s\n' "$report" | tail -n 120)
+summary=$(printf '%s\n' "$report" | tail -n 1)
+
+if [ "$event" = "Stop" ] && [ "$(field stop_hook_active)" = "True" ]; then
+  printf '{"systemMessage": %s}\n' \
+    "$(printf 'pytest --eo is still red after a retry: %s' "$summary" | "$python" -I -c 'import json, sys; print(json.dumps(sys.stdin.read()))')"
+  exit 0
+fi
+
+{
+  echo "pytest --eo is red; fix every finding below, never suppress it without a reason"
+  printf '%s\n' "$findings"
+  echo "$summary"
+} >&2
+exit 2

pytest_eo-0.5.1/.claude/settings.json

@@ -0,0 +1,29 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/eo-gate.sh",
+            "timeout": 180,
+            "statusMessage": "pytest --eo"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/eo-gate.sh",
+            "timeout": 180,
+            "statusMessage": "pytest --eo"
+          }
+        ]
+      }
+    ]
+  }
+}

pytest_eo-0.5.1/.github/workflows/codecov.yml

@@ -0,0 +1,20 @@
+name: codecov
+on:
+  push:
+    branches: [main]
+  pull_request:
+jobs:
+  codecov:
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - run: python3 -m venv .venv
+      - run: .venv/bin/pip install -e '.[dev]'
+      - run: make coverage
+      - uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: coverage.xml

pytest_eo-0.5.1/.github/workflows/pypi.yml

@@ -0,0 +1,19 @@
+name: pypi
+on:
+  push:
+    tags: ["*.*.*"]
+jobs:
+  pypi:
+    runs-on: ubuntu-24.04
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - run: grep -q "^version = \"${GITHUB_REF_NAME}\"$" pyproject.toml || { echo "Tag ${GITHUB_REF_NAME} is not the version in pyproject.toml"; exit 1; }
+      - run: python3 -m pip install build==1.3.0
+      - run: python3 -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1

pytest_eo-0.5.1/.gitignore

@@ -0,0 +1,10 @@
+.venv/
+__pycache__/
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+*.egg-info/
+dist/
+.coverage
+.coverage.*
+coverage.xml

pytest_eo-0.5.1/.rultor.yml

@@ -0,0 +1,17 @@
+---
+docker:
+  image: python:3.11
+merge:
+  script: |-
+    python3 -m venv .venv
+    .venv/bin/pip install -e '.[dev]'
+    make check
+release:
+  script: |-
+    [[ "${tag}" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]] || { echo "Tag ${tag} is not a version like 1.2.3"; exit 1; }
+    sed -i -E "s/^version = \"[^\"]*\"$/version = \"${tag}\"/" pyproject.toml
+    grep -q "^version = \"${tag}\"$" pyproject.toml || { echo "Cannot set version ${tag} in pyproject.toml"; exit 1; }
+    python3 -m venv .venv
+    .venv/bin/pip install -e '.[dev]'
+    make check
+    git commit -am "${tag}"

pytest_eo-0.5.1/CLAUDE.md

@@ -0,0 +1,101 @@
+<!-- Source: https://github.com/yegor256/prompt (README.txt) at commit 83ec21442f7349179a291445d0d369361273c891.
+     MIT License, Copyright (c) 2025 Yegor Bugayenko; see third_party/yegor256-prompt-LICENSE.txt.
+     Changed for Linux: gsed, gfind, ggrep, gcat are written as sed, find, grep, cat. -->
+
+# Be Quality Dogmatic
+
+Keep chat replies and your answers easy to comprehend.
+
+## Tools
+
+Use GNU (GNU's Not Unix) tools such as `sed`, `find`, `grep`, and `cat`.
+Commit changes with `courier:commit-changes-to-git` skill.
+Submit pull requests with `courier:submit-a-pull-request` skill.
+File issues with `bugscribe:submit-an-issue` skill.
+
+## Discipline
+
+Write concise, direct, human prose.
+Speak plain English in full sentences, avoiding jargon, slang, and shorthand.
+Push back on technical mistakes, deferring to users on vision and architecture.
+Stay on scope, refactoring only what tasks require.
+Design top-down, whole before parts, composition before ingredients.
+Never work around design obstacles, stopping to ask me instead.
+
+## Workflow
+
+Pull from Git before changes, push back only with explicit user permission.
+Name each branch after its GitHub issue integer, asking when unsure.
+Always practice TDD (test-driven development), reproducing bugs before fixing.
+Invest in unit tests until bugs reproduce, trusting intuition over debugging.
+Log extensively when problems stay hard.
+
+## Changes
+
+Tolerate upstream bugs, suggesting issues and waiting for fixes.
+Keep changes focused and minimal.
+Leave puzzles for later, following Puzzle Driven Development.
+Flag smells and refactoring, suggesting issues rather than fixing silently.
+Fix style violations in code, trusting checkers rather than suppressing them.
+
+## Code
+
+Favor aesthetics over functionality.
+Skip inline comments.
+Prepend classes with plain-text docblocks explaining purpose, not usage.
+Name variables as single nouns.
+Inline single-use expressions, dropping unnecessary local variables.
+Name methods as single nouns or verbs, separating commands from queries.
+Pack method bodies without blank lines.
+
+## Style
+
+Keep error and log messages to one sentence with context.
+Strip trailing periods from messages.
+Follow "Paired Brackets" and "Monotonic Indentation".
+
+## Objects
+
+Honor Elegant Objects and SOLID (single, open, Liskov, interface, dependency).
+Follow DDD (domain-driven design) and YAGNI (you arent gonna need it).
+Apply SRP (single-responsibility) and DRY (dont repeat yourself).
+Favor failing immediately over failing silently.
+Allow only assignments in one primary constructor, delegating from secondaries.
+Compose objects instead of inheriting implementation.
+Reject -er names and utility classes.
+Make every class final, holding one to four attributes.
+
+## Methods
+
+Build only immutable objects, freezing attributes after assignment.
+Drop static methods, public static literals, setters, and getters.
+Declare methods in interfaces first, exposing nothing public outside them.
+Reject null returns and arguments.
+Skip type introspection, casting, and reflection.
+
+## Tests
+
+Follow "Angry Tests".
+Place one assertion per test, as its last statement.
+Phrase each failure message negatively.
+Keep tests short, verifying one behavior with one statement.
+Map test files one-to-one with feature files, naming tests as sentences.
+Spell "cannot" and "dont" without apostrophes.
+Isolate tests from shared attributes, setUp, tearDown, constants, and cleanup.
+
+## Fixtures
+
+Provide custom arguments to tested objects, not defaults.
+Skip irrelevant code, side effects, accessors, constructors, and errors.
+Favor fakes and stubs over mocks.
+Use Hamcrest matchers with irregular, random inputs.
+Inline brief fixtures, generating bulky ones at runtime.
+Create fixture objects against duplication, using temporary directories.
+Keep filesystem, sockets, and memory unmocked.
+
+## Runtime
+
+Disable logging in tests.
+Bound every wait with timeouts.
+Test concurrency, retrying flaky blocks.
+Assume no Internet, using ephemeral ports.

pytest_eo-0.5.1/LICENSE.txt

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

pytest_eo-0.5.1/Makefile

@@ -0,0 +1,9 @@
+.PHONY: check coverage
+check:
+	.venv/bin/pytest --eo
+
+coverage:
+	.venv/bin/coverage run -m pytest
+	.venv/bin/coverage combine --quiet
+	.venv/bin/coverage report
+	.venv/bin/coverage xml

pytest_eo-0.5.1/PKG-INFO

@@ -0,0 +1,177 @@
+Metadata-Version: 2.5
+Name: pytest-eo
+Version: 0.5.1
+Summary: pytest --eo: strict style gate over ruff, mypy --strict and pyeo
+Author: RaulIQ
+License-Expression: MIT
+License-File: LICENSE.txt
+Requires-Python: >=3.11
+Requires-Dist: eo-styleguide==0.2.0
+Requires-Dist: flake8-override==0.1.1
+Requires-Dist: flake8==7.4.1
+Requires-Dist: mypy==2.4.0
+Requires-Dist: pyhamcrest>=2.1
+Requires-Dist: pytest>=8
+Requires-Dist: ruff==0.17.1
+Requires-Dist: typing-extensions>=4.4
+Provides-Extra: dev
+Requires-Dist: coverage>=7.10; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# pytest-eo
+
+[![codecov](https://codecov.io/gh/RaulIQ/pytest-eo/graph/badge.svg)](https://codecov.io/gh/RaulIQ/pytest-eo)
+
+`pytest --eo` is a strict quality gate in the spirit of
+[Qulice](https://github.com/yegor256/qulice), built from ready-made tools.
+The plugin runs the tools, reads their reports, and shows each tool as a
+separate test; its own rules cover only tests and suppressions.
+
+| Test              | Tool                                           |
+|-------------------|------------------------------------------------|
+| `eo::ruff`        | `ruff check`, all rules (`select = ["ALL"]`)   |
+| `eo::ruff-format` | `ruff format --check`                          |
+| `eo::mypy`        | `mypy --strict`                                |
+| `eo::flake8`      | `flake8` with [pyeo](https://pypi.org/project/eo-styleguide/) (Elegant Objects rules) |
+| `eo::suppressions`| `# noqa` and `# ruff: ignore` comments         |
+
+The Elegant Objects rules enabled so far, most of them from
+[pyeo](https://github.com/blablatdinov/pyeo) and the rest from its sibling
+packages:
+
+| Code     | Rule                                         | Package |
+|----------|----------------------------------------------|---------|
+| `FIN100` | every class is `@final`                      | pyeo    |
+| `PEO101` | `__init__` contains only assignments         | pyeo    |
+| `PEO102` | `@classmethod` contains only a `cls()` call  | pyeo    |
+| `PEO200` | every class is frozen (immutable)            | pyeo    |
+| `PEO300` | no class names ending in "-er"               | pyeo    |
+| `PEO301` | no public attributes                         | pyeo    |
+| `PEO400` | no static methods                            | pyeo    |
+| `PEO500` | no `@property`, a getter in disguise         | pyeo    |
+| `PEO601` | no methods starting with `get`               | pyeo    |
+| `PEO602` | no getter methods                            | pyeo    |
+| `PEO700` | no introspection, casting, or reflection     | pyeo    |
+| `NPM100` | no private functions or methods              | [flake8-no-private-methods](https://github.com/blablatdinov/flake8-no-private-methods) |
+| `OVR100` | every public method is an `@override` of an interface method | [flake8-override](https://github.com/blablatdinov/flake8-override) |
+| `FOC100` | one public class per module                  | [flake8-one-class](https://github.com/blablatdinov/flake8-one-class) |
+
+mypy runs with `explicit-override` and `warn_unreachable` on top of
+`--strict`: an `@override` must override a real method, every overriding
+method must say so, and code that can never run is an error.
+Python 3.11 has no `typing.override`; import it from `typing_extensions`.
+
+The package also brings a flake8 plugin of its own, with rules in the spirit
+of "Angry Tests" for the files pytest collects (`test_*.py`, `*_test.py`):
+
+| Code     | Rule                                                     |
+|----------|----------------------------------------------------------|
+| `TST100` | a test ends with its only assertion, or with `pytest.raises` |
+| `TST200` | a test module keeps no constants, except `pytest_plugins` |
+| `TST300` | an assertion carries a negative message, such as `"x doesnt y"` |
+
+More rules of its own cover every file, tests or not:
+
+| Code     | Rule                                                     |
+|----------|----------------------------------------------------------|
+| `ENC100` | a class encapsulates one to four attributes; a `Protocol` is exempt |
+| `BOD100` | a function body holds no blank lines, except around a nested `def` or `class` |
+| `BOD200` | a function body holds no comments, except suppressions |
+
+As in Qulice, which rejects plain JUnit assertions, a test asserts through a
+Hamcrest matcher, never through a plain `assert`; ruff's `S101` stays on in
+tests too. PyHamcrest comes with the package:
+
+```python
+from hamcrest import assert_that, equal_to
+
+
+def test_checks_the_whole_directory_by_default(tmp_path: Path) -> None:
+    assert_that(
+        Project(EoTable(tmp_path / "pyproject.toml"), tmp_path).paths(),
+        equal_to((".",)),
+        "Project doesnt check the whole directory by default",
+    )
+```
+
+A rule may be suppressed on one line only, with a reason:
+`# noqa: PEO200 - pytest.Item is mutable by design`, or
+`# ruff: ignore[unused-import] - re-exported for plugins`.
+`eo::suppressions` enforces it:
+
+| Code     | Rule                                                     |
+|----------|----------------------------------------------------------|
+| `SUP001` | a suppression gives a reason after ` - `                 |
+| `SUP002` | a suppression never names `TID251` (`banned-api`), the ban on mocks |
+| `SUP003` | nothing suppresses past one line: no `# ruff: noqa`, `file-ignore` or `disable`, no `# flake8: noqa`, no `# mypy:` comment, no `# type: ignore` above the code |
+
+ruff already rejects a bare `# noqa` (`PGH004`), a bare `# type: ignore`
+(`PGH003`) and an unused `# noqa` for its own codes (`RUF100`).
+
+The configuration is bundled with the package (`src/pytest_eo/config/`)
+and cannot be overridden by a project. A project may only say what to
+check and what to skip:
+
+```toml
+[tool.eo]
+paths = ["src", "tests"]    # default: src and tests, if they exist
+exclude = ["generated/"]
+```
+
+## Usage
+
+```sh
+pip install 'pytest-eo==0.5.1'
+pytest --eo
+```
+
+Without `--eo` the plugin does nothing. Pin an exact version: every version
+of the rules is a version of the package, so pip installs new rules only
+when the version in the requirement changes.
+
+## Claude Code hooks
+
+This repository runs the gate on every Claude Code session that works in it:
+after Claude edits a `.py`, `.toml`, `.ini` or `.cfg` file, and again before
+it finishes. When the gate is red, the findings go back to Claude and it has
+to fix them. If the gate is still red after one retry, Claude may stop, and
+you see a warning instead.
+
+To get the same in another project:
+
+1. Install pytest-eo into the project's `.venv`.
+2. Copy `.claude/hooks/eo-gate.sh` into the same place in that project and
+   make it executable.
+3. Copy the `hooks` block of `.claude/settings.json` into that project's
+   `.claude/settings.json`, merging it with what is already there.
+4. Commit both files, so everyone who opens the project with Claude Code gets
+   the gate, and run `/hooks` once in an open session to load them.
+
+## Development
+
+```sh
+python3 -m venv .venv
+.venv/bin/pip install -e '.[dev]'
+make check
+```
+
+`make check` runs the tests and `pytest --eo` on the plugin itself; Rultor
+merges on it. `make coverage` measures lines and branches, counting the
+pytest subprocesses of the end-to-end tests too, and writes `coverage.xml`,
+which GitHub Actions sends to Codecov on every push and pull request.
+
+`pyproject.toml` on `main` always says `version = "0.0.0"`; a real version
+exists only in a tag. To release, comment in any issue, with the version in
+backticks, since Rultor reads nothing else:
+
+```text
+@rultor release, tag is `0.3.0`
+```
+
+Rultor writes the version into `pyproject.toml`, runs
+`make check`, commits the result on a side branch and pushes only the tag.
+GitHub Actions builds that tag and uploads it to PyPI through Trusted
+Publishing, so no token is stored anywhere.
+Every change to the rules or the bundled configuration ships in a release:
+raise the minor number for a new or stricter rule and the patch number for a
+fix.

pytest_eo-0.5.1/README.md

@@ -0,0 +1,157 @@
+# pytest-eo
+
+[![codecov](https://codecov.io/gh/RaulIQ/pytest-eo/graph/badge.svg)](https://codecov.io/gh/RaulIQ/pytest-eo)
+
+`pytest --eo` is a strict quality gate in the spirit of
+[Qulice](https://github.com/yegor256/qulice), built from ready-made tools.
+The plugin runs the tools, reads their reports, and shows each tool as a
+separate test; its own rules cover only tests and suppressions.
+
+| Test              | Tool                                           |
+|-------------------|------------------------------------------------|
+| `eo::ruff`        | `ruff check`, all rules (`select = ["ALL"]`)   |
+| `eo::ruff-format` | `ruff format --check`                          |
+| `eo::mypy`        | `mypy --strict`                                |
+| `eo::flake8`      | `flake8` with [pyeo](https://pypi.org/project/eo-styleguide/) (Elegant Objects rules) |
+| `eo::suppressions`| `# noqa` and `# ruff: ignore` comments         |
+
+The Elegant Objects rules enabled so far, most of them from
+[pyeo](https://github.com/blablatdinov/pyeo) and the rest from its sibling
+packages:
+
+| Code     | Rule                                         | Package |
+|----------|----------------------------------------------|---------|
+| `FIN100` | every class is `@final`                      | pyeo    |
+| `PEO101` | `__init__` contains only assignments         | pyeo    |
+| `PEO102` | `@classmethod` contains only a `cls()` call  | pyeo    |
+| `PEO200` | every class is frozen (immutable)            | pyeo    |
+| `PEO300` | no class names ending in "-er"               | pyeo    |
+| `PEO301` | no public attributes                         | pyeo    |
+| `PEO400` | no static methods                            | pyeo    |
+| `PEO500` | no `@property`, a getter in disguise         | pyeo    |
+| `PEO601` | no methods starting with `get`               | pyeo    |
+| `PEO602` | no getter methods                            | pyeo    |
+| `PEO700` | no introspection, casting, or reflection     | pyeo    |
+| `NPM100` | no private functions or methods              | [flake8-no-private-methods](https://github.com/blablatdinov/flake8-no-private-methods) |
+| `OVR100` | every public method is an `@override` of an interface method | [flake8-override](https://github.com/blablatdinov/flake8-override) |
+| `FOC100` | one public class per module                  | [flake8-one-class](https://github.com/blablatdinov/flake8-one-class) |
+
+mypy runs with `explicit-override` and `warn_unreachable` on top of
+`--strict`: an `@override` must override a real method, every overriding
+method must say so, and code that can never run is an error.
+Python 3.11 has no `typing.override`; import it from `typing_extensions`.
+
+The package also brings a flake8 plugin of its own, with rules in the spirit
+of "Angry Tests" for the files pytest collects (`test_*.py`, `*_test.py`):
+
+| Code     | Rule                                                     |
+|----------|----------------------------------------------------------|
+| `TST100` | a test ends with its only assertion, or with `pytest.raises` |
+| `TST200` | a test module keeps no constants, except `pytest_plugins` |
+| `TST300` | an assertion carries a negative message, such as `"x doesnt y"` |
+
+More rules of its own cover every file, tests or not:
+
+| Code     | Rule                                                     |
+|----------|----------------------------------------------------------|
+| `ENC100` | a class encapsulates one to four attributes; a `Protocol` is exempt |
+| `BOD100` | a function body holds no blank lines, except around a nested `def` or `class` |
+| `BOD200` | a function body holds no comments, except suppressions |
+
+As in Qulice, which rejects plain JUnit assertions, a test asserts through a
+Hamcrest matcher, never through a plain `assert`; ruff's `S101` stays on in
+tests too. PyHamcrest comes with the package:
+
+```python
+from hamcrest import assert_that, equal_to
+
+
+def test_checks_the_whole_directory_by_default(tmp_path: Path) -> None:
+    assert_that(
+        Project(EoTable(tmp_path / "pyproject.toml"), tmp_path).paths(),
+        equal_to((".",)),
+        "Project doesnt check the whole directory by default",
+    )
+```
+
+A rule may be suppressed on one line only, with a reason:
+`# noqa: PEO200 - pytest.Item is mutable by design`, or
+`# ruff: ignore[unused-import] - re-exported for plugins`.
+`eo::suppressions` enforces it:
+
+| Code     | Rule                                                     |
+|----------|----------------------------------------------------------|
+| `SUP001` | a suppression gives a reason after ` - `                 |
+| `SUP002` | a suppression never names `TID251` (`banned-api`), the ban on mocks |
+| `SUP003` | nothing suppresses past one line: no `# ruff: noqa`, `file-ignore` or `disable`, no `# flake8: noqa`, no `# mypy:` comment, no `# type: ignore` above the code |
+
+ruff already rejects a bare `# noqa` (`PGH004`), a bare `# type: ignore`
+(`PGH003`) and an unused `# noqa` for its own codes (`RUF100`).
+
+The configuration is bundled with the package (`src/pytest_eo/config/`)
+and cannot be overridden by a project. A project may only say what to
+check and what to skip:
+
+```toml
+[tool.eo]
+paths = ["src", "tests"]    # default: src and tests, if they exist
+exclude = ["generated/"]
+```
+
+## Usage
+
+```sh
+pip install 'pytest-eo==0.5.1'
+pytest --eo
+```
+
+Without `--eo` the plugin does nothing. Pin an exact version: every version
+of the rules is a version of the package, so pip installs new rules only
+when the version in the requirement changes.
+
+## Claude Code hooks
+
+This repository runs the gate on every Claude Code session that works in it:
+after Claude edits a `.py`, `.toml`, `.ini` or `.cfg` file, and again before
+it finishes. When the gate is red, the findings go back to Claude and it has
+to fix them. If the gate is still red after one retry, Claude may stop, and
+you see a warning instead.
+
+To get the same in another project:
+
+1. Install pytest-eo into the project's `.venv`.
+2. Copy `.claude/hooks/eo-gate.sh` into the same place in that project and
+   make it executable.
+3. Copy the `hooks` block of `.claude/settings.json` into that project's
+   `.claude/settings.json`, merging it with what is already there.
+4. Commit both files, so everyone who opens the project with Claude Code gets
+   the gate, and run `/hooks` once in an open session to load them.
+
+## Development
+
+```sh
+python3 -m venv .venv
+.venv/bin/pip install -e '.[dev]'
+make check
+```
+
+`make check` runs the tests and `pytest --eo` on the plugin itself; Rultor
+merges on it. `make coverage` measures lines and branches, counting the
+pytest subprocesses of the end-to-end tests too, and writes `coverage.xml`,
+which GitHub Actions sends to Codecov on every push and pull request.
+
+`pyproject.toml` on `main` always says `version = "0.0.0"`; a real version
+exists only in a tag. To release, comment in any issue, with the version in
+backticks, since Rultor reads nothing else:
+
+```text
+@rultor release, tag is `0.3.0`
+```
+
+Rultor writes the version into `pyproject.toml`, runs
+`make check`, commits the result on a side branch and pushes only the tag.
+GitHub Actions builds that tag and uploads it to PyPI through Trusted
+Publishing, so no token is stored anywhere.
+Every change to the rules or the bundled configuration ships in a release:
+raise the minor number for a new or stricter rule and the patch number for a
+fix.

pytest_eo-0.5.1/pyproject.toml

@@ -0,0 +1,54 @@
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[project]
+name = "pytest-eo"
+version = "0.5.1"
+description = "pytest --eo: strict style gate over ruff, mypy --strict and pyeo"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE.txt"]
+authors = [{ name = "RaulIQ" }]
+requires-python = ">=3.11"
+dependencies = [
+    "pytest>=8",
+    "ruff==0.17.1",
+    "mypy==2.4.0",
+    "flake8==7.4.1",
+    "eo-styleguide==0.2.0",
+    "flake8-override==0.1.1",
+    "typing_extensions>=4.4",
+    "PyHamcrest>=2.1",
+]
+
+[project.optional-dependencies]
+dev = ["coverage>=7.10"]
+
+[project.entry-points.pytest11]
+eo = "pytest_eo.plugin"
+
+[project.entry-points."flake8.extension"]
+TST = "pytest_eo.angry_tests:AngryTests"
+ENC = "pytest_eo.encapsulation:Encapsulation"
+BOD = "pytest_eo.bodies:Bodies"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/pytest_eo"]
+
+[tool.eo]
+paths = ["src", "tests"]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]
+
+[tool.coverage.run]
+branch = true
+source = ["pytest_eo"]
+patch = ["subprocess"]
+parallel = true
+
+[tool.coverage.report]
+show_missing = true
+skip_covered = true

pytest_eo-0.5.1/src/pytest_eo/__init__.py

@@ -0,0 +1 @@
+"""pytest --eo: a strict style gate that aggregates ready-made tools."""