feat: initial implementation

Author: LifeLex

.github/workflows/publish.yml

@@ -0,0 +1,55 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  id-token: write
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - name: Install dependencies
+        run: pip install tox ruff mypy pyright pytest
+      - name: Run tests
+        run: tox -e py
+      - name: Ruff check
+        run: ruff check src tests
+      - name: Ruff format
+        run: ruff format --check src tests
+      - name: mypy
+        run: mypy src
+      - name: pyright
+        run: pyright src
+
+  publish:
+    needs: test
+    runs-on: ubuntu-latest
+    environment: pypi
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

.github/workflows/test.yml

@@ -0,0 +1,61 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        os: [ubuntu-latest, windows-latest, macos-latest]
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install tox
+        run: pip install tox
+
+      - name: Run tests
+        run: tox -e py
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: pip install ruff
+      - name: Ruff check
+        run: ruff check src tests
+      - name: Ruff format
+        run: ruff format --check src tests
+
+  type-check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - name: Install dependencies
+        run: pip install mypy pyright pytest
+      - name: mypy
+        run: mypy src
+      - name: pyright
+        run: pyright src

.gitignore

@@ -27,3 +27,13 @@ env/
 
 # Type checking
 .mypy_cache/
+.pyright/
+
+# Coverage
+.coverage
+.coverage.*
+htmlcov/
+coverage.xml
+
+# Setuptools SCM
+src/pytest_do_not_mock/_version.py

.pre-commit-config.yaml

@@ -0,0 +1,36 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+      - id: check-merge-conflict
+      - id: debug-statements
+      - id: check-toml
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.4.8
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: local
+    hooks:
+      - id: mypy
+        name: mypy
+        entry: mypy src
+        language: system
+        types: [python]
+        files: ^src/
+        pass_filenames: false
+
+      - id: pyright
+        name: pyright
+        entry: pyright src
+        language: system
+        types: [python]
+        files: ^src/
+        pass_filenames: false

CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## 0.1.0 (Unreleased)
+
+- Initial release
+- `@pytest.do_not_mock` decorator to block all mocking in a test
+- `@pytest.do_not_mock(func1, func2)` to protect specific functions
+- Support for function objects and string module paths
+- Detection of `unittest.mock.patch` (decorator, context manager, start/stop)
+- Detection of `Mock`, `MagicMock`, `AsyncMock`, `create_autospec`
+- Python 3.10-3.13 support

README.md

@@ -1,13 +1,88 @@
 # pytest-do-not-mock
 
-A pytest plugin that prevents mocking of specific classes and functions.
+Pytest plugin to prevent mocking of critical functions in tests.
 
 ## Installation
 
 ```bash
 pip install pytest-do-not-mock
 ```
 
+The plugin activates automatically once installed — no configuration needed.
+
+## Usage
+
+### Block all mocking in a test
+
+Use `@pytest.do_not_mock` with no arguments to prevent any mocking:
+
+```python
+import pytest
+
+@pytest.do_not_mock
+def test_payment_integration():
+    """This test must use real implementations, no mocks allowed."""
+    result = process_payment(100.0)
+    assert result is True
+```
+
+Any attempt to use `Mock()`, `MagicMock()`, `patch()`, or similar will raise `DoNotMockError`.
+
+### Protect specific functions
+
+Pass functions (or string paths) to only block mocking of those targets:
+
+```python
+from myapp import process_payment, send_email
+
+@pytest.do_not_mock(process_payment)
+def test_selective():
+    """process_payment cannot be mocked, but other functions can."""
+    with patch("myapp.send_email"):  # this is fine
+        result = process_payment(100.0)
+        assert result is True
+```
+
+Multiple functions and string paths are supported:
+
+```python
+@pytest.do_not_mock(process_payment, validate_user)
+def test_multiple():
+    ...
+
+@pytest.do_not_mock("myapp.payments.charge")
+def test_string_path():
+    ...
+```
+
+### What gets blocked
+
+**No-args mode** (`@pytest.do_not_mock`):
+- `Mock()`, `MagicMock()`, `AsyncMock()`
+- `patch()` as decorator, context manager, or `start()`/`stop()`
+- `patch.object()`, `patch.dict()`
+- `create_autospec()`
+
+**Targeted mode** (`@pytest.do_not_mock(func)`):
+- `patch()` targeting the protected function
+- `patch.object()` targeting the protected function
+- Other mocking is allowed
+
+## Testing
+
+```bash
+tox
+```
+
+Runs tests across Python 3.10–3.13, plus ruff linting and type checking (mypy + pyright).
+
+```bash
+tox -e py313          # single Python version
+tox -e linting        # ruff check + format
+tox -e typing         # mypy + pyright
+pytest tests/ -v      # run tests directly
+```
+
 ## Development
 
 ```bash
@@ -16,5 +91,19 @@ cd pytest-do-not-mock
 python3 -m venv .venv
 source .venv/bin/activate
 pip install -e ".[dev]"
-pytest
 ```
+
+### Project structure
+
+```
+src/pytest_do_not_mock/
+├── __init__.py      # Public API: do_not_mock, DoNotMockError
+└── plugin.py        # Decorator + pytest hooks
+
+tests/
+└── test_do_not_mock.py
+```
+
+## License
+
+MIT