python项目打包成whl文件

目录

1单个py文件打包

2文件夹下多个py文件打包

2.1__init__.py的作用

2.2setup.py重要参数

2.3打包过程

---

1单个py文件打包

同一文件夹下生成打包py文件与setup.py文件。

生成测试的te11.py文件。

def jia(x,y):
    return x+y

z = 100

生成打包的setup.py文件 

from setuptools import setup
setup(name='te11',
      version='1.0',
      py_modules=['te11'],
      )

win+R  在cmd中转到当前文件夹 

输入如下代码打包。

python setup.py bdist_wheel

 打包完成，在同目录下的dist文件夹找到whl文件。

pip安装包

pip install D:\工作\代码打包\dist\te11-1.0-py3-none-any.whl

导入包检验模块。

import过程中会运行py文件内所有代码，可对变量赋值直接导入，也可以运行读取保存操作。 

 

2文件夹下多个py文件打包

2.1__init__.py的作用

__init__.py 文件的作用是将文件夹变为一个Python模块,Python 中的每个模块的包中，都有__init__.py 文件。通常__init__.py 文件为空，但是我们还可以为它增加其他的功能。我们在导入一个包时，实际上是导入了它的__init__.py文件。这样我们可以在__init__.py文件中批量导入我们所需要的模块，而不再需要一个一个的导入。

# package
# __init__.py
import a
import b
import c
import d

# test.py
import package 
print(package.a, package.b, package.c, package.d)

使用__all__将__init__.py文件中__all__列表中的模块和包导入到当前文件中来。

# __init__.py
__all__ = ['a', 'b', 'c', 'd']

# test.py
from package import *

2.2setup.py重要参数

--name 包名称------------生成的egg名称
--version (-V) 包版本----生成egg包的版本号
--author 程序的作者------包的制作者名字
--author_email 程序的作者的邮箱地址
--maintainer 维护者
--maintainer_email 维护者的邮箱地址
--url 程序的官网地址
--license 程序的授权信息
--description 程序的简单描述-------程序的概要介绍
--long_description 程序的详细描述---程序的详细描述
--platforms 程序适用的软件平台列表
--classifiers 程序的所属分类列表
--keywords 程序的关键字列表
--packages 需要处理的包目录（包含__init__.py的文件夹）-------和setup.py同一目录下搜索各个含有 init.py的包
--py_modules 需要打包的python文件列表
--download_url 程序的下载地址
--cmdclass
--data_files 打包时需要打包的数据文件，如图片，配置文件等
--scripts 安装时需要执行的脚步列表
--package_dir 告诉setuptools哪些目录下的文件被映射到哪个源码包。一个例子：package_dir = {'': 'lib'}，表示“root package”中的模块都在lib 目录中。
--requires 定义依赖哪些模块
--provides定义可以为哪些模块提供依赖
--find_packages() 对于简单工程来说，手动增加packages参数很容易，刚刚我们用到了这个函数，它默认在和setup.py同一目录下搜索各个含有 init.py的包。
其实我们可以将包统一放在一个src目录中，另外，这个包内可能还有aaa.txt文件和data数据文件夹。另外，也可以排除一些特定的包
find_packages(exclude=[".tests", ".tests.", "tests.", "tests"])
--install_requires = ["requests"] 需要安装的依赖包
--entry_points 动态发现服务和插件。

样例：

from setuptools import setup, find_packages
setup(
    name="prml",
    version="0.0.1",
    description="Collection of PRML algorithms",
    author="ctgk",
    python_requires=">=3.6",
    install_requires=["numpy", "scipy"],#需要安装的依赖
    packages=find_packages(exclude=["test", "test.*"]), # 需要打包的package,使用            
    find_packages 来动态获取package，exclude参数的存在，使打包的时候，排除掉这些文件
    test_suite="test"
    )

2.3打包过程

生成打包文件，具体文件目录格式如下，setup.py需要和装有多个py文件的文件夹同目录，__init__.py为空。

promax/
    __init__.py
    te11.py
    te22.py
setup.py

te11.py

def jia(x,y):
    return x+y

z = 100

te22.py

def jia(x,y):
    return x+y

def jian(x,y):
    return x-y

import pandas as pd

print(11111)

setup.py

from setuptools import setup, find_packages
 
setup(name='promax',
      version='0.0.1',
      description='test for zip',
      author='Fyx',
      author_email='2290906844@qq.com',
      packages=['promax'], 
      #packages=find_packages()可替换上个packages,可自动寻找到所有文件，当promax下有多文件夹时            
      #可用
      )

cmd转到该文件目录进行打包。

python setup.py bdist_wheel

pip安装后测试结果如下：

由于te22为模块之前有导入过，系统默认不再次导入，11111没有print，可加入reload，重新导入模块。

from imp import reload
reload(promax.te22)

到此已经可以完成python项目打包whl了。