python 打包egg_python核心 - 打包与发布

当需要将写的程序打包分发出去的时候，就要使用到setuptools工具了，这里我通过一个实际例子来介绍它的使用方法。

之前写过一个rpc模块叫xnrpc：

软件包归档格式

Python的软件包一开始是没有官方的标准分发格式的。比如Java有jar包或者war包作为分发格式，Python则什么都没有。

后来不同的工具都开始引入一些比较通用的归档格式。比如，setuptools引入了Egg格式。

但是，这些都不是官方支持的，存在元数据和包结构彼此不兼容的问题。因此，为了解决这个问题，

PEP 427定义了新的分发包标准，名为Wheel。目前pip和setuptools工具都支持Wheel格式。

这里我们简单总结一下常用的分发格式：

tar.gz格式：这个就是标准压缩格式，里面包含了项目元数据和代码，可以使用Python setup.py sdist命令生成。

egg格式：这个本质上也是一个压缩文件，只是扩展名换了，里面也包含了项目元数据以及源代码。这个格式由setuptools项目引入。

可以通过命令Python setup.py bdist_egg命令生成。

whl格式：这个是Wheel包，也是一个压缩文件，只是扩展名换了，里面也包含了项目元数据和代码，还支持免安装直接运行。

whl分发包内的元数据和egg包是有些不同的。这个格式是由PEP 427引入的。可以通过命令Python setup.py bdist_wheel生成。

Python Wheels网站展示了使用Wheels发行的python模块在PyPI上的占有率，推荐使用wheel包。

.egg-info和.dist-info目录

如果你到系统中安装Python库的路径下看看，就能看到很多名称以.egg-info或者以.dist-info结尾的目录。这些目录的内容就是这个库的元数据，

是从库的分发包中拷贝出来的。其中.egg-info类型的目录来自于Egg格式的分发包，.dist-info类型的目录来自于Wheel格式的分发包

项目目录结构

xnrpc项目的目录结果如下

项目最顶层的目录为”xnrpc”，其中与打包最相关的文件是setup.py，

这里面最核心的文件就是这个setup.py了，我们看看里面写什么：

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54#!/usr/bin/env python

# -*- encoding: utf-8 -*-

from setuptools import setup, find_packages

setup(

name='xnrpc',

version='1.0.0',

packages = find_packages(),

# Project uses , so ensure

install_requires=[

"gevent>=1.1.2",

"zerorpc>=0.6.0",

],

description='simple rpc based on zerorpc and gevent',

long_description=open("README.rst").read(),

url='https://github.com/yidao620c/xnrpc',

author='Xiong Neng',

author_email='[email protected]',

license='Apache License 2.0',

classifiers=[

'Development Status :: 4 - Beta',

'Intended Audience :: Developers',

'Topic :: Software Development :: Build Tools',

'License :: OSI Approved :: MIT License',

'Programming Language :: Python :: 2.6',

'Programming Language :: Python :: 2.7',

'Programming Language :: Python :: 3',

'Programming Language :: Python :: 3.3',

'Programming Language :: Python :: 3.4',

'Programming Language :: Python :: 3.5',

],

package_data = {

# If any package contains *.txt or *.rst files, include them:

'': ['*.txt', '*.rst'],

# include any *.msg files found in the 'test' package, too:

'test': ['*.msg'],

},

# The data_files option can be used to specify additional files

# needed by the module distribution: configuration files,

# message catalogs, data files

data_files=[('etc/xnrpc', ['etc/xnrpc.conf']), ],

cmdclass={'install': CustomInstallCommand},

keywords=['xnrpc', 'gevent', 'zerorpc'],

entry_points={

# "xnrpc.registered_commands": [

# "upload = xnrpc.commands.upload:main",

# "register = xnrpc.commands.register:main",

# ],

"console_scripts": [

"xnrpc = xnrpc.__main__:main",

],

},

)

name -> 为项目名称，和顶层目录名称一致;

version -> 是项目当前的版本，1.0.0.dev1表示1.0.0版，目前还处于开发阶段

description -> 是包的简单描述，这个包是做什么的

long_description -> 这是项目的详细描述，出现在pypi软件的首页上

url -> 为项目访问地址，我的项目放在github上。

author -> 为项目开发人员名称

author_email -> 为项目开发人员联系邮件

license -> 为本项目遵循的授权许可

classifiers -> 有很多设置，具体内容可以参考官方文档

keywords -> 是本项目的关键词，理解为标签

