Skip to content

Commit 0743615

Browse files
mattwang44mattwang44
committed
Deploying to gh-pages from @ ebd40d0 🚀
1 parent b72a43d commit 0743615

File tree

556 files changed

+662
-581
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

556 files changed

+662
-581
lines changed

‎_sources/library/codecs.rst.txt

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -53,6 +53,14 @@ any codec:
5353
:exc:`UnicodeDecodeError`). Refer to :ref:`codec-base-classes` for more
5454
information on codec error handling.
5555

56+
.. function:: charmap_build(string)
57+
58+
Return a mapping suitable for encoding with a custom single-byte encoding.
59+
Given a :class:`str` *string* of up to 256 characters representing a
60+
decoding table, returns either a compact internal mapping object
61+
``EncodingMap`` or a :class:`dictionary <dict>` mapping character ordinals
62+
to byte values. Raises a :exc:`TypeError` on invalid input.
63+
5664
The full details for each codec can also be looked up directly:
5765

5866
.. function:: lookup(encoding)

‎_sources/library/csv.rst.txt

Lines changed: 28 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ The :mod:`csv` module defines the following functions:
5353
.. index::
5454
single: universal newlines; csv.reader function
5555

56-
.. function:: reader(csvfile, dialect='excel', **fmtparams)
56+
.. function:: reader(csvfile, /, dialect='excel', **fmtparams)
5757

5858
Return a :ref:`reader object <reader-objects>` that will process
5959
lines from the given *csvfile*. A csvfile must be an iterable of
@@ -84,7 +84,7 @@ The :mod:`csv` module defines the following functions:
8484
Spam, Lovely Spam, Wonderful Spam
8585

8686

87-
.. function:: writer(csvfile, dialect='excel', **fmtparams)
87+
.. function:: writer(csvfile, /, dialect='excel', **fmtparams)
8888

8989
Return a writer object responsible for converting the user's data into delimited
9090
strings on the given file-like object. *csvfile* can be any object with a
@@ -323,8 +323,8 @@ The :mod:`csv` module defines the following constants:
323323
.. data:: QUOTE_MINIMAL
324324

325325
Instructs :class:`writer` objects to only quote those fields which contain
326-
special characters such as *delimiter*, *quotechar* or any of the characters in
327-
*lineterminator*.
326+
special characters such as *delimiter*, *quotechar*, ``'\r'``, ``'\n'``
327+
or any of the characters in *lineterminator*.
328328

329329

330330
.. data:: QUOTE_NONNUMERIC
@@ -342,10 +342,13 @@ The :mod:`csv` module defines the following constants:
342342

343343
.. data:: QUOTE_NONE
344344

345-
Instructs :class:`writer` objects to never quote fields. When the current
346-
*delimiter* occurs in output data it is preceded by the current *escapechar*
347-
character. If *escapechar* is not set, the writer will raise :exc:`Error` if
345+
Instructs :class:`writer` objects to never quote fields.
346+
When the current *delimiter*, *quotechar*, *escapechar*, ``'\r'``, ``'\n'``
347+
or any of the characters in *lineterminator* occurs in output data
348+
it is preceded by the current *escapechar* character.
349+
If *escapechar* is not set, the writer will raise :exc:`Error` if
348350
any characters that require escaping are encountered.
351+
Set *quotechar* to ``None`` to prevent its escaping.
349352

350353
Instructs :class:`reader` objects to perform no special processing of quote characters.
351354

@@ -414,9 +417,16 @@ Dialects support the following attributes:
414417

415418
.. attribute:: Dialect.escapechar
416419

