File: autodoc2.sphinx.docstring.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 (121 lines) | stat: -rw-r--r-- 4,300 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
:py:mod:`autodoc2.sphinx.docstring`
===================================

.. py:module:: autodoc2.sphinx.docstring

.. autodoc2-docstring:: autodoc2.sphinx.docstring
   :allowtitles:

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

Classes
~~~~~~~

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

   * - :py:obj:`DocstringRenderer <autodoc2.sphinx.docstring.DocstringRenderer>`
     - .. autodoc2-docstring:: autodoc2.sphinx.docstring.DocstringRenderer
          :summary:

Functions
~~~~~~~~~

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

   * - :py:obj:`parser_options <autodoc2.sphinx.docstring.parser_options>`
     - .. autodoc2-docstring:: autodoc2.sphinx.docstring.parser_options
          :summary:
   * - :py:obj:`summary_option <autodoc2.sphinx.docstring.summary_option>`
     - .. autodoc2-docstring:: autodoc2.sphinx.docstring.summary_option
          :summary:
   * - :py:obj:`parsing_context <autodoc2.sphinx.docstring.parsing_context>`
     - .. autodoc2-docstring:: autodoc2.sphinx.docstring.parsing_context
          :summary:
   * - :py:obj:`change_source <autodoc2.sphinx.docstring.change_source>`
     - .. autodoc2-docstring:: autodoc2.sphinx.docstring.change_source
          :summary:
   * - :py:obj:`_example <autodoc2.sphinx.docstring._example>`
     - .. autodoc2-docstring:: autodoc2.sphinx.docstring._example
          :parser: myst
          :summary:

API
~~~

.. py:function:: parser_options(argument: str) -> docutils.parsers.Parser | None
   :canonical: autodoc2.sphinx.docstring.parser_options

   .. autodoc2-docstring:: autodoc2.sphinx.docstring.parser_options

.. py:function:: summary_option(argument: str) -> int | None
   :canonical: autodoc2.sphinx.docstring.summary_option

   .. autodoc2-docstring:: autodoc2.sphinx.docstring.summary_option

.. py:class:: DocstringRenderer(name, arguments, options, content, lineno, content_offset, block_text, state, state_machine)
   :canonical: autodoc2.sphinx.docstring.DocstringRenderer

   Bases: :py:obj:`sphinx.util.docutils.SphinxDirective`

   .. autodoc2-docstring:: autodoc2.sphinx.docstring.DocstringRenderer

   .. rubric:: Initialization

   .. autodoc2-docstring:: autodoc2.sphinx.docstring.DocstringRenderer.__init__

   .. py:attribute:: has_content
      :canonical: autodoc2.sphinx.docstring.DocstringRenderer.has_content
      :value: False

      .. autodoc2-docstring:: autodoc2.sphinx.docstring.DocstringRenderer.has_content

   .. py:attribute:: required_arguments
      :canonical: autodoc2.sphinx.docstring.DocstringRenderer.required_arguments
      :value: 1

      .. autodoc2-docstring:: autodoc2.sphinx.docstring.DocstringRenderer.required_arguments

   .. py:attribute:: optional_arguments
      :canonical: autodoc2.sphinx.docstring.DocstringRenderer.optional_arguments
      :value: 0

      .. autodoc2-docstring:: autodoc2.sphinx.docstring.DocstringRenderer.optional_arguments

   .. py:attribute:: final_argument_whitespace
      :canonical: autodoc2.sphinx.docstring.DocstringRenderer.final_argument_whitespace
      :value: True

      .. autodoc2-docstring:: autodoc2.sphinx.docstring.DocstringRenderer.final_argument_whitespace

   .. py:attribute:: option_spec
      :canonical: autodoc2.sphinx.docstring.DocstringRenderer.option_spec
      :type: typing.ClassVar[dict[str, typing.Any]]
      :value: None

      .. autodoc2-docstring:: autodoc2.sphinx.docstring.DocstringRenderer.option_spec

   .. py:method:: run() -> list[docutils.nodes.Node]
      :canonical: autodoc2.sphinx.docstring.DocstringRenderer.run

      .. autodoc2-docstring:: autodoc2.sphinx.docstring.DocstringRenderer.run

.. py:function:: parsing_context() -> typing.Generator[None, None, None]
   :canonical: autodoc2.sphinx.docstring.parsing_context

   .. autodoc2-docstring:: autodoc2.sphinx.docstring.parsing_context

.. py:function:: change_source(state: docutils.parsers.rst.states.RSTStateMachine, source_path: str, line_offset: int) -> typing.Generator[None, None, None]
   :canonical: autodoc2.sphinx.docstring.change_source

   .. autodoc2-docstring:: autodoc2.sphinx.docstring.change_source

.. py:function:: _example(a: int, b: str) -> None
   :canonical: autodoc2.sphinx.docstring._example

   .. autodoc2-docstring:: autodoc2.sphinx.docstring._example
      :parser: myst