fix(mypy): Stub passes type check with 1.10

Runtime check still requires mypy 1.11 however

.github/workflows/compat.yml

@@ -9,9 +9,14 @@ jobs:
       fail-fast: false
       matrix:
         myver:
+          - 1.10.0
+          - 1.10.1
           - 1.11.0
           - 1.11.1
           - 1.11.2
+          - 1.12.0
+          - 1.12.1
+          - 1.13.0
     runs-on: ubuntu-22.04
     steps:
       - uses: actions/checkout@v4

lxml-stubs/etree/_factory_func.pyi

@@ -41,7 +41,7 @@ Element: _ElementFactory
 # type annotation attribute is modified.
 # OE users need to use E-factory for more flexibility.
 @overload
-def SubElement(
+def SubElement(  # type: ignore[overload-overlap]
     _parent: ObjectifiedElement,
     _tag: _TagName,
     /,

lxml-stubs/etree/_xslt.pyi

@@ -220,7 +220,7 @@ class XSLTExtension(metaclass=abc.ABCMeta):
         remove_blank_text: bool = False,
     ) -> None: ...
     @overload
-    def apply_templates(  # pyright: ignore[reportOverlappingOverload]
+    def apply_templates(  # type: ignore[overload-overlap]  # pyright: ignore[reportOverlappingOverload]
         self,
         context: Any,
         node: Any,
@@ -269,7 +269,7 @@ class XSLTExtension(metaclass=abc.ABCMeta):
         remove_blank_text: bool = False,
     ) -> None: ...
     @overload
-    def process_children(  # pyright: ignore[reportOverlappingOverload]
+    def process_children(  # type: ignore[overload-overlap]  # pyright: ignore[reportOverlappingOverload]
         self,
         context: Any,
         output_parent: None = None,

lxml-stubs/html/_parse.pyi

@@ -91,7 +91,7 @@ def document_fromstring(
     base_url: str | None = None,
 ) -> HtmlElement: ...
 @overload
-def fragments_fromstring(  # pyright: ignore[reportOverlappingOverload]
+def fragments_fromstring(  # type: ignore[overload-overlap]  # pyright: ignore[reportOverlappingOverload]
     html: _AnyStr,
     no_leading_text: Literal[True],
     base_url: str | None = None,

lxml-stubs/html/html5parser.pyi

@@ -55,14 +55,14 @@ def document_fromstring(
 # 2 for html (bytes/str)
 # 2 for no_leading_text (true/false)
 @overload  # html=bytes, no_leading_text=true
-def fragments_fromstring(  # pyright: ignore[reportOverlappingOverload]
+def fragments_fromstring(  # type: ignore[overload-overlap]  # pyright: ignore[reportOverlappingOverload]
     html: bytes,
     no_leading_text: Literal[True],
     guess_charset: bool | None = None,
     parser: HTMLParser | None = None,
 ) -> list[_Element]: ...
 @overload  # html=str, no_leading_text=true
-def fragments_fromstring(  # pyright: ignore[reportOverlappingOverload]
+def fragments_fromstring(  # type: ignore[overload-overlap]  # pyright: ignore[reportOverlappingOverload]
     html: str,
     no_leading_text: Literal[True],
     guess_charset: None = None,

pyproject.toml

@@ -37,10 +37,15 @@ classifiers = [
 [project.urls]
 homepage = 'https://github.com/abelcheung/types-lxml'
 
+# Although mypy 1.10 itself produce no problem in stub,
+# it is basically unusable for real life code that uses lxml,
+# not until following improvement is done in 1.11.
+# https://mypy.readthedocs.io/en/stable/changelog.html#type-inference-improvements
+
 [project.optional-dependencies]
 test = [
     'tox ~= 4.0',
-    'mypy ~= 1.11.0',
+    'mypy ~= 1.11',
     'pyright >= 1.1.351',
     'typeguard >= 3.0; python_full_version < "3.12.4"',
     'typeguard >= 4.3.0; python_full_version >= "3.12.4"',
@@ -99,6 +104,7 @@ packages = 'lxml-stubs'
 strict = true
 show_error_context = true
 pretty = true
+warn_unused_ignores = false
 
 [tool.ruff]
 target-version = "py312"

tox.ini

@@ -27,10 +27,16 @@ deps =
 commands =
     pytest --mypy-ini-file=test-stub/mypy-pytest.ini {posargs:test-stub}
 
+# Although mypy 1.10 itself produce no problem in stub,
+# it is basically unusable for real life code that uses lxml,
+# not until following improvement is done in 1.11.
+# https://mypy.readthedocs.io/en/stable/changelog.html#type-inference-improvements
+# So runtime test requires 1.11 instead
+
 [testenv:py{310,311,312}-rt-lxml{49,50,51,52,53},py313-rt-lxml53]
 deps =
     {[testenv:pyright]deps}
-    {[testenv:mypy]deps}
+    mypy == 1.11.2
     typeguard == 4.3.0
     pytest == 8.3.3
     html5lib == 1.1
@@ -57,7 +63,7 @@ commands =
 [testenv:mypy]
 deps =
     {[common_dep]deps}
-    mypy == 1.12.0
+    mypy == 1.10.1
 package = skip
 commands = mypy {posargs:} lxml-stubs