typing-protocol-intersection 0.5.3__tar.gz → 0.6.1__tar.gz

typing_protocol_intersection-0.6.1/.github/workflows/ci.yml

@@ -0,0 +1,29 @@
+name: tests & static analysis
+
+on:
+  push:
+  pull_request:
+    branches: ["master"]
+  schedule:
+    - cron: "0 7 * * *"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14", "3.14t"]
+        mypy-version: ["1.5.0", "latest"]
+
+    steps:
+      - uses: actions/checkout@v3
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+      - name: Set Python version
+        run: uv python install ${{ matrix.python-version }}
+      - name: Run linting
+        run: make lint
+      # Run tests with the matrix combination of Python and mypy versions
+      # Conditionally adds MYPY parameter only when not using latest
+      - name: Run tests
+        run: make test-version PYTHON=${{ matrix.python-version }} ${{ matrix.mypy-version != 'latest' && format('MYPY={0}', matrix.mypy-version) || '' }}

typing_protocol_intersection-0.6.1/.gitignore

@@ -0,0 +1,161 @@
+
+# Created by https://www.toptal.com/developers/gitignore/api/python
+# Edit at https://www.toptal.com/developers/gitignore?templates=python
+
+### Python ###
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# End of https://www.toptal.com/developers/gitignore/api/python
+.idea
+create-github-release.sh

typing_protocol_intersection-0.6.1/CHANGELOG.md

