Python 进阶：模块、包和异常处理

二、包：模块的集合

2.1 什么是包？

包（Package）是多个模块的集合，用于构建更大规模的项目。一个包是一个包含 __init__.py 文件的目录。

包的结构如下：

my_package/
  __init__.py
  math_utils.py
  string_utils.py

2.2 创建和使用包

创建一个包：

# 文件结构 my_package/
# __init__.py
# math_utils.py
# string_utils.py

# math_utils.py
def add(a, b):
    return a + b

# string_utils.py
def to_uppercase(s):
    return s.upper()

导入包：

# 导入整个包中的模块
from my_package import math_utils, string_utils
print(math_utils.add(3, 4))  # 输出：7
print(string_utils.to_uppercase("hello"))  # 输出：HELLO

# 从模块中导入特定函数
from my_package.math_utils import add
print(add(5, 6))  # 输出：11

三、异常处理：编写健壮的代码

3.1 什么是异常？

异常（Exception）是程序运行时发生的错误。例如，除以零会引发 ZeroDivisionError，访问未定义的变量会引发 NameError。

print(10 / 0)  # ZeroDivisionError: division by zero
print(undefined_variable)  # NameError: name 'undefined_variable' is not defined

3.2 捕获异常

使用 try-except 语句捕获并处理异常，从而避免程序崩溃。

try:
    print(10 / 0)
except ZeroDivisionError:
    print("Cannot divide by zero!")  # 输出：Cannot divide by zero!

3.3 捕获多个异常

可以同时捕获多种类型的异常。

try:
    print(undefined_variable)
except (ZeroDivisionError, NameError) as e:
    print(f"An error occurred: {e}")

3.4 使用 else 和 finally

• else：在没有异常时执行。
• finally：无论是否有异常，都会执行。

try:
    result = 10 / 2
except ZeroDivisionError:
    print("Cannot divide by zero!")
else:
    print(f"Result is {result}")  # 输出：Result is 5.0
finally:
    print("Execution completed.")  # 输出：Execution completed.

3.5 自定义异常

可以通过继承 Exception 类创建自定义异常。

class CustomError(Exception):
    pass

def check_positive(value):
    if value < 0:
        raise CustomError("Value must be positive!")

try:
    check_positive(-10)
except CustomError as e:
    print(e)  # 输出：Value must be positive!

四、实战：构建模块化的应用

假设我们要开发一个简单的日历工具，支持以下功能：

• 添加事件。
• 列出事件。
• 删除事件。

项目结构：

calendar_app/
  __init__.py
  event_manager.py
  utils.py

event_manager.py

class EventManager:
    def __init__(self):
        self.events = []

    def add_event(self, event):
        self.events.append(event)

    def list_events(self):
        return self.events

    def delete_event(self, event):
        if event in self.events:
            self.events.remove(event)
        else:
            raise ValueError("Event not found!")

utils.py

def format_event(event):
    return f"Event: {event}"

主程序：

from calendar_app.event_manager import EventManager
from calendar_app.utils import format_event

manager = EventManager()

# 添加事件
manager.add_event("Meeting at 10 AM")
manager.add_event("Lunch at 12 PM")

# 列出事件
events = manager.list_events()
for event in events:
    print(format_event(event))  # 格式化输出事件

# 删除事件
manager.delete_event("Lunch at 12 PM")
print(manager.list_events())  # 输出：['Meeting at 10 AM']

五、最佳实践

1. 模块化代码：将代码拆分为逻辑清晰的模块或包，便于重用和维护。
2. 优雅的异常处理：捕获特定异常，避免使用裸露的 except 语句。
3. 保持目录整洁：合理组织项目结构，使用包管理复杂项目。
4. 写测试代码：为模块和函数编写单元测试，确保代码质量。

总结

模块和包是 Python 代码组织的基石，它们让代码更加清晰、易维护。而异常处理则是提高代码健壮性的重要工具。通过理解和应用这些特性，你可以开发出更高效、更可靠的 Python 应用程序。