Terry Jan Reedy
2f9ef514fb
bpo-27646: Say that 'yield from' expression can be any iterable (GH-24595)
...
Previously, the doc at least strongly implied that it had to be an iterator.
2021-02-20 21:33:25 -05:00
Ken Jin
2edaf6a4fb
bpo-8264: Document hasattr and getattr behavior for private attributes (GH-23513)
...
Clarify ``getattr`` and ``setattr`` requirements for accessing name-mangled attributes
Co-Authored-By: Catalin Iacob <iacobcatalin@gmail.com >
2021-02-02 13:06:57 -08:00
Joongi Kim
6e8dcdaaa4
bpo-41229: Update docs for explicit aclose()-required cases and add contextlib.aclosing() method (GH-21545)
...
This is a PR to:
* Add `contextlib.aclosing` which ia analogous to `contextlib.closing` but for async-generators with an explicit test case for [bpo-41229]()
* Update the docs to describe when we need explicit `aclose()` invocation.
which are motivated by the following issues, articles, and examples:
* [bpo-41229]()
* https://github.com/njsmith/async_generator
* https://vorpus.org/blog/some-thoughts-on-asynchronous-api-design-in-a-post-asyncawait-world/#cleanup-in-generators-and-async-generators
* https://www.python.org/dev/peps/pep-0533/
* https://github.com/achimnol/aiotools/blob/ef7bf0cea7af/src/aiotools/context.py#L152
Particuarly regarding [PEP-533](https://www.python.org/dev/peps/pep-0533/ ), its acceptance (`__aiterclose__()`) would make this little addition of `contextlib.aclosing()` unnecessary for most use cases, but until then this could serve as a good counterpart and analogy to `contextlib.closing()`. The same applies for `contextlib.closing` with `__iterclose__()`.
Also, still there are other use cases, e.g., when working with non-generator objects with `aclose()` methods.
2020-11-02 00:02:48 -08:00
kj
9129af6050
bpo-42198: Link to GenericAlias in typing and expressions (GH-23030)
...
Follow up to 7cdf30fff3 and 4173320920 . This addresses the point "1. Update links in typing, subscription and union to point to GenericAlias." in the bpo for this PR.
2020-10-29 21:01:17 -07:00
kj
7cdf30fff3
bpo-42010: [docs] Clarify subscription of types (GH-22822)
2020-10-20 16:38:08 -07:00
Florian Dahlitz
2d55aa9e37
bpo-29981: Add examples and update index for set, dict, and generator comprehensions'(GH-20272)
...
Co-authored-by: Rémi Lapeyre <remi.lapeyre@henki.fr >
2020-10-20 17:27:07 -04:00
Victor Stinner
8af239eacf
bpo-41762: Fix usage of productionlist markup in the doc (GH-22281)
...
Use an unique identifier for the different grammars documented using
the Sphinx productionlist markup.
productionlist markups of the same grammar, like "expressions" or
"compound statements", use the same identifier "python-grammar".
2020-09-18 09:10:15 +02:00
Shankar Jha
f117cef25b
bpo-39868: Add documentation for Assignment Expressions (walrus, PEP 572) ( #18851 )
2020-07-25 16:33:48 -07:00
Mark Dickinson
810f68f128
Fix misinformation about NaN != NaN comparison (GH-19357)
2020-04-05 10:25:24 +01:00
Mathieu Dupuy
c49016e67c
fix comma location in various places (GH-19233)
2020-03-30 14:28:25 -07:00
Brandt Bucher
8bae21962b
bpo-39868: Update Language Reference for PEP 572. ( #18793 )
2020-03-05 21:19:22 -08:00
Emily Morehouse
6357c95716
bpo-35224: Additional documentation for Assignment Expressions (GH-15935)
...
Add or update assignment expression documentation for:
- FAQ - Design
- Reference - Expressions
- Reference - Lexical Analysis
https://bugs.python.org/issue35224
Automerge-Triggered-By: @matrixise
2019-09-11 07:37:12 -07:00
Andre Delfino
dc26997109
bpo-33459: Fix "tuple displays" term in Expressions.rst (GH-6760)
...
https://bugs.python.org/issue33459
Automerge-Triggered-By: @matrixise
2019-09-11 06:16:11 -07:00
Raymond Hettinger
edd21129dd
bpo-32118: Simplify docs for sequence comparison (GH-15450)
2019-08-24 10:43:55 -07:00
Jörn Heissler
c8a35417db
bpo-35224: Reverse evaluation order of key: value in dict comprehensions (GH-14139)
...
… as proposed in PEP 572; key is now evaluated before value.
https://bugs.python.org/issue35224
2019-06-22 07:40:55 -07:00
Antti Haapala
2f5b9dcc0a
bpo-30969: Fix docs about the comparison in absence of __contains__ (GH-2761)
2019-05-30 16:19:28 -04:00
divyag9
778a910758
bpo-34682: Wording and grammatical changes to the doc( https://docs.python.org/3 ) (GH-13120)
...
https://bugs.python.org/issue34682
2019-05-13 06:05:20 -07:00
Johnny Gérard
4ef9b8e505
Correct misspelling (GH-11470)
2019-05-12 23:39:32 -04:00
Serhiy Storchaka
2b57c43f21
bpo-35506: Remove redundant and incorrect links from keywords. (GH-11174)
2018-12-19 08:09:46 +02:00
Andre Delfino
55f41e45b4
Correct a couple of unbalanced parenthesis. (GH-10779)
2018-12-05 21:45:30 +02:00
Andrés Delfino
bfe1839aa9
Add link to PEP 525 in Expressions. (GH-10333)
2018-11-07 20:12:12 +02:00
Serhiy Storchaka
913876d824
bpo-35054: Add yet more index entries for symbols. (GH-10121)
2018-10-28 13:41:26 +02:00
Serhiy Storchaka
ddb961d2ab
bpo-35054: Add more index entries for symbols. (GH-10064)
2018-10-26 09:00:49 +03:00
Tony Flury
ad8a000420
closes bpo-28955: Clarified comparisons between NaN and number in reference documentation (GH-5982)
...
Co-authored-by: Benjamin Peterson <benjamin@python.org >
2018-09-14 10:48:50 -07:00
Andrés Delfino
caccca78e4
bpo-33702: Add some missing links in production lists and do a little polish (GH-7259)
2018-07-07 23:24:46 +03:00