Python 模块和包_python模块和包的使用-CSDN博客

在Python中，模块和包是用于组织代码的工具，它们有助于将代码逻辑进行结构化，从而提高代码的可读性和可维护性。下面我们详细介绍如何使用模块和包，以及它们之间的关系。

1. 模块

1.1 模块是什么？

模块是一个包含Python代码的文件。任何一个 .py 文件都可以被看作是一个模块，可以在其他Python脚本中导入并使用其中定义的变量、函数、类等。

1.2 导入模块

在Python中，使用 import 语句可以导入模块。常见的导入方式包括：

导入整个模块

# 导入math模块
import math

# 使用模块中的函数
print(math.sqrt(16))  # 输出: 4.0

导入模块中的特定部分

# 从math模块中只导入sqrt函数
from math import sqrt

# 直接使用sqrt函数
print(sqrt(16))  # 输出: 4.0

使用模块的别名

# 为模块起别名
import math as m

# 使用别名来调用模块中的函数
print(m.pi)  # 输出: 3.141592653589793

1.3 自定义模块

我们可以创建自己的模块，方法是创建一个 .py 文件，并在另一个文件中使用 import 导入它。

创建自定义模块

# 文件名：my_module.py

def greet(name):
    return f"Hello, {name}!"

def add(a, b):
    return a + b

在另一个文件中导入自定义模块

# 文件名：main.py

# 导入自定义模块
import my_module

# 调用模块中的函数
print(my_module.greet("Alice"))  # 输出: Hello, Alice!
print(my_module.add(5, 3))       # 输出: 8

2. 包

2.1 包是什么？

包是一个包含多个模块的文件夹。包是为了组织和管理多个模块而设计的，它可以包含多个相关模块，形成一个目录层级。包的文件夹中通常会包含一个 __init__.py 文件，这个文件可以是空的，也可以包含包的初始化代码。

2.2 创建包

步骤1：创建包目录

首先，创建一个目录作为包。包的目录结构如下：

my_package/
    __init__.py
    module1.py
    module2.py

__init__.py 文件：这个文件使Python将该目录视为一个包。即使文件为空，包的功能仍然可以正常使用。

步骤2：在包中创建模块

module1.py

# 文件名：module1.py

def greet(name):
    return f"Hello, {name} from module1!"

module2.py

# 文件名：module2.py

def add(a, b):
    return a + b

步骤3：导入包中的模块

# 导入包中的模块
from my_package import module1, module2

# 使用module1和module2中的函数
print(module1.greet("Alice"))  # 输出: Hello, Alice from module1!
print(module2.add(5, 3))       # 输出: 8

使用 `init.py` 进行包初始化

在 __init__.py 文件中，我们可以预先导入包中的部分模块，以便用户直接从包中导入这些模块。

my_package/__init__.py

# 在__init__.py文件中导入模块
from .module1 import greet
from .module2 import add

现在，在主文件中可以直接从包中导入这些函数：

# 导入包中的函数
from my_package import greet, add

# 使用导入的函数
print(greet("Alice"))  # 输出: Hello, Alice from module1!
print(add(5, 3))       # 输出: 8

2.3 子包的使用

包中还可以包含子包，形成更复杂的结构。这种结构适用于大型项目，能更好地组织代码。

my_package/
    __init__.py
    sub_package/
        __init__.py
        module3.py

sub_package/module3.py

def multiply(a, b):
    return a * b

导入子包中的模块

# 导入子包中的模块
from my_package.sub_package import module3

# 使用子包模块中的函数
print(module3.multiply(4, 5))  # 输出: 20

2.4 包的相对导入

在包的内部模块之间，可以使用相对导入。相对导入通过 .（表示当前目录）或 ..（表示上级目录）来访问模块。

# module1.py 中使用相对导入
from .module2 import add

def greet_and_add(name, a, b):
    greeting = greet(name)
    sum_result = add(a, b)
    return f"{greeting}, the sum is {sum_result}"

3. 常用内置模块

3.1 `os` 模块

os 模块提供了一些与操作系统交互的函数。

import os

# 获取当前工作目录
print(os.getcwd())  # 输出: 当前的工作目录路径

# 列出当前目录的所有文件和文件夹
print(os.listdir())

# 创建目录
os.mkdir("test_directory")

# 删除目录
os.rmdir("test_directory")

3.2 `sys` 模块

sys 模块提供对Python解释器相关的操作。

import sys

# 查看Python的搜索路径
print(sys.path)

# 获取Python版本信息
print(sys.version)

3.3 `datetime` 模块

datetime 模块用于处理日期和时间。

import datetime

# 获取当前日期和时间
now = datetime.datetime.now()
print(now)

# 格式化日期
formatted = now.strftime("%Y-%m-%d %H:%M:%S")
print(formatted)  # 输出: 2024-10-19 10:20:30（示例日期）

