Commit Graph

8943 Commits

Author SHA1 Message Date
Brett Cannon 5a4ada6b84
PEP 621: mark as final (#1857) 2021-03-02 17:11:39 -08:00
Matthew Rahtz b95239fef1
PEP 646: Update draft (#1856)
This is the more-or-less final version now. I'll do one last read-through to confirm everything's consistent, then post in typing-sig to confirm it's ready for the Steering Committee.

Semantic changes:
* Remove support for type variable tuples in `Union`. Apparently the implementation would be tricky in Pyre because of special-casing around `Union`. That could be evidence that it would be tricky in Mypy and pytype. Since we don't have a specific use-case in mind, I think this is fine.
* Support concatenation in `Callable`. Pradeep pointed ou that `ParamSpec` doesn't cover all potential use-cases because it doesn't support concatenating suffixes (in turn because `ParamSpec`s can contain keyword arguments, and concatenation is positional).

Readability changes:
* Remove the section on a full `Array` example. We've moved the important thing here - an explicit confirmation that `Array` can be generic in both datatype and shape - to the beginning of the PEP to make it more obvious. We've removed the `Ndim` thing after someone pointed out that e.g. `Ndim[Literal[2]]` would be incompatible with `Shape[Any, Any]`; I just don't think it's going to work. All that's left is the aliases, which we've moved into the Aliases section itself.

Other changes:
* Fill out Backwards Compatibility section.
* Reference initial CPython implementation.
2021-03-02 16:33:15 -08:00
Irit Katriel a3f0183936
PEP 654: ExceptionGroup --> exception group in prose (#1855) 2021-03-01 20:00:23 -08:00
Brett Cannon 7d760822a3
PEP 1: Suggest people reach out to important projects to support their PEP's motivation (#1842) 2021-03-01 15:50:22 -08:00
Dustin Ingram 36c87838bc
PEP 541: New issue URL (#1845) 2021-03-01 15:47:03 -08:00
Irit Katriel 41886dd6b3
PEP 654: Tidy up leaf_generator example (#1854) 2021-03-01 15:41:37 -08:00
Irit Katriel 274670b330
PEP-654: Add example of subgroup callback with side effects (#1852) 2021-03-01 15:24:59 -08:00
Dave Brondsema f69d426700
PEP 654: fix typos (#1853) 2021-03-02 07:54:10 +11:00
Pablo Galindo 53aef125a4
PEP 619: Update date for 3.10.0a6 2021-03-01 20:09:58 +00:00
Irit Katriel 9a1afd9a94
PEP 654: Add BaseExceptionGroup//ExceptionGroup split (#1850) 2021-03-01 10:19:06 -08:00
Irit Katriel aea3cc1016
PEP-654: state in rationale the premise that the new features will be used selectively (#1851) 2021-02-28 20:19:13 -08:00
Sean Lockwood c9f4cf2e8b
PEP 636 typo fix (#1849)
Fix minor typo:
"But **_ would be redundant, so it not allowed."
--> "But **_ would be redundant, so it is not allowed."
2021-02-27 14:28:46 -08:00
Jacob Walls db3c43df95
PEP 618: Fix typo (#1848) 2021-02-28 03:12:04 +11:00
David Foster c60ea16a48
PEP 655: Update Post-History (#1847) 2021-02-26 21:55:13 -08:00
Irit Katriel 31ba5bd70c
PEP 654: Explain why we did not extend except to handle ExceptionGroups (#1846) 2021-02-26 16:59:40 -08:00
Irit Katriel afa1503545
PEP-654: simplify traverse() example (#1844)
We don't need to pass the cause and context from the root. The ones for the leaf are on the leaf exception itself.
2021-02-26 14:20:35 -08:00
Naren Santhanam 22114c7ba3
PEP 646: Fix quotes in example (#1843) 2021-02-26 14:13:44 -08:00
David Foster ff3e7b1eb3
PEP 655: Marking individual TypedDict items as required (#1829) 2021-02-25 21:34:11 -08:00
Irit Katriel d729120776
PEP 654: Add section about handling ExceptionGroups (#1841) 2021-02-25 18:49:58 -08:00
Thomas Kluyver e93b2efdea
PEP 427: Point to spec on packaging.python.org (GH-1840) 2021-02-25 22:35:05 +00:00
Ken Jin bff63f80cf
PEP 634: Fix error typo in mapping patterns (TypeError ->ValueError) (GH-1839) 2021-02-23 23:15:36 -08:00
Irit Katriel 13be7c414f
PEP 654: Clarifications after python-dev review (#1838)
- subgroup returns None for empty.
- except *(TypeError, ExceptionGroup) is forbidden.
2021-02-23 17:39:29 -08:00
Dennis Sweeney 05fe23f12b
PEP 616: Replace a misleading example (#1837)
* PEP 616: Remove misleading example

* Add a replacement example
2021-02-23 17:54:21 -05:00
Brett Cannon 579038f1d9
PEP 654: fix a grammar mistake 2021-02-23 11:55:29 -08:00
Irit Katriel cbd46e4448
PEP 654: Add Post-History date (#1834) 2021-02-23 06:52:39 -08:00
Florian Bruhin 08d3be348f
PEP 0654: Fix typo (#1835) 2021-02-23 21:59:28 +11:00
Irit Katriel e7193a3e63
PEP-654: fix level of subsection headings (#1832) 2021-02-22 15:24:40 -08:00
Yury Selivanov 3daf8f2199
pep 654: Fix indentation to use consistent 4 spaces in all snippets (#1833) 2021-02-22 12:24:54 -08:00
Yury Selivanov aebbd8c4fc
pep 654: Restore code formatting 2021-02-22 11:48:40 -08:00
Yury Selivanov cef697a03c
A couple PEP 654 edits (#1830)
* Markup edits. Use REsT references, fix a couple of typos.

* Mention TaskGroups in Motivation; add an example of trio.MultiError API
2021-02-22 11:38:55 -08:00
Irit Katriel 4ca905e7ff
PEP 654: "This PEP" --> " this document" (#1831) 2021-02-22 07:23:10 -08:00
Matthew Rahtz a2339f34ea
PEP 646: tweaks, clarifications, and move summary example up (#1828)
Readability changes:
* Tweak framing to also acknowledge that variadic generics have been wanted for other things too (though as far as I've been able to tell there isn't a consistent enough pattern to the other use cases to justify including them in the PEP)
* Move the Array example much earlier (both because reading a detailed example is going to be a faster way of getting the gist for people in a hurry, and because we want to make it clear to numerical computing folks from the start that we can also specify a datatype here). (We still have a more detailed Array example later; I'm leaving that there for the time being pending some discussion with Pradeep, but eventually I guess it'll be removed and absorbed into this earlier example)
* Make it clear that other types can appear in `Union` alongside `TypeVarTuple` instances.

Semantic changes:
* Disallow a `Union` of more than one type variable tuple (I thought this would be easier than concatenation of more than one type variable tuple, but Pradeep points out it could still get hairy for type checkers, so disallow it for now to be on the safe safe)

Also some *more* type fixes...
2021-02-21 20:41:48 -08:00
Yury Selivanov a23ba419ff
Give PEP 654 a proper name. 2021-02-21 19:15:56 -08:00
Irit Katriel b60a7dcae6
Initial version of Exception Groups and except* PEP (#1820) 2021-02-21 19:13:06 -08:00
Inada Naoki b643690860
PEP 597: Fixup (#1827) 2021-02-21 16:01:52 +09:00
Eric Traut 35a0204848
Fixed several omissions and errors in sample code in PEP 646. (#1826)
Co-authored-by: Eric Traut <erictr@microsoft.com>
2021-02-20 15:20:04 -08:00
Matthew Rahtz 4304da21ec
PEP 646: various improvements (#1825)
Semantic changes:
* Unparameterised variadics are compatible with parameterised variadics in both direction
* Allow suffixing

Readability changes:
* De-emphasise unparameterised `Array` behaving like `Array[Any, ...]` to avoid the suggestion that `Array[Any, ...]` might be supported
* Explicitly forbid `Array[Any, ...]` and similar
* Clarify that only `*args` can be annotated as `*Ts`; other arguments must use `Tuple[*Ts]`
* Remove 'Final Notes' section (I was hoping we'd have more edge cases to add to this, but in the end there haven't been any, and the only example we do have is obscure enough that I think we can just remove it)

Also some minor typo fixes.
2021-02-20 10:55:14 -08:00
Mark Shannon c8f7f9cd7c
PEP 653: Make it clearer that MATCH_DEFAULT is the default. (#1823) 2021-02-19 18:55:47 +00:00
Mark Shannon 89183f61d1
Clarify description of __match_kind__. Drop claims of improved security (#1822) 2021-02-19 17:56:52 +00:00
Łukasz Langa 79fdaaad0b
[pep-0569][pep-0596] Actual dates for 3.8.8, 3.9.2; stop providing RCs for maintenance releases 2021-02-19 16:36:31 +01:00
Inada Naoki 233ecaddab
PEP 597: Use longer option name (#1821) 2021-02-19 17:40:27 +09:00
Mark Shannon aeab09a58f
PEP 653: Precise Semantics for Pattern Matching (#1819) 2021-02-18 15:08:53 +00:00
Łukasz Langa 1f669e94af
[pep-0569][pep-0596] Actual dates for 3.8.8rc1 and 3.9.2rc1 2021-02-17 13:38:35 +01:00
Ned Deily 9cab28f2f6
3.7.10 and 3.6.13 released 2021-02-16 00:19:18 -05:00
Evan Carroll 5f16dd91a6
PEP 3333: Simplify and clairify SERVER_PORT (#1818) (#1817)
There was confusion around what to do with SERVER_PORT if HTTP_HOST is
sent. Now it's clear these two variables are only used if HTTP_HOST is
not present.
2021-02-15 20:00:35 -08:00
Inada Naoki dcf77ae9b0
PEP 624: Add a discussion link in python-dev (#1818) 2021-02-15 17:36:09 +09:00
Inada Naoki 1653e14d8b
PEP 597: Update (#1799) 2021-02-14 23:06:57 +09:00
Matej Dujava 7d7965bf2d
PEP 636: Add missing colons at the end of case statement (#1815)
Signed-off-by: Matej Dujava <mdujava@kocurkovo.cz>

Co-authored-by: Matej Dujava <mdujava@win.kocurkovo.cz>
2021-02-13 07:58:28 -08:00
JimJJewett d0a76d4ffc
PEP 647: comment about backwards-compatibility (#1813) 2021-02-12 14:19:16 -08:00
JimJJewett b51b797708
PEP 647: clarify why type guards are not just a boolean (#1812) 2021-02-12 14:17:43 -08:00