File: autodoc2.utils.rst

package info (click to toggle)
python-sphinx-autodoc2 0.5.0-7
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 1,268 kB
  • sloc: python: 3,407; xml: 72; makefile: 9
file content (251 lines) | stat: -rw-r--r-- 7,063 bytes parent folder | download | duplicates (3)
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
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
:py:mod:`autodoc2.utils`
========================

.. py:module:: autodoc2.utils

.. autodoc2-docstring:: autodoc2.utils
   :allowtitles:

Module Contents
---------------

Classes
~~~~~~~

.. list-table::
   :class: autosummary longtable
   :align: left

   * - :py:obj:`ItemData <autodoc2.utils.ItemData>`
     - .. autodoc2-docstring:: autodoc2.utils.ItemData
          :summary:
   * - :py:obj:`WarningSubtypes <autodoc2.utils.WarningSubtypes>`
     - .. autodoc2-docstring:: autodoc2.utils.WarningSubtypes
          :summary:

Functions
~~~~~~~~~

.. list-table::
   :class: autosummary longtable
   :align: left

   * - :py:obj:`yield_modules <autodoc2.utils.yield_modules>`
     - .. autodoc2-docstring:: autodoc2.utils.yield_modules
          :summary:

Data
~~~~

.. list-table::
   :class: autosummary longtable
   :align: left

   * - :py:obj:`PROPERTY_TYPE <autodoc2.utils.PROPERTY_TYPE>`
     - .. autodoc2-docstring:: autodoc2.utils.PROPERTY_TYPE
          :summary:
   * - :py:obj:`ARGS_TYPE <autodoc2.utils.ARGS_TYPE>`
     - .. autodoc2-docstring:: autodoc2.utils.ARGS_TYPE
          :summary:

API
~~~

.. py:data:: PROPERTY_TYPE
   :canonical: autodoc2.utils.PROPERTY_TYPE
   :value: None

   .. autodoc2-docstring:: autodoc2.utils.PROPERTY_TYPE

.. py:data:: ARGS_TYPE
   :canonical: autodoc2.utils.ARGS_TYPE
   :value: None

   .. autodoc2-docstring:: autodoc2.utils.ARGS_TYPE

.. py:class:: ItemData()
   :canonical: autodoc2.utils.ItemData

   Bases: :py:obj:`typing.TypedDict`

   .. autodoc2-docstring:: autodoc2.utils.ItemData

   .. rubric:: Initialization

   .. autodoc2-docstring:: autodoc2.utils.ItemData.__init__

   .. py:attribute:: type
      :canonical: autodoc2.utils.ItemData.type
      :type: typing_extensions.Required[str]
      :value: None

      .. autodoc2-docstring:: autodoc2.utils.ItemData.type

   .. py:attribute:: full_name
      :canonical: autodoc2.utils.ItemData.full_name
      :type: typing_extensions.Required[str]
      :value: None

      .. autodoc2-docstring:: autodoc2.utils.ItemData.full_name

   .. py:attribute:: doc
      :canonical: autodoc2.utils.ItemData.doc
      :type: typing_extensions.Required[str]
      :value: None

      .. autodoc2-docstring:: autodoc2.utils.ItemData.doc

   .. py:attribute:: range
      :canonical: autodoc2.utils.ItemData.range
      :type: tuple[int, int]
      :value: None

      .. autodoc2-docstring:: autodoc2.utils.ItemData.range

   .. py:attribute:: file_path
      :canonical: autodoc2.utils.ItemData.file_path
      :type: None | str
      :value: None

      .. autodoc2-docstring:: autodoc2.utils.ItemData.file_path

   .. py:attribute:: encoding
      :canonical: autodoc2.utils.ItemData.encoding
      :type: str
      :value: None

      .. autodoc2-docstring:: autodoc2.utils.ItemData.encoding

   .. py:attribute:: all
      :canonical: autodoc2.utils.ItemData.all
      :type: None | list[str]
      :value: None

      .. autodoc2-docstring:: autodoc2.utils.ItemData.all

   .. py:attribute:: imports
      :canonical: autodoc2.utils.ItemData.imports
      :type: list[tuple[str, str | None]]
      :value: None

      .. autodoc2-docstring:: autodoc2.utils.ItemData.imports

   .. py:attribute:: value
      :canonical: autodoc2.utils.ItemData.value
      :type: None | str | typing.Any
      :value: None

      .. autodoc2-docstring:: autodoc2.utils.ItemData.value

   .. py:attribute:: annotation
      :canonical: autodoc2.utils.ItemData.annotation
      :type: None | str
      :value: None

      .. autodoc2-docstring:: autodoc2.utils.ItemData.annotation

   .. py:attribute:: properties
      :canonical: autodoc2.utils.ItemData.properties
      :type: list[autodoc2.utils.PROPERTY_TYPE]
      :value: None

      .. autodoc2-docstring:: autodoc2.utils.ItemData.properties

   .. py:attribute:: args
      :canonical: autodoc2.utils.ItemData.args
      :type: autodoc2.utils.ARGS_TYPE
      :value: None

      .. autodoc2-docstring:: autodoc2.utils.ItemData.args

   .. py:attribute:: return_annotation
      :canonical: autodoc2.utils.ItemData.return_annotation
      :type: None | str
      :value: None

      .. autodoc2-docstring:: autodoc2.utils.ItemData.return_annotation

   .. py:attribute:: bases
      :canonical: autodoc2.utils.ItemData.bases
      :type: list[str]
      :value: None

      .. autodoc2-docstring:: autodoc2.utils.ItemData.bases

   .. py:attribute:: doc_inherited
      :canonical: autodoc2.utils.ItemData.doc_inherited
      :type: str
      :value: None

      .. autodoc2-docstring:: autodoc2.utils.ItemData.doc_inherited

   .. py:attribute:: inherited
      :canonical: autodoc2.utils.ItemData.inherited
      :type: str
      :value: None

      .. autodoc2-docstring:: autodoc2.utils.ItemData.inherited