417-
A one-character string used by the writer to escape the *delimiter* if *quoting*
418-
is set to :const:`QUOTE_NONE` and the *quotechar* if *doublequote* is
419-
:const:`False`. On reading, the *escapechar* removes any special meaning from
420+
A one-character string used by the writer to escape characters that
421+
require escaping:
422+
423+
* the *delimiter*, the *quotechar*, ``'\r'``, ``'\n'`` and any of the
424+
characters in *lineterminator* are escaped if *quoting* is set to
425+
:const:`QUOTE_NONE`;
426+
* the *quotechar* is escaped if *doublequote* is :const:`False`;
427+
* the *escapechar* itself.
428+
429+
On reading, the *escapechar* removes any special meaning from
420430
the following character. It defaults to :const:`None`, which disables escaping.
421431

422432
.. versionchanged:: 3.11
@@ -436,9 +446,12 @@ Dialects support the following attributes:
436446

437447
.. attribute:: Dialect.quotechar
438448

439-
A one-character string used to quote fields containing special characters, such
440-
as the *delimiter* or *quotechar*, or which contain new-line characters. It
441-
defaults to ``'"'``.
449+
A one-character string used to quote fields containing special characters,
450+
such as the *delimiter* or the *quotechar*, or which contain new-line
451+
characters (``'\r'``, ``'\n'`` or any of the characters in *lineterminator*).
452+
It defaults to ``'"'``.
453+
Can be set to ``None`` to prevent escaping ``'"'`` if *quoting* is set
454+
to :const:`QUOTE_NONE`.
442455

443456
.. versionchanged:: 3.11
444457
An empty *quotechar* is not allowed.
@@ -447,7 +460,8 @@ Dialects support the following attributes:
447460

448461
Controls when quotes should be generated by the writer and recognised by the
449462
reader. It can take on any of the :ref:`QUOTE_\* constants <csv-constants>`
450-
and defaults to :const:`QUOTE_MINIMAL`.
463+
and defaults to :const:`QUOTE_MINIMAL` if *quotechar* is not ``None``,
464+
and :const:`QUOTE_NONE` otherwise.
451465

452466

453467
.. attribute:: Dialect.skipinitialspace

‎_sources/library/math.rst.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -774,7 +774,7 @@ Constants
774774
The mathematical constant *τ* = 6.283185..., to available precision.
775775
Tau is a circle constant equal to 2\ *π*, the ratio of a circle's circumference to
776776
its radius. To learn more about Tau, check out Vi Hart's video `Pi is (still)
777-
Wrong <https://www.youtube.com/watch?v=jG7vhMMXagQ>`_, and start celebrating
777+
Wrong <https://vimeo.com/147792667>`_, and start celebrating
778778
`Tau day <https://tauday.com/>`_ by eating twice as much pie!
779779

780780
.. versionadded:: 3.6

‎_sources/library/time.rst.txt

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -712,13 +712,18 @@ Functions
712712

713713
Clock:
714714

715-
* On Windows, call ``GetSystemTimeAsFileTime()``.
715+
* On Windows, call ``GetSystemTimePreciseAsFileTime()``.
716716
* Call ``clock_gettime(CLOCK_REALTIME)`` if available.
717717
* Otherwise, call ``gettimeofday()``.
718718

719719
Use :func:`time_ns` to avoid the precision loss caused by the :class:`float`
720720
type.
721721

722+
.. versionchanged:: 3.13
723+
724+
On Windows, calls ``GetSystemTimePreciseAsFileTime()`` instead of
725+
``GetSystemTimeAsFileTime()``.
726+
722727

723728
.. function:: time_ns() -> int
724729

‎about.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -320,7 +320,7 @@ <h3>瀏覽</h3>
320320
<a href="https://www.python.org/psf/donations/">Please donate.</a>
321321
<br>
322322
<br>
323-
最後更新於 6月 30, 2025 (06:01 UTC)。
323+
最後更新於 7月 01, 2025 (10:10 UTC)。
324324

325325
<a href="/bugs.html">Found a bug</a>?
326326

‎bugs.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -359,7 +359,7 @@ <h3>瀏覽</h3>
359359
<a href="https://www.python.org/psf/donations/">Please donate.</a>
360360
<br>
361361
<br>
362-
最後更新於 6月 30, 2025 (06:01 UTC)。
362+
最後更新於 7月 01, 2025 (10:10 UTC)。
363363

