Movatterモバイル変換

[0]ホーム
URL:

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

 Sign up
Appearance settings

Commit9b7e942

Browse files
Deploy preview for PR 1143 🛫
1 parent06c1e83 commit9b7e942

File tree

578 files changed

+1353
-1108
lines changed

Some content is hidden

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

578 files changed

+1353
-1108
lines changed

‎pr-preview/pr-1143/_sources/faq/design.rst.txt‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -589,9 +589,9 @@ exhaustive test suites that exercise every line of code in a module.
589589
An appropriate testing discipline can help build large complex applications in
590590
Python as well as having interface specifications would. In fact, it can be
591591
better because an interface specification cannot test certain properties of a
592-
program. For example, the:meth:`!list.append` method is expected to add new elements
592+
program. For example, the:meth:`list.append` method is expected to add new elements
593593
to the end of some internal list; an interface specification cannot test that
594-
your:meth:`!list.append` implementation will actually do this correctly, but it's
594+
your:meth:`list.append` implementation will actually do this correctly, but it's
595595
trivial to check this property in a test suite.
596596

597597
Writing test suites is very helpful, and you might want to design your code to

‎pr-preview/pr-1143/_sources/faq/programming.rst.txt‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -454,7 +454,7 @@ There are two factors that produce this result:
454454
(the list), and both ``x`` and ``y`` refer to it.
455455
2) Lists are:term:`mutable`, which means that you can change their content.
456456

457-
After the call to:meth:`!append`, the content of the mutable object has
457+
After the call to:meth:`~sequence.append`, the content of the mutable object has
458458
changed from ``[]`` to ``[10]``. Since both the variables refer to the same
459459
object, using either name accesses the modified value ``[10]``.
460460

@@ -1397,9 +1397,9 @@ To see why this happens, you need to know that (a) if an object implements an
13971397
:meth:`~object.__iadd__` magic method, it gets called when the ``+=`` augmented
13981398
assignment
13991399
is executed, and its return value is what gets used in the assignment statement;
1400-
and (b) for lists,:meth:`!__iadd__` is equivalent to calling:meth:`!extend` on the list
1401-
and returning the list. That's why we say that for lists, ``+=`` is a
1402-
"shorthand" for:meth:`!list.extend`::
1400+
and (b) for lists,:meth:`!__iadd__` is equivalent to calling
1401+
:meth:`~sequence.extend` on the list and returning the list.
1402+
That's why we say that for lists, ``+=`` is a"shorthand" for:meth:`list.extend`::
14031403

14041404
>>> a_list = []
14051405
>>> a_list += [1]

‎pr-preview/pr-1143/_sources/glossary.rst.txt‎

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,9 @@ Glossary
2121
right delimiters (parentheses, square brackets, curly braces or triple
2222
quotes), or after specifying a decorator.
2323

24-
* The:const:`Ellipsis` built-in constant.
24+
..index::single: ...; ellipsis literal
25+
26+
* The three dots form of the:ref:`Ellipsis<bltin-ellipsis-object>` object.
2527

2628
abstract base class
2729
Abstract base classes complement:term:`duck-typing` by
@@ -1203,8 +1205,9 @@ Glossary
12031205
The:class:`collections.abc.Sequence` abstract base class
12041206
defines a much richer interface that goes beyond just
12051207
:meth:`~object.__getitem__` and:meth:`~object.__len__`, adding
1206-
:meth:`!count`,:meth:`!index`,:meth:`~object.__contains__`, and
1207-
:meth:`~object.__reversed__`. Types that implement this expanded
1208+
:meth:`~sequence.count`,:meth:`~sequence.index`,
1209+
:meth:`~object.__contains__`, and:meth:`~object.__reversed__`.
1210+
Types that implement this expanded
12081211
interface can be registered explicitly using
12091212
:func:`~abc.ABCMeta.register`. For more documentation on sequence
12101213
methods generally, see

‎pr-preview/pr-1143/_sources/library/bisect.rst.txt‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -83,7 +83,7 @@ The following functions are provided:
8383
Insert *x* in *a* in sorted order.
8484

8585
This function first runs:py:func:`~bisect.bisect_left` to locate an insertion point.
86-
Next, it runs the:meth:`!insert` method on *a* to insert *x* at the
86+
Next, it runs the:meth:`~sequence.insert` method on *a* to insert *x* at the
8787
appropriate position to maintain sort order.
8888

8989
To support inserting records in a table, the *key* function (if any) is
@@ -103,7 +103,7 @@ The following functions are provided:
103103
entries of *x*.
104104

105105
This function first runs:py:func:`~bisect.bisect_right` to locate an insertion point.
106-
Next, it runs the:meth:`!insert` method on *a* to insert *x* at the
106+
Next, it runs the:meth:`~sequence.insert` method on *a* to insert *x* at the
107107
appropriate position to maintain sort order.
108108

109109
To support inserting records in a table, the *key* function (if any) is

