Merge pull request #34 from George-Ogden/release

Ready For Release

Author: George-Ogden

.github/workflows/test.yaml

@@ -16,13 +16,13 @@ jobs:
         total-shards: [3]
     uses: George-Ogden/actions/.github/workflows/python-test.yaml@v3.1.3
     with:
-      python-versions: "['3.13']"
+      python-versions: "['3.12', '3.13', '3.14']"
       timeout-minutes: 15
       pytest-flags: -vv mypy_pytest_plugin -n auto --shard-id=${{ matrix.shard }} --num-shards=${{ matrix.total-shards }}
 
   integration_tests:
     uses: George-Ogden/actions/.github/workflows/python-test.yaml@v3.1.3
     with:
-      python-versions: "['3.13']"
+      python-versions: "['3.12', '3.13', '3.14']"
       timeout-minutes: 10
       pytest-flags: -vv tests -n auto

LICENSE

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

README.md

@@ -0,0 +1,74 @@
+# Mypy Pytest
+
+A Mypy plugin for type checking Pytest code.
+(Not a Pytest plugin for running Mypy.)
+
+## Features
+
+- Check your parametrizations are correct
+  - [x] You didn't mispel the argnames
+  - [x] Your test cases have the right type
+  - [x] You didn't forget any arguments
+- Works with fixtures
+  - [x] Your fixtures have the correct types
+  - [x] All the fixture arguments are included
+  - [x] You don't have conflicting fixtures
+- Checks your mocks
+  - [x] Your mock has the correct type (or close enough)
+- Checks your marks
+  - [x] You're using a pre-defined mark
+  - [x] Your mark is registered
+- Checks for `Iterator` bugs
+  - [x] You're robustly testing methods that want `Iterable` by giving them an `Iterable` and not a `Sequence`
+- Works with whatever Pytest configuration
+  - [x] Only checks your custom test files and test names
+  - [x] Analyzes third-party Pytest plugins
+- [x] Some [limitations](#limitations) because Mypy didn't expect plugins this cool :sunglasses:
+- [x] All the rest of Mypy
+
+## Install and Usage
+
+Install with pip
+
+```bash
+pip install git+https://github.com/George-Ogden/dbg.git
+```
+
+Then register the plugin.
+
+`pyproject.toml`:
+
+```toml
+plugins = ["mypy_pytest_plugin.plugin"]
+```
+
+`mypy.ini`:
+
+```toml
+plugins = mypy_pytest_plugin.plugin
+```
+
+See the [Mypy docs](https://mypy.readthedocs.io/en/stable/extending_mypy.html#configuring-mypy-to-use-plugins) for more info.
+
+## Limitations
+
+The Mypy plugin system is fairly limited, so this can only check marked functions.
+If you're using parametrized testing, that's fine as you `pytest.mark.parametrize`.
+If not, [add a `typed` mark](https://docs.pytest.org/en/stable/how-to/mark.html#registering-marks) then mark any remaining tests you want to check.
+
+```python
+import random
+import pytest
+
+@pytest.fixture
+def random_0_to_10() -> float:
+    return random.random() * 10
+
+@pytest.mark.typed
+def test_random_string_length(random_0_to_10: int) -> None: # 'test_random_string_length' requests 'random_0_to_10' with type "float", but expects type "int"
+    assert 0 <= random_0_to_10 <= 10
+```
+
+## Development
+
+Use the GitHub issue tracker for bugs/feature requests.

mypy_pytest_plugin/plugin.py

@@ -65,8 +65,6 @@ def get_attribute_hook(self, fullname: str) -> Callable[[AttributeContext], Type
 
     @classmethod
     def check_mark(cls, ctx: AttributeContext) -> Type:
-        if ctx.api.path == "test_samples/mark_test.py":
-            ...
         if (
             not ctx.is_lvalue
             and isinstance(checker := ctx.api, TypeChecker)

pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "mypy-pytest-plugin"
 requires-python = ">=3.12,<3.15"
-version = "0.8.0"
+version = "1.0.0"
 dynamic = ["dependencies"]
 
 [tool.setuptools]

test_samples/mock_test.py

@@ -2,7 +2,7 @@
 
 import sys
 from typing import TYPE_CHECKING, Any
-from unittest.mock import MagicMock, Mock, NonCallableMock, PropertyMock, ThreadingMock
+from unittest.mock import MagicMock, Mock, NonCallableMock, PropertyMock
 
 if TYPE_CHECKING:
     from mypy_pytest_plugin_types.mock import Mock as _Mock
@@ -42,4 +42,7 @@ def increment_float(x: float) -> float:
 Mock() + Mock()
 MagicMock() + MagicMock()
 
-ThreadingMock()
+if sys.version_info >= (3, 13):
+    from unittest.mock import ThreadingMock
+
+    ThreadingMock()