4. 第三方模块的使用

4.1 安装第三方模块

使用 pip 工具可以安装第三方模块。以下是安装和使用 requests 模块的示例：

# 安装requests模块
pip install requests

4.2 使用第三方模块

import requests

# 发送HTTP GET请求
response = requests.get('https://api.github.com')

# 输出响应的状态码
print(response.status_code)  # 输出: 200

1. Pyecharts的使用

Pyecharts 是一个用于生成 ECharts 图表的 Python 库。它提供了一种直观的方式在 Python 中创建复杂的数据可视化。以下是如何使用 Pyecharts 的总结。

1.1. 安装

首先，确保安装了 pyecharts：

pip install pyecharts

1.2. 创建简单图表

Pyecharts 提供了多种图表类型，常用的有折线图、柱状图、饼图等。以下是柱状图的示例：

示例：柱状图

from pyecharts.charts import Bar
from pyecharts import options as opts

# 创建柱状图
bar = Bar()

# 添加 X 轴和 Y 轴数据
bar.add_xaxis(["苹果", "香蕉", "橙子"])
bar.add_yaxis("销量", [5, 20, 36])

# 设置全局选项
bar.set_global_opts(title_opts=opts.TitleOpts(title="水果销量"))

# 渲染图表
bar.render("bar_chart.html")  # 生成 HTML 文件

1.3. 其他图表类型

折线图（Line）：用于展示连续数据的变化。
饼图（Pie）：适合展示不同类别的占比。

示例：折线图

from pyecharts.charts import Line

line = Line()
line.add_xaxis(["一月", "二月", "三月", "四月"])
line.add_yaxis("气温", [5, 10, 15, 20])
line.set_global_opts(title_opts=opts.TitleOpts(title="每月气温变化"))
line.render("line_chart.html")

1.4. 自定义配置

Pyecharts 提供了丰富的自定义选项，包括标题、图例、轴线、标注等。例如，你可以通过 set_global_opts() 配置全局设置，通过 set_series_opts() 配置单个系列的选项。

示例：添加标注

bar.set_series_opts(label_opts=opts.LabelOpts(is_show=True))
bar.set_global_opts(title_opts=opts.TitleOpts(title="柱状图示例"))

1.5. 渲染方式

render()：将图表渲染为HTML文件，默认打开浏览器查看。
render_notebook()：在 Jupyter Notebook 中渲染图表。

2. PyMySQL的使用

PyMySQL 是一个纯 Python 实现的 MySQL 客户端，可以用于连接 MySQL 数据库并执行 SQL 语句。

2.1. 安装

首先，确保安装了 pymysql：

pip install pymysql

2.2. 连接数据库

要使用 PyMySQL 连接 MySQL 数据库，你需要提供数据库的主机地址、用户名、密码和数据库名称。

示例：连接数据库

import pymysql

# 连接数据库
connection = pymysql.connect(
    host='localhost',
    user='root',
    password='password',
    database='test_db'
)

# 创建游标对象
cursor = connection.cursor()

# 执行查询
cursor.execute("SELECT VERSION()")

# 获取结果
data = cursor.fetchone()
print(f"Database version: {data[0]}")

# 关闭连接
cursor.close()
connection.close()

2.3. 执行 SQL 语句

通过 PyMySQL，您可以执行各种 SQL 语句，如查询、插入、更新和删除。

示例：插入数据

# 插入数据
try:
    cursor = connection.cursor()
    sql = "INSERT INTO employees (name, age, position) VALUES (%s, %s, %s)"
    values = ("John Doe", 28, "Engineer")
    cursor.execute(sql, values)

    # 提交事务
    connection.commit()
except Exception as e:
    print(f"Error: {e}")
    connection.rollback()  # 出现错误时回滚
finally:
    cursor.close()

示例：查询数据

# 查询数据
cursor = connection.cursor()
sql = "SELECT * FROM employees"
cursor.execute(sql)

# 获取所有结果
results = cursor.fetchall()

# 遍历结果
for row in results:
    print(f"Name: {row[0]}, Age: {row[1]}, Position: {row[2]}")

2.4. 常用操作

execute()：执行 SQL 语句。
fetchone()：获取查询结果的第一行。
fetchall()：获取所有查询结果。
commit()：提交事务。
rollback()：回滚事务。

2.5. 关闭连接

为了避免资源浪费，确保在数据库操作完成后关闭连接和游标：

cursor.close()
connection.close()

总结

库	主要用途	使用示例
Pyecharts	数据可视化库，生成交互式图表	折线图、柱状图、饼图等；`render()` 渲染为HTML文件
PyMySQL	Python MySQL客户端，执行SQL语句	连接MySQL数据库，执行查询、插入、更新、删除等操作

Pyecharts 用于数据可视化，生成漂亮的图表；PyMySQL 则是用于与 MySQL 数据库进行交互。