Automatic documentation decorators#
The torx/decorators module provides a set of decorators for automatic
rich documentation in the TorX project. These decorators are designed
to provide a nice documentation for modules, functions, and classes.
Overview#
The automatic rich documentation decorators are a set of tools that help you create high-quality documentation for your code. They are designed to be easy to use and flexible, allowing you to customize the documentation to fit your needs.
Decorators#
The decorators provided by the torx/decorators module are:
autodoc_module: Automatically creates nice documentation for modules.autodoc_function: Automatically creates nice documentation for functions.AutoDocClass: Automatically creates nice documentation for classes.AutoDocEnum: Automatically creates nice documentation for enumerations.
Usage#
Here are some examples of how to use the decorators:
from torx.decorators import autodoc_module
autodoc_module(__name__)
from torx.decorators import AutoDocClass
class MyClass(AutoDocClass):
pass
from torx.decorators import autodoc_function
@autodoc_function
def my_function():
pass
from torx.decorators import AutoDocEnum
class MyEnum(AutoDocEnum):
A = 1
B = 2