a3859422d1
Update http.cookiejar document for cookie object attributes (GH-101885)
2024-02-22 19:08:04 +00:00
7bc79371a6
gh-115795: Doc: fix obsolete URL ( #115749 )
2024-02-22 08:45:26 +02:00
fac99b8b0d
gh-111140: Improve PyLong_AsNativeBytes API doc example & improve the test ( #115380 )
...
This expands the examples to cover both realistic use cases for the API.
I noticed thing in the test that could be done better so I added those as well: We need to guarantee that all bytes of the result are overwritten and that too many are not written. Tests now pre-fills the result with data in order to ensure that.
Co-authored-by: Steve Dower <steve.dower@microsoft.com>
2024-02-22 03:27:16 +00:00
fbd40ce46e
gh-115399: Document CVE-2023-52425 under "XML vulnerabilities" (GH-115400)
...
Doc/library/xml.rst: Document CVE-2023-52425 under "XML vulnerabilities"
2024-02-21 12:26:16 +01:00
10fc4675fd
gh-115653: Document PyCode_GetFirstFree() ( #115654 )
...
Correct the return type of the PyCode_GetNumFree() documentation.
2024-02-21 10:01:36 +01:00
e1fdc3c323
gh-104061: Add socket.SO_BINDTOIFINDEX constant (GH-104062)
...
Add socket.SO_BINDTOIFINDEX constant
This socket option avoids a race condition between SO_BINDTODEVICE and network interface renaming.
2024-02-20 23:08:15 +02:00
c0b0c2f201
gh-101860: Expose __name__ on property (GH-101876)
...
Useful for introspection and consistent with functions and other
descriptors.
2024-02-20 17:14:34 +02:00
e71468ba4f
gh-112020: Document the meaning of empty bytes returned by socket.recv() (GH-112055)
2024-02-20 16:54:33 +02:00
acda1757bc
gh-113157: Document and test __get__ for MethodType (gh-115492)
2024-02-20 01:53:25 -06:00
2aaef56236
Make the title match the content (GH-115702)
2024-02-20 01:51:56 -06:00
9f8a9e8ac7
Modernize the Sorting HowTo guide (gh-115479)
2024-02-19 21:22:07 -06:00
57d31ec359
Fix typo in multiprocessing docs ( #115650 )
2024-02-19 18:19:14 +00:00
8f602981ba
gh-115664: Fix versionadded and versionchanged directives in multiprocessing.rst (GH-115665)
2024-02-19 18:03:42 +00:00
b02ab65e80
gh-115664: Fix chronological ordering of versionadded and versionchanged directives ( #115676 )
2024-02-19 17:54:54 +00:00
d504968983
gh-115652: Fix indentation in the documentation of multiprocessing.get_start_method (GH-115658)
2024-02-19 14:26:23 +00:00
cbe809dfa9
gh-83648: Add missing `deprecated` arg in argparse.rst (GH-115640)
2024-02-19 10:29:32 +02:00
1476ac2c58
gh-102388: Add windows_31j to aliases for cp932 codec ( #102389 )
...
The charset name "Windows-31J" is registered in the IANA Charset Registry[1]
and is implemented in Python as the cp932 codec.
[1] https://www.iana.org/assignments/charset-reg/windows-31J
Signed-off-by: Masayuki Moriyama <masayuki.moriyama@miraclelinux.com>
2024-02-19 17:01:35 +09:00
177b9cb52e
Docs: Add explanation about little/big endian ( #109841 )
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
2024-02-18 23:50:09 -08:00
edea0e7d99
gh-114709: Mark commonpath behaviour as changed in 3.13 ( #115639 )
2024-02-18 14:08:50 -08:00
0c80da4c14
gh-115572: Move `codeobject.replace()` docs to the data model ( #115631 )
2024-02-18 14:13:46 +00:00
371c970886
gh-114709: Fix exceptions raised by posixpath.commonpath ( #114710 )
...
Fix the exceptions raised by posixpath.commonpath
Raise ValueError, not IndexError when passed an empty iterable. Raise
TypeError, not ValueError when passed None.
2024-02-18 00:24:58 -08:00
04005f5021
Document use of ANY in test assertions (GH-94060)
2024-02-17 13:13:34 +00:00
e88ebc1c40
gh-97590: Update docs and tests for ftplib.FTP.voidcmd() (GH-96825)
...
Since 2f3941d743
2024-02-17 11:57:51 +00:00
d5a30a1777
gh-56499: Update the pickle library's note section for the __setstate__ function (GH-101062)
2024-02-17 10:51:43 +00:00
debb1386be
gh-87688: Amend SSLContext.hostname_checks_common_name docs (GH-100517)
2024-02-17 10:22:19 +00:00
4dff48d1f4
gh-101100: Fix Sphinx warnings in `whatsnew/3.2.rst` ( #115580 )
...
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2024-02-17 03:03:20 -07:00
30fce5f228
gh-101100: Fix Sphinx warnings in `whatsnew/3.1.rst` ( #115575 )
2024-02-17 02:39:07 -07:00
d2d7808853
gh-101699: Explain using Match.expand with \g<0> (GH-101701)
...
Update documentation for re library to explain that a backreference `\g<0>` is
expanded to the entire string when using Match.expand().
Note that numeric backreferences to group 0 (`\0`) are not supported.
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2024-02-17 08:33:28 +00:00
73e8637002
gh-113812: Allow DatagramTransport.sendto to send empty data ( #115199 )
...
Also include the UDP packet header sizes (8 bytes per packet)
in the buffer size reported to the flow control subsystem.
2024-02-16 18:38:07 -08:00
318f2190bc
docs: Add glossary term references to shutil docs ( #115559 )
...
Add glossary term references to shutil docs
2024-02-16 16:04:17 -06:00
5903190727
gh-115103: Implement delayed memory reclamation (QSBR) ( #115180 )
...
This adds a safe memory reclamation scheme based on FreeBSD's "GUS" and
quiescent state based reclamation (QSBR). The API provides a mechanism
for callers to detect when it is safe to free memory that may be
concurrently accessed by readers.
2024-02-16 15:25:19 -05:00
2a7a0020c9
gh-69990: Make Profile.print_stats support sorting by multiple values (GH-104590)
...
Co-authored-by: Chiu-Hsiang Hsu
2024-02-16 12:03:46 +00:00
cfb26401f6
gh-100734: What's New in 3.x: Add missing detail from 3.x branch ( #114689 )
2024-02-15 17:32:33 +02:00
298bcdc185
gh-112433: Add optional _align_ attribute to ctypes.Structure (GH-113790)
2024-02-15 16:40:20 +02:00
edb59d5718
bpo-38364: unwrap partialmethods just like we unwrap partials ( #16600 )
...
* bpo-38364: unwrap partialmethods just like we unwrap partials
The inspect.isgeneratorfunction, inspect.iscoroutinefunction and inspect.isasyncgenfunction already unwrap functools.partial objects, this patch adds support for partialmethod objects as well.
Also: Rename _partialmethod to __partialmethod__.
Since we're checking this attribute on arbitrary function-like objects,
we should use the namespace reserved for core Python.
---------
Co-authored-by: Petr Viktorin <encukou@gmail.com>
2024-02-15 12:08:45 +01:00
9e3729bbd7
gh-114626: add PyCFunctionFast and PyCFunctionFastWithKeywords (GH-114627)
...
Co-authored-by: Petr Viktorin <encukou@gmail.com>
2024-02-15 11:05:20 +01:00
474204765b
docs: use consistent .append() in dis.rst ( #115434 )
...
The STACK variable is described as like a Python list, so pushing to it should be done with .append() consistently throughout.
2024-02-15 02:14:03 -05:00
3e7b7df5cb
gh-114570: Add PythonFinalizationError exception ( #115352 )
...
Add PythonFinalizationError exception. This exception derived from
RuntimeError is raised when an operation is blocked during the Python
finalization.
The following functions now raise PythonFinalizationError, instead of
RuntimeError:
* _thread.start_new_thread()
* subprocess.Popen
* os.fork()
* os.fork1()
* os.forkpty()
Morever, _winapi.Overlapped finalizer now logs an unraisable
PythonFinalizationError, instead of an unraisable RuntimeError.
2024-02-14 23:35:06 +01:00
49e8fdc1df
Docs: spell out sentence about ndbm/gdbm file formats ( #115470 )
2024-02-14 19:03:20 +01:00
81e140d10b
Docs: reword sentences about dbm submodule traits ( #114609 )
...
Don't repeatedly say that keys and values are coerced into bytes.
2024-02-14 16:36:13 +01:00
6755c4e0c8
gh-115403: Remove extra colon after "Examples" in datetime documentation ( #115452 )
2024-02-14 13:52:42 +00:00
6d9141ed76
gh-100414: Make dbm.sqlite3 the preferred dbm backend ( #115447 )
2024-02-14 13:47:19 +00:00
dd5e4d9078
gh-100414: Add SQLite backend to dbm ( #114481 )
...
Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com>
2024-02-14 11:14:56 +00:00
3fd2ad8241
ftplib docs: `timeout` doesn't have to be a whole number ( #115443 )
2024-02-14 10:41:17 +00:00
46245b0d83
Docs: Use substitutions instead of manual version updates ( #115416 )
2024-02-13 23:55:00 -07:00
de07941729
gh-115405: add versionadded tag for co_qualname in code objects documentation ( #115411 )
2024-02-13 16:10:00 +00:00
5719aa23ab
gh-113437: Update documentation about PyUnicode_AsWideChar() function (GH-113455)
2024-02-13 15:23:10 +01:00
0a6e1a4119
Update "Using Python on a Mac" ( #115024 )
2024-02-13 08:31:49 +02:00
10756b10ff
gh-111140: Minor doc fixes for PyLong_AsNativeBytes (GH-115375)
2024-02-12 22:28:36 +00:00
341d7874f0
gh-115317: Rewrite changelog filter to use vanilla JavaScript ( #115324 )
...
Co-authored-by: Tomas R <tomas.roun8@gmail.com>
2024-02-12 22:17:33 +00:00
7861dfd26a
gh-111140: Adds PyLong_AsNativeBytes and PyLong_FromNative[Unsigned]Bytes functions (GH-114886)
2024-02-12 20:13:13 +00:00
879f4546bf
gh-110850: Add PyTime_t C API (GH-115215)
...
* gh-110850: Add PyTime_t C API
Add PyTime_t API:
* PyTime_t type.
* PyTime_MIN and PyTime_MAX constants.
* PyTime_AsSecondsDouble(), PyTime_Monotonic(),
PyTime_PerfCounter() and PyTime_GetSystemClock() functions.
Co-authored-by: Victor Stinner <vstinner@python.org>
2024-02-12 18:13:10 +01:00
91822018ee
gh-115233: Fix an example in the Logging Cookbook (GH-115325)
...
Also add more tests for LoggerAdapter.
Also support stacklevel in LoggerAdapter._log().
2024-02-12 18:24:45 +02:00
92483b21b3
gh-101100: Fix Sphinx warnings in `whatsnew/2.7.rst` and related ( #115319 )
...
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2024-02-12 14:40:41 +02:00
705c76d4a2
gh-114785: Remove content from `Porting from Python2` how-to ( #114805 )
...
Keep the page though, because people might still rely on it (the traffic shows that they do).
Instead of our own manual we now give links to the 3rd-party ones.
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
2024-02-12 14:59:58 +03:00
235cacff81
GH-114695: Add `sys._clear_internal_caches` (GH-115152)
2024-02-12 09:04:36 +00:00
e1552fd19d
gh-101100: Clean up Doc/c-api/exceptions.rst and Doc/c-api/sys.rst (GH-114825)
2024-02-11 18:51:07 +00:00
b104360788
gh-49766: Make date-datetime comparison more symmetric and flexible (GH-114760)
...
Now the special comparison methods like `__eq__` and `__lt__` return
NotImplemented if one of comparands is date and other is datetime
instead of ignoring the time part and the time zone or forcefully
return "not equal" or raise TypeError.
It makes comparison of date and datetime subclasses more symmetric
and allows to change the default behavior by overriding
the special comparison methods in subclasses.
It is now the same as if date and datetime was independent classes.
2024-02-11 13:06:43 +02:00
d2c4baa41f
gh-97928: Partially restore the behavior of tkinter.Text.count() by default (GH-115031)
...
By default, it preserves an inconsistent behavior of older Python
versions: packs the count into a 1-tuple if only one or none
options are specified (including 'update'), returns None instead of 0.
Except that setting wantobjects to 0 no longer affects the result.
Add a new parameter return_ints: specifying return_ints=True makes
Text.count() always returning the single count as an integer
instead of a 1-tuple or None.
2024-02-11 12:43:14 +02:00
573acb30f2
gh-115172: Fix explicit index extries for the C API (GH-115173)
2024-02-11 12:23:30 +02:00
1b89591474
gh-101100: Fix dangling refs in bdb.rst ( #114983 )
...
Co-authored-by: AN Long <aisk@users.noreply.github.com>
2024-02-11 11:21:10 +02:00
4821f08674
gh-101100: Fix sphinx warnings in `c-api/gcsupport.rst` ( #114786 )
2024-02-10 15:59:23 -07:00
9d1a353230
gh-114894: add array.array.clear() method ( #114919 )
...
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
Co-authored-by: AN Long <aisk@users.noreply.github.com>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
2024-02-10 07:59:46 -08:00
e19103a346
gh-114552: Update `__dir__` method docs: it allows returning an iterable ( #114662 )
2024-02-10 08:34:23 +00:00
b2d9d134dc
gh-96471: Add shutdown() method to queue.Queue ( #104750 )
...
Co-authored-by: Duprat <yduprat@gmail.com>
2024-02-09 20:58:30 -08:00
769d444826
Docs: correctly link to code objects ( #115214 )
2024-02-09 15:11:36 +01:00
c968dc7ff3
GH-113632: update configure.ac for WebAssembly support tiers ( #115192 )
...
Move WASI to tier 2 and drop Emscripten.
2024-02-09 09:21:49 +01:00
553c90ccc2
gh-101100: Fix sphinx warnings in `library/enum.rst` ( #114696 )
...
Co-authored-by: Ethan Furman <ethan@stoneleaf.us>
2024-02-08 23:40:28 -07:00
17689e3c41
gh-107944: Improve error message for getargs with bad keyword arguments ( #114792 )
2024-02-08 01:04:41 -08:00
8a3c499ffe
GH-108362: Revert "GH-108362: Incremental GC implementation (GH-108038)" ( #115132 )
...
Revert "GH-108362: Incremental GC implementation (GH-108038)"
This reverts commit 36518e69d7
2024-02-07 12:38:34 +00:00
d0322fdf2c
gh-101100: Fix Py_DEBUG dangling Sphinx references ( #115003 )
2024-02-07 10:48:42 +00:00
60375a3809
gh-115114: Add missing slash to file URI prefix `file:/` ( #115115 )
...
Add missing slash to file URI prefix `file:/`
2024-02-07 05:22:47 +00:00
3f71c416c0
gh-115106 docs: 'enum.Flag.__iter__()' did not exist prior to Python 3.11 (GH-115107)
...
change versionchanged to versionadded
2024-02-06 17:28:01 -08:00
de61d4bd4d
gh-112066: Add `PyDict_SetDefaultRef` function. ( #112123 )
...
The `PyDict_SetDefaultRef` function is similar to `PyDict_SetDefault`,
but returns a strong reference through the optional `**result` pointer
instead of a borrowed reference.
Co-authored-by: Petr Viktorin <encukou@gmail.com>
2024-02-06 11:36:23 -05:00
0e2ab73dc3
gh-114756: Update FAQ section on removing the GIL ( #114957 )
...
Update FAQ section on removing the GIL to reflect recent progress on PEP 703 and PEP 684.
Co-authored-by: AN Long <aisk@users.noreply.github.com>
2024-02-06 10:55:44 -05:00
1a10437a14
gh-91602: Add iterdump() support for filtering database objects ( #114501 )
...
Add optional 'filter' parameter to iterdump() that allows a "LIKE"
pattern for filtering database objects to dump.
Co-authored-by: Erlend E. Aasland <erlend@python.org>
2024-02-06 12:34:56 +01:00
bb57ffdb38
gh-83648: Support deprecation of options, arguments and subcommands in argparse (GH-114086)
2024-02-06 00:41:34 +02:00
652fbf88c4
gh-82626: Emit a warning when bool is used as a file descriptor (GH-111275)
2024-02-05 22:51:11 +02:00
750489cc77
gh-114967: Fix "Built-in Exceptions" documentation ambiguous wording ( #114968 )
...
Change the somewhat vague "listed below" to "listed in this chapter" in Doc/library/exceptions.rst.
The exceptions are listed in multiple sections after two intermediate sections.
---------
Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
2024-02-05 15:22:57 -05:00
36518e69d7
GH-108362: Incremental GC implementation (GH-108038)
2024-02-05 18:28:51 +00:00
b4ba0f73d6
gh-43457: Tkinter: fix design flaws in wm_attributes() (GH-111404)
...
* When called with a single argument to get a value, it allow to omit
the minus prefix.
* It can be called with keyword arguments to set attributes.
* w.wm_attributes(return_python_dict=True) returns a dict instead of
a tuple (it will be the default in future).
* Setting wantobjects to 0 no longer affects the result.
2024-02-05 18:24:54 +02:00
39ec7fbba8
Remove bogus syntax error marker in csv doc ( #115017 )
2024-02-05 04:11:31 +00:00
da8f9fb2ea
gh-113803: Fix inaccurate documentation for shutil.move when dst is an existing directory ( #113837 )
...
* fix the usage of dst and destination in shutil.move doc
* update shutil.move doc
2024-02-04 13:42:58 -05:00
ca715e56a1
gh-69893: Add the close() method for xml.etree.ElementTree.iterparse() iterator (GH-114534)
2024-02-04 17:25:21 +02:00
ff7588b729
gh-114071: [Enum] update docs and code for tuples/subclasses (GH-114871)
...
Update documentation with `__new__` and `__init__` entries.
Support use of `auto()` in tuple subclasses on member assignment lines. Previously, auto() was only supported on the member definition line either solo or as part of a tuple:
RED = auto()
BLUE = auto(), 'azul'
However, since Python itself supports using tuple subclasses where tuples are expected, e.g.:
from collections import namedtuple
T = namedtuple('T', 'first second third')
def test(one, two, three):
print(one, two, three)
test(*T(4, 5, 6))
# 4 5 6
it made sense to also support tuple subclasses in enum definitions.
2024-02-04 07:22:55 -08:00
ec69e1d0dd
gh-101100: Fix dangling references in pickle.rst ( #114972 )
...
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2024-02-04 14:24:24 +00:00
848c86786b
gh-101100: Fix Sphinx warnings from PEP 3108 stdlib re-organisation ( #114327 )
...
* Fix Sphinx warnings from PEP 3108 stdblib re-organisation
* Apply suggestions from code review
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* Update Doc/whatsnew/2.2.rst
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
* Apply suggestions from code review
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
---------
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2024-02-04 09:45:35 +00:00
72d2d0f10d
gh-114803: Mention that `@dataclass` should not be applied on enums (GH-114891)
...
Co-authored-by: Kirill Podoprigora <kirill.bast9@mail.ru>
Co-authored-by: Ethan Furman <ethan@stoneleaf.us>
2024-02-03 13:55:38 -08:00
ab76d37948
gh-101100: Fix Sphinx reference warnings in the glossary ( #114729 )
...
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2024-02-03 18:45:49 +00:00
6b53d5fe04
gh-112202: Ensure that condition.notify() succeeds even when racing with Task.cancel() ( #112201 )
...
Also did a general cleanup of asyncio locks.py comments and docstrings.
2024-02-03 08:19:37 -08:00
b4240fd68e
gh-114955: Add clear to MutableSequence's mixin methods in document (gh-114956)
2024-02-03 09:33:58 -06:00
28bb2961ba
Update LOGGING example taken from Django docs. ( #114903 )
...
For example, Django no longer provides a custom NullHandler
6c66a41c3d
2024-02-03 09:37:21 +02:00
00d7109075
Normalize heading underline in multiprocessing.rst ( #114923 )
...
This gets rid of the mildly confusing `>>>>>>>' underlines which look vaguely like `diff` punctuation.
2024-02-02 17:56:00 -08:00
1183f1e6bf
gh-114913: Add newline to subprocess doc ( #114941 )
...
*creationflags* is a separate topic from *startupinfo*.
Start sentence with 'If given', like previous sentence.
2024-02-02 23:14:32 +00:00
73d20cafb5
Correct timedelta description (GH-101417)
...
It only represents the difference between two datetime or
date objects, not between two time objects.
2024-02-02 23:42:17 +02:00
b27812d632
Fix indentation of "versionchanged" in datetime.rst (GH-114933)
2024-02-02 23:09:16 +02:00
c12240ed28
gh-114728: Fix documentation for comparison of objects in datetime module (GH-114749)
2024-02-02 20:53:24 +02:00
9872855a31
GH-69695: Update ``PyImport_ImportModule`` description (GH-103836)
...
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-02-02 17:31:55 +01:00
ee66c33349
gh-114909: Add --first-weekday option to usage message ( #114910 )
2024-02-02 17:13:00 +02:00
d29f57f603
gh-103360: Add link in stdtypes.rst to escape sequences in lexical_analysis.rst (GH-103638)
2024-02-02 15:32:46 +02:00
NewUserHa
partev
Gregory P. Smith
Sebastian Pipping
Bogdan Romanyuk
Victor Westerhuis
Eugene Toder
talcs
Raymond Hettinger
Naglis Jonaitis
Serhiy Storchaka
Brian Schubert
Daniel Haag
0xflotus
Masayuki Moriyama
Simon A. Eugster
Shantanu
Daler
Sebastian Rittau
Thomas Grainger
Matthew Hughes
Furkan Onder
Rami
Hugo van Kemenade
Stevoisiak
Jamie Phan
Sam Gross
monkeyman192
Martijn Pieters
David Hewitt
Ned Batchelder
Victor Stinner
Erlend E. Aasland
Stanislav Lyu
Alex Waygood
Christophe Papazian
qqwqqw689
Steve Dower
Petr Viktorin
Nikita Sobolev
Brandt Bucher
Skip Montanaro
Mike Zimin
Laurie O
Brett Cannon
Mark Shannon
Edgar Ramírez Mondragón
Finite State Machine
da-woods
Mariusz Felisiak
HarryLHW
Terry Jan Reedy
Dai Wentao
Ethan Furman
Kristján Valur Jónsson
AN Long
John Belmonte
patenaud
Steven Ward
Justin Williams