Ethan Furman
6ecead106a
[doc] minor fixes to expressions.rst (GH-29444)
2021-11-06 10:26:43 -07:00
Arthur Milchior
d9c1868c25
bpo-45583: Correct datamodel documentation of int() (GH-29182)
...
It should be noted that this part of the documentation is redundant with
function.rst's documentation of int. This one was correctly updated with Python 3.8.
2021-10-28 21:48:37 +02:00
Tim Peters
51ed2c56a1
bpo-45530: speed listobject.c's unsafe_tuple_compare() (GH-29076)
...
Keep track of whether unsafe_tuple_compare() calls are resolved by the very
first tuple elements, and adjust strategy accordingly. This can significantly
cut the number of calls made to the full-blown PyObject_RichCompareBool(),
and especially when duplicates are rare.
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-10-24 22:27:24 -05:00
Luca Chiodini
4ecd119b00
bpo-45463: Clarify that global statements allows multiple names (GH-28851)
...
The global statement allows specifying a list of identifiers
(https://docs.python.org/3/reference/simple_stmts.html#the-global-statement ).
The "Execution model" chapter described the global statement as if it
only allowed one single name. Pluralize "name" in the appropriate places.
2021-10-16 08:55:12 -04:00
Petr Viktorin
3dee0cb621
[docs] lexical_analysis: Expand the text on ``_`` (GH-28903)
...
Also:
* Expand the discussion into its own entry. (Even before this,
text on ``_`` was longet than the text on ``_*``.)
* Briefly note the other common convention for `_`: naming unused
variables.
Co-authored-by: Brandt Bucher <brandtbucher@gmail.com>
Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com>
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-10-13 18:34:01 +02:00
Christophe Nanteuil
0bcc5ade9b
Fix class pattern docs to refer to class patterns (GH-28849)
2021-10-10 22:12:51 +08:00
Christian Clauss
241bda785a
[doc] Fix typos found using codespell (GH-28744)
...
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-10-05 23:48:44 +02:00
Raymond Hettinger
db91b058d5
bpo-45346: Keep docs consistent regarding true and false values (GH-28697)
2021-10-02 13:48:08 -05:00
Serhiy Storchaka
4f05f15d7b
[docs] Improve the markup of powers (GH-28598)
2021-09-28 22:40:57 +02:00
Mohamad Mansour
8f943ca257
[codemod] Fix non-matching bracket pairs (GH-28473)
...
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-09-22 01:09:00 +02:00
Raymond Hettinger
94b462686b
bpo-45198: __set_name__ documentation not clear about its usage with non-descriptor classes (GH-28439)
2021-09-18 01:49:43 -05:00
Benjamin Peterson
024fda47d4
closes bpo-45190: Update Unicode data to version 14.0.0. (GH-28336)
2021-09-14 11:00:38 -07:00
Pablo Galindo Salgado
ab327f2929
bpo-44964: Correct the note about the f_lasti field (GH-28208)
2021-09-10 17:53:42 +02:00
Raymond Hettinger
fa15df77f0
bpo-45104: Clarify when __init__ is called (GH-28210)
2021-09-07 18:04:39 +02:00
Pablo Galindo Salgado
fa2c0b85a8
bpo-44964: Add a note explaining the new semantics of f_last_i in frame objects (GH-28200)
2021-09-07 12:18:54 +01:00
Objectivitix
806e25fd31
bpo-45003: Change __div__ to __truediv__ in py3 language reference. (GH-27951)
2021-08-26 08:49:02 +03:00
Jack DeVries
7cba23164c
bpo-39452: Rewrite and expand __main__.rst ( #26883 )
...
Broadened scope of the document to explicitly discuss and differentiate between ``__main__.py`` in packages versus the ``__name__ == '__main__'`` expression (and the idioms that surround it), as well as ``import __main__``.
Co-authored-by: Géry Ogam <gery.ogam@gmail.com>
Co-authored-by: Éric Araujo <merwok@netwok.org>
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-08-24 19:01:41 +02:00
William Chargin
80f33f266b
bpo-41706: Fix special method invocation docs to mention using type() (GH-22084)
2021-08-04 13:43:06 -07:00
andrei kulakov
4bd9caafb6
bpo-41911: Update docs for various expressions (GH-27470)
...
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2021-07-30 18:52:44 +02:00
Jack DeVries
2693132292
bpo-44589: raise a SyntaxError when mapping patterns have duplicate literal keys (GH-27131)
2021-07-14 17:38:42 -07:00
Serhiy Storchaka
054e9c84ac
bpo-33346: Allow async comprehensions inside implicit async comprehensions (GH-6766)
...
Co-authored-by: Pablo Galindo <pablogsal@gmail.com>
2021-07-13 22:27:50 +01:00
Ammar Askar
9c3eaf88dc
bpo-43950: Add documentation for PEP-657 (GH-27047)
...
Co-authored-by: Pablo Galindo <Pablogsal@gmail.com>
Co-authored-by: Batuhan Taskaya <batuhanosmantaskaya@gmail.com>
2021-07-13 01:29:39 +01:00
Pablo Galindo
8363c53369
bpo-44530: Document the new CodeObject.co_qualname attribute (GH-27052)
2021-07-07 14:20:49 +01:00
Illia Volochii
a1092f6249
bpo-43216: Remove @asyncio.coroutine (GH-26369)
...
Remove the @asyncio.coroutine decorator
enabling legacy generator-based coroutines to be compatible with async/await
code; remove asyncio.coroutines.CoroWrapper used for wrapping
legacy coroutine objects in the debug mode.
The decorator has been deprecated
since Python 3.8 and the removal was initially scheduled for Python 3.10.
2021-07-01 15:13:59 +02:00
Furkan Onder
878d7e4ee4
bpo-21760: fix __file__ description (GH-19097)
2021-06-09 14:10:20 -07:00
Daniel Shahaf
fe175a87ad
Doc: Fix ambiguous pronoun (GH-26037)
2021-05-13 23:27:06 -07:00
Saiyang Gou
3d4b5f1019
Update doc as relative import can be used with star import (GH-25667)
2021-05-13 22:37:19 -07:00
Ken Jin
53c91ac525
bpo-43977: Update pattern matching language reference docs (GH-25917)
...
* Update patma language reference with new changes to sequence and mapping
* update 3.10 whatsnew too
2021-05-13 22:31:28 -07:00
Terry Jan Reedy
3b200b2aa6
bpo-44025: Clarify when '_' is a keyword. ( #25873 )
...
In match statements, in case patterns and nowhere else.
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2021-05-04 11:00:29 +02:00
Zackery Spytz
7d2b83e9f0
bpo-43990: Fix the footnote ordering in the operator precedence docs (GH-25805)
...
Footnotes 5 and 6 were in the wrong order.
2021-05-02 10:29:15 -07:00
larryhastings
49b26fa517
bpo-43987: Add "Annotations Best Practices" HOWTO doc. ( #25746 )
...
Add "Annotations Best Practices" HOWTO doc.
2021-05-01 21:19:24 -07:00
Ryan Hileman
9a2c2a9ec3
bpo-42800: add audit hooks for f_code and tb_frame (GH-24182)
...
Accessing the following attributes will now fire PEP 578 style audit hooks as ("object.__getattr__", obj, name):
* PyTracebackObject: tb_frame
* PyFrameObject: f_code
* PyGenObject: gi_code, gi_frame
* PyCoroObject: cr_code, cr_frame
* PyAsyncGenObject: ag_code, ag_frame
Add an AUDIT_READ attribute flag aliased to READ_RESTRICTED.
Update obsolete flag documentation.
2021-04-30 00:15:55 +01:00
Géry Ogam
a1a5e3c4c8
Fix a typo in datamodel reference document (GH-24930)
2021-04-25 14:13:19 -07:00
Pablo Galindo
b0544ba77c
bpo-38605: Revert making 'from __future__ import annotations' the default (GH-25490)
...
This reverts commits 044a1048ca
and 1be456ae9d
, adapting the code to changes that happened after it.
2021-04-21 12:41:19 +01:00
Ammar Askar
68ba0c67ca
bpo-43837: Reverse order of precedence table to show tightly binding operators first (GH-25469)
2021-04-19 08:22:03 -07:00
Ken Jin
37a5e22023
Use double quotes over single quotes for match statement grammar (GH-24943)
2021-04-12 10:03:20 -07:00
Victor Stinner
553ee2781a
bpo-43682: Make staticmethod objects callable (GH-25117)
...
Static methods (@staticmethod) are now callable as regular functions.
2021-04-12 00:21:22 +02:00
Mark Dickinson
79650d0118
Fix description of behaviour of an exception class in 'from' clause (GH-24303)
2021-04-11 09:33:59 +01:00
Saiyang Gou
1e051a21b7
bpo-39702: Remove dotted_name from decorator documentation (GH-25234)
2021-04-08 15:34:09 -07:00
Saiyang Gou
58d72cab89
bpo-36540: Improve doc of function definition regarding positional-only arguments (GH-25235)
2021-04-07 20:06:43 +01:00
Saiyang Gou
1be456ae9d
bpo-38605: Update "Future statements" docs since PEP 563 is always enabled (GH-25236)
...
Update documentation section for "Future statements" to reflect that `from __future__ import annotations` is on by default, and no features require using the future statement now.
2021-04-06 22:02:20 -07:00
Saiyang Gou
0fdf11e8e9
bpo-43755: Update docs to reflect that lambda is not allowed in `comp_if` since 3.9 (GH-25231)
2021-04-06 23:15:37 +01:00
Ken Jin
5143fd15b4
Update pattern matching docs for changes to the PEP ( #25185 )
...
See:
- https://github.com/python/peps/pull/1909 (__match_args__ must be a tuple)
- https://github.com/python/peps/pull/1908 (allow keyword patterns for int(x) etc.)
2021-04-06 09:03:00 -07:00
Brett Cannon
f97dc80068
bpo-43672: raise ImportWarning when calling find_loader() (GH-25119)
2021-04-02 12:35:32 -07:00
Brett Cannon
a7ff6df60c
bpo-42134: Raise ImportWarning when calling find_module() in the import system (GH-25044)
2021-03-30 08:43:03 -07:00
Brett Cannon
1899087b21
bpo-42136: Deprecate module_repr() as found in importlib (GH-25022)
2021-03-26 11:55:07 -07:00
Daniel F Moisset
a22bca6b1e
bpo-42128: Add documentation for pattern matching (PEP 634) ( #24664 )
...
This is a first edition, ready to go out with the implementation. We'll iterate during the rest of the period leading up to 3.10.0.
Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
Co-authored-by: Fidget-Spinner <28750310+Fidget-Spinner@users.noreply.github.com>
Co-authored-by: Brandt Bucher <brandt@python.org>
Co-authored-by: Raymond Hettinger <1623689+rhettinger@users.noreply.github.com>
Co-authored-by: Guido van Rossum <guido@python.org>
2021-02-28 20:08:38 -08:00
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
Pablo Galindo
7c8e0b0336
Document new parenthesized with statements (GH-24281)
2021-01-25 23:15:51 +00:00