364364
<a href="/bugs.html">Found a bug</a>?
365365

‎c-api/abstract.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -329,7 +329,7 @@ <h3>瀏覽</h3>
329329
<a href="https://www.python.org/psf/donations/">Please donate.</a>
330330
<br>
331331
<br>
332-
最後更新於 6月 30, 2025 (06:01 UTC)。
332+
最後更新於 7月 01, 2025 (10:10 UTC)。
333333

334334
<a href="/bugs.html">Found a bug</a>?
335335

‎c-api/allocation.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -350,7 +350,7 @@ <h3>瀏覽</h3>
350350
<a href="https://www.python.org/psf/donations/">Please donate.</a>
351351
<br>
352352
<br>
353-
最後更新於 6月 30, 2025 (06:01 UTC)。
353+
最後更新於 7月 01, 2025 (10:10 UTC)。
354354

355355
<a href="/bugs.html">Found a bug</a>?
356356

‎c-api/apiabiversion.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -376,7 +376,7 @@ <h3>瀏覽</h3>
376376
<a href="https://www.python.org/psf/donations/">Please donate.</a>
377377
<br>
378378
<br>
379-
最後更新於 6月 30, 2025 (06:01 UTC)。
379+
最後更新於 7月 01, 2025 (10:10 UTC)。
380380

381381
<a href="/bugs.html">Found a bug</a>?
382382

‎c-api/arg.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -931,7 +931,7 @@ <h3>瀏覽</h3>
931931
<a href="https://www.python.org/psf/donations/">Please donate.</a>
932932
<br>
933933
<br>
934-
最後更新於 6月 30, 2025 (06:01 UTC)。
934+
最後更新於 7月 01, 2025 (10:10 UTC)。
935935

936936
<a href="/bugs.html">Found a bug</a>?
937937

‎c-api/bool.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -341,7 +341,7 @@ <h3>瀏覽</h3>
341341
<a href="https://www.python.org/psf/donations/">Please donate.</a>
342342
<br>
343343
<br>
344-
最後更新於 6月 30, 2025 (06:01 UTC)。
344+
最後更新於 7月 01, 2025 (10:10 UTC)。
345345

346346
<a href="/bugs.html">Found a bug</a>?
347347

‎c-api/buffer.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1022,7 +1022,7 @@ <h3>瀏覽</h3>
10221022
<a href="https://www.python.org/psf/donations/">Please donate.</a>
10231023
<br>
10241024
<br>
1025-
最後更新於 6月 30, 2025 (06:01 UTC)。
1025+
最後更新於 7月 01, 2025 (10:10 UTC)。
10261026

10271027
<a href="/bugs.html">Found a bug</a>?
10281028

‎c-api/bytearray.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -400,7 +400,7 @@ <h3>瀏覽</h3>
400400
<a href="https://www.python.org/psf/donations/">Please donate.</a>
401401
<br>
402402
<br>
403-
最後更新於 6月 30, 2025 (06:01 UTC)。
403+
最後更新於 7月 01, 2025 (10:10 UTC)。
404404

405405
<a href="/bugs.html">Found a bug</a>?
406406

‎c-api/bytes.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -521,7 +521,7 @@ <h3>瀏覽</h3>
521521
<a href="https://www.python.org/psf/donations/">Please donate.</a>
522522
<br>
523523
<br>
524-
最後更新於 6月 30, 2025 (06:01 UTC)。
524+
最後更新於 7月 01, 2025 (10:10 UTC)。
525525

526526
<a href="/bugs.html">Found a bug</a>?
527527

‎c-api/call.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -652,7 +652,7 @@ <h3>瀏覽</h3>
652652
<a href="https://www.python.org/psf/donations/">Please donate.</a>
653653
<br>
654654
<br>
655-
最後更新於 6月 30, 2025 (06:01 UTC)。
655+
最後更新於 7月 01, 2025 (10:10 UTC)。
656656

