hyb
2025-12-23 10f3a1daddfbc7fa3dd2069197d83e8b6ef19176
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
Ë
Kñúh8ãó¢—dZddlZddlZddlmZgZdedededdfd    „Zdefd
„Zed d d «edd d«ede    e«d«e«Z
y)z=A module for creating docstrings for sphinx ``data`` domains.éNé)ÚNDArrayÚnameÚvalueÚdocÚreturncó4—tj|||f«y)zþAppend ``_docstrings_list`` with a docstring for `name`.
 
    Parameters
    ----------
    name : str
        The name of the object.
    value : str
        A string-representation of the object.
    doc : str
        The docstring of the object.
 
    N)Ú_docstrings_listÚappend)rrrs   úOH:\Change_password\venv_build\Lib\site-packages\numpy/_typing/_add_docstring.pyÚ
add_newdocr s€ô×јT 5¨#Ð.Õ/ócó–—g}tD]-\}}}tj|«jdd«}|j    d«}g}d}|D]º}t j d|«}    |    r‹|r‰tj|j««}
|
dk(r(d}|j|    jd«›d|
›«n'd}|j|    jd«›d    |
›«|jd«Œ¦|j|›|›«Œ¼dj|«}d
|›d |›d|›} |j| «Œ0dj|«S) zaConvert all docstrings in ``_docstrings_list`` into a single
    sphinx-legible text block.
 
    ú
z
    Úz^(\s+)[-=]+\s*$ÚExamplesrz .. rubric:: z    z.. admonition:: z
.. data:: z
    :value: ) r
ÚtextwrapÚdedentÚreplaceÚsplitÚreÚmatchÚpopr ÚgroupÚjoin) Ú type_list_retrrrÚsÚlinesÚ    new_linesÚindentÚlineÚmÚprevÚs_blocks             r Ú_parse_docstringsr%sM€ð
€MÜ,ó&шˆeSÜ O‰O˜CÓ  × (Ñ (¨¨xÓ 8ˆð—‘˜“ ˆØˆ    ØˆØò     4ˆDÜ—‘Ð+¨TÓ2ˆAÙ‘YÜ—‘ y§}¡}£Ó7Ø˜:Ò%ؐFØ×$Ñ$¨¯©°«
 |°<À¸vÐ%FÕGà$FØ×$Ñ$¨¯©°«
 |Ð3CÀDÀ6Ð%JÔKØ× Ñ  Õ$à× Ñ  F 8¨D¨6Ð!2Õ3ð     4ð I‰IiÓ  ˆØ    n°U°G¸6À!ÀÐGˆØ×јWÖ%ð/&ð0 9‰9]Ó #Ð#rÚ    ArrayLikeztyping.Union[...]ag
    A `~typing.Union` representing objects that can be coerced
    into an `~numpy.ndarray`.
 
    Among others this includes the likes of:
 
    * Scalars.
    * (Nested) sequences.
    * Objects implementing the `~class.__array__` protocol.
 
    .. versionadded:: 1.20
 
    See Also
    --------
    :term:`array_like`:
        Any scalar or sequence that can be interpreted as an ndarray.
 
    Examples
    --------
    .. code-block:: python
 
        >>> import numpy as np
        >>> import numpy.typing as npt
 
        >>> def as_array(a: npt.ArrayLike) -> np.ndarray:
        ...     return np.array(a)
 
    Ú    DTypeLikeaÒ
    A `~typing.Union` representing objects that can be coerced
    into a `~numpy.dtype`.
 
    Among others this includes the likes of:
 
    * :class:`type` objects.
    * Character codes or the names of :class:`type` objects.
    * Objects with the ``.dtype`` attribute.
 
    .. versionadded:: 1.20
 
    See Also
    --------
    :ref:`Specifying and constructing data types <arrays.dtypes.constructing>`
        A comprehensive overview of all objects that can be coerced
        into data types.
 
    Examples
    --------
    .. code-block:: python
 
        >>> import numpy as np
        >>> import numpy.typing as npt
 
        >>> def as_dtype(d: npt.DTypeLike) -> np.dtype:
        ...     return np.dtype(d)
 
    ra9
    A `np.ndarray[tuple[Any, ...], np.dtype[ScalarT]] <numpy.ndarray>`
    type alias :term:`generic <generic type>` w.r.t. its
    `dtype.type <numpy.dtype.type>`.
 
    Can be used during runtime for typing arrays with a given dtype
    and unspecified shape.
 
    .. versionadded:: 1.21
 
    Examples
    --------
    .. code-block:: python
 
        >>> import numpy as np
        >>> import numpy.typing as npt
 
        >>> print(npt.NDArray)
        numpy.ndarray[tuple[typing.Any, ...], numpy.dtype[~_ScalarT]]
 
        >>> print(npt.NDArray[np.float64])
        numpy.ndarray[tuple[typing.Any, ...], numpy.dtype[numpy.float64]]
 
        >>> NDArrayInt = npt.NDArray[np.int_]
        >>> a: NDArrayInt = np.arange(10)
 
        >>> def func(a: npt.ArrayLike) -> npt.NDArray[Any]:
        ...     return np.array(a)
 
    ) Ú__doc__rrÚ _array_likerr
Ústrr r%ÚreprÚ _docstrings©rr ú<module>r.sðÙCã    Ûå àÐð 0Sð 0 ð 0¨3ð 0°4ó 0ð $˜3ó$ñB ˆ;Ð+ðô    ñ< ˆ;Ð+ðô    ñ> ˆ9‘d˜7“mðô    ñ@ Ó! r