Python 类型标注和函数标注

在 Python 中，类型标注是一种注释，用于指定变量、函数参数和返回值的预期类型。这种做法可以帮助开发人员更好地理解代码，提高代码的可读性和可维护性。同时，类型标注还可以用于支持类型检查工具，如 Mypy，以在运行时检查代码中的类型错误。
在 Python 3.5 之后，可以使用内置的 typing 模块来定义类型标注。例如，以下是一个简单的函数，它接受两个整数作为参数，并返回它们的和：

from typing import Tuple
def add_numbers(a: int, b: int) -> int:
return a + b

在这个例子中，我们使用 int 类型来标注参数 a 和 b，并使用 -> 符号来指定函数返回值的类型。注意，我们还需要从 typing 模块中导入 Tuple 类型。
除了内置类型，如 int、str、list 等之外，你还可以定义自己的标注类型。例如，你可以创建一个元组类型标注：

from typing import Tuple
MyTuple = Tuple[int, int]

然后，你可以在函数参数和返回值中使用这个自定义类型标注：

def add_points(p1: MyTuple, p2: MyTuple) -> MyTuple:
return (p1[0] + p2[0], p1[1] + p2[1])

在这个例子中，我们定义了一个名为 MyTuple 的自定义类型标注，它表示一个包含两个整数的元组。然后，我们将这个自定义类型标注用于函数参数和返回值。
除了类型标注之外，Python 还支持使用装饰器来为函数添加元数据。其中，最常用的装饰器之一是 @staticmethod，它用于将一个方法声明为静态方法。静态方法不需要访问类实例或类属性，因此它们不需要 self 参数。使用 @staticmethod 装饰器可以让方法更易于理解和使用。
下面是一个使用 @staticmethod 装饰器的示例：

class Calculator:
@staticmethod
def add(a, b):
return a + b

在这个例子中，我们定义了一个名为 Calculator 的类，并在其中定义了一个静态方法 add。使用 @staticmethod 装饰器可以让这个方法不需要访问类实例或类属性。我们可以直接通过类名来调用这个方法：Calculator.add(3, 4)。
需要注意的是，虽然静态方法不需要访问类实例或类属性，但它们仍然可以通过实例来调用。例如：c = Calculator()； c.add(3, 4)。因此，在实际应用中，根据需要选择合适的装饰器来声明方法。