657657
<a href="/bugs.html">Found a bug</a>?
658658

‎c-api/capsule.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -450,7 +450,7 @@ <h3>瀏覽</h3>
450450
<a href="https://www.python.org/psf/donations/">Please donate.</a>
451451
<br>
452452
<br>
453-
最後更新於 6月 30, 2025 (06:01 UTC)。
453+
最後更新於 7月 01, 2025 (10:10 UTC)。
454454

455455
<a href="/bugs.html">Found a bug</a>?
456456

‎c-api/cell.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -341,7 +341,7 @@ <h3>瀏覽</h3>
341341
<a href="https://www.python.org/psf/donations/">Please donate.</a>
342342
<br>
343343
<br>
344-
最後更新於 6月 30, 2025 (06:01 UTC)。
344+
最後更新於 7月 01, 2025 (10:10 UTC)。
345345

346346
<a href="/bugs.html">Found a bug</a>?
347347

‎c-api/code.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -606,7 +606,7 @@ <h3>瀏覽</h3>
606606
<a href="https://www.python.org/psf/donations/">Please donate.</a>
607607
<br>
608608
<br>
609-
最後更新於 6月 30, 2025 (06:01 UTC)。
609+
最後更新於 7月 01, 2025 (10:10 UTC)。
610610

611611
<a href="/bugs.html">Found a bug</a>?
612612

‎c-api/codec.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -445,7 +445,7 @@ <h3>瀏覽</h3>
445445
<a href="https://www.python.org/psf/donations/">Please donate.</a>
446446
<br>
447447
<br>
448-
最後更新於 6月 30, 2025 (06:01 UTC)。
448+
最後更新於 7月 01, 2025 (10:10 UTC)。
449449

450450
<a href="/bugs.html">Found a bug</a>?
451451

‎c-api/complex.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -448,7 +448,7 @@ <h3>瀏覽</h3>
448448
<a href="https://www.python.org/psf/donations/">Please donate.</a>
449449
<br>
450450
<br>
451-
最後更新於 6月 30, 2025 (06:01 UTC)。
451+
最後更新於 7月 01, 2025 (10:10 UTC)。
452452

453453
<a href="/bugs.html">Found a bug</a>?
454454

‎c-api/concrete.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -464,7 +464,7 @@ <h3>瀏覽</h3>
464464
<a href="https://www.python.org/psf/donations/">Please donate.</a>
465465
<br>
466466
<br>
467-
最後更新於 6月 30, 2025 (06:01 UTC)。
467+
最後更新於 7月 01, 2025 (10:10 UTC)。
468468

469469
<a href="/bugs.html">Found a bug</a>?
470470

‎c-api/contextvars.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -428,7 +428,7 @@ <h3>瀏覽</h3>
428428
<a href="https://www.python.org/psf/donations/">Please donate.</a>
429429
<br>
430430
<br>
431-
最後更新於 6月 30, 2025 (06:01 UTC)。
431+
最後更新於 7月 01, 2025 (10:10 UTC)。
432432

433433
<a href="/bugs.html">Found a bug</a>?
434434

‎c-api/conversion.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -390,7 +390,7 @@ <h3>瀏覽</h3>
390390
<a href="https://www.python.org/psf/donations/">Please donate.</a>
391391
<br>
392392
<br>
393-
最後更新於 6月 30, 2025 (06:01 UTC)。
393+
最後更新於 7月 01, 2025 (10:10 UTC)。
394394

395395
<a href="/bugs.html">Found a bug</a>?
396396

‎c-api/coro.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -319,7 +319,7 @@ <h3>瀏覽</h3>
319319
<a href="https://www.python.org/psf/donations/">Please donate.</a>
320320
<br>
321321
<br>
322-
最後更新於 6月 30, 2025 (06:01 UTC)。
322+
最後更新於 7月 01, 2025 (10:10 UTC)。
323323

324324
<a href="/bugs.html">Found a bug</a>?
325325

