【Python】Python 包 ② ( 自定义 Python 包 | 导入并调用自定义 Python 包 | `__init__.py` 定义 `__all__` 变量 )

文章目录

  • 一、自定义 Python 包
    • 1、PyCharm 中创建 Python 包
    • 2、自定义 Module 模块代码
    • 3、`__init__.py` 代码
  • 二、导入并调用自定义 Python 包
    • 1、使用 import 导入自定义包模块
    • 2、使用 from 导入自定义包模块
    • 3、使用 from 导入自定义包模块中的函数功能
  • 三、`__init__.py` 定义 `__all__` 变量




一、自定义 Python 包



1、PyCharm 中创建 Python 包


右键点击 PyCharm 中的 Python 工程根目录 , 选择 ” New / Python Package ” 选项 ,

输入 Python 包名称 , 然后点击回车 , 创建 Python 包 ;

创建完成后 , 自动生成了一个 my_package 目录 , 该目录下自动生成了一个 __init__.py 文件 ;

在命令行中 , 使用 tree /f 命令 , 查看 该 Python 工程的目录结构 :

Y:\002_WorkSpace\PycharmProjects\HelloPython>tree /f
卷 新加卷 的文件夹 PATH 列表
卷序列号为 C893-6821
Y:.
│  hello.py
│  main.py
│
├─.idea
│  │  .gitignore
│  │  HelloPython.iml
│  │  misc.xml
│  │  modules.xml
│  │  workspace.xml
│  │
│  └─inspectionProfiles
│          profiles_settings.xml
│
└─my_package
        __init__.py


Y:\002_WorkSpace\PycharmProjects\HelloPython>


2、自定义 Module 模块代码


右键点击 PyCharm 根目录中的模块包 , 然后选择 ” New / Python File ” 选项 ,

输入文件名 ,

点击回车 , 即可在 Python 包中创建了 模块代码 ;

在 my_module1.py 中实现一个函数 :

"""
Python 包模块代码示例
"""


def my_module1_print():
    print("my_package 的 my_module1 模块运行")

再次创建一个模块 my_module2.py , 在 my_module2.py 中实现一个函数 :

"""
Python 包模块代码示例
"""


def my_module2_print():
    print("my_package 的 my_module2 模块运行")


3、__init__.py 代码


__init__.py 源码文件可以空着 , 但是必须要有 , 这是 Python 包的标志 ;

有了 __init__.py 源码文件之后 , 该目录才会被当做包对待 ,

如下图所示 , my_package 目录下有 __init__.py 源码文件 , 其目录图标中间有个点 , 普通的目录是这个样子的 , 如 PyCharm 项目的根目录 HelloPython ;


__init__.py 源码 中可以定义 __all__ 变量 , 这是一个列表容器 , 元素类型是字符串 ;





二、导入并调用自定义 Python 包



1、使用 import 导入自定义包模块


导入后 , 可以 通过 包名.模块名.功能名 访问指定功能 ;


代码示例 :

"""
自定义 Python 包 代码示例
"""

import my_package.my_module1
import my_package.my_module2

my_package.my_module1.my_module1_print()
my_package.my_module2.my_module2_print()

执行结果 :

Y:\002_WorkSpace\PycharmProjects\pythonProject\venv\Scripts\python.exe Y:/002_WorkSpace/PycharmProjects/HelloPython/hello.py
my_package 的 my_module1 模块运行
my_package 的 my_module2 模块运行

Process finished with exit code 0


2、使用 from 导入自定义包模块


代码示例 :

"""
自定义 Python 包 代码示例
"""

from my_package import my_module1
from my_package import my_module2

my_module1.my_module1_print()
my_module2.my_module2_print()

执行结果 :

Y:\002_WorkSpace\PycharmProjects\pythonProject\venv\Scripts\python.exe Y:/002_WorkSpace/PycharmProjects/HelloPython/hello.py
my_package 的 my_module1 模块运行
my_package 的 my_module2 模块运行

Process finished with exit code 0


3、使用 from 导入自定义包模块中的函数功能


代码示例 :

"""
自定义 Python 包 代码示例
"""

from my_package.my_module1 import my_module1_print
from my_package.my_module2 import my_module2_print

my_module1_print()
my_module2_print()

执行结果 :

Y:\002_WorkSpace\PycharmProjects\pythonProject\venv\Scripts\python.exe Y:/002_WorkSpace/PycharmProjects/HelloPython/hello.py
my_package 的 my_module1 模块运行
my_package 的 my_module2 模块运行

Process finished with exit code 0





三、__init__.py 定义 __all__ 变量


__init__.py 中定义 __all__ 变量 , 其含义是该软件包中 , my_module1 模块是有效的 , 其它模块不生效 ;

__all__ = ["my_module1"]


使用

from my_package import *

代码 , 导入整个软件包 ,

如下代码中 , 只有 my_module1 模块中的内容是可用的 , my_module2 模块无法被访问 ;

"""
自定义 Python 包 代码示例
"""

from my_package import *

my_module1.my_module1_print()
my_module2.my_module2_print()

执行结果 :

Y:\002_WorkSpace\PycharmProjects\pythonProject\venv\Scripts\python.exe Y:/002_WorkSpace/PycharmProjects/HelloPython/hello.py
my_package 的 my_module1 模块运行
Traceback (most recent call last):
  File "Y:\002_WorkSpace\PycharmProjects\HelloPython\hello.py", line 8, in <module>
    my_module2.my_module2_print()
NameError: name 'my_module2' is not defined. Did you mean: 'my_module1'?

Process finished with exit code 1

文章出处登录后可见!

已经登录?立即刷新

共计人评分,平均

到目前为止还没有投票!成为第一位评论此文章。

(0)
心中带点小风骚的头像心中带点小风骚普通用户
上一篇 2023年11月7日
下一篇 2023年11月7日

相关推荐