‎pr-preview/pr-1143/_sources/library/collections.abc.rst.txt‎

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -268,8 +268,9 @@ Collections Abstract Base Classes -- Detailed Descriptions
268268
ABCs for read-only and mutable:term:`sequences <sequence>`.
269269

270270
Implementation note: Some of the mixin methods, such as
271-
:meth:`~container.__iter__`,:meth:`~object.__reversed__` and:meth:`index`, make
272-
repeated calls to the underlying:meth:`~object.__getitem__` method.
271+
:meth:`~container.__iter__`,:meth:`~object.__reversed__`,
272+
and:meth:`~sequence.index` make repeated calls to the underlying
273+
:meth:`~object.__getitem__` method.
273274
Consequently, if:meth:`~object.__getitem__` is implemented with constant
274275
access speed, the mixin methods will have linear performance;
275276
however, if the underlying method is linear (as it would be with a
@@ -285,8 +286,8 @@ Collections Abstract Base Classes -- Detailed Descriptions
285286
Supporting the *start* and *stop* arguments is optional, but recommended.
286287

287288
..versionchanged::3.5
288-
The:meth:`!index` methodadded support for *stop* and *start*
289-
arguments.
289+
The:meth:`~sequence.index` methodgained support for
290+
the *stop* and *start*arguments.
290291

291292
..deprecated-removed::3.12 3.14
292293
The:class:`ByteString` ABC has been deprecated.

‎pr-preview/pr-1143/_sources/library/collections.rst.txt‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -783,10 +783,10 @@ sequence of key-value pairs into a dictionary of lists:
783783

784784
When each key is encountered for the first time, it is not already in the
785785
mapping; so an entry is automatically created using the:attr:`~defaultdict.default_factory`
786-
function which returns an empty:class:`list`. The:meth:`!list.append`
786+
function which returns an empty:class:`list`. The:meth:`list.append`
787787
operation then attaches the value to the new list. When keys are encountered
788788
again, the look-up proceeds normally (returning the list for that key) and the
789-
:meth:`!list.append` operation adds another value to the list. This technique is
789+
:meth:`list.append` operation adds another value to the list. This technique is
790790
simpler and faster than an equivalent technique using:meth:`dict.setdefault`:
791791

792792
>>>d= {}

‎pr-preview/pr-1143/_sources/library/constants.rst.txt‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -62,8 +62,9 @@ A small number of constants live in the built-in namespace. They are:
6262
..index::single: ...; ellipsis literal
6363
..data::Ellipsis
6464

65-
The same as the ellipsis literal "``...``". Special value used mostly in conjunction
66-
with extended slicing syntax for user-defined container data types.
65+
The same as the ellipsis literal "``...``", an object frequently used to
66+
indicate that something is omitted. Assignment to ``Ellipsis`` is possible, but
67+
assignment to ``...`` raises a:exc:`SyntaxError`.
6768
``Ellipsis`` is the sole instance of the:data:`types.EllipsisType` type.
6869

6970

‎pr-preview/pr-1143/_sources/library/logging.rst.txt‎

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -671,16 +671,15 @@ Formatter Objects
671671
which is just the logged message.
672672
:type fmt: str
673673

674-
:param datefmt: A format string in the given *style* for
675-
the date/time portion of the logged output.
674+
:param datefmt: A format string for the date/time portion of the logged output.
676675
If not specified, the default described in:meth:`formatTime` is used.
677676
:type datefmt: str
678677

679678
:param style: Can be one of ``'%'``, ``'{'`` or ``'$'`` and determines
680679
how the format string will be merged with its data: using one of
681680
:ref:`old-string-formatting` (``%``),:meth:`str.format` (``{``)
682681
or:class:`string.Template` (``$``). This only applies to
683-
*fmt*and *datefmt*(e.g. ``'%(message)s'`` versus ``'{message}'``),
682+
*fmt* (e.g. ``'%(message)s'`` versus ``'{message}'``),
684683
not to the actual log messages passed to the logging methods.
685684
However, there are:ref:`other ways<formatting-styles>`
686685
to use ``{``- and ``$``-formatting for log messages.

‎pr-preview/pr-1143/_sources/library/pickle.rst.txt‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -716,8 +716,8 @@ or both.
716716
These items will be appended to the object either using
717717
``obj.append(item)`` or, in batch, using ``obj.extend(list_of_items)``.
718718
This is primarily used for list subclasses, but may be used by other
719-
classes as long as they have
720-
:ref:`append andextend methods<typesseq-common>` with
719+
classes as long as they have:meth:`~sequence.append`
720+
and:meth:`~sequence.extend` methods with
721721
the appropriate signature. (Whether:meth:`!append` or:meth:`!extend` is
722722
used depends on which pickle protocol version is used as well as the number
723723
of items to append, so both must be supported.)

0 commit comments

Comments
 (0)
[8]ページ先頭
©2009-2025 Movatter.jp