Python基础:模块与包

模块的概念

模块是Python程序架构的一个核心概念

  • 每一个扩展名 “py” 结尾的Python 源代码文件 都是一个模块
  • 模块名 同样也是一个标识符,需要符合标识符的命名规则
  • 在模块中定义的 全局变量、函数、类 都是提供给外界直接使用的工具
  • 模块好比就是 工具包,要想使用这个工具包中的工具,就需要先导入这个模块

模块的两种导入方式

import 导入

import 模块名1, 模块名2
  • 提示;在导入模块时,每个导入应该独占一行(该方法为 Python PEP8规范)
import 模块名1
import 模块名2
  • 导入之后

    • 通过 模块名. 使用模块提供的工具 —> 全局变量、函数、类
  • 使用as 指定模块的别名

    • 如果模块的名字太长,可以使用 as 指定模块的名称,以方便在代码中的使用
import 模块名1 as 模块别名

# test01模块


# 全局变量
title = "模块1"


# 函数
def say_hello():
	print("我是 %s" % title)
	
	
# 类
class Dog(object):
	pass
	

test02.py


# test02模块


# 全局变量
title = "模块2"


# 函数
def say_hello():
	print("我是 %s" % title)
	
	
# 类
class Cat(object):
	pass
	

import test_01_测试模块1 as DogModule
import test_02_测试模块2 as CatModule

DogModule.say_hello()
CatModule.say_hello()

dog = DogModule.Dog()
print(dog)

cat = CatModule.Cat()
print(cat)


  • 注意:模块别名 应该符合 大驼峰命名法

from…import 导入

  • 如果希望 从某一个模块中,导入 部分 工具,就可以使用 from…import 的方式
  • import 模块名 是 一次性 把模块中 所有工具,全部导入,并且通过 模块名/别名 访问
# 从 模块 导入 第一个工具
from 模块名1 import 工具名

from test_01_测试模块1 import Dog
from test_02_测试模块2 import say_hello

say_hello()


wangcai = Dog()
print(wangcai)


  • 导入之后

    • 不需要 通过 模块名
    • 可以直接使用 模块提供的工具 —> 全局变量、函数、类
  • 注意:如果两个模块,存在同名的函数,那么 后导入模块的函数,会覆盖掉先导入的函数

  • 开发时 import 代码应该统一写在 代码的顶部,更容易及时发现冲突

  • 一旦发现冲突,可以使用 as 关键字 给其中一个工具起一个别名

from…import * (仅作了解)

# 从 模块 导入 所有工具
from 模块名1 import *

from test_01_测试模块1 import *
print(title)
say_hello()

wangcai = Dog()
print(wangcai)


  • 注意:这种方式不推荐使用,因为函数重名并没有任何的提示,出现问题不好排查

模块的搜索顺序[扩展]

  • Python 的解释器在 ***导入模块***时,会:

    • 搜索 当前目录 指定模块名的文件, 如果有就直接导入
    • 如果没有,再搜索 系统目录
  • 在开发时,给文件名,不要和 系统的模块文件 重名

    • Python 中每一个模块都有一个内置属性 file 可以 查看模块 的 完整路径

示例:

import random

# 生成一个 0~10 的随机数字
rand = random.randint(0, 10)

print(rand)  
  • 注意:如果当前目录下,存在一个 random.py 的文件,程序就无法执行了!

    • 这个时候,Python的解释器会 加载当前目录 下的 random.py , 而不会加载 系统的 random 模块

原则–每一个文件都应该可以被导入的

  • 一个独立的 python 文件 就是一个 模块
  • 在导入文件时,文件中 所有没有任何缩进的代码 都会被执行一遍!

实际开发场景

  • 在实际开发中,每一个模块都是独立开发的,大多都有专人负责
  • 开发人员 通常会在 模块下方 增加一些测试代码

name 属性:

  • __name__ 属性可以做到,测试模块的代码 只在测试情况下被运行,而在 被导入时不会被执行!
1)、__name__ 是 Python 的一个内置属性,记录着一个 字符串
2)、如果 是被其他文件导入的, __name__ 就是 模块名
3)、如果 是当前执行的程序  __name__ 是 __main__

在很多 Python 文件中都会看到以下格式的代码:


