my_awesome_module.py

这是一个示例Python模块的文档。

```python def greet(name: str) -> str: """ 这个函数返回一个简单的问候语。

Args: name (str): 要问候的人的名字。

Returns: str: 问候语。 """ return f"你好，{name}！"

def add_numbers(a: int, b: int) -> int: """ 这个函数将两个数字相加。

Args: a (int): 第一个数字。 b (int): 第二个数字。

Returns: int: 两个数字的总和。 """ return a + b

class Calculator: """ 一个简单的计算器类。 """

def init(self): """ 初始化计算器。 """ self.result = 0

def add(self, num: int): """ 将数字添加到计算器的结果中。

Args:
    num (int): 要添加的数字。
"""
self.result += num

def get_result(self) -> int: """ 返回计算器的当前结果。

Returns:
    int: 计算器的结果。
"""
return self.result

```

用法示例:

```python from my_awesome_module import greet, add_numbers, Calculator

使用 greet 函数

print(greet("世界"))

使用 add_numbers 函数

result = add_numbers(5, 3) print(f"5 + 3 = {result}")

使用 Calculator 类

calculator = Calculator() calculator.add(10) calculator.add(5) print(f"计算结果：{calculator.get_result()}") ```

模块信息:

• 名称: my_awesome_module
• 作者: Bard
• 版本: 1.0.0
• 许可证: MIT

模块说明:

这个模块包含一些简单的函数和类，例如问候语函数、加法函数和计算器类。它可以作为一个学习和实践 Python 的示例。