documented
¶
This is my module brief line.
This is a more complete paragraph documenting my module.
- A list item.
- Another list item.
This section can use any reST syntax.
Functions¶
a_function()
: This is the brief description of my function.
-
documented.
a_function
(my_arg, another)¶ This is the brief description of my function.
This is a more complete example of my function. It can include doctest, code blocks or any other reST structure.
>>> a_function(10, [MyClass('a'), MyClass('b')]) 20
Parameters: Returns: The length of the second argument times the first argument.
Return type:
Classes¶
MyClass
: This is the brief of my main class.AnotherClass
: This another class.
-
class
documented.
MyClass
(param1, param2=None)¶ This is the brief of my main class.
A more general description of what the class does.
Parameters: Variables: my_attribute – Just an instance attribute.
Raises: TypeError – if param2 is not None.
Inheritance
-
class_attribute
= 625¶ This is a class attribute.
-
Exceptions¶
MyException
: This is my custom exception.
-
exception
documented.
MyException
¶ This is my custom exception.
This is a more complete description of what my exception does. Again, you can be as verbose as you want here.
Inheritance