Python打包发布一条龙

今天介绍一下 Python 项目的打包及分发。

相关工具

distutils

distutils 是于2000年发布的 Python 项目创建打包工具。

但现在很少直接使用, 而是使用 setuptools 。

setuptools

setuptools 于2004年发布, 是 distutils 的增强版本, 包含 setup 和 find_packages 等常见函数。

另外它包含了 easy_install 这个包安装工具, 使用Eggs包来进行安装(扩展名为 .egg ), 如果你不幸用 Windows 做过 Python 开发, 应该对它不陌生。

另外现在在 macOS 的 Python 环境中也附带了这个工具。

常见用法如下:

1	$ easy_install redisdict-0.0.1-py2.7.egg

Eggs文件实际是一个压缩包, 解压后目录结构大致如下, 具体可以参看 The Internal Structure of Python Eggs¶


├── EGG-INFO


│   ├── PKG-INFO


│   ├── SOURCES.txt


│   ├── dependency_links.txt


│   ├── requires.txt


│   ├── top_level.txt


│   └── zip-safe


├── redisdict


│   ├── __init__.py

说到 Eggs 就得谈谈 Wheel, Wheel 是2012年发布的Python包格式, 类似于 Eggs , 其目录结构大致如下:


├── redisdict


│   └── __init__.py


└── redisdict-0.0.1.dist-info


├── DESCRIPTION.rst


├── METADATA


├── RECORD


├── WHEEL


├── metadata.json


└── top_level.txt

pip

pip 是 PyPA(Python Packaging Authority) 推荐、时下最主流的包安装工具, 发布于2013年, pip 支持从常见的VCS系统(例如git)进行安装, 也可以安装Eggs包, Wheel包。

使用 setuptools 打包

我们以 RedisDict 这个模块为例, 首先在项目中新建 setup.py 文件, 并引入 setuptools 。
之后使用 setuptools.setup 方法对项目进行打包, 方法的参数设定可以参看 setup-args 。

示例代码如下:


import setuptools


import codecs


def get_requirements(filename):


return codecs.open('requirements/' + filename, encoding='utf-8').read().splitlines()


setuptools.setup(


name='redisdict',


version='0.0.1',


packages=setuptools.find_packages(exclude=['tests', 'tests.*']),


url='https://github.com/kxrr/redisdict',


license='MIT',


author='kxrr',


author_email='hi@kxrr.us',


description='A dict-like object using Redis as the backend.',


install_requires=get_requirements('default.txt'),


tests_require=get_requirements('test.txt'),


)

之后, 我们可以使用下面命令将项目打包为压缩文件:


$ python setup.py check  # 检查


$ python setup.py sdist  # 打包为 .tar.gz 


$ python setup.py bdist_egg  #  创建 Eggs包


$ python setup.py bdist_wheel  # 创建 Wheel包

生成的文件均位于 dist 目录下:


dist


├── redisdict-0.0.1-py2-none-any.whl


├── redisdict-0.0.1-py2.7.egg


└── redisdict-0.0.1.tar.gz

别外也可以通过 setuptools 将项目打包成其它格式(比如exe), 有兴趣的可以自己看看。

分发

发布到自建 PyPI Server

只需要通过 scp 命令将打好的包传到我们的 PyPI Server 上去:

1	$ scp dist/redisdict-0.0.1-py2.py3-none-any.whl deploy@pypi.pinbot.me:/home/deploy/packages

上传完成后可以使用 pip 进行安装:

1	$ pip install redisdict -i http://pypi.pinbot.me/simple/ --trusted-host pypi.pinbot.me

发布到官方 PyPI Server

首先到 PyPI 注册一个帐号, 在邮箱内确认。

之后在家目录新建一个 .pypirc 文件, 写入下面内容(注意填入自己的帐号密码):


[pypirc]


servers = pypi


[server-login]


username:username


password:password

接下来就可以开始上传了:

1 2	$ python setup.py register # 将包注册到 PyPI $ python setup.py register sdist upload # 上传

运行过后根据提示操作即可发布完成。

Packaging User Guide: https://packaging.python.org/key_projects/
Celery setup.py: https://github.com/celery/celery/blob/master/setup.py
What was the problem with packaging?: http://pythonhosted.org/distlib/overview.html#what-was-the-problem-with-packaging
Uploading your project to pypi: https://packaging.python.org/distributing/#uploading-your-project-to-pypi

Python打包发布一条龙

相关工具

distutils

setuptools

pip

使用 setuptools 打包

分发

发布到自建 PyPI Server

发布到官方 PyPI Server

Trending Articles

《沈冰自述——我和周永康的故事》全本

Moog - Subsequent 25

出售: 林憶蓮•回來愛的身邊 (東芝1A1頭版)

筆記 - 使用 PowerShell 清除停用 AD 帳號與 OU

df-dferh-01 中国区 Android 安装 Google Play Store 后报错的解决办法

「一棒接一棒、棒棒強棒」108學年度家長會長交接典禮

吸烟与MBTI类型判断捷径 (豆瓣 INFJ的奇幻之旅小组)

acermark龍璿國際展出多款包裝設備

枋寮北勢寮隆山宮睽違12年再辦迎王祭典

日本女优有村千佳COS集锦：狂三&黑白岩&亚丝娜&绫波丽

有遇到过这个问题么。/jsb-videoplayer.js not found, possible missing file.

MAS v2.8 magicgenius 汉化版 - 11.11更新

出售: Monster Cable Interlink Reference 2

福建佛教人士望云和尚(林斌)的九仙禅寺被强行收走，望云妈妈被赶出寺庙

R 语言中的OpenBLAS*和英特尔® 数学核心函数库的性能比较

[转载]煞貢、直星、人專吉日\金神七煞歌

HAKERS哈克士戶外 12月8~14日廠拍

OBS Studio 23.2.1 免安裝中文版 - 免費網路實況廣播軟體實況主必備軟體取代Fraps

<請教>行駛中安卓機會重新開機

Udp2raw-tunnel 及其一键安装脚本