009b2f0204
Correct a typo in the Unittest documentation (GH-10397)
...
Co-Authored-By: maggyero <gery.ogam@gmail.com>
2018-11-09 14:34:54 -05:00
b83942c755
Cleanup and improve the regex tokenizer example. (GH-10426)
...
1) Convert weird field name "typ" to the more standard "type".
2) For the NUMBER type, convert the value to an int() or float().
3) Simplify ``group(kind)`` to the shorter and faster ``group()`` call.
4) Simplify logic go a single if-elif chain to make this easier to extend.
5) Reorder the tests to match the order the tokens are specified.
This isn't necessary for correctness but does make the example
easier to follow.
6) Move the "column" calculation before the if-elif chain so that
users have the option of using this value in error messages.
2018-11-09 01:19:33 -08:00
0f221d09ca
bpo-24412: Adds cleanUps for setUpClass and setUpModule. (GH-9190)
2018-11-08 18:34:33 -08:00
ae31e3fbf4
glob uses fnmatch.filter instead of fnmatch since 2001. (GH-10102)
2018-11-07 20:09:11 +02:00
d64991031e
Correct grammar mistakes in string.rst. (GH-9752)
2018-11-07 19:24:56 +02:00
ca03f3b93e
Mark len call as a code snippet in stdtypes.rst. (GH-9804)
2018-11-07 19:22:47 +02:00
637a33b996
bpo-2504: Add pgettext() and variants to gettext. (GH-7253)
2018-11-07 16:12:20 +02:00
5598cc90c7
bpo-34160: Preserve order of attributes in minidom. (GH-10219)
2018-11-07 16:09:04 +02:00
f194479949
bpo-31553: add --json-lines option to json.tool ( #10051 )
...
* add jsonlines option to json.tool
* code review
* fix:avoid read infile after it close
* improve doc in whatsnew 3.8
2018-11-07 12:09:32 +02:00
0e7497cb46
bpo-34898: Add mtime parameter to gzip.compress(). (GH-9704)
...
Without setting mtime, time.time() will be used as the timestamp which will
end up in the compressed data and each invocation of the compress() function
will vary over time.
2018-11-07 11:50:23 +02:00
d2b11af915
Remove duplicate "Reference Guide" in optparse.rst. (GH-10372)
2018-11-07 07:47:11 +02:00
76cd0c30d6
bpo-33000: Document that IDLE's shell has no line limit. ( #10373 )
...
A program that runs indefinitely can overfill memory.
2018-11-06 23:55:06 -05:00
75d9d59ab3
bpo-23220: Explain how IDLE's Shell displays output (GH-10356)
...
Add a new subsection to the doc.
2018-11-06 12:37:36 -05:00
5e79090324
bpo-35099: Improve the doc about IDLE running user code. ( #10350 )
...
The section is renamed from "IDLE -- console differences". It mostly
covers the implications of using custom sys.stdxxx objects.
2018-11-05 21:30:32 -05:00
6531bf6309
bpo-33462: Add __reversed__ to dict and dict views (GH-6827)
2018-11-06 09:38:54 +09:00
16c8a53490
[Docs] Fix required version of an example of importlib (GH-10118)
...
§31.5.6.3. Importing a source file directly: `module_from_spec` is new in Python 3.5.
2018-11-05 23:41:17 +01:00
083a7a172b
bpo-35167: Specify program for gzip and json.tool command line options. (GH-10332)
2018-11-05 17:47:27 +02:00
ad1a25f499
bpo-32512: Add -m option to profile for profiling modules ( #5132 )
...
The new option in the CLI of the profile module allow to profile
executable modules. This change follows the same implementation as the
one already present in `cProfile`.
As the argument is now present on both modules, move the tests to the
common test case to be run with profile as well.
2018-11-05 22:03:46 +10:00
2810dd7be9
closes bpo-32285: Add unicodedata.is_normalized. (GH-4806)
2018-11-04 15:58:24 -08:00
98b8535415
bpo-35118: Improve docs regarding indexing (GH-10265)
2018-11-04 14:34:22 -08:00
55f3317e98
bpo-10536: Enhancements to gettext docs (GH-10324)
2018-11-04 23:24:41 +01:00
622935d9a6
bpo-31887: Adds documentations for special multipart/signed handling (GH-4268)
...
This pull request adds some information about the special multipart/signed handling to clear about disabling header folding.
https://bugs.python.org/issue31887
2018-11-04 14:12:34 -08:00
52465e1b8b
Explain that the orderness of the result of glob is system-dependant (GH-6587)
...
Thanks!
2018-11-04 15:50:55 +01:00
3e28eed9ec
bpo-34969: Add --fast, --best on the gzip CLI (GH-9833)
2018-11-03 16:24:23 +01:00
bf46a09dec
bpo-35075: Fix broken url in the pprint documentation (GH-10201)
...
https://bugs.python.org/issue35075
2018-11-01 05:29:38 -07:00
511747bec3
bpo-35110: Fix yet few spaces before dashes. (GH-10255)
2018-10-31 11:14:38 +02:00
3f819ca138
bpo-35110: Fix unintentional spaces around hyphens and dashes. (GH-10231)
2018-10-31 02:26:06 +02:00
68f323715e
bpo-35116, urllib.parse: Document the new max_num_fields parameter (GH-10247)
2018-10-30 21:30:19 +01:00
a80af77087
bpo-35086: Fix tkinter example "A Simple Hello World Program". (GH-10160)
...
The root widget was accessed as a global variable in the Application's method.
2018-10-30 16:56:07 +02:00
b232df9197
bpo-31680: Add curses.ncurses_version. (GH-4217)
...
Use curses.ncurses_version for conditionally skipping a test.
2018-10-30 13:22:42 +02:00
b83d917faf
Doc: fix asyncio loop.close() description (GH-10229)
...
Needs backport to 3.7. In 3.6 the description is correct.
2018-10-29 14:39:21 -07:00
0200928e8d
Include memo in the documented signature of copy.deepcopy()
...
* Include memo in the documented signature of copy.deepcopy()
The memo argument is mentioned lower on the doc page under writing a
`__deepcopy__` method, but is not included in the documented function signature.
This makes it easy to miss, and can lead to incorrect/buggy implementations of
`__deepcopy__` -- which is exatly what just happpend to me!
2018-10-29 12:30:12 -06:00
c0799ec973
bpo-27741: Better wording for datetime.strptime() (GH-9994)
2018-10-29 12:49:52 +01:00
ea9c8bd443
bpo-35097: Add IDLE doc subsection explaining editor windows. ( #10206 )
...
Topics include opening, title and status bar, .py* extension, and running.
2018-10-28 20:42:18 -04:00
18032632ab
Issue 35093: Document the IDLE document viewer in the IDLE doc. ( #10195 )
...
Add a paragraph in "Help and preferences", "Help sources" subsection.
2018-10-28 16:21:18 -04:00
e3685fd5fd
bpo-34160: Preserve user specified order of Element attributes (GH-10163)
2018-10-28 11:18:22 -07:00
68d6dc0770
bpo-1529353: Explain Shell text squeezing in the IDLE doc. ( #10169 )
2018-10-28 12:44:44 -04:00
c8a8d6b347
bpo-35089: Don't mention typing.io and typing.re (GH-10173)
...
https://bugs.python.org/issue35089
2018-10-28 16:03:29 +00:00
913876d824
bpo-35054: Add yet more index entries for symbols. (GH-10121)
2018-10-28 13:41:26 +02:00
d855f2fdbd
unittest documentation: Spell pytest without the dot (GH-9820)
...
Referring to ``pytest`` as ``py.test`` is deprecated.
2018-10-27 11:09:12 -07:00
40bf6cff22
Fix typo in zipfile documentation. (GH-10151)
2018-10-27 17:42:56 +03:00
fec35c99aa
bpo-33710: Deprecate l*gettext() and related functions in the gettext module. (GH-10139)
...
They return encoded bytes and are Python 2 artifacts.
2018-10-27 08:00:41 +03:00
d9bff4e81b
bpo-35079: Revise difflib.SequenceManager.get_matching_blocks doc (GH-10144)
...
Specify that blocks are non-overlapping. Change '!=' to '<'.
2018-10-26 23:03:08 -04:00
12e696b4f0
bpo-35042: Use the :pep: role where a PEP is specified ( #10036 )
2018-10-26 15:58:26 -07:00
4e3a53bcee
Fix a typo in asyncio-dev.rst. (GH-10133)
...
"threadsafe"
2018-10-26 10:14:04 -07:00
a6dc531063
bpo-34789: make xml.sax.make_parser accept iterables of all types (GH-9576)
2018-10-26 17:56:57 +03:00
25a525bf5a
Simplify the warning for http.server. ( #10116 )
2018-10-26 06:43:37 -07:00
7cd2543416
bpo-34890: Make iscoroutinefunction, isgeneratorfunction and isasyncgenfunction work with functools.partial (GH-9903)
...
inspect.isfunction() processes both inspect.isfunction(func) and
inspect.isfunction(partial(func, arg)) correctly but some other functions in the
inspect module (iscoroutinefunction, isgeneratorfunction and isasyncgenfunction)
lack this functionality. This commits adds a new check in the mentioned functions
in the inspect module so they can work correctly with arbitrarily nested partial
functions.
2018-10-26 12:19:14 +01:00
e483f02423
bpo-35044, doc: Use the :exc: role for the exceptions (GH-10037)
2018-10-26 12:52:11 +02:00
ddb961d2ab
bpo-35054: Add more index entries for symbols. (GH-10064)
2018-10-26 09:00:49 +03:00
6c83d9f4a7
bpo-35022: unittest.mock.MagicMock now also supports __fspath__ (GH-9960)
...
The MagicMock class supports many magic methods, but not __fspath__. To ease
testing with modules such as os.path, this function is now supported by default.
2018-10-25 23:48:58 +02:00
1770d1c512
bpo-35038: AttributeError: 'frame' object has no attribute 'f_restricted'. (GH-10098)
...
https://bugs.python.org/issue35038
2018-10-25 14:13:45 -07:00
890423f796
configparser doc: Properly label ConfigParser attributes (GH-9930)
2018-10-25 01:47:01 +02:00
78401f7156
importlib doc: Fix approximated import_module() code (GH-9945)
...
The spec gets stored on modules with the __spec__ attribute, not spec.
2018-10-25 01:32:26 +02:00
9f43fbbd9d
Use f-strings in asyncio-task code examples (GH-10035)
...
Replace str.format with f-strings in the code examples of asyncio-task documentation.
2018-10-25 00:37:12 +02:00
057f4078b0
bpo-32797: improve documentation of linecache.getline (GH-9540)
2018-10-24 14:44:41 +02:00
4f399be0e7
bpo-34260, shutil: fix copy2 and copystat documentation (GH-8523)
...
Fix the documentation of copy2, as it does not copy file ownership (user and
group), only mode, mtime, atime and flags.
The original text was confusing to developers as it suggested that this
command is the same as 'cp -p', but according to cp(1), '-p' copies file
ownership as well.
Clarify which metadata is copied by shutil.copystat in its docstring.
2018-10-23 12:09:50 +02:00
83a07652e0
bpo-34748: link to :ref:`partial-objects` in functools.partial doc. (GH-9809)
2018-10-23 14:11:20 +08:00
890a4b9293
bpo-35020: Link to sorting examples from list.sort() (GH-9931)
2018-10-20 14:39:03 -07:00
eeab510bb7
bpo-34576 - Fix the formatting for security considerations in http.server.rst ( #10005 )
...
* bpo-34576 - Fix the formatting for security considerations in http.server.rst
* Address review comment.
2018-10-20 11:32:07 -07:00
0522fd81dc
bpo-34839: Add a 'before 3.6' in the section 'warnings' of doctest (GH-9736)
2018-10-20 10:43:32 +02:00
d5b4f1b5a0
bpo-34983: Expose symtable.Symbol.is_nonlocal() in the symtable module (GH-9872)
...
The symbol table was not exposing functionality to query the nonlocal symbols
in a function or to check if a particular symbol is nonlocal.
2018-10-20 01:46:00 +01:00
027664a3d5
bpo-32798: Add restriction on the offset parameter for mmap.flush in the docs ( #5621 )
...
Add restriction on the offset parameter for mmap.flush.
Explain that ALLOCATIONGRANULARITY is the same as PAGESIZE in Unix.
2018-10-20 02:37:55 +02:00
a2670565d8
bpo-32236: open() emits RuntimeWarning if buffering=1 for binary mode (GH-4842)
...
If buffering=1 is specified for open() in binary mode, it is silently
treated as buffering=-1 (i.e., the default buffer size).
Coupled with the fact that line buffering is always supported in Python 2,
such behavior caused several issues (e.g., bpo-10344, bpo-21332).
Warn that line buffering is not supported if open() is called with
binary mode and buffering=1.
2018-10-20 02:22:31 +02:00
acef69068f
queue doc: Clarify that the simple FIFO queue is SimpleQueue (GH-8372)
2018-10-20 00:27:49 +02:00
96200eb2ff
unittest.mock doc: Fix references to recursive seal of Mocks (GH-9028)
...
The docs in `library/unittest.mock` have been updated to remove
confusing terms about submock and be explicit about the behavior
expected.
2018-10-19 23:57:37 +02:00
b981fec8d6
Use dict unpacking in functools.partial() docs (GH-9412)
2018-10-19 23:42:07 +02:00
5be00247ae
bpo-26441: Remove documentation for deleted to_splittable and from_splittable methods ( #9865 )
2018-10-18 20:13:23 -04:00
bbd90e4f62
Updated documentation on logging.debug(). (GH-9946)
2018-10-18 11:45:58 +01:00
0f11a88622
Add missing comma to wsgiref doc (GH-9932)
2018-10-17 22:55:32 +01:00
8e73ad38ab
Doc: Fix is_prime (GH-9909)
2018-10-17 08:45:51 +02:00
c984d20ec8
In email docs, correct spelling of foregoing ( #9856 )
2018-10-16 15:28:34 -04:00
a5ca98537b
In email.parser in message_from_bytes, update `strict` to `policy` ( #9854 )
...
According to the versionchanged note, the `strict` argument was removed in 3.3 and `policy` was added, but the name of the argument in the paragraph wasn't updated.
2018-10-16 15:26:17 -04:00
43a5bd7b45
bpo-23554: Change echo server example class name from EchoServerClientProtocol to EchoServerProtocol (GH-9859)
2018-10-15 17:39:16 -04:00
6bdb6f7675
fix dangling keyfunc examples in documentation of heapq and sorted ( #1432 )
...
* fix dangling mention of key=str.lower in heapq doc
* Fix dangling mention of keyfunc example for sorted()
2018-10-15 13:06:53 -06:00
18fb1fb943
bpo-34844: logging.Formatter enhancement - Ensure style and format string matches in logging.Formatter (GH-9703)
2018-10-15 19:41:36 +01:00
0461704060
bpo-22872: multiprocessing.Queue's put() and get() now raise ValueError if the queue is closed. (GH-9010)
...
Previously, put() and get() would raise AssertionError and OSError,
respectively.
2018-10-13 12:26:09 +03:00
2d6097d027
bpo-11233: Create availability directive for documentation (GH-9692)
...
Replace "Availability: xxx" with ".. availability:: xxx" in the doc.
Original patch by Georg Brandl.
Co-Authored-By: Georg Brandl <georg@python.org>
2018-10-12 16:55:20 +02:00
859c068e52
bpo-34962: make doctest in Doc/ now passes, and is enforced in CI (GH-9806)
2018-10-12 09:51:05 +02:00
1d26c72e6a
bpo-34576 warn users on security for http.server ( #9720 )
...
It was proposed to add an warning for http.server regarding security
issues. The wording was provided at bpo-26005 by @orsenthil
2018-10-10 19:43:40 -07:00
a6b3ec5b6d
bpo-34022: Stop forcing of hash-based invalidation with SOURCE_DATE_EPOCH (GH-9607)
...
Unconditional forcing of ``CHECKED_HASH`` invalidation was introduced in
3.7.0 in bpo-29708. The change is bad, as it unconditionally overrides
*invalidation_mode*, even if it was passed as an explicit argument to
``py_compile.compile()`` or ``compileall``. An environment variable
should *never* override an explicit argument to a library function.
That change leads to multiple test failures if the ``SOURCE_DATE_EPOCH``
environment variable is set.
This changes ``py_compile.compile()`` to only look at
``SOURCE_DATE_EPOCH`` if no explicit *invalidation_mode* was specified.
I also made various relevant tests run with explicit control over the
value of ``SOURCE_DATE_EPOCH``.
While looking at this, I noticed that ``zipimport`` does not work
with hash-based .pycs _at all_, though I left the fixes for
subsequent commits.
2018-10-10 18:43:14 +02:00
7e18deef65
bpo-34926: Make mimetypes.guess_type accept os.PathLike objects (GH-9777)
...
:meth:`mimetypes.MimeTypes.guess_type` now accepts :term:`path-like object` in addition to url strings.
2018-10-10 16:46:44 +02:00
7c817e620b
bpo-34913: Document gzip command line interface (GH-9782)
2018-10-10 08:28:26 +02:00
4c33997057
bpo-34911: Added support for secure websocket cookies (GH-9734)
2018-10-08 21:49:29 +03:00
a8d5e2f255
Use double quote instead of backtick to clarify Ellipsis constant (GH-9754)
2018-10-08 20:44:16 +05:30
ffc5a14d00
bpo-33014: Clarify str.isidentifier docstring (GH-6088)
...
* bpo-33014: Clarify str.isidentifier docstring
* bpo-33014: Add code example in isidentifier documentation
2018-10-08 12:23:32 +05:30
656d52dbfd
bpo-34901: add isolated (-I) flag to sys.flags (GH-9708)
...
https://bugs.python.org/issue34901
2018-10-07 09:12:31 -07:00
7dfbd49671
Correct grammar mistake in re.rst. (GH-9745)
2018-10-06 22:48:30 +03:00
92878829c3
bpo-34158: Documentation UTC offset update (GH-8377)
...
* Documentation of UTC offset update
Since changes in the UTC offset that allows sub-minute offsets, the documentation needs update:
- "%z" format code documentation update
Karthikeyan Singaravelan commented on bugs.python.org:
Added as part of 018d353c1cbac2d5ba30https://github.com/python/cpython/pull/2896/files#diff-25e2d173c84057d069b7890450714eddR214 .
Relevant test case with 6-digit string for microsecond : https://github.com/python/cpython/pull/2896/files#diff-acc40bec51c7de832de3361db3edae52R309 .
Table at https://docs.python.org/3.7/library/datetime.html#strftime-and-strptime-behavior could also be updated with microseconds being optional in the second column
%z | UTC offset in the form ±HHMM[SS] (empty string if the object is naive). | (empty), +0000, -0400, +1030
- isoformat documentation update
According to me, needs confirmation:
Relevant format string at https://github.com/python/cpython/pull/4699/files#diff-25e2d173c84057d069b7890450714eddR176
Relevant test case at https://github.com/python/cpython/pull/4699/files#diff-25e2d173c84057d069b7890450714edd
* From Martin Panter: some style improvment;
From @pganssle: using f for fractional part of seconds in all file.
2018-10-05 18:57:02 -04:00
6f9c55d1c0
bpo-34825: Add more entries to os to pathlib reference table (GH-9608)
...
The added functions are as below :
| os module | Pathlib |
| ------------- | ------------- |
| os.chmod | Path.chmod |
| os.mkdir | Path.mkdir |
| os.rename | Path.rename |
| os.replace | Path.replace |
| os.rmdir | Path.rmdir |
| os.remove, os.unlink | Path.unlink |
| os.path.samefile | Path.samefile |
Thanks
https://bugs.python.org/issue34825
2018-10-05 08:24:11 -07:00
07fbbfde1b
bpo-34906: Doc: Fix typos (GH-9712)
2018-10-05 16:17:18 +02:00
e006b39a40
Make it clear that the msg argument to assertWarns/assertWarnsRegex/assertRaisesRegex is keyword-only. (GH-9680)
...
A follow up to be4e5b8920
2018-10-02 21:38:39 -07:00
be4e5b8920
Make it clear that the msg argument to assertRaises is keyword-only. (GH-9670)
2018-10-01 22:18:44 -07:00
30534cc717
bpo-31865: Fix a couple of typos in the html.unescape() docs. (GH-9662)
2018-10-01 17:34:46 -07:00
cd602b8af2
bpo-34476: Document that asyncio.sleep() always suspends. ( #9643 )
2018-10-01 13:09:38 +03:00
9df100286b
Fix name of argument in docs for functools.reduce(). ( #9634 )
2018-09-30 23:52:10 -07:00
e45473e3ca
bpo-27351: Fix ConfigParser.read() documentation and docstring (GH-8123)
...
Switch "list" with "iterable" to match with the implementation.
2018-09-29 10:15:55 -06:00
eef059657d
bpo-31370: Remove references to threadless builds ( #8805 )
...
Support for threadless builds was removed in a6a4dc81
2018-09-29 10:07:11 -06:00
508d820512
Fix astuple in dataclasses documentation (GH-9631)
2018-09-29 06:50:31 -04:00
37aae9dcf1
bpo-34687: Update asyncio doc for ProactorEventLoop (GH-9623)
...
Since ProactorEventLoop is now the default in 3.8, remove examples
using it explicitly on Windows.
https://bugs.python.org/issue34687
2018-09-28 08:40:08 -07:00
59ee5b1293
bpo-34802: Fix asyncio.iscoroutine() docs (GH-9611)
2018-09-27 15:48:30 -04:00
3f22811fef
bpo-32892: Use ast.Constant instead of specific constant AST types. (GH-9445)
2018-09-27 17:42:37 +03:00
f55c64c632
bpo-31425: fix versionadded in docs and add attribution in NEWS (GH-9595)
2018-09-27 00:20:38 +03:00
130717fe58
Clarify that Type[SomeTypeVar] is legal ( #9585 )
...
Currently, the docs state that when doing `Type[X]`, X is only allowed to
be a class, a union of classes, and Any. This pull request amends
that sentence to clarify X may also be a typevar (or a union involving
classes, Any, and TypeVars).
2018-09-26 16:13:28 +01:00
bb8165172a
bpo-31425: Expose AF_QIPCRTR in socket module (GH-3706)
...
The AF_QIPCRTR address family was introduced in Linux v4.7.
Co-authored-by: Bjorn Andersson <bjorn.andersson@linaro.org>
2018-09-26 16:47:52 +03:00
d345bb4d9b
bpo-34334: Don't log traceback twice in QueueHandler (GH-9537)
2018-09-26 00:00:08 +01:00
fad6af2744
asyncio/docs: Replace Python 4.0 -> 3.10 (GH-9579)
2018-09-25 17:44:52 -04:00
5a5ce064b3
bpo-5950: Support reading zips with comments in zipimport ( #9548 )
...
* bpo-5950: Support reading zips with comments in zipimport
2018-09-25 15:15:47 -04:00
996859a90d
bpo-34790: [docs] Passing coroutines to asyncio.wait() can be confusing. (GH-9543)
2018-09-25 14:51:21 -04:00
6ea29c5e90
bpo-34687: Make asynico use ProactorEventLoop by default (GH-9538)
2018-09-25 11:27:08 -04:00
c8c0249c9e
bpo-32557: allow shutil.disk_usage to take a file path on Windows also (GH-9372)
...
https://bugs.python.org/issue32557
2018-09-25 07:57:36 -07:00
b60b4683f6
Fix wrong exception reference: BrokenThreadPool -> BrokenProcessPool (GH-9533)
2018-09-25 11:30:25 +08:00
9718b59ee5
bpo-34659: Adds initial kwarg to itertools.accumulate() (GH-9345)
2018-09-23 17:34:59 -07:00
17b1d5d4e3
bpo-17239: Disable external entities in SAX parser (GH-9217)
...
The SAX parser no longer processes general external entities by default
to increase security. Before, the parser created network connections
to fetch remote files or loaded local files from the file system for DTD
and entities.
Signed-off-by: Christian Heimes <christian@python.org>
https://bugs.python.org/issue17239
2018-09-23 00:50:25 -07:00
9fb051f032
bpo-34670: Add TLS 1.3 post handshake auth (GH-9460)
...
Add SSLContext.post_handshake_auth and
SSLSocket.verify_client_post_handshake for TLS 1.3 post-handshake
authentication.
Signed-off-by: Christian Heimes <christian@python.org>q
https://bugs.python.org/issue34670
2018-09-22 23:32:31 -07:00
5bdab641da
bpo-29577: Enum: mixin classes don't mix well with already mixed Enums (GH-9328)
...
* bpo-29577: allow multiple mixin classes
2018-09-21 19:03:09 -07:00
db1a80e97a
bpo-33649: Fix gather() docs; fix title; few other nits. (GH-9475)
2018-09-21 16:23:15 -04:00
7d161726e4
Make docs of exitcode for subprocess.getstatusoutput more clear. (GH-9477)
...
Make it more accurate and not limited to UNIX.
2018-09-21 13:18:20 -07:00
e247b46cba
bpo-33649: More improvements (GH-9439)
2018-09-20 12:43:59 -04:00
ffef50f1f5
bpo-34746: Fix stop -> close (GH-9437)
2018-09-20 01:17:09 -04:00
471503954a
bpo-33649: Add a high-level section about Futures; few quick fixes (GH-9403)
...
Co-authored-by: Elvis Pranskevichus <elvis@magic.io>
2018-09-18 17:55:44 -04:00
a3c88ef12c
Clarify that AsyncExitStack works with coroutine functions (GH-9405)
...
The docs were ambiguous about whether you pass in a coroutine function
or a coroutine object, e.g. is it:
aestack.push_async_exit(some_async_func)
or
aestack.push_async_exit(some_async_func())
(It's the first one.)
2018-09-18 14:27:59 -07:00
0185f34ddc
bpo-33721: Make some os.path functions and pathlib.Path methods be tolerant to invalid paths. ( #7695 )
...
Such functions as os.path.exists(), os.path.lexists(), os.path.isdir(),
os.path.isfile(), os.path.islink(), and os.path.ismount() now return False
instead of raising ValueError or its subclasses UnicodeEncodeError
and UnicodeDecodeError for paths that contain characters or bytes
unrepresentative at the OS level.
2018-09-18 11:28:51 +03:00
7bdf28265a
bpo-32455: Add jump parameter to dis.stack_effect(). (GH-6610)
...
Add C API function PyCompile_OpcodeStackEffectWithJump().
2018-09-18 09:54:26 +03:00
b042cf10c6
bpo-33649: Fix markup; add another note that asyncio.run is 3.7+ (GH-9389)
2018-09-18 02:47:54 -04:00
9c53fa6ad9
Fix syntax error on Asyncio example in doc (GH-9387)
...
The `gather` method requires to close the parenthesis, but it is being closed twice.
2018-09-18 02:01:26 -04:00
7bfbda46f4
Change "set_after" reference to `say_after`. (GH-9384)
2018-09-18 00:49:21 -04:00
ac94e38d07
bpo-33649: Note that asyncio.run() calls shutdown_asyncgens() (GH-9380)
2018-09-17 23:58:00 -04:00
1fa2ec49be
bpo-33649: A copy-editing pass on asyncio documentation (GH-9376)
2018-09-17 19:16:44 -04:00
3085534c39
bpo-33649: Add a hello world example to asyncio.rst (GH-9374)
2018-09-17 18:41:59 -04:00
c62ab2862d
bpo-34717: Stop numbering stdlib titles/sections in the docs (GH-9370)
2018-09-17 18:12:21 -04:00
394374e30c
bpo-33649: Add low-level APIs index. (GH-9364)
2018-09-17 15:35:24 -04:00
5e99b56d6b
bpo-33216: Improve the documentation for CALL_FUNCTION_* (GH-8338) (GH-8784)
2018-09-17 15:15:03 +03:00
5cc583d940
bpo-33649: Clarify protocol_factory as a method parameter (GH-9330)
2018-09-16 16:40:44 -07:00
805e27eff6
bpo-33649: Fix asyncio-dev (GH-9324)
2018-09-14 16:57:11 -07:00
7372c3bbef
bpo-33649: Add high-level APIs cheat-sheet (GH-9319)
2018-09-14 15:11:24 -07:00
6c7316439d
bpo-33649: Refresh asyncio docs landing page (GH-9322)
2018-09-14 14:57:39 -07:00
5acccfaf68
Grammar fix (GH-9318)
2018-09-14 14:37:48 -07:00
3faaa8857a
bpo-33649: Refresh Tasks and Futures pages ( #9314 )
...
* bpo-33649: Refresh Tasks and Futures pages
* Fixes
* Fix markup
2018-09-14 13:32:07 -07:00
271818fe27
Fix "Python" casing in a few places (GH-9001)
2018-09-14 10:13:09 -07:00
c9d66f0ed4
bpo-33649 Polish asyncio docs on queues, protocols, and subproccesses ( #9306 )
...
* small clarification
* edits to protocols doc
* Edit async queue doc
2018-09-14 10:06:55 -07:00
902bcd9a1e
Note that distinct argument patterns can be cached separately (GH-9298)
2018-09-14 00:53:20 -07:00
5ac704306f
bpo-33073: Adding as_integer_ratio to ints. (GH-8750)
2018-09-13 23:56:23 -07:00
1aeba7458d
bpo-34552: Clarify built-in types comparisons (GH-9035)
...
Some updates to ancient text about comparisons; fixes bp-34552.
2018-09-13 21:50:18 -07:00
4e824e9649
bpo-33649: Polish asyncio subprocess and sync docs (GH-9285)
...
Second pass for asyncio subprocess and sync docs.
https://bugs.python.org/issue33649
2018-09-13 18:28:19 -07:00
11194c877c
bpo-34666: Implement stream.awrite() and stream.aclose() (GH-9274)
2018-09-13 16:53:49 -07:00
a3c8ba7235
polish exceptions and platforms (GH-9272)
2018-09-13 16:14:41 -07:00
1abba455d1
Polish doc as part of asyncio doc improvement (GH-9185)
2018-09-12 22:40:37 -07:00
6d9767fb26
edit async policy doc - second pass (GH-9235)
2018-09-12 17:09:08 -07:00
5b7cbd602e
bpo-33649: Edit asyncio eventloop doc - second pass (GH-9233)
2018-09-12 17:05:17 -07:00
2087023fde
bpo-32933: Implement __iter__ method on mock_open() (GH-5974)
2018-09-13 01:21:16 +03:00
5b10d5111d
closes bpo-34004: Skip lock interruption tests on musl. (GH-9224)
...
Returning EINTR from pthread semaphore or lock acquisition is an optional POSIX
feature. musl does not provide this feature, so some threadsignal tests fail
when Python is built against it.
There's no good way to test for musl, so we skip if we're on Linux and not using
glibc pthreads.
Also, hedge in the threading documentation about when we can provide interrupts
from lock acquisition.
2018-09-12 13:48:03 -07:00
aca819fb49
bpo-33649: Fix doc to reflect changes in 47cd10d (or bpo-23347) (GH-9219)
2018-09-12 11:31:56 -07:00
9dfa0fe587
bpo-34637: Make the *start* argument for *sum()* visible as a keyword argument. (GH-9208)
2018-09-12 10:54:06 -07:00
f52237400b
bpo-33437: add __new__ vs __init__ example (GH-9145)
...
Improve Enum docs.
https://bugs.python.org/issue33437
2018-09-12 10:00:30 -07:00
731ff68eee
closes bpo-25041: Document AF_PACKET socket address format. (GH-4092)
2018-09-11 17:32:15 -07:00
8be876e44b
bpo-33649: Cleanup asyncio/streams and asyncio/synchronization docs (GH-9192)
2018-09-11 17:10:37 -07:00
9c223794c7
bpo-34365: Update date object documentation (GH-8814)
...
Python 3.x does not fall back to comparing object addresses when comparing two `dt` objects.
<!-- issue-number: [bpo-34365](https://www.bugs.python.org/issue34365 ) -->
https://bugs.python.org/issue34365
<!-- /issue-number -->
2018-09-11 13:59:23 -07:00
b4ec36200a
bpo-34613: document the correct value of limit argument of asyncio.StreamReader (GH-9121)
...
The default value of asyncio.StreamReader *limit* is `_DEFAULT_LIMIT` instead of `None`.
<!-- issue-number: [bpo-34613](https://www.bugs.python.org/issue34613 ) -->
https://bugs.python.org/issue34613
<!-- /issue-number -->
2018-09-11 11:45:26 -07:00
08bcf647d8
bpo-28617 Fixed docs inaccuracies about the types that support membership tests (GH-9086)
...
<!-- issue-number: [bpo-28617](https://www.bugs.python.org/issue28617 ) -->
https://bugs.python.org/issue28617
<!-- /issue-number -->
2018-09-11 10:44:52 -07:00
7c7605ff11
bpo-33649: First asyncio docs improvement pass (GH-9142)
...
Rewritten/updated sections:
* Event Loop APIs
* Transports & Protocols
* Streams
* Exceptions
* Policies
* Queues
* Subprocesses
* Platforms
2018-09-11 09:54:40 -07:00
3666b3c1f6
bpo-33032: Mention the implicit cache in struct.Struct() docs (GH-7700)
...
Mention the implicit cache in struct.Struct() docs.
Consistent with the re.compile documentation note.
2018-09-10 21:37:33 -07:00
2064bb6d57
Fix missing line from example shell session (GH-9143)
2018-09-10 18:43:08 -07:00
ffa198c642
bpo-33487: improve BZ2File Deprecation and documentation. (GH-6785)
...
Emit warning when None passed explicitly, list Python version since
deprecation in warning message and docs.
2018-09-10 18:15:56 -07:00
959625b5a5
Use bytes.hex instead of binascii.hexlify in pbkdf2_hmac example (GH-8420)
2018-09-10 18:07:19 -07:00
9430652535
bpo-33217: Raise TypeError for non-Enum lookups in Enums (GH-6651)
...
* bpo-33217: Raise TypeError for non-Enum lookups in Enums
2018-09-10 11:21:04 -07:00
51a4743d19
bpo-33604: Remove deprecated HMAC default value marked for removal in 3.8 (GH-7063)
...
HMAC's digestmod was deprecated marked for removal, this removes it as planned.
2018-09-10 11:10:01 -07:00
78deb7f332
closes bpo-34525: Fix smtplib's authobject() documentation (GH-8965)
2018-09-10 10:29:43 -07:00
d700f97b62
bpo-20104: Change the file_actions parameter of os.posix_spawn(). (GH-6725)
...
* Make its default value an empty tuple instead of None.
* Make it a keyword-only parameter.
2018-09-08 14:48:18 +03:00
d5fbe9b1a3
bpo-34246: Use no mutable default args in smtplib (GH-8554)
...
Some methods of the SMTP class use mutable default arguments. Specially
`send_message` is affected as it mutates one of the args by appending items
to it, which has side effects on further calls.
2018-09-07 23:04:48 +01:00
254a4663d8
bpo-20104: Add flag capabilities to posix_spawn (GH-6693)
...
Implement the "attributes objects" parameter of `os.posix_spawn` to complete the implementation and fully cover the underlying API.
2018-09-07 16:44:24 +01:00
5e922658fb
bpo-34605: Avoid master/slave terms (GH-9101)
...
* Replace "master process" with "parent process"
* Replace "master option mappings" with "main option mappings"
* Replace "master pattern object" with "main pattern object"
* ssl: replace "master" with "server"
* And some other similar changes
2018-09-07 17:30:33 +02:00
77b112cd56
bpo-34097: Polish API design (GH-8725)
...
Move strict_timestamps to constructor.
2018-08-31 16:43:31 +02:00
d658deac60
bpo-21145: Add cached_property decorator in functools ( #6982 )
...
Robust caching of calculated properties is
harder than it looks at first glance, so add
a solid, well-tested implementation to the
standard library.
2018-08-28 17:11:56 +10:00
3fe89dac42
bpo-34434: Update doc for bool(), float() and int() arguments (GH-8834)
2018-08-27 18:45:26 +08:00
44838be9f7
closes bpo-34502: Remove a note about utf8_mode from sys.exit() docs. (GH-8928)
2018-08-25 11:23:00 -07:00
2e5d2ea208
Fix markup in stdtypes documentation (GH-8905)
2018-08-25 07:08:20 -07:00
416cbce22d
Fixed typo with asynccontextmanager code example (GH-8845)
...
`yield conn`, instead of just `yield`.
2018-08-24 19:38:11 -07:00
075b3c3259
Fix typo in the dataclasses's doc (GH-8896)
2018-08-24 05:19:24 -04:00
cc18258daf
Fix doc for `add_subparsers` arguments (GH-8884)
...
There was a missing comma.
2018-08-23 20:08:54 -07:00
b8a181f4ae
Fix typo in asyncio.BoundedSemaphore docs (GH-8882)
...
semapthores -> semaphores
2018-08-23 18:50:00 -07:00
c33bb5d401
Make it more clear that setUpClass runs before each class, not "class run" (GH-8844)
2018-08-23 07:49:18 -07:00
e7d4b2f205
bpo-2122: Make mmap.flush() behave same on all platforms (GH-8692)
...
Previously, its behavior was platform-dependent and there was no error checking
under Windows.
2018-08-22 21:21:05 +03:00
225b055480
bpo-22057: Clarify eval() documentation (GH-8812)
...
If a globals dictionary without a '__builtins__' key is passed to
eval(), a '__builtins__' key will be inserted to the dictionary:
>>> eval("print('__builtins__' in globals())", {})
True
(As a result of this behavior, we can use the builtins
print() and globals() even if we passed a dictionary without a
'__builtins__' key to eval().)
2018-08-19 13:25:33 +03:00
93b5655c04
bpo-34432: doc Mention complex and decimal.Decimal on str.format not about locales (GH-8808)
2018-08-18 13:36:24 -04:00
a2510732da
Warn not to set SIGPIPE to SIG_DFL ( #6773 )
2018-08-17 14:48:05 +01:00
c53aaec793
bpo-34418: Fix HTTPErrorProcessor documentation (GH-8793)
...
The http_response() and https_response() methods of the HTTPErrorProcessor
class have two required parameters, 'request' and 'response'.
2018-08-17 12:47:32 +03:00
e0b5b2096e
bpo-34384: Fix os.readlink() on Windows (GH-8740)
...
os.readlink() now accepts path-like and bytes objects on Windows.
Previously, support for path-like and bytes objects was only
implemented on Unix.
This commit also merges Unix and Windows implementations of
os.readlink() in one function and adds basic unit tests to increase
test coverage of the function.
2018-08-15 13:03:41 +03:00
da12063f2f
smtplib documentation fixes (GH-8708)
...
* SMTP.startssl: Fix doc on keyfile and certfile use
* SMTP.startssl: Add missing keyfile and certfile deprecation notice
* SMTP: Doc grammar fixes
2018-08-12 20:39:19 -07:00
65b5ef02ec
Fix the versionadded indentation in exec_module doc (GH-8719)
2018-08-11 23:50:46 -07:00
9e84084851
bpo-34379: Doc: Move note for json.dump (GH-8730)
2018-08-11 16:34:02 +09:00
84a13fbda0
bpo-9372: Deprecate several __getitem__ methods (GH-8609)
...
The __getitem__ methods of DOMEventStream, FileInput,
and FileWrapper classes ignore their 'index' parameters
and return the next item instead.
2018-08-11 09:05:04 +03:00
22d131a7f9
Doc: add missing capture_output arg to subprocess.run() signature ( #8374 )
2018-08-09 13:01:54 -07:00
cca4eec3c0
bpo-34270: Make it possible to name asyncio tasks (GH-8547)
...
Co-authored-by: Antti Haapala <antti.haapala@anttipatterns.com>
2018-08-08 17:06:47 -04:00
d2ac400267
bpo-34335: Use async/await syntax in documentation examples (GH-8674)
2018-08-07 13:29:06 -07:00
5b2657fb8c
bpo-34319: Clarify file handler closure in pathlib.read_text (GH-8645)
...
Patch by Terry Jan Reedy.
2018-08-06 15:55:03 -04:00
28c7f8c8ce
bpo-34273: Change 'Fixed point' to 'Fixed-point notation'. ( #8673 )
...
* bpo-34273: Change 'Fixed point' to 'Fixed-point notation'.
The change in the mini language floating point and decimal table
is consistent with 'Exponential notation' and clarifies that we
are referring to the output notation, not an object type.
* Update string.rst
* Update string.rst
* Update string.rst
* Update string.rst
2018-08-06 08:41:17 -04:00
336c945858
bpo-34336: Don't promote possibility to leave out typing.Optional ( #8677 )
2018-08-05 17:38:04 +01:00
2e5566d9e7
Fix reST markup in unittest documentation (GH-8665)
2018-08-04 00:56:55 +03:00
46dc4e34ed
bpo-34329: Doc'd how to remove suffix of pathlib.Path() (GH-8655)
2018-08-03 23:49:42 +03:00
Géry Ogam
Raymond Hettinger
Lisa Roach
Andrés Delfino
Cheryl Sabella
Diego Rojas
HongWeipeng
guoci
Terry Jan Reedy
Rémi Lapeyre
E Kawashima
Serhiy Storchaka
Mario Corchero
Max Bélanger
Windson yang
Stéphane Wirtel
Saptak Sengupta
Elena Oat
Pablo Galindo
matthewbelisle-wf
Daniel Lovell
Andriy Maletsky
Stephan Hoyer
Gus Goulart
Sebastian Rittau
Andreas Pelme
nsrip
Benjamin Peterson
Senthil Kumaran
Ned Batchelder
orlnub123
Mariatta
jdemeyer
Zsolt Cserna
Andrei Petre
Xtreak
Alexey Izbyshev
Julien Palard
Sergey Fedoseev
Braden Groom
Vinay Sajip
Wolfgang Maier
BNMetrics
Zackery Spytz
Felipe Rodrigues
Elvis Pranskevichus
Mayank Asthana
Paul Bailey
Sanyam Khurana
Danish Prakash
Christophe Nanteuil
Ezio Melotti
Hrvoje Nikšić
Brendan Jurd
방성범 (Bang Seongbeom)
Victor Stinner
Yury Selivanov
Tal Einat
Michael Lee
Bjorn Andersson
Joe Pamer
Joni Kähärä
Christian Heimes
Ethan Furman
Xiang Zhang
Nathaniel J. Smith
Miguel Ángel García
Danny Hermes
Bumsik Kim
Grant
Carol Willing
Andrew Svetlov
Tony Flury
Bram
wim glenn
Matthias Bussonnier
Ville Skyttä
Rahul Jha
Sebastian Rittau
Pablo Aguiar
Marcel Plch
Carl Meyer
Louis Sautier
Alexander Vasin
Daniel Dương
Anthony Sottile
Jelle Zijlstra
Berker Peksag
Alfred Perlstein
Evan Allrich
Andriy Maletsky
Alex Grönholm
Mikhail Terekhov
Stefan Otte