Skip to content

Commit 3bf5bbd

Browse files
authored
Merge branch 'main' into update-generics-pep695
2 parents 0225ec1 + 7bf2409 commit 3bf5bbd

File tree

4 files changed

+17
-9
lines changed

4 files changed

+17
-9
lines changed

conformance/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -81,7 +81,7 @@ Note that some type checkers may not run on some platforms. If a type checker fa
8181

8282
Different type checkers report errors in different ways (with different wording in error messages and different line numbers or character ranges for errors). This variation makes it difficult to fully automate test validation given that tests will want to check for both false positive and false negative type errors. Some level of manual inspection will therefore be needed to determine whether a type checker is fully conformant with all tests in any given test file. This "scoring" process is required only when the output of a test changes — e.g. when a new version of that type checker is released and the tests are rerun. We assume that the output of a type checker will be the same from one run to the next unless/until a new version is released that fixes or introduces a bug. In this case, the output will need to be manually inspected and the conformance results re-scored for those tests whose output has changed.
8383

84-
Conformance results are reported and summarized for each supported type checker. Currently, results are reported for mypy, pyrefly, pyright, zuban and ty. It is the goal and desire to add additional type checkers over time.
84+
[Conformance results](https://htmlpreview.github.io/?https://github.com/python/typing/blob/main/conformance/results/results.html) are reported and summarized for each supported type checker. Currently, results are reported for mypy, pyrefly, pyright, zuban and ty. It is the goal and desire to add additional type checkers over time.
8585

8686
## Adding a New Test Case
8787

conformance/tests/constructors_call_metaclass.py

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ def __new__(cls, x: int) -> Self:
4343

4444
class Meta3(type):
4545
def __call__(cls: type[T], *args, **kwargs) -> T:
46-
return super().__call__(cls, *args, **kwargs)
46+
return super().__call__(*args, **kwargs)
4747

4848

4949
class Class3(metaclass=Meta3):
@@ -57,7 +57,7 @@ def __new__(cls, x: int) -> Self:
5757

5858
class Meta4(type):
5959
def __call__(cls, *args, **kwargs):
60-
return super().__call__(cls, *args, **kwargs)
60+
return super().__call__(*args, **kwargs)
6161

6262

6363
class Class4(metaclass=Meta4):

docs/Makefile

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ build:
2929
html: BUILDER = html
3030
html: build
3131
@echo "Build finished. The HTML pages are in build/html."
32-
@echo "file://$(shell pwd)/build/html"
32+
@echo "file://$(shell pwd)/build/html/index.html"
3333
@echo
3434

3535
text: BUILDER = text

docs/index.rst

Lines changed: 13 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -57,6 +57,15 @@ Specification
5757

5858
spec/index
5959

60+
61+
Typing PEPs
62+
-----------
63+
64+
Significant changes to the Python Type System Specification are proposed and
65+
discussed in Python Enhancement Proposals (PEPs). See
66+
https://peps.python.org/topic/typing for a list of all current and historical
67+
typing-related PEPs.
68+
6069
Indices and tables
6170
==================
6271

@@ -85,6 +94,10 @@ Type Checkers
8594
* `ty <https://docs.astral.sh/ty/>`_
8695
* `Zuban <https://docs.zubanls.com/en/latest/>`_
8796

97+
The extent to which these adhere to the specification is monitored by a
98+
`conformance test suite <https://github.com/python/typing/tree/main/conformance>`_
99+
(`results <https://htmlpreview.github.io/?https://github.com/python/typing/blob/main/conformance/results/results.html>`_).
100+
88101
Development Environments
89102
------------------------
90103

@@ -116,8 +129,3 @@ Type-Hint and Stub Integration
116129
a thin wrapper around ``ApplyTypeAnnotationsVisitor`` from
117130
`libCST <https://libcst.readthedocs.io/en/latest/>`_ that integrates .pyi
118131
signatures as inline type-hints in Python source code.
119-
120-
Typing PEPs
121-
===========
122-
123-
See https://peps.python.org/topic/typing for a list of all typing-related PEPs.

0 commit comments

Comments
 (0)