7d7a378c1a
Fix typo in Sorting howto ( #92280 )
...
The phrase is usually "odds and ends," not "odd and ends."
2022-05-03 21:38:29 -06:00
48c6165c28
gh-91928: Add `datetime.UTC` alias for `datetime.timezone.utc` (GH-91973)
...
### fixes #91928
`UTC` is now module attribute aliased to `datetime.timezone.utc`.
You can now do the following:
```python
from datetime import UTC
```
2022-05-03 15:14:25 -07:00
ee2205b208
gh-87304: Improve comments in language reference for imports ( #92164 )
2022-05-03 16:08:05 -06:00
27e3665715
Improve the typing docs ( #92264 )
...
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2022-05-03 15:49:21 -06:00
2eca5dad0a
gh-89653: PEP 670: Convert PyBytes macros to functions ( #91990 )
...
Convert the following macros to static inline functions:
* PyByteArray_AS_STRING()
* PyByteArray_GET_SIZE()
* PyBytes_AS_STRING()
* PyBytes_GET_SIZE()
Limited C API version 3.11 no longer casts arguments.
Add _PyBytes_CAST() and _PyByteArray_CAST() macros.
2022-05-03 20:14:58 +02:00
d5dfcd4489
bpo-46696: Add socket.SO_INCOMING_CPU constant ( #31237 )
...
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2022-05-03 11:33:11 -06:00
9dc4aae8e9
Link to GitHub instead of BPO for CPython bug tracker (GH-92221)
2022-05-03 22:40:36 +08:00
f6f36cc269
bpo-44863: Allow generic typing.TypedDict ( #27663 )
...
Co-authored-by: Ken Jin <28750310+Fidget-Spinner@users.noreply.github.com>
Co-authored-by: Yurii Karabas <1998uriyyo@gmail.com>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2022-05-03 07:21:42 -06:00
6c7249f265
gh-92154: Expose PyCode_GetCode in the C API (GH-92168)
2022-05-03 21:13:13 +08:00
78e70be331
gh-70363: Implement `io.IOBase` interface for `SpooledTemporaryFile` (GH-29560)
...
Since the underlying file-like objects (either `io.BytesIO`,
or a true file object) all implement the `io.IOBase`
interface, the `SpooledTemporaryFile` should as well.
Additionally, since the underlying file object will either be an
instance of an `io.BufferedIOBase` (for binary mode) or an
`io.TextIOBase` (for text mode), methods for these classes were also
implemented.
In every case, the required methods and properties are simply delegated
to the underlying file object.
Co-authored-by: Gary Fernie <Gary.Fernie@skyscanner.net>
Co-authored-by: Inada Naoki <songofacandy@gmail.com>
2022-05-03 21:18:18 +09:00
c1767fce52
Fix doc warnings in What's New in 3.11 (GH-92215)
2022-05-03 14:49:06 +08:00
b04e02c57f
bpo-43923: Add support for generic typing.NamedTuple ( #92027 )
2022-05-02 16:41:23 -06:00
cc6ae4f483
bpo-46586: Fix more erroneous doc links to builtins ( #31429 )
...
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Co-authored-by: Éric <merwok@netwok.org>
2022-05-02 16:32:44 -06:00
2d30adee72
bpo-46285: Add command-line option -p/--protocol to module http.server ( #30999 )
...
Co-authored-by: Éric <merwok@netwok.org>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2022-05-02 16:28:45 -06:00
32e4f450af
bpo-6686: Replace String with Bytes in xml.sax.handler documentation ( #30612 )
2022-05-02 16:26:42 -06:00
5f45a9d3c3
importlib docs: Update importlib.abc hierarchy ( #31113 )
...
Fixed some inconsistencies in the text about relationships
2022-05-02 14:26:35 -06:00
dd57fe1dd7
Fix duplicate word. (GH-92182)
2022-05-02 13:43:52 -06:00
ff88f7e007
gh-87390: Add __unpacked__ attribute to types.GenericAlias ( #92059 )
2022-05-02 13:21:59 -06:00
4b297a9ffd
gh-91783: Document security considerations for shutil.unpack_archive ( #91844 )
2022-05-02 11:15:04 -06:00
5f9c0f5ddf
Add weakref_slot to dataclass decorator, to allow instances with slots to be weakref-able. ( #92160 )
2022-05-02 10:36:39 -06:00
958f21c5cd
gh-92082: contextlib docs: Change aclosing from a class to a function for consistency ( #92155 )
...
Signed-off-by: prwatson <prwatson@redhat.com>
2022-05-02 10:20:30 -06:00
b9ab6cea08
gh-88546: glob.glob docs: Make new paragraph for emphasis and reordered sentence ( #91614 )
2022-05-02 09:11:05 -06:00
bb857a96ef
asyncio.subprocess: Fix a typo in doc ( #92030 )
...
Remove a confusion for read method in asyncio-subprocess doc for stderr StreamReader instance
2022-05-02 09:01:52 -06:00
2a7efa3242
Fix typo in Programming FAQ ( #92083 )
...
I believe the word "with" was missing here.
2022-05-02 09:01:03 -06:00
b25352a5c0
gh-85133: os docs: Add that getenv uses os.environ ( #91874 )
...
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2022-05-02 08:43:32 -06:00
9166ace805
gh-84714: Add behavior if dst file exists ( #91867 )
2022-05-02 08:31:55 -06:00
6811bdef63
gh-88097: doc: fix link to Py_Version ( #92141 )
2022-05-02 15:29:22 +02:00
614420df97
gh-85679: Recommend `encoding="utf-8"` in tutorial (GH-91778)
2022-05-02 17:25:05 +09:00
ed711290a0
gh-91998: 'WebAssemby' to 'WebAssembly' ( #92040 )
2022-05-01 20:24:41 -05:00
9588f880a2
typing docs: Add example for async functions ( #20386 )
...
Fixes python/typing#424
2022-04-30 22:40:27 -06:00
1066ecb970
gh-81488: Add recursive wording for issubclass docs ( #92087 )
2022-04-30 22:05:20 -06:00
0729b31a8b
gh-91952: Make TextIOWrapper.reconfigure() supports "locale" encoding (GH-91982)
2022-05-01 10:44:14 +09:00
238aa6253b
Improving readability of argparse.rst (GH-91751)
...
Fixed few typos and enhanced few paragraphs for your review and consideration.
Trivial contribution towards continuous improvement, so no issue was raised.
Automerge-Triggered-By: GH:rhettinger
2022-04-30 15:20:10 -07:00
5dcfb916c7
gh-89253: Add 3.10 whatsnew section for itertools.pairwise (GH-91563)
...
#89253
[`pairwise()`](https://docs.python.org/3/library/itertools.html#itertools.pairwise ) already has the 'new in python3.10'
Automerge-Triggered-By: GH:rhettinger
2022-04-30 15:14:38 -07:00
efb87b1090
gh-85757: Change wording from nested to inner (GH-91811)
...
#85757
https://docs.python.org/3/tutorial/datastructures.html#nested-list-comprehensions
I do think this is clearer, but I wonder if 'nested' should be kept though to get the terminology out there more often. So perhaps it could be something like 'inner (nested) listcomp' or 'nested (inner) listcomp' despite sounding a bit redundant
Automerge-Triggered-By: GH:rhettinger
2022-04-30 15:12:33 -07:00
2b97d7f6df
Fix typo in asyncio-extending.rst ( #91609 )
2022-04-30 16:09:48 -06:00
ea39246782
gh-91611: Use example.com for documentation, not mydomain.com ( #91613 )
...
example.com is reserved by the IANA as special-use domain name for documentation
purposes. The domain names are used widely in books, tutorials, sample network
configurations, and generally as examples for the use of domain name.
On the other hand, mydomain.com is real Domain Name Registration service.
2022-04-30 15:52:13 -06:00
567be058b4
gh-87801: Add run() to subprocess.CalledProcessError description ( #91628 )
2022-04-30 15:32:00 -06:00
d7eb1ffbe8
gh-87192: Update wording for fcntl 'Changed in' ( #91658 )
2022-04-30 15:24:01 -06:00
b660d0931e
Convert :issue: to :gh: in whatsnew (GH-92089)
2022-04-30 15:53:59 -04:00
3a8e2b6e65
gh-85864: io docs: Add missing position-only parameters ( #91950 )
2022-04-30 09:22:33 -06:00
9ea9078ec7
gh-92019: Make sqlite3.Blob indexing conform with the norm ( #92020 )
...
- get index now returns an int
- set index now requires an int in range(0, 256)
Resolves #92019
2022-04-30 09:01:37 -06:00
3483299a24
gh-81548: Deprecate octal escape sequences with value larger than 0o377 (GH-91668)
2022-04-30 13:16:27 +03:00
19dca04121
gh-91760: Deprecate group names and numbers which will be invalid in future (GH-91794)
...
Only sequence of ASCII digits will be accepted as a numerical reference.
The group name in bytes patterns and replacement strings could only
contain ASCII letters and digits and underscore.
2022-04-30 13:13:46 +03:00
354ace8b07
gh-91954: Emit EncodingWarning from locale and subprocess (GH-91977)
...
locale.getpreferredencoding() and subprocess.Popen() emit EncodingWarning
2022-04-30 15:53:29 +09:00
2f7952c35b
Rephrase typing.assert_never docs ( #92061 )
...
This change is similar to that in #32069
2022-04-29 21:13:21 -06:00
d0064a1e72
gh-91491: Add several typing features to What's New ( #92060 )
...
This gets all the major items in #91491 . However, I didn't get around to
adding what's new entries for the large clump of changes in the last
bullet point in the issue.
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2022-04-29 21:12:45 -06:00
c2b579741d
gh-91217: deprecate xdrlib (GH-92066)
...
Automerge-Triggered-By: GH:brettcannon
2022-04-29 18:22:10 -07:00
7861a9e327
Fix indentation for typing.Unpack docs ( #92058 )
...
https://docs.python.org/3.11/library/typing.html#typing.Unpack
2022-04-29 16:58:40 -06:00
53ca774497
sorting howto: Add clarification on < using __lt__ ( #92010 )
2022-04-29 16:08:07 -06:00
81120b6754
bpo-44791: Accept ellipsis as the last argument of typing.Concatenate ( #30969 )
2022-04-29 15:01:40 -06:00
89c6b2b8f6
bpo-36329: Remove 'make -C Doc serve' in favour of 'make -C Doc htmlview' (GH-32354)
...
Also updated `make -C htmlview` so it used a full path with `file://`, because the original didn't open the page (macOS).
For example:
```sh
cd Doc
# Doesn't open anything:
python3 -c "import webbrowser; webbrowser.open('build/html/index.html')"
# Opens the docs page e.g. file:///Users/hugo/github/cpython/Doc/build/html/index.html :
python3 -c "import os, webbrowser; webbrowser.open('file://' + os.path.realpath('build/html/index.html'))"
```
https://bugs.python.org/issue36329
2022-04-29 15:47:26 +02:00
64113a4ba8
gh-91873: Summarise deprecations in typing at the top level (GH-91864)
2022-04-29 12:22:25 +08:00
ea2f5bcda1
bpo-22276: Change pathlib.Path.glob not to ignore trailing path separator (GH-10349)
...
Now pathlib.Path.glob() **only** matches directories when the pattern ends in a path separator.
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2022-04-28 12:45:03 -07:00
0ef8d921f5
gh-91603: Speed up isinstance/issubclass on union types (GH-91631)
...
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
2022-04-28 23:24:19 +08:00
87c6cf9aa7
gh-89479: Export _Py_GetSpecializationStats() internal function ( #92011 )
...
When Python is built with "./configure --enable-pystats" (if the
Py_STATS macro is defined), the _Py_GetSpecializationStats() function
must be exported, since it's used by the _opcode extension which is
built as a shared library.
2022-04-28 14:02:45 +02:00
407c3afe19
gh-91217: deprecate uu (GH-92009)
...
Automerge-Triggered-By: GH:brettcannon
2022-04-27 20:26:33 -07:00
f348154c8f
Add note that headers added via urllib.request.add_header are added to redirected requests ( #30708 )
2022-04-27 16:25:03 -06:00
161dff7e10
gh-84459: Make wording more specific for Path.replace (GH-91853)
...
#84459
2022-04-27 15:03:03 -07:00
ad9f817eeb
gh-91498: socket: Add TCP_CONNECTION_INFO on macOS ( #69256 )
...
Fixes GH-91498
2022-04-27 06:47:17 -06:00
80de0273c0
gh-68966: Deprecate the mailcap module ( #91951 )
2022-04-26 22:43:50 +02:00
b87f7f2c21
bpo-21761: Clarify __file__/__cached__ in import reference (GH-31565)
...
Automerge-Triggered-By: GH:brettcannon
2022-04-26 12:12:02 -07:00
1af871eeee
gh-91217: deprecate telnetlib (GH-91958)
2022-04-26 10:45:08 -07:00
d174ebe91e
gh-91217: deprecate sunau (GH-91866)
2022-04-25 16:26:43 -07:00
cd5726fe67
gh-91401: Add a failsafe way to disable vfork. ( #91490 )
...
Just in case there is ever an issue with _posixsubprocess's use of
vfork() due to the complexity of using it properly and potential
directions that Linux platforms where it defaults to on could take, this
adds a failsafe so that users can disable its use entirely by setting
a global flag.
No known reason to disable it exists. But it'd be a shame to encounter
one and not be able to use CPython without patching and rebuilding it.
See the linked issue for some discussion on reasoning.
Also documents the existing way to disable posix_spawn.
2022-04-25 16:19:39 -07:00
20cc695286
gh-64783: Fix signal.NSIG value on FreeBSD ( #91929 )
...
Fix signal.NSIG value on FreeBSD to accept signal numbers greater
than 32, like signal.SIGRTMIN and signal.SIGRTMAX.
* Add Py_NSIG constant.
* Add pycore_signal.h internal header file.
* _Py_Sigset_Converter() now includes the range of valid signals in
the error message.
2022-04-26 00:13:31 +02:00
93d280141c
gh-90633: Improve error and docs for typing.assert_never ( #91720 )
...
Closes #90633
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2022-04-25 06:40:18 -07:00
f7641a2ffe
gh-91888: add a `:gh:` role to the documentation ( #91889 )
...
* Add a new :gh:`...` role for GitHub issues.
* Fix a GitHub id to use the :gh: role.
* Add Misc/NEWS entry.
* Refactoring and rephrasing.
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2022-04-25 12:05:54 +02:00
dd3cf124a0
gh-91491: What's New in 3.11 section for typing PEPs ( #91721 )
...
Other aspects of typing aren't covered yet; I'll do that in a
separate PR.
2022-04-24 14:13:15 -07:00
b4e048411f
gh-91230: Concise catch_warnings with simplefilter ( #91435 )
2022-04-23 17:55:22 -07:00
692e9078a1
gh-91217: deprecate spwd ( #91846 )
...
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2022-04-23 14:48:17 -07:00
92c1037afc
gh-84461: Add --enable-wasm-pthreads and more file systems (GH-91820)
2022-04-23 14:59:33 +02:00
9b5ca5405e
gh-84461: Add sys._emscripten_info, improve docs and build (gh-91781)
2022-04-23 09:52:16 +02:00
0daa99f68b
gh-88116: Enhance the inspect frame APIs to use the extended position information (GH-91531)
2022-04-23 03:16:48 +01:00
a3f2cf3ced
gh-85864: Mark positional-only args in io docs ( #91683 )
2022-04-22 17:30:52 -07:00
254aaa7981
gh-91547: Remove "Undocumented modules" page ( #91682 )
2022-04-22 16:01:52 -07:00
e7929cba16
gh-91217: deprecate-sndhdr ( #91806 )
...
Also inline necessary functionality from `sndhdr` into `email.mime.audio` for `MIMEAudio`.
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
2022-04-22 15:48:03 -07:00
5576ddbbbc
bpo-46720: Add support for path-like objects to multiprocessing.set_executable for Windows (GH-31279)
...
This bring the API to be on a par with Unix-like systems.
2022-04-22 15:47:09 -07:00
9fe82d0b70
gh-91764: Mark version typing.Unpack and LiteralString were added in ( #91817 )
...
Closes GH-91764
2022-04-22 07:28:39 -07:00
1218061609
gh-89653: PEP 670: Amend docs (GH-91813)
2022-04-22 14:59:18 +02:00
82ec638ab7
Docs: Clarify availability of PyOS_CheckStack (GH-91816)
2022-04-22 12:44:43 +02:00
bcf14ae433
gh-91291: Accept attributes as keyword arguments in decimal.localcontext ( #32242 )
...
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2022-04-21 21:27:15 -07:00
2551a6c92f
gh-91217: deprecate-pipes (GH-91779)
2022-04-21 19:28:34 -07:00
29afb7d2ef
gh-69093: Add indexing and slicing support to sqlite3.Blob ( #91599 )
...
Authored-by: Aviv Palivoda <palaviv@gmail.com>
Co-authored-by: Erlend E. Aasland <erlend.aasland@innova.no>
2022-04-21 18:45:16 -07:00
1317b70f89
gh-91156: Use `locale.getencoding()` instead of getpreferredencoding (GH-91732)
...
Co-authored-by: Victor Stinner <vstinner@python.org>
2022-04-22 10:39:24 +09:00
364ed94092
gh-89373: _Py_Dealloc() checks tp_dealloc exception ( #32357 )
...
If Python is built in debug mode, _Py_Dealloc() now ensures that the
tp_dealloc function leaves the current exception unchanged.
2022-04-21 23:04:01 +02:00
eaa85cb22f
gh-91768: C API no longer use "const PyObject*" type ( #91769 )
...
Py_REFCNT(), Py_TYPE(), Py_SIZE() and Py_IS_TYPE() functions argument
type is now "PyObject*", rather than "const PyObject*".
* Replace also "const PyObject*" with "PyObject*" in functions:
* _Py_strhex_impl()
* _Py_strhex_with_sep()
* _Py_strhex_bytes_with_sep()
* Remove _PyObject_CAST_CONST() and _PyVarObject_CAST_CONST() macros.
* Py_IS_TYPE() can now use Py_TYPE() in its implementation.
2022-04-21 22:07:19 +02:00
d44815cabc
GH-88116: Document that PyCodeNew is dangerous, and make PyCode_NewEmpty less dangerous. (GH-91790)
2022-04-21 19:08:36 +01:00
5974827c71
GH-88756: Update docs for PEP 523 eval function type. (GH-91788)
2022-04-21 18:14:01 +01:00
25e35742ce
Minor improvements to grammar and markup. (GH-91762)
2022-04-20 16:02:47 -05:00
ad3ca17ff5
bpo-23747: Enhance platform doc, document default behavior (GH-31462)
2022-04-20 18:23:40 +02:00
f92bcfe6de
gh-89770: [PEP-678] add exception notes to tutorial (GH-30441)
2022-04-20 13:43:10 +01:00
5101d97d0b
bpo-30718: Add information about text buffering (GH-32351)
2022-04-20 17:24:53 +09:00
26f2e688b8
Clean-up the argparse docs quick links table (GH-91726)
2022-04-20 01:21:54 -05:00
692aea6f38
Add link to sys.path in os lib ( #91679 )
2022-04-19 20:59:48 -07:00
326ae71f1d
Fix awkward sentence in signal docs ( #91508 )
...
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2022-04-19 18:20:25 -07:00
3c43806513
gh-74166: make all_errors keyword-only (GH-91704)
2022-04-19 18:16:20 +01:00
061a8bf77c
gh-91231: Add shutdown_timeout to multiprocessing BaseManager ( #32112 )
...
Add an optional keyword 'shutdown_timeout' parameter to the
multiprocessing.BaseManager constructor. Kill the process if
terminate() takes longer than the timeout.
Multiprocessing tests pass test.support.SHORT_TIMEOUT
to BaseManager.shutdown_timeout.
2022-04-19 16:27:00 +02:00
6a7a8a740e
Doc: Fix link formatting typo (GH-91659)
2022-04-19 18:15:46 +09:00
aa5c0a9f8d
bpo-40421: Cleanup PyFrame C API (GH-32417)
2022-04-19 09:53:10 +02:00
Carl Meyer
Kabir Kwatra
Robert Yang
Jelle Zijlstra
Victor Stinner
David CARLIER
slateny
Samodya Abey
Ken Jin
Carey Metcalfe
Serhiy Storchaka
Meer Suri
Géry Ogam
Yassir Karroum
David Gilbertson
Benjamin Peterson
Sam Ezeh
Eric V. Smith
Thaddeus1499
Harsh
Matt Harding
Inada Naoki
vainaijr
Sam Bull
Antonio Andrade
Yurii Karabas
Motoki Naruse
Dennis Sweeney
Erlend Egeberg Aasland
Shantanu
Brett Cannon
Hugo van Kemenade
Eisuke Kawashima
Ashwin Ramaswami
Gregory P. Smith
Ezio Melotti
Zac Hatfield-Dodds
Christian Heimes
Pablo Galindo Salgado
Dominic Davis-Foster
Erlend Egeberg Aasland
Petr Viktorin
Mark Shannon
Raymond Hettinger
Irit Katriel
AJ Jordan