Python 中的 __doc__ 属性是用来做什么的？Python 中的 logging 模块是用来做什么的？如何配置日志记录？

Python 中的 doc 属性是用来做什么的？

doc 是 Python 中用于存储文档字符串（docstring）的特殊属性。文档字符串是与模块、类、函数或方法相关联的字符串，用于提供对其功能和使用的简要描述。

主要用途：
文档和注释： doc 存储的是用三引号括起来的字符串，通常包含有关模块、类、函数或方法的文档和注释信息。这使得代码更容易理解和维护。

自动生成文档： 通过合理编写文档字符串，可以使用工具（例如 Sphinx、Doxygen）自动生成代码文档。这对于团队协作和代码共享非常有用。

示例：
在模块中使用 doc：

"""这是一个模块的文档字符串。

这里可以包含模块的概述、用法示例等信息。
"""

def my_function():
    """这是一个函数的文档字符串。

    这里可以包含函数的参数、返回值等信息。
    """
    pass

print(__doc__)  # 打印模块的文档字符串
print(my_function.__doc__)  # 打印函数的文档字符串

在类中使用 doc：

class MyClass:
    """这是一个类的文档字符串。

    这里可以包含类的属性、方法等信息。
    """

    def my_method(self):
        """这是一个方法的文档字符串。

        这里可以包含方法的参数、返回值等信息。
        """
        pass

print(MyClass.__doc__)  # 打印类的文档字符串
print(MyClass.my_method.__doc__)  # 打印方法的文档字符串

注意事项：
文档字符串的编写应该遵循一定的规范，以确保生成的文档清晰、准确。
通过 help() 函数或特定的文档生成工具，可以方便地查看和导出文档信息。
总的来说，doc 属性是 Python 中一种用于存储和访问代码文档的简单而有用的机制。

Python 中的 logging 模块是用来做什么的？如何配置日志记录？

logging 模块是 Python 标准库中用于实现灵活且可配置的日志记录的模块。它提供了一套强大而灵活的工具，用于在应用程序中添加日志记录，以便在不同级别的详细程度下跟踪代码执行过程，帮助定位问题、调试代码，并提供运行时信息。

logging 模块的主要组件：
Logger（记录器）：

logging.getLogger(name)：获取或创建一个记录器对象。通过不同的 name 可以获取不同的记录器对象。
Handler（处理器）：

处理日志记录的输出。例如，将日志记录写入文件、发送到控制台等。
常见的处理器包括 StreamHandler（控制台输出）、FileHandler（文件输出）、SMTPHandler（邮件输出）等。
Formatter（格式化器）：

控制日志记录的输出格式。定义了日志记录中包含哪些信息以及它们的排列方式。
常见的格式化器包括 Formatter、SimpleFormatter 等。
如何配置日志记录：
在使用 logging 模块时，你可以通过以下方式配置日志记录：

基本配置：

使用 basicConfig 配置全局的日志记录设置，设置日志级别、输出目标等。

import logging

logging.basicConfig(
    level=logging.INFO,  # 设置日志级别为 INFO
    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
)

创建记录器对象：

使用 logging.getLogger(name) 创建记录器对象，其中 name 是记录器的名称。

logger = logging.getLogger("example")

创建处理器对象：

创建处理器对象，将日志记录发送到不同的目标。例如，控制台、文件、邮件等。

console_handler = logging.StreamHandler()  # 控制台输出
file_handler = logging.FileHandler("example.log")  # 文件输出

创建格式化器对象：

创建格式化器对象，控制日志记录的输出格式。

formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
console_handler.setFormatter(formatter)

将处理器添加到记录器：

将处理器添加到记录器对象，以便实际处理日志记录。

logger.addHandler(console_handler)

记录日志：

使用记录器对象记录不同级别的日志。

logger.debug("This is a debug message.")
logger.info("This is an info message.")
logger.warning("This is a warning message.")
logger.error("This is an error message.")
logger.critical("This is a critical message.")

通过以上步骤，你可以配置和控制应用程序中的日志记录，以便满足不同的需求和场景。可以根据实际情况创建多个记录器、处理器和格式化器，以灵活应对不同的日志记录需求。