- 源码包：python setup.py install
- 在线安装：pip install 包名（linux） / easy_install 包名(window)
python包在开发中十分常见，通常的使用套路是全部的功能作一个python模块包，打包模块，而后发布，安装使用。打包和安装包就是最多见的工做。学习中遇到distutils和setuptools两种打包的工具，学习以后作笔记记录。linux
distutils
distutils 是 python 标准库的一部分，这个库的目的是为开发者提供一种方便的打包方式， 同时为使用者提供方便的安装方式。当咱们开发了本身的模块以后，使用distutils的setup.py打包。git
1、完成功能python浏览器
hello.py安全
|
1
2
|
def hello_fun():
print
"i say hello to you"
|
2、创建setup.py文件dom
setup.pysvn
|
1
2
3
4
5
6
7
8
9
|
from
distutils.core import setup
setup(
name=
"hello_module"
,
version=
"1.0"
,
author=
"ljk"
,
author_email=
"wilber@sh.com"
,
py_modules=[
'hello'
],
)
|
3、执行打包命令函数
|
1
|
python setup sdist
|
再次查看当前目录下自动生成了一个文件夹dist，文件夹中有一个压缩包即为咱们的目标文件。另外有一个记录文件MANIFEST。工具
4、安装模块post
hello_module-1.0.tar.gz 是生成的python模块。切换到的个人python虚拟环境中，安装该模块。
使用python setup.py install 安装该模块。从路径能够看出，该模块安装到标准库的制定路径下。
5、使用模块
安装好模块以后，在python的交互环境中导入模块。模块就是hello.py文件，引用hello.py文件中的hello_fun()函数。
setuptools
setuptools是distutils的加强版。setuptools有一个entry_points功能很方便，相似linux启动某个服务，如在linux命令行里firefox能启动火狐浏览器。
首先检验没有安装以前，命令path没有做用。
1、建立功能包
建立一个文件夹demo，在文件夹里建立get_path.py和__init__.py两个文件。get_path.py是功能函数，__init__.py是包的标识文件。
get_path.py
|
1
2
3
4
5
|
import os
def fun():
print
"i am in the path:"
print os.getcwd()
|
2、配置setup.py文件
建立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
|
#-*- encoding: UTF-8 -*-
from
setuptools import setup
setup(
name =
"demo"
, # 包名
version =
"0.1"
, # 版本信息
packages = [
'demo'
], # 要打包的项目文件夹
include_package_data=True, # 自动打包文件夹内全部数据
zip_safe=True, # 设定项目包为安全，不用每次都检测其安全性
install_requires = [ # 安装依赖的其余包（测试数据）
'docutils>=0.3'
,
'requests'
,
],
# 设置程序的入口为path
# 安装后，命令行执行path至关于调用get_path.py中的fun方法
entry_points={
'console_scripts'
:[
'path = demo.get_path:fun'
]
},
)
<br><br>
|
在配置中将该模块须要的依赖所有都写好，安装时指定地址去下载。这种方式简化了使用时的安装过程，可是还不够好。最好的方式是pip的自动下载。
3、打包
|
1
|
python setup.py sdist
|
打包以后多出两个文件夹，分别是demo.egg-info和dist。demo.egg-info是必要的安装信息，而dist中的压缩包就是安装包。
查看dist/demo-0.1.tar.gz解压以后的文件。
4、安装包
5、使用包
安装以后在命令行中直接输入path，回车可以看到调用了get_path.py中的函数fun()，输出字符串。
同时也能够导入使用。
setuptools的进阶使用
上面使用setuptools时只是简单的用一个配置文件setup.py就完成了打包信息填写。在真实的开发环境中，每每是多个文件配合。以openstack的打包为例。openstack中引入了Pbr的管理工具。
pbr是setuptools的辅助工具，最初为openstack开发，基于d2to1。Pbr会读取和过滤setup.cfg中的内容，而后将解析后的数据提供给setup.py做为参数。 setup.cfg提供setup.py的默认参数，同时易于修改。Setup.py先解析setup.cfg文件，而后执行相关命令。包括如下功能： 一、从git中获取Version，AUTHORS和ChangeLog信息 二、SphinxAutodoc。pbr会扫描project，找到全部模块，生成stubfiles 三、Requirements。读取requirements.txt文件，生成setup函数须要依赖包 四、long_description。从README.rst、README.txt或者READMEfile中生成long_description参数
Pbr的文件很简单，以下。配置以后会自动寻找目录下的setup.cfg文件，解析文件参数给setup.py使用。
setup.py
|
1
2
3
4
5
6
7
8
|
from
setuptools import setup
setuptools.setup(
setup_requires=[
'pbr'
],
pbr=True)
|
setup.cfg
|
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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
|
[metadata]
name= keystone
version= 2015.2
summary= OpenStack Identity
description-file=
README.rst
author= OpenStack
author-email= openstack-dev@lists.openstack.org
home-page= http:
//www.openstack.org/
classifier=
Environment:: OpenStack
IntendedAudience :: Information Technology
IntendedAudience :: System Administrators
License:: OSI Approved :: Apache Software License
OperatingSystem :: POSIX :: Linux
ProgrammingLanguage :: Python
ProgrammingLanguage :: Python :: 2
ProgrammingLanguage :: Python :: 2.7
[files]
packages=
keystone
[global]
setup-hooks=
pbr.hooks.setup_hook
[egg_info]
tag_build=
tag_date= 0
tag_svn_revision= 0
[build_sphinx]
all_files= 1
build-dir= doc/build
source-dir= doc/source
[compile_catalog]
directory= keystone/locale
domain= keystone
|