# 导入模块
# 定义全局变量
# 定义类
# 定义函数

# 在代码的最下方
def main():
	# ...
    pass


# 根据 __name__ 判断是否执行下方代码
if __name__ == "__main__"
    main()   
    
# 全局变量、函数、类, 注意:直接执行的代码不是向外界提供的工具!


def say_hello():
    print("我是 say_hello")


# 如果直接执行模块,__name__ 是 __main__
if __name__ == "__main__":
    print(__name__)


    # 文件被导入时,能够直接执行的代码不需要被执行!
    print("小明开发的模块")
    say_hello()

包(package)

概念:

  • 包是一个 包含多个模块 的 特殊目录
  • 目录下有一个特殊文件 “init.py”
  • 包名的 命名方式 和 变量名一致

好处:

  • 使用 import 包名 可以一次性导入包中所有的模块

案例演练:

1、新建一个 test_message 包
2、在目录下,新建两个文件 send_message 和 receive_message
3、在 send_message 文件中定义一个 send 函数
4、在 receive_message 文件中定义一个 receive 函数
5、在外部直接导入 test_message 的包

创建 test_message 包 — > [Python Package]

__init__.py

  • 要在外界使用 包 中的模块,需要在 __init__.py 中 指定对外界提供的模块列表

# 从 当前目录 导入 模块列表
from.import send_message
from.import receive_message


send_message.py


def send(text):
    print("正在发送 %s" % text)
    

receive_message.py


def receive():
    print("这是来自 100XX 的短信")


test_import_message.py


import test_message

test_message.send_message.send("hello")

say_hello = test_message.receive_message.receive()
print(say_hello)


在这里插入图片描述

发布模块

  • 如果希望自己开发的模块, 分享 给其他人,可以按照以下步骤操作

制作发布压缩包步骤

创建 setup.py 文件


from distutils.core import setup

setup(name="test_message",    # 包名
      version="1.0",          # 版本号
      description="test's 发送和接收消息模块",  # 描述信息
      long_description="完整的发送和接收消息模块",  # 完整的描述信息
      author="tester",  # 作者
      author_email="[email protected]",  # 作者邮箱
      url="www.tester.com",  # 主页
      py_modules=["test_message.send_message",
                    "test_message.receive_message"])
                    

构建模块

# 终端内通过python解释器执行 setup.py 文件
$ python3 setup.py build
# 构建完成之后,可通过 tree 命令查看当前目录结构
$ tree

生成发布压缩包

# 终端内通过python解释器执行 setup.py 文件
$ python3 setup.py sdist

注意:要制作哪个版本的模块,就使用哪个版本的解释器执行!

2、安装模块

终端内通过 tar 命令 解压 生成好的包
$ tar -zxvf test_message-1.0.tar.gz
$ sudo python3 setup.py install

3、卸载模块

# 直接从安装目录下,把安装模块的 目录 删除就可以

$ cd usr/local/lib/python3.7/dist_package/
$ sudo rm -r test_message*

from distutils.core import setup

setup(name="test_message",    # 包名
      version="1.0",          # 版本号
      description="test's 发送和接收消息模块",  # 简单的描述信息
      long_description="完整的发送和接收消息模块",  # 完整的描述信息
      author="tester",  # 作者
      author_email="[email protected]",  # 作者邮箱
      url="www.tester.com",  # 主页
      py_modules=["test_message.send_message",
                    "test_message.receive_message"])
                    

pip 安装第三方模块

  • 第三方模块 通常是指由 知名的第三方团队 开发的 并且被 程序员广泛使用 的 Python包/模块

    • 例如 pygame 就是一套非常成熟的游戏开发模块
  • pip 是一个现代的,通用的 Python 包管理工具

  • 提供了对 Python 包的查找、下载、安装、卸载等功能

安装和卸载命令如下

# 将模块安装到 Python2.x环境
$ sudo pip install pygame
$ sudo pip uninstall pygame

# 将模块安装到 Python3.x环境
$ sudo pip3 install pygame
$ sudo pip3 uninstall pygame

在Mac下安装

$ sudo pip install ipython

在Linux下安装

$sudo apt install ipython
$sudo apt install ipython3

猜你喜欢

转载自blog.csdn.net/weixin_42250835/article/details/88797531