packages -> 是本项目包含哪些包，使用工具函数自动发现包

package_data -> 通常包含与包实现相关的文件

data_files -> 指定其他的一些文件(如配置文件)

cmdclass -> build或install的时候执行的额外操作

entry_points -> 可以定义安装该模块后执行的脚本，比如将某个函数作为linux命令

这里面重点讲解三个：

package_data 通常包含与包实现相关的文件。打包的时候会自动包括进去

data_files 指定其他的一些文件(如配置文件并放置在指定的目录)，

如果目录名是相对路径，则是相对于sys.prefix或sys.exec_prefix的路径

cmdclass build或install的时候执行的额外操作

还有一个文件MANIFEST.in定义了打源码包的时候需要包含的文件，一个示例如下：

1

2

3

4

5

6

7include LICENSE

include README.rst

include README.md

include AUTHORS

recursive-include tests *.py

recursive-include etc *.conf

项目打包1

2cd xnrpc/

python setup.py sdist bdist_wheel

如果报错：invalid command ‘bdist_wheel’，则先安装下wheel模块：

1pip install wheel

执行完后，在顶层项目目录下将产生几个新的目录：

注册PyPI帐号

如果没有账号需要先在PyPI网站上注册账号。

在您的本机用户下创建~/.pypirc文件，此文件中配置PyPI访问地址和账号。下面是我的.pypirc文件内容请根据自己的账号来修改。

1

2

3

4

5

6

7[distutils]

index-servers = pypi

[pypi]

repository=http://pypi.python.org/pypi

username=yidao620c

password=********

注册项目1python setup.py register

如果报错：

Server response (403): Must access using HTTPS instead of HTTP

解决方法：

1pip install twine

注册项目:

1

2twine register dist/xnrpc-1.0.0.tar.gz

twine register dist/xnrpc-1.0.0-py2-none-any.whl

通过上面.pypirc文件中的配置，在PyPI上注册项目信息，成功注册之后，可以在PyPI上看到自己的项目名称：

上传项目1

2

3# python setup.py sdist bdist_wheel upload

# 安装了twine使用

twine upload dist/*

通过上面.pypirc文件中的配置，上传打包文件，可以在PyPI上看到上传的项目文件：

恭喜你成功将你的软件包上传至PyPI上面，全世界的人都可以通过pip来安装了：

1pip install xnrpc

下载量分析

安装:

1pip install vanity

使用:

1

2vanity xnrpc

vanity xnrpc==1.0.0

pip包管理器

讲完了怎样打包发布，接下来我们来讲怎样使用这些包。一般都会使用到pip这个工具

安装pip

有几种方法安装pip

第1种使用get-pip.py来安装：

1

2curl "https://bootstrap.pypa.io/get-pip.py" -o "get-pip.py"

sudo python get-pip.py

第2种使用easy_install命令来安装：

先安装setuptools，上面也讲了打包也需要这个，直接源码安装，去pypi上面下载最新的tar包解压后执行：

1python setup.py install

然后使用easy_install来安装最新版的：

1sudo easy_install pip

或者去pypi上面下载最新源码来安装也行

使用pip

基本使用：

1

2

3

4

5

6

7

8

9

10# 安装

sudo pip install xnrpc

# 升级

sudo pip install -U xnrpc

# 卸载

sudo pip uninstall xnrpc

# 查询已经安装的包

pip list

# 查询可以安装的包

pip search xnrpc

其他有用的功能：

批量下载，读取requirements.txt，将里面指定的包(包括依赖包)下载到本地某个目录，不安装

1pip download -d "/root/packages/" -r requirements.txt

批量安装，pip从本地包安装

1pip install --no-index --find-links=/root/packages/ -r requirements.txt

下载指定的包到指定文件夹

1pip download -d /root/packages/ gevent

安装指定的离线包

1pip install --no-index --find-links=/root/packages/ gevent

虚拟环境

安装，同样两种方式，一种源码，一种是通过pip，这里我通过pip安装：

1sudo pip install -U virtualenv

创建一个独立于系统的虚拟环境

1virtualenv --no-site-packages --no-download django-mimo

基本使用

1

2

3

4

5

6

7

8

9

10

11# 激活

source django-mimo/bin/activate

# 退出

deactivate

# 删除，退出后直接删除django-mimo文件夹即可

# 安装包(激活后)

pip install Django

# 整体虚拟环境导出(激活后)

pip freeze > requirements.txt

# 整体虚拟环境导入(激活后)

pip install -r requirements.txt