如何在Python中记录模块？

Posted 2023-02-24

而已。如果要记录函数或类，请在定义之后放置一个字符串。例如：

def foo():
    """This function does nothing."""
    pass

但是模块怎么样？如何记录file.py的作用？

答案

对于包，您可以在__init__.py中记录它。对于模块，您只需在模块文件中添加docstring即可。

所有信息都在这里：http://www.python.org/dev/peps/pep-0257/

另一答案

将您的docstring添加为first statement in the module。

"""
Your module's verbose yet thorough docstring.
"""

import foo

# ...

对于包，您可以将文档字符串添加到__init__.py。

另一答案

这是关于如何记录模块的Example Google Style Python Docstrings。基本上有一个关于模块的信息，如何执行它以及有关模块级变量和ToDo项列表的信息。

"""Example Google style docstrings.

This module demonstrates documentation as specified by the `Google
Python Style Guide`_. Docstrings may extend over multiple lines.
Sections are created with a section header and a colon followed by a
block of indented text.

Example:
    Examples can be given using either the ``Example`` or ``Examples``
    sections. Sections support any reStructuredText formatting, including
    literal blocks::

        $ python example_google.py

Section breaks are created by resuming unindented text. Section breaks
are also implicitly created anytime a new section starts.

Attributes:
    module_level_variable1 (int): Module level variables may be documented in
        either the ``Attributes`` section of the module docstring, or in an
        inline docstring immediately following the variable.

        Either form is acceptable, but the two should not be mixed. Choose
        one convention to document module level variables and be consistent
        with it.

Todo:
    * For module TODOs
    * You have to also use ``sphinx.ext.todo`` extension

.. _Google Python Style Guide:   
http://google.github.io/styleguide/pyguide.html

"""

module_level_variable1 = 12345

def my_function():   
    pass 
... 
...

另一答案

你这样做完全一样。将字符串作为模块中的第一个语句。

另一答案

这很容易，您只需在模块顶部添加文档字符串即可。