def add(a, b):
    """
    計(jì)算兩個(gè)數(shù)的和

    參數(shù):
    a (int): 第一個(gè)加數(shù)
    b (int): 第二個(gè)加數(shù)

    返回:
    int: 兩個(gè)加數(shù)的和
    """
    return a + b

print(help(add))
# 或者
print(add.__doc__)

def add(a, b):
    """
    計(jì)算兩個(gè)數(shù)的和
    
    參數(shù):
    a (int): 第一個(gè)數(shù)字
    b (int): 第二個(gè)數(shù)字
    
    返回:
    int: 兩個(gè)數(shù)字的和
    
    示例:
    >>> add(2, 3)
    5
    >>> add(-1, 1)
    0
    """
    return a + b

class Calculator:
    """
    一個(gè)簡(jiǎn)單的計(jì)算器類(lèi)
    
    屬性:
    brand (str): 計(jì)算器品牌
    
    方法:
    add: 加法運(yùn)算
    subtract: 減法運(yùn)算
    """
    
    def __init__(self, brand):
        self.brand = brand
    
    def multiply(self, a, b):
        """返回兩個(gè)數(shù)的乘積"""
        return a * b

help(add)
# 或者
help(Calculator)

print(add.__doc__)
print(Calculator.__doc__)

# 在IPython或Jupyter中
add?
# 或者
add??

def calculate_area(radius):
    """
    計(jì)算圓的面積
    
    Args:
        radius (float): 圓的半徑
        
    Returns:
        float: 圓的面積
        
    Raises:
        ValueError: 當(dāng)半徑為負(fù)數(shù)時(shí)
        
    Example:
        >>> calculate_area(5)
        78.53981633974483
    """
    if radius < 0:
        raise ValueError("半徑不能為負(fù)數(shù)")
    return 3.141592653589793 * radius ** 2

def calculate_area(radius):
    """
    計(jì)算圓的面積
    
    Parameters
    ----------
    radius : float
        圓的半徑
        
    Returns
    -------
    float
        圓的面積
        
    Examples
    --------
    >>> calculate_area(5)
    78.53981633974483
    """
    return 3.141592653589793 * radius ** 2

"""
math_utils.py

這個(gè)模塊提供了一些數(shù)學(xué)工具函數(shù)。

包含的功能:
- 基本算術(shù)運(yùn)算
- 幾何計(jì)算
- 統(tǒng)計(jì)函數(shù)

作者: Your Name
版本: 1.0
"""

def average(numbers):
    """計(jì)算數(shù)字列表的平均值"""
    return sum(numbers) / len(numbers)

class BankAccount:
    """
    銀行賬戶類(lèi)
    
    屬性:
        account_holder (str): 賬戶持有人姓名
        balance (float): 賬戶余額
        account_number (str): 賬戶號(hào)碼
        
    方法:
        deposit: 存款
        withdraw: 取款
        get_balance: 查詢余額
    """
    
    def __init__(self, account_holder, initial_balance=0):
        """
        初始化銀行賬戶
        
        Args:
            account_holder (str): 賬戶持有人姓名
            initial_balance (float, optional): 初始余額，默認(rèn)為0
        """
        self.account_holder = account_holder
        self.balance = initial_balance
        self.account_number = self._generate_account_number()
    
    def deposit(self, amount):
        """
        存款操作
        
        Args:
            amount (float): 存款金額
            
        Returns:
            float: 更新后的余額
            
        Raises:
            ValueError: 當(dāng)存款金額為負(fù)數(shù)時(shí)
        """
        if amount <= 0:
            raise ValueError("存款金額必須為正數(shù)")
        self.balance += amount
        return self.balance
    
    def withdraw(self, amount):
        """
        取款操作
        
        Args:
            amount (float): 取款金額
            
        Returns:
            float: 更新后的余額
            
        Raises:
            ValueError: 當(dāng)取款金額為負(fù)數(shù)或超過(guò)余額時(shí)
        """
        if amount <= 0:
            raise ValueError("取款金額必須為正數(shù)")
        if amount > self.balance:
            raise ValueError("余額不足")
        self.balance -= amount
        return self.balance

# 使用幫助文檔
help(BankAccount)
help(BankAccount.deposit)