使用setuptools库或pyinstaller库对python程序进行打包(附国内镜像源)
setuptools适用于打包成Python包,方便上传到PyPI或者本地安装。适用于打包成独立的可执行文件,适合不需要Python解释器的用户。不过由于网络原因,直接从 PyPI 安装 Python 包可能会导致下载速度较慢或者连接失败,因此很多用户选择使用国内的镜像源。
Python程序的打包可以通过多种方式实现,最常见的方法是使用setuptools
或者PyInstaller
。以下是如何使用这两种工具进行打包的简要说明:
1. 使用 setuptools
进行打包
setuptools
是Python的一个扩展库,通常用于构建、分发和安装Python包。
步骤:
-
安装 setuptools:
pip install setuptools
-
创建
setup.py
文件:
在项目的根目录下创建一个名为setup.py
的文件,内容如下:from setuptools import setup, find_packages setup( name='your_package_name', version='0.1', packages=find_packages(), install_requires=[ # 列出你的项目依赖的其他Python包 'requests', 'numpy', ], entry_points={ 'console_scripts': [ 'your_script_name=your_package.module:main_function', ], }, author='Your Name', description='A short description of your project', url='http://example.com', )
这里的
find_packages()
会自动查找项目中所有的Python包(即包含__init__.py
的目录)。修改name
,version
,install_requires
, 和entry_points
等字段以适应你的项目。 -
使用
setup.py
打包:
在终端中运行以下命令来打包你的项目:python setup.py sdist bdist_wheel
这条命令会生成两个主要的打包文件:
dist/your_package_name-0.1.tar.gz
(源码发行包)dist/your_package_name-0.1-py3-none-any.whl
(可执行二进制包)
-
安装和分发:
你可以使用pip
安装打包好的项目,或者将dist
目录中的文件上传到PyPI,供其他人下载安装。
2. 使用 PyInstaller
进行打包
PyInstaller
是一个简单的打包工具,可以将Python程序打包为独立的可执行文件(如 .exe
或 Unix 可执行文件)。
步骤:
-
安装 PyInstaller:
pip install pyinstaller
-
打包你的Python程序:
在终端中运行以下命令来打包你的Python脚本:pyinstaller --onefile your_script.py
your_script.py
是你的主脚本文件,--onefile
参数表示将所有文件打包成一个单独的可执行文件。 -
打包结果:
PyInstaller
会在dist
目录中生成可执行文件。你可以直接双击运行生成的可执行文件,或者分发给其他人。
总结
setuptools
适用于打包成Python包,方便上传到PyPI或者本地安装。PyInstaller
适用于打包成独立的可执行文件,适合不需要Python解释器的用户。
附录:
不过由于网络原因,直接从 PyPI 安装 Python 包可能会导致下载速度较慢或者连接失败,因此很多用户选择使用国内的镜像源。
常用的国内镜像源
以下是一些常用的国内 PyPI 镜像源,你可以在使用 pip install
时指定镜像源来提升下载速度:
-
清华大学镜像
https://pypi.tuna.tsinghua.edu.cn/simple
-
中国科技大学镜像
https://pypi.mirrors.ustc.edu.cn/simple/
-
阿里云镜像
https://mirrors.aliyun.com/pypi/simple/
-
豆瓣镜像
https://pypi.doubanio.com/simple/
-
华中科技大学镜像
https://pypi.hustunique.com/
使用方法
你可以通过以下命令来指定使用某个镜像安装 setuptools
:
pip install setuptools -i https://pypi.tuna.tsinghua.edu.cn/simple
如果你希望为整个 Python 环境设置默认镜像,可以在用户目录下创建或修改 pip
配置文件:
- Linux 和 macOS:
~/.pip/pip.conf
- Windows:
%USERPROFILE%\pip\pip.ini
在配置文件中添加如下内容:
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
这样以后使用 pip install
时就会默认使用指定的镜像源了。
示例安装命令
例如,使用清华的镜像安装 setuptools
的完整命令如下:
pip install setuptools -i https://pypi.tuna.tsinghua.edu.cn/simple
开放原子开发者工作坊旨在鼓励更多人参与开源活动,与志同道合的开发者们相互交流开发经验、分享开发心得、获取前沿技术趋势。工作坊有多种形式的开发者活动,如meetup、训练营等,主打技术交流,干货满满,真诚地邀请各位开发者共同参与!
更多推荐
所有评论(0)