Python doc文本读写

在Python中，文档字符串（Docstrings）是一种用于提供模块、函数、类等的文档注释的方式。它们通常位于代码块的开始处，被三引号('"""')包围，用于解释其功能、输入参数、返回值等信息。

**读取docstring**：
如果你想要获取某个函数、方法或类的文档字符串，可以使用内置的`__doc__`属性。例如：

def my_function():
    """This is a sample docstring."""
    pass

print(my_function.__doc__)

运行上述代码会打印出 `my_function` 的文档字符串内容。

**编写和写入docstring**：
当你创建新的函数或类时，应该始终包含一个文档字符串。Python本身并不直接支持“写入”docstring到文件，但是你可以将它们存储在一个单独的`.md`或`.rst`（reStructuredText）文件中，并通过工具如`sphinx`来生成API文档。

如果你想在模块中管理全局文档，可以在模块级别设置一个`__doc__`变量，不过这通常是不必要的，因为每个函数或类内部的文档更具体也更有针对性。