add Dockerfile

[YangSen-qn]

No description provided.

[qiniu-x]

Missing function or method docstring (missing-function-docstring)

Details

lint 解释

missing-function-docstring 是一个常见的代码质量检查，用于确保函数或方法有文档字符串（docstring）。文档字符串是用于描述函数、类或模块用途的字符串，通常放在函数定义的第一行。它有助于其他开发者理解代码的功能和使用方式。

错误用法

以下是一个缺少函数文档字符串的示例：

def calculate_area(length, width):
    return length * width

在这个例子中，calculate_area 函数没有文档字符串，这可能会导致其他开发者难以理解该函数的作用。

正确用法

以下是添加了文档字符串的正确示例：

def calculate_area(length, width):
    """
    计算矩形面积
    
    参数:
    length (float): 矩形的长度
    width (float): 矩形的宽度
    
    返回:
    float: 矩形的面积
    """
    return length * width

在这个例子中，calculate_area 函数添加了一个文档字符串，详细描述了函数的功能、参数和返回值。这有助于提高代码的可读性和可维护性。

---

💡 以上内容由 AI 辅助生成，如有疑问欢迎反馈交流

[qiniu-x]

Use lazy % formatting in logging functions (logging-fstring-interpolation)

Details

lint 解释

logging-fstring-interpolation 是一个lint规则，用于检查在日志记录函数中使用懒惰的 % 格式化。这个规则建议使用更现代和易读的格式化方法，如 f-string 或 str.format()。

错误用法

以下是一个使用 % 格式化的错误示例：

import logging

logging.basicConfig(level=logging.DEBUG)
logger = logging.getLogger(__name__)

user_id = 123
logger.debug("User ID: %d" % user_id)

在这个例子中，日志消息使用了 % 格式化方法。

正确用法

以下是一个使用 f-string 的正确示例：

import logging

logging.basicConfig(level=logging.DEBUG)
logger = logging.getLogger(__name__)

user_id = 123
logger.debug(f"User ID: {user_id}")

在这个例子中，日志消息使用了 f-string 格式化方法，这是一种更现代和易读的格式化方式。

---

💡 以上内容由 AI 辅助生成，如有疑问欢迎反馈交流

[qiniu-x]

Use lazy % formatting in logging functions (logging-fstring-interpolation)

Details

lint 解释

logging-fstring-interpolation 是一个lint规则，用于检查在日志记录函数中使用懒惰的字符串格式化（lazy string formatting）。懒惰的字符串格式化意味着只有在实际需要时才进行字符串格式化，而不是在记录日志时就立即进行。这可以提高性能，特别是在日志级别设置为不记录某些信息时。

错误用法

以下是一个使用非懒惰字符串格式化的示例：

import logging

logging.basicConfig(level=logging.DEBUG)
logger = logging.getLogger(__name__)

user_id = 123
username = "john_doe"
logger.debug("User %s logged in with ID %d" % (username, user_id))

在这个例子中，字符串格式化在记录日志时立即进行，即使日志级别设置为不记录 DEBUG 级别的信息。

正确用法

以下是一个使用懒惰字符串格式化的示例：

import logging

logging.basicConfig(level=logging.DEBUG)
logger = logging.getLogger(__name__)

user_id = 123
username = "john_doe"
logger.debug("User %s logged in with ID %d" % (username, user_id))

在这个例子中，字符串格式化在记录日志时立即进行，即使日志级别设置为不记录 DEBUG 级别的信息。

错误用法

以下是一个使用非懒惰字符串格式化的示例：

import logging

logging.basicConfig(level=logging.DEBUG)
logger = logging.getLogger(__name__)

user_id = 123
username = "john_doe"
logger.debug("User %s logged in with ID %d" % (username, user_id))

在这个例子中，字符串格式化在记录日志时立即进行，即使日志级别设置为不记录 DEBUG 级别的信息。

正确用法

以下是一个使用懒惰字符串格式化的示例：

import logging

logging.basicConfig(level=logging.DEBUG)
logger = logging.getLogger(__name__)

user_id = 123
username = "john_doe"
logger.debug("User %s logged in with ID %d" % (username, user_id))

在这个例子中，字符串格式化在记录日志时立即进行，即使日志级别设置为不记录 DEBUG 级别的信息。

---

💡 以上内容由 AI 辅助生成，如有疑问欢迎反馈交流

[qiniu-x]

Use lazy % formatting in logging functions (logging-fstring-interpolation)

Details

lint 解释

logging-fstring-interpolation 是一个lint规则，用于检查在日志记录函数中使用懒惰的字符串格式化（lazy string formatting）。懒惰的字符串格式化意味着只有在实际需要时才进行字符串格式化，而不是在记录日志时就立即进行。这可以提高性能，特别是在日志级别设置为不记录某些信息时。

错误用法

以下是一个使用非懒惰字符串格式化的示例：

import logging

logging.basicConfig(level=logging.DEBUG)
logger = logging.getLogger(__name__)

user_id = 123
username = "john_doe"
logger.debug("User %s logged in with ID %d" % (username, user_id))

在这个例子中，字符串格式化在记录日志时立即进行，即使日志级别设置为不记录 DEBUG 级别的信息。

正确用法

以下是一个使用懒惰字符串格式化的示例：

import logging

logging.basicConfig(level=logging.DEBUG)
logger = logging.getLogger(__name__)

user_id = 123
username = "john_doe"
logger.debug("User %s logged in with ID %d" % (username, user_id))

在这个例子中，字符串格式化在记录日志时立即进行，即使日志级别设置为不记录 DEBUG 级别的信息。

错误用法

以下是一个使用非懒惰字符串格式化的示例：

import logging

logging.basicConfig(level=logging.DEBUG)
logger = logging.getLogger(__name__)

user_id = 123
username = "john_doe"
logger.debug("User %s logged in with ID %d" % (username, user_id))

在这个例子中，字符串格式化在记录日志时立即进行，即使日志级别设置为不记录 DEBUG 级别的信息。

正确用法

以下是一个使用懒惰字符串格式化的示例：

import logging

logging.basicConfig(level=logging.DEBUG)
logger = logging.getLogger(__name__)

user_id = 123
username = "john_doe"
logger.debug("User %s logged in with ID %d" % (username, user_id))

在这个例子中，字符串格式化在记录日志时立即进行，即使日志级别设置为不记录 DEBUG 级别的信息。

---

💡 以上内容由 AI 辅助生成，如有疑问欢迎反馈交流