29c8f80760
GH-95861: Add support for Spearman's rank correlation coefficient (GH-95863)
2022-08-18 13:48:27 -05:00
91afe66707
Docs: Escape lone stars in sqlite3 docs ( #96081 )
2022-08-18 20:39:36 +02:00
c87ea10fc9
gh-95271: Rework sqlite3 tutorial ( #95749 )
...
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
2022-08-18 20:36:20 +02:00
cfaa79aac0
gh-93103: Doc uses PyConfig rather than deprecated vars ( #96070 )
...
The C API documentation now uses the new PyConfig API, rather than
deprecated global configuration variables.
2022-08-18 16:58:38 +02:00
0f2b469ce1
gh-95991: Add some infrastructure for testing Limited API in _testcapi (GH-95992)
...
- Limited API needs to be enabled per source file
- Some builds don't support Limited API, so Limited API tests must be skipped on those builds
(currently this is `Py_TRACE_REFS`, but that may change.)
- `Py_LIMITED_API` must be defined before `<Python.h>` is included.
This puts the hoop-jumping in `testcapi/parts.h`, so individual
test files can be relatively simple. (Currently that's only
`vectorcall_limited.c`, imagine more.)
2022-08-17 13:48:43 +02:00
da0aa518bf
gh-96005: FreeBSD has ENOTCAPABLE, too (GH-96034)
2022-08-17 07:24:53 +02:00
48174fa0b9
gh-96005: Handle WASI ENOTCAPABLE in getpath (GH-96006)
...
- On WASI `ENOTCAPABLE` is now mapped to `PermissionError`.
- The `errno` modules exposes the new error number.
- `getpath.py` now ignores `PermissionError` when it cannot open landmark
files `pybuilddir.txt` and `pyenv.cfg`.
2022-08-16 20:20:15 +02:00
e8259e047c
Clarify asyncio.Runner docs re: loop_factory ( #95979 )
2022-08-14 08:53:34 -07:00
f235178bec
gh-94439: typing docs: Add minimum version to `__required_keys__` and `__optional_keys__` ( #95373 )
2022-08-12 21:23:33 -07:00
50bf5fafcc
gh-82180: Document support for non-integer arg removed from grp.getgrgid in 3.10 (GH-95346)
2022-08-12 18:22:06 +02:00
e6623e7083
gh-95273: Improve sqlite3.complete_statement docs ( #95840 )
...
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-08-12 01:05:12 +02:00
9af4aed73a
gh-75510: Edit idlelib entry in doc ( #95869 )
...
Make section instead of subsection and revise sentence.
2022-08-10 22:44:17 -04:00
70fc9641b5
gh-75500: Add idlelib section to IDLE doc ( #95832 )
...
This enables accessing IDLE as 'idlelib' in the Doc Module listing.
2022-08-09 14:34:42 -04:00
141f2517fc
gh-95767: Fix grammatical error in asyncio loop.create_task docs ( #95768 )
2022-08-09 15:59:27 +02:00
7c8626ab3d
Improvements to the bisect docs (GH-95807)
2022-08-09 01:31:50 -05:00
41c939cb35
gh-95273: Reorganize sqlite3 doc module level funcs and vars ( #95626 )
...
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-08-08 21:25:35 +02:00
f83b0cabeb
Fix documentation typo for functools.cmp_to_key (GH-95766)
2022-08-08 01:49:48 -05:00
56af5a200d
gh-94635: Fixup sqlite3 'Introduction' seealso note ( #95751 )
...
In gh-95269, the seealso note incorrectly ended up in
the 'Tutorial' section.
2022-08-06 23:30:26 +02:00
56d16e8cb4
gh-93243: Make smtpd private before porting its users (GH-93246)
...
gh-93243
This PR is required to reduce diffs of the following porting (no need to either maintain documentation and tests consistent with each porting step, or try to port everything and remove smtpd in a single PR).
Automerge-Triggered-By: GH:warsaw
2022-08-05 17:41:29 -07:00
29650fea96
gh-86943: implement `pathlib.WindowsPath.is_mount()` (GH-31458)
...
Have `pathlib.WindowsPath.is_mount()` call `ntpath.ismount()`. Previously it raised `NotImplementedError` unconditionally.
https://bugs.python.org/issue42777
2022-08-05 15:37:44 -07:00
834064c19a
gh-89362: Doc IDLE menu and search ( #95697 )
...
Update menu item position and capitalization.
Add paragraph about search.
For help.html, include save-as addition.
2022-08-05 12:21:45 -04:00
a525f2ada4
GH-95685: Fix rendering of the string documentation ( #95686 )
...
There's an extra underlines that messed the rest of the documentation rendering.
Closes #95685
2022-08-05 09:41:02 +02:00
5f3c9fda18
GH-90997: Document CACHEs (GH-95694)
2022-08-04 22:45:05 -07:00
9890f86ae2
gh-65802: IDLE - explain SaveAs and extensions ( #95690 )
...
File name extensions may or may not be shown for the current name
and are added in an OS-dependent manner if not given for the new
name.
2022-08-04 21:51:14 -04:00
e1182bc377
gh-94619: Remove long deprecated methods module_repr() and load_module() ( #94624 )
...
* gh-94619: Remove long deprecated methods module_repr() and load_module()
Closes #94619
* Update Misc/NEWS.d/next/Library/2022-07-06-14-57-33.gh-issue-94619.PRqKVX.rst
Fix typo
Co-authored-by: Brett Cannon <brett@python.org>
Co-authored-by: Brett Cannon <brett@python.org>
2022-08-04 17:24:26 -07:00
44f1f63ad5
Docs: sqlite3 docs fixup ( #95681 )
...
- Disable links to the module itself
- Fix link indent
- Consistent ref markup
2022-08-05 00:06:46 +02:00
b24e8b28a7
gh-95271: Extract placeholders howto from sqlite3 tutorial ( #95522 )
...
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
2022-08-04 22:41:18 +02:00
12d92c733c
gh-95273: Improve documented return values and exceptions raised for sqlite3 class methods ( #95530 )
...
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
2022-08-04 21:58:10 +02:00
962acd4468
Docs: fix two typos in the sqlite3 docs ( #95661 )
...
- statment => statement
- transaciton => transaction
2022-08-04 20:25:53 +02:00
0342c93a6b
gh-91323: Revert "Allow overriding a future compliance check in asyncio.Task (GH-32197)" (GH-95442)
...
This reverts commit d4bb38f82b
2022-08-04 15:51:38 +02:00
d0d0154443
gh-91838: Resolve HTTP links which redirect to HTTPS (GH-95642)
...
It updates links which redirect to HTTPS with different authority or
path.
2022-08-04 13:30:05 +03:00
f79547a429
gh-91838: Use HTTPS links in docs for resources which redirect to HTTPS (GH-95527)
...
If an HTTP link is redirected to a same looking HTTPS link, the latter can
be used directly without changes in readability and behavior.
It protects from a men-in-the-middle attack.
This change does not affect Python examples.
2022-08-04 10:13:49 +03:00
dc2757accd
gh-90817: Use .. deprecated-removed:: when removal version known ( #94960 )
2022-08-03 23:47:20 +02:00
ebd660156d
gh-95423: Update winreg.DeleteKeyEx documentation and remove dynamic function load (GH-95521)
2022-08-03 21:55:03 +01:00
4d02572f8c
gh-95273: Align sqlite3 const doc refs with the devguide recommendations ( #95525 )
2022-08-03 22:21:15 +02:00
89f5229328
Docs: fix incorrect formatting in sqlite3 CLI docs ( #95581 )
2022-08-03 00:17:09 +02:00
e3b6ff19aa
gh-95451: Update docs for wasm32-emscripten and -wasi platforms (GH-95452)
...
Co-authored-by: Éric <merwok@netwok.org>
Co-authored-by: Michael Droettboom <mdboom@gmail.com>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-08-02 21:00:41 +02:00
75a6441718
gh-95516: Add param types and clarify param descriptions of LogRecord (GH-95517)
2022-08-02 08:42:35 +01:00
d965d1995e
no-issue: Fix typo of "thrid" instead of "third" in dis docs (gh-95510)
2022-08-02 00:06:43 +09:00
bc7c7cd18a
gh-77617: Add sqlite3 command-line interface ( #95026 )
...
Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
2022-08-01 12:25:16 +02:00
1e6b63542e
gh-95273: Clarify when sqlite_* attributes are added to sqlite3 exceptions ( #95523 )
2022-08-01 11:15:07 +02:00
d29e279de3
bpo-42037: Corrected request dependencies in CookieJar functions (GH-23112)
2022-08-01 10:42:13 +08:00
aa37ffda29
bpo-45445: Revert "bpo-45445: Fail if an invalid X-option is provided in the command line (GH-28823)" ( #94745 )
2022-07-31 16:33:56 +01:00
6c439b978b
gh-94635: Add Reference, How-to, and Concepts headings to sqlite3 docs ( #94636 )
...
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-07-31 01:24:15 +02:00
82814624bf
Doctest cleanups (GH-95436)
...
* GHA: Don't hide doctest output
* Enable doctests in math.rst
* Squash warnings in nntplib.rst doctests
* Squash warning in turtle.rst doctest
* Squash warnings in whatsnew/3.2.rst doctests
* Treat warnings as errors in Doc/ doctests
2022-07-30 17:21:08 -05:00
cd26595232
gh-95454: Replace truthy/falsy with true/false (GH-95456)
2022-07-30 00:42:21 -07:00
d92b19e1b5
gh-95273: Relocate sqlite3 enable load extension note ( #95430 )
2022-07-29 21:27:15 +02:00
e3bae80e70
gh-94302: Clarify use of the 'open' operation in os.startfile (GH-95441)
2022-07-29 17:24:56 +01:00
f81a6c5fc7
gh-95415: Make availability directive consistent (GH-95416)
2022-07-29 16:42:09 +02:00
2fbee85931
gh-95432: Fixup sqlite3 tutorial example ( #95431 )
...
- the insert statement should have five placeholders, not four
- missing ... in the multiline row list
2022-07-29 14:31:41 +02:00
e003b64f40
gh-95273: Improve sqlite3 class descriptions ( #95379 )
...
Co-authored-by: CAM Gerlach <CAM.Gerlach@Gerlach.CAM>
2022-07-29 11:53:23 +02:00
f0bf7956e6
gh-95273: Move sqlite3 executemany examples from reference to tutorial ( #95351 )
2022-07-29 09:42:22 +02:00
e9c8de669d
gh-95273: Condense sqlite3 executescript example ( #95383 )
2022-07-29 09:40:44 +02:00
6e44bf9558
Improve documentation for adding datetime and timedelta (gh-95403)
2022-07-28 20:09:51 -04:00
7df2f4d787
gh-86128: Add warning to ThreadPoolExecutor docs about atexit behaviour (GH-94008)
2022-07-28 23:38:56 +01:00
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
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
df7c8b9537
gh-95233: Correct grp.getgrgid parameter name in documentation (gid -> id) (gh-95232)
2022-07-25 18:54:42 +09: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
c1e929858a
gh-90385: Add `pathlib.Path.walk()` method (GH-92517)
...
Automerge-Triggered-By: GH:brettcannon
2022-07-22 16:55:46 -07: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
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
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
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
ed06ec1ab8
GH-81620: Add random.binomialvariate() (GH-94719)
2022-07-13 09:46:04 -05: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
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
Raymond Hettinger