5. test_py_module
¶
Table of Contents
Test Module for sphinx_rtd_theme.
-
class
test_py_module.test.
Foo
(qux, spam=False)[исходный код]¶ Docstring for class Foo.
This text tests for the formatting of docstrings generated from output
sphinx.ext.autodoc
. Which contain reST, but sphinx nests it in the<dl>
, and<dt>
tags. Also,<tt>
is used for class, method names and etc, but those will always have the.descname
or.descclassname
class.Normal
<tt>
(like the <tt> I just wrote here) needs to be shown with the same style as anything else with``this type of markup``
.It’s common for programmers to give a code example inside of their docstring:
from test_py_module import Foo myclass = Foo() myclass.dothismethod('with this argument') myclass.flush() print(myclass)
Here is a link to
capitalize()
. Here is a link to__init__()
.-
__init__
(qux, spam=False)[исходный код]¶ Start the Foo.
Параметры: - qux (string) – The first argument to initialize class.
- spam (bool) – Spam me yes or no…
-
__weakref__
¶ list of weak references to the object (if defined)
-
add
(val1, val2)[исходный код]¶ Return the added values.
Параметры: - val1 (int) – First number to add.
- val2 (int) – Second number to add.
Тип результата: int
-
another_function
(a, b, **kwargs)[исходный код]¶ Here is another function.
Параметры: - a (int) – The number of green hats you own.
- b (int) – The number of non-green hats you own.
- kwargs (float) – Additional keyword arguments. Each keyword parameter should specify the name of your favorite cuisine. The values should be floats, specifying the mean price of your favorite dish in that cooking style.
Результат: A 2-tuple. The first element is the mean price of all dishes across cuisines. The second element is the total number of hats you own: \(a + b\).
Тип результата: tuple
Исключение: ValueError – When
a
is not an integer.Добавлено в версии 1.0: This was added in 1.0
Изменено в версии 2.0: This was changed in 2.0
Не рекомендуется, начиная с версии 3.0: This is deprecated since 3.0
-
bar
= 1¶ Doc comment for class attribute Foo.bar. It can have multiple lines.
-
baz
= 2¶ Docstring for class attribute Foo.baz.
-
capitalize
(myvalue)[исходный код]¶ Return a string as uppercase.
Параметры: myvalue (string) – String to change Тип результата: string
-
flox
= 1.5¶ Doc comment for Foo.flox. One line only.
-
qux
= None¶ Doc comment for instance attribute qux.
-
spam
= None¶ Docstring for instance attribute spam.
-
5.1. Generated Index¶
Part of the sphinx build process in generate and index file: Алфавитный указатель.
5.2. Optional parameter args¶
At this point optional parameters cannot be generated from code. However, some projects will manually do it, like so:
This example comes from django-payments module docs.
-
class
payments.dotpay.
DotpayProvider
(seller_id, pin[, channel=0[, lock=False], lang='pl'])¶ This backend implements payments using a popular Polish gateway, Dotpay.pl.
Due to API limitations there is no support for transferring purchased items.
Параметры: - seller_id – Seller ID assigned by Dotpay
- pin – PIN assigned by Dotpay
- channel – Default payment channel (consult reference guide)
- lang – UI language
- lock – Whether to disable channels other than the default selected above