ea269b9a38
Docs: Fix refs & tweak wording in sqlite3 'Using shortcut methods'
...
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-07-28 07:38:36 +02:00
0fe645d6fd
gh-95174: Add pthread stubs for WASI (GH-95234)
...
Co-authored-by: Brett Cannon <brett@python.org>
2022-07-27 20:28:06 +02:00
2361908a9d
gh-95273: Normalise sqlite3 reference wording ( #95274 )
...
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-07-27 15:24:13 +02:00
2b37395612
gh-94630: Fixup sqlite3 argument spec docs for connection execute* methods ( #95319 )
2022-07-27 14:46:21 +02:00
daa64d6a59
gh-95085: Promote Emscripten and WASI to PEP 11 tier 3 (GH-95086)
2022-07-27 08:18:34 +02:00
2e35a13e46
gh-94635: Add sqlite3 'Introduction' and 'Tutorial' doc headings ( #95269 )
2022-07-27 07:43:24 +02:00
b7ce4625fe
Clarifying the documentation on library/syslog (GH-92587)
2022-07-26 02:06:06 -05:00
5012bedc7c
gh-95235: Add explicit parameter list to some sqlite3 methods ( #95240 )
...
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-07-26 08:29:18 +02:00
4e704d7847
gh-95077: [Enum] add code-based deprecation warnings for member.member access (GH-95083)
...
* issue deprecation warning for member.member access
* always store member property in current class
* remove __getattr__
2022-07-25 11:05:10 -07:00
ac6a94c669
gh-95235: Document undocumented parameters in sqlite3 functions and methods ( #95236 )
...
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-07-25 18:46:55 +02:00
10b12dd92a
gh-93963: Document importlib.abc deprecations ( #94546 )
2022-07-25 18:24:42 +02:00
ccd7c7a0bd
gh-93610: Improve docs for importlib.resources ( #93611 )
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2022-07-25 18:16:17 +02:00
a566912049
gh-85454: Remove distutils documentation ( #95239 )
...
Most places now refer to setuptools or link to setuptools documentation.
Some examples like zipapp need to be updated later.
2022-07-25 15:50:46 +02:00
d58be48369
gh-85454: Remove links from historical mentions of distutils (GH-95192)
2022-07-25 12:20:09 +02:00
df7c8b9537
gh-95233: Correct grp.getgrgid parameter name in documentation (gid -> id) (gh-95232)
2022-07-25 18:54:42 +09:00
9007dec606
gh-95173: Revert commit 51ed2c56a1 ( #95176 )
2022-07-24 22:33:06 +01:00
0c6f898005
gh-95051: ensure that timeouts scheduled with `asyncio.Timeout` that have already expired are deliverered promptly ( #95109 )
...
Co-authored-by: Kumar Aditya <59607654+kumaraditya303@users.noreply.github.com>
2022-07-24 13:18:05 -07:00
9762572d0a
gh-93351: Add news entry and what's new entry for changes in gh-93351 ( #95175 )
2022-07-23 19:35:44 +01:00
de28ee8f75
Doc: Add omitted secondary prompt in inputoutput tutorial (GH-30317)
...
For the continuation lines, "..." should present as secondary prompt
2022-07-23 17:25:42 +08:00
c1e929858a
gh-90385: Add `pathlib.Path.walk()` method (GH-92517)
...
Automerge-Triggered-By: GH:brettcannon
2022-07-22 16:55:46 -07:00
34d11f1b0c
Fix copy-friendliness of tutorial example (GH-93424)
2022-07-22 15:11:48 -05:00
79d2f549ad
Fix async method reference links in `compound_stmts` docs (GH-94935)
2022-07-22 12:03:17 -05:00
9c47cf337c
Fix scheme count in `sysconfig` whatsnew entry (GH-94110)
2022-07-22 11:51:14 -05:00
346aabf916
Fix incorrect directive in multiprocessing module documentation (GH-93517)
2022-07-22 11:46:42 -05:00
2a9c227ac1
Closes gh-95133: docs, fix indentation level in TestCase.assertLogs example (GH-95134)
2022-07-22 11:37:22 -05:00
f9b3706df6
gh-81040: Improve sqlite3.Cursor.rowcount docs ( #94940 )
2022-07-22 09:34:39 +02:00
d06c552e35
gh-95112: Fix What's New 3.12 contribution note periods ( #95118 )
...
A couple, so far, are missing.
2022-07-21 20:36:53 -04:00
8df8ef9743
gh-95112: Fix What's New 3.11 contribution note periods ( #95115 )
...
Some are missing, a few placed after the ')'.
2022-07-21 20:35:56 -04:00
c944649ffc
gh-95112: Fix What's New 3.10 contribution note periods ( #95114 )
...
Some are missing, a few placed after the ')'.
One ') was missing.
2022-07-21 20:00:52 -04:00
b1924b1006
GH-95029: Describe Windows Store package isolation and redirection in more detail (GH-95030)
2022-07-21 01:01:23 +01:00
6e2fbdab92
docs: use 'recursively' in the description of rglob, and mention globs in the os equivalences (GH-94954)
...
The r in `rglob` stands for "recursively", so use the word in the description. Also, glob and rglob can usefully be mentioned as the pathlib equivalent of os.walk.
Automerge-Triggered-By: GH:brettcannon
2022-07-20 14:47:43 -07:00
6dadf6ca01
gh-90016: Deprecate default sqlite3 adapters and converters ( #94276 )
...
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-07-20 21:37:59 +02:00
fc0dc9203d
Fix documentation to include possible Exception ( #94818 )
2022-07-18 15:31:17 -04:00
a25a803c4c
Fix incorrect double indent in ast doc ( #94976 )
...
Warning directive indent was 4 rather than 3 spaces.
2022-07-18 13:24:18 -04:00
c41d4d0917
Remove out of date reference to YIELD_FROM from docs. ( #94966 )
2022-07-18 18:04:07 +01:00
7b617be4ab
In ast doc, update 'below' to 'above' ( #94967 )
...
The included asdl file was moved from 'below' to 'above' in 3.9.
2022-07-18 12:38:52 -04:00
044a593cbb
gh-91348: Restore frame argument to sys._getframe audit event (GH-94928)
2022-07-17 16:11:24 +01:00
ec4745b5f2
gh-91181: Add a What's New entry for dropping bytes support for `sys.path` (GH-94918)
2022-07-16 19:14:40 -07:00
6da988a46c
gh-91181: drop support for bytes on sys.path (GH-31934)
...
Support for bytes broke sometime between Python 3.2 and 3.6 and has been broken ever since. Trying to bring back supports is surprisingly difficult in the face of -b and checking for keys in sys.path_importer_cache. Since the support was broken for so long, trying to overcome the difficulty of bringing back the support has been deemed not worth it.
Co-authored-by: Eryk Sun <eryksun@gmail.com>
Co-authored-by: Brett Cannon <brett@python.org>
2022-07-16 18:07:53 -07:00
16b6e14cc2
gh-94698: add Subscript and Attribute targets to ast.for documentation (GH-94901)
...
### Summary
Add Attribute and Subscript as possible targets for the "ast for loop documentation".
Automerge-Triggered-By: GH:isidentical
2022-07-16 04:26:43 -07:00
7502af888f
Tutorial sys.argv example should not have interactive prompt (GH-94880)
2022-07-15 21:10:19 -05:00
3789c63577
Add additional pointers to pathlib's mapping to os.path functions ( #94828 )
...
* Add additional pointers to pathlib's mapping to os.path functions
os.path.splitext has a somewhat quirky signature since it mixes the path and filename components but I wanted the documentation to mention `PurePath.stem` as the natural counterpart to `PurePath.suffix` for the common use of `os.path.splitext` to turn "file.py" into "file" and "py".
Technically this could have some discussion of how to handle the parent directory hierarchy but that seems a bit out of keeping with the spirit of this table so I omitted mentioning `PurePath.parents` here.
* Update Doc/library/pathlib.rst
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
2022-07-16 00:09:27 +02:00
dc54193095
[doc] Update cookbook example and add information about queue types. (GH-94854)
2022-07-15 06:03:58 +01:00
08f68975ab
GH-46771: docs for asyncio.timeout and task cancellation ( #94794 )
2022-07-14 19:38:38 -07:00
9ea72e9d8d
Docs: fix typo in sqlite3.rst ( #94798 )
...
Colum -> Column
2022-07-14 23:47:46 +02:00
81dca70d70
gh-93939: Build C extensions without setup.py (GH-94474)
...
Combines GH-93940, GH-94452, and GH-94433
2022-07-14 00:51:49 -07:00
b03a9e8c8a
gh-94309: Add typing.Hashable and typing.Sized for "What's New for Python 3.12" (GH-94729)
...
Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com>
2022-07-14 07:50:31 +01:00
967da5febb
gh-90359: Unify documentation style for datetime.rst (gh-94836)
2022-07-14 09:40:10 +09:00
07374cce52
gh-90359: Update documentation to follow PEP 495. (gh-94800)
2022-07-14 09:04:52 +09:00
ed06ec1ab8
GH-81620: Add random.binomialvariate() (GH-94719)
2022-07-13 09:46:04 -05:00
47f50cbab7
Fix heading levels for "Deprecated" section in What's New for 3.12 (GH-94762)
...
These headings were at the same level as the "Deprecated" heading, but
likely intended to be a subheading within that section.
Co-authored-by: Pradyun Gedam <pradyunsg@users.noreply.github.com>
2022-07-12 20:55:32 +01:00
90a6e56e56
docs: typing.Self, fix typo (GH-94771)
...
* fix typo - double spelled word 'use'
* change methods names to the infinitive form
2022-07-12 18:45:52 +01:00
46fc584b00
gh-87822: Make traceback module robust to exceptions from repr() of local values (GH-94691)
2022-07-11 10:14:15 +01:00
da717519ec
gh-93883: elide traceback indicators when possible ( #93994 )
...
* gh-93883: elide traceback indicators when possible
Elide traceback column indicators when the entire line of the
frame is implicated. This reduces traceback length and draws
even more attention to the remaining (very relevant) indicators.
Example:
```
Traceback (most recent call last):
File "query.py", line 99, in <module>
bar()
File "query.py", line 66, in bar
foo()
File "query.py", line 37, in foo
magic_arithmetic('foo')
File "query.py", line 18, in magic_arithmetic
return add_counts(x) / 25
^^^^^^^^^^^^^
File "query.py", line 24, in add_counts
return 25 + query_user(user1) + query_user(user2)
^^^^^^^^^^^^^^^^^
File "query.py", line 32, in query_user
return 1 + query_count(db, response['a']['b']['c']['user'], retry=True)
~~~~~~~~~~~~~~~~~~^^^^^
TypeError: 'NoneType' object is not subscriptable
```
Rather than going out of our way to provide indicator coverage
in every traceback test suite, the indicator test suite should
be responible for sufficient coverage (e.g. by adding a basic
exception group test to ensure that margin strings are covered).
2022-07-11 07:40:53 +01:00
e8e4b550f5
gh-94309: Deprecate typing.Hashable/Sized (GH-94626)
...
Deprecate typing.Hashable/Sized. Use the collections.abc counterparts directly instead.
To be consistent with PEP 585, deprecated aliases will not raise any DeprecationWarning.
2022-07-10 19:04:01 +01:00
ef61b259e3
GH-77265: Document NaN handling in statistics functions that sort or count ( #94676 )
...
* Document NaN handling in functions that sort or count
* Update Doc/library/statistics.rst
Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
* Update Doc/library/statistics.rst
Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
* Fix trailing whitespace and rewrap text
Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
2022-07-10 17:40:27 +10:00
761eeb62a9
gh-94700: Rewrite the logging.Formatter API ref in structured form (GH-94701)
2022-07-09 06:03:47 +01:00
efb20a97c4
Use mdash-es consistently in the library docs index ( #92762 )
2022-07-08 16:44:15 +02:00
00464bbed6
gh-94199: Remove the ssl.wrap_socket() function ( #94203 )
...
Remove the ssl.wrap_socket() function, deprecated in Python 3.7:
instead, create a ssl.SSLContext object and call its
sl.SSLContext.wrap_socket() method. Any package that still uses
ssl.wrap_socket() is broken and insecure. The function neither sends
a SNI TLS extension nor validates server hostname. Code is subject to
CWE-295 : Improper Certificate Validation.
2022-07-08 15:20:15 +02:00
e5b841a403
gh-94622: Add more references to the sqlite3 types anchor ( #94623 )
2022-07-08 02:38:38 +02:00
fb6dccae34
gh-94321: Document sqlite3.PrepareProtocol ( #94620 )
2022-07-08 00:33:17 +02:00
b6558d768f
gh-94343: Ease initialization of reprlib.Repr attributes (GH-94581)
2022-07-07 09:55:33 -05:00
3eb2b9634f
gh-94628: Add explicit parameter list to sqlite3.connect docs ( #94629 )
...
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-07-07 09:00:20 +02:00
94988603f3
gh-94630: Update sqlite3 docs with positional-only and keyword-only symbols ( #94631 )
2022-07-07 01:13:30 +02:00
760b8cf0c8
gh-94017: Improve clarity of sqlite3 transaction handling docs ( #94320 )
...
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-07-06 22:59:07 +02:00
5f319308a8
gh-91330: Tests and docs for dataclass descriptor-typed fields (GH-94424)
...
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2022-07-05 20:09:41 +02:00
e6ec6f5b50
Docs: Convert PEP 630 (Isolating Extension Modules) to a HOWTO (GH-94489)
...
Co-authored-by: Stanley <46876382+slateny@users.noreply.github.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2022-07-05 16:37:28 +02:00
c60f125533
bpo-46755: Don't log stack info twice in QueueHandler (GH-31355)
2022-07-05 15:23:12 +01:00
92bcb26d00
gh-94379: Remove zipimport find_loader() and find_module() methods ( #94380 )
...
zipimport: Remove find_loader() and find_module() methods, deprecated
in Python 3.10: use the find_spec() method instead. See PEP 451 for
the rationale.
2022-07-05 12:11:42 +02:00
3440d197a5
Docs: remove redundant "adverb-adjective" hyphens from compound modifiers (GH-94551)
...
Discussion: https://discuss.python.org/t/slight-grammar-fix-throughout-adverbs-dont-need-hyphen/17021
2022-07-05 11:16:10 +02:00
4791a8a835
gh-93626: Set the release for `__future__.annotations` to `None` (GH-93628)
...
Co-authored-by: Guido van Rossum <gvanrossum@gmail.com>
2022-07-05 10:46:39 +02:00
fd76eb547d
gh-94383: Remove ElementTree.Element.copy() method ( #94384 )
...
xml.etree: Remove the ElementTree.Element.copy() method of the pure
Python implementation, deprecated in Python 3.10, use the copy.copy()
function instead. The C implementation of xml.etree has no copy()
method, only a __copy__() method.
2022-07-04 15:51:01 +02:00
fbcee570d1
gh-94352: shlex.split() no longer accepts None ( #94353 )
...
shlex.split(): Passing None for s argument now raises an exception,
rather than reading sys.stdin. The feature was deprecated in Python
3.9.
2022-07-04 15:29:19 +02:00
a391b74dbe
Update logging documentation: change cross-reference and add webapp r… (GH-94540)
2022-07-04 06:06:43 +01:00
b296c7442b
gh-92869: ctypes: Add c_time_t ( #92870 )
...
Adds `ctypes.c_time_t` to represent the C `time_t` type accurately as its size varies.
Primarily-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Gregory P. Smith <greg@krypto.org> [Google]
2022-07-03 11:58:02 -07:00
39c29f753e
IDLE doc: Tweek RESTART and Windows console start ( #94530 )
2022-07-03 12:56:44 -04:00
cc81962e69
Doc: fix sqlite3 blob reference anchor ( #94505 )
2022-07-02 08:35:48 +02:00
80aaeabb8b
gh-81054: Document that SimpleHTTPRequestHandler follows symbolic links (GH-94416)
2022-07-01 18:21:27 +02:00
ad55147c1d
Update code sample when importing modules in queue doc (GH-94244)
...
In the queue documentation, the code snippet shows the import to be not PEP 8 compliant.
Since people typically copy-paste from such code samples, I think it's important to show best-practices here.
2022-07-01 17:51:46 +02:00
c57aad777a
gh-94216: add pseudo instructions to the dis/opcodes modules (GH-94241)
2022-07-01 15:33:35 +01:00
62bb7a3b50
multiprocessing.spawn doc: Capitalize the p in "Python" (gh-94462)
2022-06-30 10:23:04 -07:00
594c369949
GH-94398: TaskGroup: Fail create_task() during shutdown (GH-94400)
...
Once the task group is shutting down, it should not be possible to create a new task.
Here "shutting down" means `self._aborting` is set, indicating that at least one task
has failed and we have cancelled all others.
Co-authored-by: Łukasz Langa <lukasz@langa.pl>
2022-06-30 19:10:46 +02:00
639e35108b
xml.dom.minidom docs: fix typo ( #93437 )
2022-06-30 10:06:42 -07:00
b6ec6d4041
GH-90908: Document asyncio.TaskGroup (GH-94359)
...
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-06-30 18:16:22 +02:00
d68f2d27bb
gh-89038: [doc] update dis.findlinestarts documentation for changes related to PEP-626 (GH-94247)
2022-06-30 15:57:35 +01:00
68fb03249f
bpo-92336: [doc] clarify that the dfile is read by the traceback display code (GH-94409)
2022-06-29 20:24:43 +01:00
22b783aba0
Docs: Update SyntaxError message in REPL example for list comprehension (GH-93901)
2022-06-29 19:06:51 +02:00
595baa4e06
gh-86404: [doc] Two 'make suspicious' false positives. (GH-94407)
2022-06-29 10:18:54 +02:00
600c65c094
gh-94172: Remove ssl.PROTOCOL_SSLv2 dead code ( #94312 )
...
Remove dead code related to ssl.PROTOCOL_SSLv2. ssl.PROTOCOL_SSLv2
was already removed in Python 3.10.
In test_ssl, @requires_tls_version('SSLv2') always returned False.
Extract of the removed code: "OpenSSL has removed support for SSLv2".
2022-06-28 13:57:08 +02:00
4b854b7466
gh-61585: Clarify import scope in modules tutorial (GH-93455)
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-06-28 12:15:44 +02:00
81ac9ac492
Add docs for decorated object and field specifier params (GH-94354)
2022-06-28 11:58:35 +02:00
efdc9d68de
gh-87995: Make MappingProxyType hashable (GH-94252)
2022-06-28 11:54:58 +02:00
71d5299b73
gh-94199: Remove hashlib.pbkdf2_hmac() Python implementation (GH-94200)
...
Remove the pure Python implementation of hashlib.pbkdf2_hmac(),
deprecated in Python 3.10. Python 3.10 and newer requires OpenSSL
1.1.1 or newer (PEP 644), this OpenSSL version provides a C
implementation of pbkdf2_hmac() which is faster.
2022-06-28 11:51:13 +02:00
bc7f6fcdf1
gh-86404: [doc] Fix missing space in idle documentation. (GH-94366)
...
This should have been spotted by sphinx-lint, tracked here:
https://github.com/sphinx-contrib/sphinx-lint/issues/39
2022-06-28 09:44:52 +02:00
e6391e08bf
gh-82006: IDLE doc improvements ( #94349 )
...
0. Update text start and stop conditions.
1. Title-case sections but not subsections.
2. Edit Shell Window sections: title, execute, restart.
2022-06-27 18:59:26 -04:00
c0453a40fa
GH-94163: Add BINARY_SLICE and STORE_SLICE instructions. (GH-94168)
2022-06-27 12:24:23 +01:00
d71f5adc41
gh-85023: [doc] clarify parameters vs arguments explanation in FAQ (GH-94282)
2022-06-26 22:57:41 +01:00
aedb5194d5
gh-94214: Add venv context.lib_path and document the context (GH-94221)
2022-06-26 17:49:03 +01:00
cc0d5e568e
gh-94226: Remove the locale.format() function ( #94229 )
...
Remove the locale.format() function, deprecated in Python
3.7: use locale.format_string() instead.
Remove TestFormatPatternArg test case: it is irrelevant for
locale.format_string() which accepts complex formats.
2022-06-26 12:41:19 +02:00
32d595fdcd
[doc] fix typo in reference to tp_descr_get and tp_descr_set (GH-94140)
2022-06-26 11:02:29 +01:00
Erlend Egeberg Aasland
Christian Heimes
Erlend Egeberg Aasland
Nicolas Haller
Ethan Furman
Hugo van Kemenade
Petr Viktorin
Oleg Iarygin
Adam Dangoor
Pablo Galindo Salgado
Thomas Grainger
Chenwei Xiao
Stanislav Zmiev
July Tikhonov
Frank Dana
oda-gitso
Alexandru Mărășteanu
Terry Jan Reedy
Anthony Shaw
Ned Batchelder
Guy Yagev
Mark Shannon
Steve Dower
Brett Cannon
anilbey
Marco Buttu
Chris Adams
Vinay Sajip
Tin Tvrtković
Ikko Ashimine
MonadChains
Dong-hee Na
Raymond Hettinger
Pradyun Gedam
Max Zhenzhera
Simon-Martin Schröder
John Belmonte
CAM Gerlach
Victor Stinner
finefoot
Erik De Bonte
Erik Montnemery
KotlinIsland
Thomas Perl
Sam Ezeh
Mariatta Wijaya
Irit Katriel
Guido van Rossum
Jean-Christophe Helary
Cheryl Sabella
Julien Palard
Stanley
Serhiy Storchaka
Arun Mani J
Paul Moore
Max Bachmann