.. py:class:: WarningSubtypes(*args, **kwds)
   :canonical: autodoc2.utils.WarningSubtypes

   Bases: :py:obj:`enum.Enum`

   .. autodoc2-docstring:: autodoc2.utils.WarningSubtypes

   .. rubric:: Initialization

   .. autodoc2-docstring:: autodoc2.utils.WarningSubtypes.__init__

   .. py:attribute:: CONFIG_ERROR
      :canonical: autodoc2.utils.WarningSubtypes.CONFIG_ERROR
      :value: 'config_error'

      .. autodoc2-docstring:: autodoc2.utils.WarningSubtypes.CONFIG_ERROR

   .. py:attribute:: GIT_CLONE_FAILED
      :canonical: autodoc2.utils.WarningSubtypes.GIT_CLONE_FAILED
      :value: 'git_clone'

      .. autodoc2-docstring:: autodoc2.utils.WarningSubtypes.GIT_CLONE_FAILED

   .. py:attribute:: MISSING_MODULE
      :canonical: autodoc2.utils.WarningSubtypes.MISSING_MODULE
      :value: 'missing_module'

      .. autodoc2-docstring:: autodoc2.utils.WarningSubtypes.MISSING_MODULE

   .. py:attribute:: DUPLICATE_ITEM
      :canonical: autodoc2.utils.WarningSubtypes.DUPLICATE_ITEM
      :value: 'dup_item'

      .. autodoc2-docstring:: autodoc2.utils.WarningSubtypes.DUPLICATE_ITEM

   .. py:attribute:: RENDER_ERROR
      :canonical: autodoc2.utils.WarningSubtypes.RENDER_ERROR
      :value: 'render'

      .. autodoc2-docstring:: autodoc2.utils.WarningSubtypes.RENDER_ERROR

   .. py:attribute:: ALL_MISSING
      :canonical: autodoc2.utils.WarningSubtypes.ALL_MISSING
      :value: 'all_missing'

      .. autodoc2-docstring:: autodoc2.utils.WarningSubtypes.ALL_MISSING

   .. py:attribute:: ALL_RESOLUTION
      :canonical: autodoc2.utils.WarningSubtypes.ALL_RESOLUTION
      :value: 'all_resolve'

      .. autodoc2-docstring:: autodoc2.utils.WarningSubtypes.ALL_RESOLUTION

   .. py:attribute:: NAME_NOT_FOUND
      :canonical: autodoc2.utils.WarningSubtypes.NAME_NOT_FOUND
      :value: 'missing'

      .. autodoc2-docstring:: autodoc2.utils.WarningSubtypes.NAME_NOT_FOUND

.. py:function:: yield_modules(folder: str | pathlib.Path, *, root_module: str | None = None, extensions: typing.Sequence[str] = ('.py', '.pyi'), exclude_dirs: typing.Sequence[str] = ('__pycache__', ), exclude_files: typing.Sequence[str] = ()) -> typing.Iterable[tuple[pathlib.Path, str]]
   :canonical: autodoc2.utils.yield_modules

   .. autodoc2-docstring:: autodoc2.utils.yield_modules