‎c-api/datetime.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -630,7 +630,7 @@ <h3>瀏覽</h3>
630630
<a href="https://www.python.org/psf/donations/">Please donate.</a>
631631
<br>
632632
<br>
633-
最後更新於 6月 30, 2025 (06:01 UTC)。
633+
最後更新於 7月 01, 2025 (10:10 UTC)。
634634

635635
<a href="/bugs.html">Found a bug</a>?
636636

‎c-api/descriptor.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -334,7 +334,7 @@ <h3>瀏覽</h3>
334334
<a href="https://www.python.org/psf/donations/">Please donate.</a>
335335
<br>
336336
<br>
337-
最後更新於 6月 30, 2025 (06:01 UTC)。
337+
最後更新於 7月 01, 2025 (10:10 UTC)。
338338

339339
<a href="/bugs.html">Found a bug</a>?
340340

‎c-api/dict.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -744,7 +744,7 @@ <h3>瀏覽</h3>
744744
<a href="https://www.python.org/psf/donations/">Please donate.</a>
745745
<br>
746746
<br>
747-
最後更新於 6月 30, 2025 (06:01 UTC)。
747+
最後更新於 7月 01, 2025 (10:10 UTC)。
748748

749749
<a href="/bugs.html">Found a bug</a>?
750750

‎c-api/exceptions.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1734,7 +1734,7 @@ <h3>瀏覽</h3>
17341734
<a href="https://www.python.org/psf/donations/">Please donate.</a>
17351735
<br>
17361736
<br>
1737-
最後更新於 6月 30, 2025 (06:01 UTC)。
1737+
最後更新於 7月 01, 2025 (10:10 UTC)。
17381738

17391739
<a href="/bugs.html">Found a bug</a>?
17401740

‎c-api/file.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -366,7 +366,7 @@ <h3>瀏覽</h3>
366366
<a href="https://www.python.org/psf/donations/">Please donate.</a>
367367
<br>
368368
<br>
369-
最後更新於 6月 30, 2025 (06:01 UTC)。
369+
最後更新於 7月 01, 2025 (10:10 UTC)。
370370

371371
<a href="/bugs.html">Found a bug</a>?
372372

‎c-api/float.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -489,7 +489,7 @@ <h3>瀏覽</h3>
489489
<a href="https://www.python.org/psf/donations/">Please donate.</a>
490490
<br>
491491
<br>
492-
最後更新於 6月 30, 2025 (06:01 UTC)。
492+
最後更新於 7月 01, 2025 (10:10 UTC)。
493493

494494
<a href="/bugs.html">Found a bug</a>?
495495

‎c-api/frame.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -534,7 +534,7 @@ <h3>瀏覽</h3>
534534
<a href="https://www.python.org/psf/donations/">Please donate.</a>
535535
<br>
536536
<br>
537-
最後更新於 6月 30, 2025 (06:01 UTC)。
537+
最後更新於 7月 01, 2025 (10:10 UTC)。
538538

539539
<a href="/bugs.html">Found a bug</a>?
540540

‎c-api/function.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -497,7 +497,7 @@ <h3>瀏覽</h3>
497497
<a href="https://www.python.org/psf/donations/">Please donate.</a>
498498
<br>
499499
<br>
500-
最後更新於 6月 30, 2025 (06:01 UTC)。
500+
最後更新於 7月 01, 2025 (10:10 UTC)。
501501

502502
<a href="/bugs.html">Found a bug</a>?
503503

‎c-api/gcsupport.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -611,7 +611,7 @@ <h3>瀏覽</h3>
611611
<a href="https://www.python.org/psf/donations/">Please donate.</a>
612612
<br>
613613
<br>
614-
最後更新於 6月 30, 2025 (06:01 UTC)。
614+
最後更新於 7月 01, 2025 (10:10 UTC)。
615615

616616
<a href="/bugs.html">Found a bug</a>?
617617

0 commit comments

Comments
 (0)