From 4e15f28bbd4546b5c33b7d379ec87738422bf8a0 Mon Sep 17 00:00:00 2001 From: Ethan Smith Date: Sat, 9 Sep 2017 11:35:01 -0700 Subject: [PATCH 1/2] Clarify Python versioning in stub file search path --- pep-0484.txt | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/pep-0484.txt b/pep-0484.txt index 0c94da0156f..00fdac03942 100644 --- a/pep-0484.txt +++ b/pep-0484.txt @@ -1833,12 +1833,12 @@ they're updated often. Third-party stub packages can use any location for stub storage. Type checkers should search for them using PYTHONPATH. A default fallback -directory that is always checked is ``shared/typehints/python3.5/`` (or -3.6, etc.). Since there can only be one package installed for a given -Python version per environment, no additional versioning is performed -under that directory (just like bare directory installs by ``pip`` in -site-packages). Stub file package authors might use the following -snippet in ``setup.py``:: +directory that is always checked is ``shared/typehints/pythonX.Y/`` (for +any PythonX.Y version, not just the installed version). Since there can +only be one package installed for a given Python version per environment, +no additional versioning is performed under that directory (just like bare +directory installs by ``pip`` in site-packages). Stub file package authors +might use the following snippet in ``setup.py``:: ... data_files=[ From f6a2f0c8c38d210ee2731ccfec6581e6760c1920 Mon Sep 17 00:00:00 2001 From: Ethan Smith Date: Sat, 9 Sep 2017 18:11:48 -0700 Subject: [PATCH 2/2] Be clearer in response to Guido's comments --- pep-0484.txt | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/pep-0484.txt b/pep-0484.txt index 00fdac03942..4ca16aa08a1 100644 --- a/pep-0484.txt +++ b/pep-0484.txt @@ -1834,11 +1834,11 @@ they're updated often. Third-party stub packages can use any location for stub storage. Type checkers should search for them using PYTHONPATH. A default fallback directory that is always checked is ``shared/typehints/pythonX.Y/`` (for -any PythonX.Y version, not just the installed version). Since there can -only be one package installed for a given Python version per environment, -no additional versioning is performed under that directory (just like bare -directory installs by ``pip`` in site-packages). Stub file package authors -might use the following snippet in ``setup.py``:: +some PythonX.Y as determined by the type checker, not just the installed +version). Since there can only be one package installed for a given Python +version per environment, no additional versioning is performed under that +directory (just like bare directory installs by ``pip`` in site-packages). +Stub file package authors might use the following snippet in ``setup.py``:: ... data_files=[