@@ -0,0 +1,114 @@
+# Changelog
+
+## 0.6.1
+
+Add support for mypy==1.19.x.
+
+## 0.6.0
+
+- Drop support for Python 3.9.
+- Drop support for mypy<1.5.0.
+- Add support for mypy==1.18.x.
+- Add support for Python 3.14.
+- Use uv and ruff for dev environment, CI and linting.
+- Mark package with free-threaded-support.
+
+## 0.5.3
+
+Add support for mypy==1.15.x.
+
+## 0.5.2
+
+Add support for mypy==1.14.x.
+
+## 0.5.1
+
+Add support for mypy==1.13.x.
+
+## 0.5.0
+
+- Drop support for Python 3.8.
+- Add Python 3.13 support.
+- Add support for mypy==1.12.x.
+
+## 0.4.2
+
+Add support for mypy==1.11.x.
+
+## 0.4.1
+
+Add support for mypy==1.10.x.
+
+## 0.4.0
+
+- Drop support for Python 3.7.
+- Add support for mypy==1.9.x.
+
+## 0.3.10
+
+Add support for mypy==1.8.x.
+
+## 0.3.9
+
+Add support for mypy==1.7.x.
+
+## 0.3.8
+
+- Add support for mypy==1.6.x.
+- Add Python 3.12 support.
+
+## 0.3.7
+
+Fixed mypy crashing in incremental mode (#5). Contributed by @drvink.
+
+## 0.3.6
+
+Add support for mypy==1.5.x.
+
+## 0.3.5
+
+Add support for mypy==1.5.x.
+
+## 0.3.4
+
+Add support for mypy==1.4.x.
+
+## 0.3.3
+
+Add support for mypy==1.3.x.
+
+## 0.3.2
+
+Add support for mypy==1.2.x.
+
+## 0.3.1
+
+Add support for mypy==1.1.x.
+
+## 0.3.0
+
+Add support for mypy==1.0.0.
+
+## 0.2.3
+
+Explicitly specify supported mypy versions as 0.920 <= x <= 0.991 and fail loudly for others.
+
+## 0.2.2
+
+Add Python 3.11 support.
+
+## 0.2.1
+
+Fix support for protocols inheriting another protocols when used as type arguments.
+
+## 0.2
+
+Fix support for protocols inheriting another protocols.
+
+## 0.1.1
+
+Add `py.typed` to the build artifact.
+
+## 0.1
+
+Initial version. Consists of a mypy plugin and a `ProtocolIntersection` type.

typing_protocol_intersection-0.6.1/DEVELOPMENT.md

@@ -0,0 +1,41 @@
+# Running tests
+
+Install [uv](https://docs.astral.sh/uv/) and run tests using the Makefile:
+```shell
+make install     # Install package and dependencies
+make lint        # Run all linters (mypy, ruff check, ruff format --check, pylint)
+make test        # Run tests with coverage
+make format      # Format code with ruff
+make all         # Run both lint and test
+make test-all    # Run tests across all Python versions with mypy 1.5.0 and latest
+```
+
+# Publishing a new release
+
+1. Run tests as described above.
+2. Update [`CHANGELOG.md`](./CHANGELOG.md).
+3. Bump version in [`pyproject.toml`](./pyproject.toml).
+4. Build and upload to pypi:
+    ```shell
+    make build              # Build the package
+    make check-build        # Check for common issues
+    make upload             # Upload to testpypi (default)
+    make upload REPO=pypi   # Upload to production PyPI
+    ```
+5. Create a new release on [github](https://github.com/klausweiss/typing-protocol-intersection/releases).
+
+# When a new mypy version is released
+
+Mypy may introduce breaking changes in minor versions (see [this blogpost](https://mypy-lang.blogspot.com/2023/02/mypy-10-released.html)).
+We don't want to risk false positives when stating the plugin works with mypy versions that haven't been tested and may have introduced breaking changes.
+That's why for every minor mypy release, this plugin should be updated as well.
+This can be a very repetitive process, so it has been automated.
+
+When a new mypy version is released, run the following script:
+```shell
+./tools/prepare-pr-after-mypy-bump.sh NEW_MYPY_VERSIONS
+```
+
+It will make necessary changes to code and commit them.
+Review the commit made by the plugin, run tests, and if it looks good, push.
+

typing_protocol_intersection-0.6.1/Makefile

@@ -0,0 +1,94 @@
+.PHONY: help
+help: ## Show this help message
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}'
+
+.PHONY: install
+install: ## Install package and dependencies
+	uv sync --all-extras --dev
+
+.PHONY: build
+build: ## Build the package (wheel and sdist)
+	uv build
+
+.PHONY: upload
+upload: ## Upload package to PyPI repository (REPO=testpypi or pypi, default: testpypi)
+	@if [ -z "$(REPO)" ]; then \
+		echo "Uploading to testpypi (default)..."; \
+		uv run twine upload dist/* -r testpypi; \
+	elif [ "$(REPO)" = "pypi" ]; then \
+		echo "Uploading to production PyPI..."; \
+		uv run twine upload dist/*; \
+	elif [ "$(REPO)" = "testpypi" ]; then \
+		echo "Uploading to testpypi..."; \
+		uv run twine upload dist/* -r testpypi; \
+	else \
+		echo "Error: Invalid REPO value. Use 'pypi' or 'testpypi'"; \
+		exit 1; \
+	fi
+
+.PHONY: check-build
+check-build: ## Check the built package for common issues
+	uv run twine check dist/*
+
+.PHONY: test
+test: ## Run tests with coverage
+	uv run pytest -vv --cov=typing_protocol_intersection
+
+.PHONY: test-version
+test-version: ## Run tests with specific Python and mypy versions (PYTHON=3.10 [MYPY=1.5.0])
+	@if [ -z "$(PYTHON)" ]; then \
+		echo "Error: PYTHON version must be specified. Usage: make test-version PYTHON=3.10 [MYPY=1.5.0]"; \
+		exit 1; \
+	fi
+	@if [ -n "$(MYPY)" ]; then \
+		echo "Running tests on Python $(PYTHON) with mypy==$(MYPY)..."; \
+		uv run --python $(PYTHON) --with mypy==$(MYPY) pytest -vv --cov=typing_protocol_intersection; \
+	else \
+		echo "Running tests on Python $(PYTHON) with latest mypy..."; \
+		uv run --python $(PYTHON) pytest -vv --cov=typing_protocol_intersection; \
+	fi
+
+.PHONY: test-all
+test-all: ## Run tests across all supported Python versions with mypy 1.5.0 and latest
+	@$(MAKE) test-version PYTHON=3.10 MYPY=1.5.0
+	@$(MAKE) test-version PYTHON=3.10
+	@$(MAKE) test-version PYTHON=3.11 MYPY=1.5.0
+	@$(MAKE) test-version PYTHON=3.11
+	@$(MAKE) test-version PYTHON=3.12 MYPY=1.5.0
+	@$(MAKE) test-version PYTHON=3.12
+	@$(MAKE) test-version PYTHON=3.13 MYPY=1.5.0
+	@$(MAKE) test-version PYTHON=3.13
+	@$(MAKE) test-version PYTHON=3.14 MYPY=1.5.0
+	@$(MAKE) test-version PYTHON=3.14
+	@$(MAKE) test-version PYTHON=3.14t MYPY=1.5.0
+	@$(MAKE) test-version PYTHON=3.14t
+
+.PHONY: lint
+lint: ## Run all linters (mypy, ruff check, ruff format --check, pylint)
+	uv run mypy typing_protocol_intersection
+	uv run ruff check .
+	uv run ruff format --check .
+	uv run pylint typing_protocol_intersection tests
+
+.PHONY: format
+format: ## Format code with ruff
+	uv run ruff format .
+
+.PHONY: all
+all: lint test ## Run lint and test
+
+.PHONY: clean
+clean: ## Remove build artifacts, cache files, and compiled Python files
+	rm -rf build dist *.egg-info
+	rm -rf .pytest_cache .mypy_cache .ruff_cache
+	find . -type d -name __pycache__ -exec rm -rf {} +
+	find . -type f -name '*.pyc' -delete
+	find . -type f -name '*.pyo' -delete
+
+.PHONY: bump-mypy
+bump-mypy: ## Prepare PR for new mypy version (fetches latest or use VERSION=x.y.z)
+	@if [ -n "$(VERSION)" ]; then \
+		./tools/prepare-pr-after-mypy-bump.sh $(VERSION); \
+	else \
+		./tools/prepare-pr-after-mypy-bump.sh; \
+	fi

{typing_protocol_intersection-0.5.3 → typing_protocol_intersection-0.6.1}/PKG-INFO

@@ -1,21 +1,22 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: typing-protocol-intersection
-Version: 0.5.3
+Version: 0.6.1
 Summary: Protocol intersection for mypy
-Home-page: https://github.com/klausweiss/typing-protocol-intersection
+Project-URL: Homepage, https://github.com/klausweiss/typing-protocol-intersection
 Project-URL: Bug Tracker, https://github.com/klausweiss/typing-protocol-intersection/issues
+License: MIT
+License-File: LICENSE
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Typing :: Typed
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
-License-File: LICENSE
 
 # typing-protocol-intersection
 
@@ -31,14 +32,14 @@ See the [examples](#examples) section below.
 
 ## Supported versions
 
-The plugin supports python 3.9 up to 3.13 and mypy >= 0.920 and <= 1.15.x.
+The plugin supports python 3.10 up to 3.14 and mypy >= 1.5.0 and <= 1.19.x.
 
 ## Installation
 
 The `typing-protocol-intersection` package is pip-installable:
 
 ```shell
-pip install typing-protocol-intersection 
+pip install typing-protocol-intersection
 ```
 
 ## Configuration

{typing_protocol_intersection-0.5.3 → typing_protocol_intersection-0.6.1}/README.md

@@ -12,14 +12,14 @@ See the [examples](#examples) section below.
 
 ## Supported versions
 
-The plugin supports python 3.9 up to 3.13 and mypy >= 0.920 and <= 1.15.x.
+The plugin supports python 3.10 up to 3.14 and mypy >= 1.5.0 and <= 1.19.x.
 
 ## Installation
 
 The `typing-protocol-intersection` package is pip-installable:
 
 ```shell
-pip install typing-protocol-intersection 
+pip install typing-protocol-intersection
 ```
 
 ## Configuration

typing_protocol_intersection-0.6.1/pyproject.toml

@@ -0,0 +1,110 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "typing-protocol-intersection"
+version = "0.6.1"
+description = "Protocol intersection for mypy"
+readme = "README.md"
+requires-python = ">=3.10"
+license = {text = "MIT"}
+authors = [
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Typing :: Typed",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+free-threaded-support = true
+
+[project.urls]
+Homepage = "https://github.com/klausweiss/typing-protocol-intersection"
+"Bug Tracker" = "https://github.com/klausweiss/typing-protocol-intersection/issues"
+
+[dependency-groups]
+dev = [
+    "mypy",
+    "pylint",
+    "pytest",
+    "pytest-cov",
+    "ruff",
+    "twine",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["."]
+include = ["**/*.py", "**/*.pyi", "**/py.typed"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py310"
+
+[tool.ruff.lint]
+select = [
+    "E",      # pycodestyle errors
+    "W",      # pycodestyle warnings
+    "F",      # pyflakes
+    "I",      # isort
+    "N",      # pep8-naming
+    "UP",     # pyupgrade
+    "B",      # flake8-bugbear
+    "S",      # flake8-bandit
+    "C4",     # flake8-comprehensions
+    "DTZ",    # flake8-datetimez
+    "PIE",    # flake8-pie
+    "Q",      # flake8-quotes
+    "RET",    # flake8-return
+    "SIM",    # flake8-simplify
+]
+ignore = [
+    "S101",   # allow assert statements
+    "E501",   # some tests have too-long lines
+    "D",      # pydocstyle - no docstrings required
+]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+
+[tool.mypy]
+check_untyped_defs = true
+disallow_any_generics = true
+disallow_any_unimported = true
+disallow_incomplete_defs = true
+disallow_subclassing_any = true
+disallow_untyped_calls = true
+disallow_untyped_decorators = true
+disallow_untyped_defs = true
+implicit_reexport = false
+no_implicit_optional = true
+show_column_numbers = true
+show_error_codes = true
+strict_equality = true
+strict_optional = true
+warn_no_return = true
+warn_redundant_casts = true
+warn_return_any = true
+warn_unused_configs = true
+
+[tool.pylint.MASTER]
+extension-pkg-allow-list = "mypy"
+
+[tool.pylint."MESSAGES CONTROL"]
+disable = """
+    duplicate-code,
+    line-too-long,
+    missing-class-docstring,
+    missing-function-docstring,
+    missing-module-docstring,
+    no-name-in-module,
+    redefined-outer-name,
+    too-few-public-methods,
+    typevar-name-incorrect-variance,
+    """

typing_protocol_intersection-0.6.1/tests/conftest.py

@@ -0,0 +1,34 @@
+import typing
+from pathlib import Path
+
+import mypy.api
+import pytest
+
+HERE = Path(__file__).parent
+
+
+@pytest.fixture
+def run_mypy(strip_invisible: typing.Callable[[str], str]):
+    def _run_mypy(input_file: Path, no_incremental: bool = True) -> tuple[str, str]:
+        args = [str(input_file), "--config-file", str(HERE / "test-mypy.ini")]
+        if no_incremental:
+            args.append("--no-incremental")
+        stdout, stderr, _ = mypy.api.run(args)
+        return strip_invisible(stdout), strip_invisible(stderr)
+
+    return _run_mypy
+
+
+@pytest.fixture
+def strip_invisible() -> typing.Callable[[str], str]:
+    def _strip_invisible(string: str) -> str:
+        """Removes all zero-width spaces from the input text and strips
+        whitespaces.
+
+        The need for the former was born with an ugly hack that we use
+        to trick mypyc.
+        """
+        zero_width_space = "\u200b"
+        return string.strip().replace(zero_width_space, "")
+
+    return _strip_invisible

typing_protocol_intersection-0.6.1/tests/test-mypy.ini

@@ -0,0 +1,20 @@
+[mypy]
+plugins = ../typing_protocol_intersection/mypy_plugin.py
+check_untyped_defs = True
+disallow_any_generics = True
+disallow_any_unimported = True
+disallow_incomplete_defs = True
+disallow_subclassing_any = True
+disallow_untyped_calls = True
+disallow_untyped_decorators = True
+disallow_untyped_defs = True
+implicit_reexport = False
+no_implicit_optional = True
+show_column_numbers = True
+show_error_codes = True
+strict_equality = True
+strict_optional = True
+warn_no_return = True
+warn_redundant_casts = True
+warn_return_any = True
+warn_unused_configs = True