File: autodoc2.render.base.rst

package info (click to toggle)
python-sphinx-autodoc2 0.5.0-6
  • links: PTS, VCS
  • area: main
  • in suites:
  • size: 1,268 kB
  • sloc: python: 3,407; xml: 72; makefile: 9
file content (143 lines) | stat: -rw-r--r-- 5,586 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
:py:mod:`autodoc2.render.base`
==============================

.. py:module:: autodoc2.render.base

.. autodoc2-docstring:: autodoc2.render.base
   :allowtitles:

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

Classes
~~~~~~~

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

   * - :py:obj:`RendererBase <autodoc2.render.base.RendererBase>`
     - .. autodoc2-docstring:: autodoc2.render.base.RendererBase
          :summary:

API
~~~

.. py:class:: RendererBase(db: autodoc2.db.Database, config: autodoc2.config.Config, *, warn: typing.Callable[[str, autodoc2.utils.WarningSubtypes], None] | None = None, all_resolver: autodoc2.resolve_all.AllResolver | None = None, standalone: bool = True)
   :canonical: autodoc2.render.base.RendererBase

   Bases: :py:obj:`abc.ABC`

   .. autodoc2-docstring:: autodoc2.render.base.RendererBase

   .. rubric:: Initialization

   .. autodoc2-docstring:: autodoc2.render.base.RendererBase.__init__

   .. py:attribute:: EXTENSION
      :canonical: autodoc2.render.base.RendererBase.EXTENSION
      :type: typing.ClassVar[str]
      :value: '.txt'

      .. autodoc2-docstring:: autodoc2.render.base.RendererBase.EXTENSION

   .. py:attribute:: _is_hidden_cache
      :canonical: autodoc2.render.base.RendererBase._is_hidden_cache
      :type: collections.OrderedDict[str, bool]
      :value: None

      .. autodoc2-docstring:: autodoc2.render.base.RendererBase._is_hidden_cache

   .. py:property:: config
      :canonical: autodoc2.render.base.RendererBase.config
      :type: autodoc2.config.Config

      .. autodoc2-docstring:: autodoc2.render.base.RendererBase.config

   .. py:property:: standalone
      :canonical: autodoc2.render.base.RendererBase.standalone
      :type: bool

      .. autodoc2-docstring:: autodoc2.render.base.RendererBase.standalone

   .. py:method:: warn(msg: str, type_: autodoc2.utils.WarningSubtypes = WarningSubtypes.RENDER_ERROR) -> None
      :canonical: autodoc2.render.base.RendererBase.warn

      .. autodoc2-docstring:: autodoc2.render.base.RendererBase.warn

   .. py:method:: get_item(full_name: str) -> autodoc2.utils.ItemData | None
      :canonical: autodoc2.render.base.RendererBase.get_item

      .. autodoc2-docstring:: autodoc2.render.base.RendererBase.get_item

   .. py:method:: get_children(item: autodoc2.utils.ItemData, types: None | set[str] = None, *, omit_hidden: bool = True) -> typing.Iterable[autodoc2.utils.ItemData]
      :canonical: autodoc2.render.base.RendererBase.get_children

      .. autodoc2-docstring:: autodoc2.render.base.RendererBase.get_children

   .. py:method:: is_hidden(item: autodoc2.utils.ItemData) -> bool
      :canonical: autodoc2.render.base.RendererBase.is_hidden

      .. autodoc2-docstring:: autodoc2.render.base.RendererBase.is_hidden

   .. py:method:: is_module_deprecated(item: autodoc2.utils.ItemData) -> bool
      :canonical: autodoc2.render.base.RendererBase.is_module_deprecated

      .. autodoc2-docstring:: autodoc2.render.base.RendererBase.is_module_deprecated

   .. py:method:: no_index(item: autodoc2.utils.ItemData) -> bool
      :canonical: autodoc2.render.base.RendererBase.no_index

      .. autodoc2-docstring:: autodoc2.render.base.RendererBase.no_index

   .. py:method:: show_module_summary(item: autodoc2.utils.ItemData) -> bool
      :canonical: autodoc2.render.base.RendererBase.show_module_summary

      .. autodoc2-docstring:: autodoc2.render.base.RendererBase.show_module_summary

   .. py:method:: show_class_inheritance(item: autodoc2.utils.ItemData) -> bool
      :canonical: autodoc2.render.base.RendererBase.show_class_inheritance

      .. autodoc2-docstring:: autodoc2.render.base.RendererBase.show_class_inheritance

   .. py:method:: show_annotations(item: autodoc2.utils.ItemData) -> bool
      :canonical: autodoc2.render.base.RendererBase.show_annotations

      .. autodoc2-docstring:: autodoc2.render.base.RendererBase.show_annotations

   .. py:method:: show_docstring(item: autodoc2.utils.ItemData) -> bool
      :canonical: autodoc2.render.base.RendererBase.show_docstring

      .. autodoc2-docstring:: autodoc2.render.base.RendererBase.show_docstring

   .. py:method:: render_item(full_name: str) -> typing.Iterable[str]
      :canonical: autodoc2.render.base.RendererBase.render_item
      :abstractmethod:

      .. autodoc2-docstring:: autodoc2.render.base.RendererBase.render_item

   .. py:method:: format_args(args_info: autodoc2.utils.ARGS_TYPE, include_annotations: bool = True, ignore_self: None | str = None) -> str
      :canonical: autodoc2.render.base.RendererBase.format_args

      .. autodoc2-docstring:: autodoc2.render.base.RendererBase.format_args

   .. py:method:: format_annotation(annotation: None | str) -> str
      :canonical: autodoc2.render.base.RendererBase.format_annotation

      .. autodoc2-docstring:: autodoc2.render.base.RendererBase.format_annotation

   .. py:method:: format_base(base: None | str) -> str
      :canonical: autodoc2.render.base.RendererBase.format_base

      .. autodoc2-docstring:: autodoc2.render.base.RendererBase.format_base

   .. py:method:: get_doc_parser(full_name: str) -> str
      :canonical: autodoc2.render.base.RendererBase.get_doc_parser

      .. autodoc2-docstring:: autodoc2.render.base.RendererBase.get_doc_parser

   .. py:method:: generate_summary(objects: list[autodoc2.utils.ItemData], alias: dict[str, str] | None = None) -> typing.Iterable[str]
      :canonical: autodoc2.render.base.RendererBase.generate_summary
      :abstractmethod:

      .. autodoc2-docstring:: autodoc2.render.base.RendererBase.generate_summary