python中安裝包的方式有很多種：

1. 源碼包：python setup.py install
2. 在線安裝：pip install 包名（linux） / easy_install 包名(window)

python包在開發(fā)中十分常見，一般的使用套路是所有的功能做一個python模塊包，打包模塊，然后發(fā)布，安裝使用。打包和安裝包就是最常見的工作。學習中遇到distutils和setuptools兩種打包的工具，學習之后做筆記記錄。

distutils

distutils 是 python 標準庫的一部分，這個庫的目的是為開發(fā)者提供一種方便的打包方式， 同時為使用者提供方便的安裝方式。當我們開發(fā)了自己的模塊之后，使用distutils的setup.py打包。

一、完成功能python

hello.py

def hello_fun():
 print "i say hello to you"

二、建立setup.py文件

setup.py

from distutils.core import setup
setup(
 name="hello_module",
 version="1.0",
 author="ljk",
 author_email="wilber@sh.com",
 py_modules=['hello'],
)

三、執(zhí)行打包命令

再次查看當前目錄下自動生成了一個文件夾dist，文件夾中有一個壓縮包即為我們的目標文件。另外有一個記錄文件MANIFEST。

四、安裝模塊

hello_module-1.0.tar.gz 是生成的python模塊。切換到的我的python虛擬環(huán)境中，安裝該模塊。

使用python setup.py install 安裝該模塊。從路徑可以看出，該模塊安裝到標準庫的制定路徑下。

五、使用模塊

 安裝好模塊之后，在python的交互環(huán)境中導入模塊。模塊就是hello.py文件，引用hello.py文件中的hello_fun()函數(shù)。

setuptools

setuptools是distutils的增強版。setuptools有一個entry_points功能很方便，類似linux啟動某個服務，如在linux命令行里firefox能啟動火狐瀏覽器。

首先檢驗沒有安裝之前，命令path沒有作用。

 一、創(chuàng)建功能包

創(chuàng)建一個文件夾demo，在文件夾里創(chuàng)建get_path.py和__init__.py兩個文件。get_path.py是功能函數(shù)，__init__.py是包的標識文件。

get_path.py

import os
def fun():
 print "i am in the path:"
 print os.getcwd() 

二、配置setup.py文件

創(chuàng)建setup.py文件，填寫必要的打包信息。

 setup.py

#-*- encoding: UTF-8 -*-
from setuptools import setup
setup(
 name = "demo",    # 包名
 version = "0.1",    # 版本信息
 packages = ['demo'],   # 要打包的項目文件夾
 include_package_data=True, # 自動打包文件夾內(nèi)所有數(shù)據(jù)
 zip_safe=True,    # 設定項目包為安全，不用每次都檢測其安全性
 install_requires = [   # 安裝依賴的其他包（測試數(shù)據(jù)）
 'docutils>=0.3',
 'requests',
 ],
 # 設置程序的入口為path
 # 安裝后，命令行執(zhí)行path相當于調(diào)用get_path.py中的fun方法
 entry_points={
  'console_scripts':[
   'path = demo.get_path:fun'
          ]
 },
)
<br data-filtered="filtered"><br data-filtered="filtered">

在配置中將該模塊需要的依賴全部都寫好，安裝時指定地址去下載。這種方式簡化了使用時的安裝過程，但是還不夠好。最好的方式是pip的自動下載。

三、打包

打包之后多出兩個文件夾，分別是demo.egg-info和dist。demo.egg-info是必要的安裝信息，而dist中的壓縮包就是安裝包。

 查看dist/demo-0.1.tar.gz解壓之后的文件。

四、安裝包

五、使用包

安裝之后在命令行中直接輸入path，回車能夠看到調(diào)用了get_path.py中的函數(shù)fun()，輸出字符串。

同時也可以導入使用。

 setuptools的進階使用

上面使用setuptools時只是簡單的用一個配置文件setup.py就完成了打包信息填寫。在真實的開發(fā)環(huán)境中，往往是多個文件配合。以openstack的打包為例。openstack中引入了Pbr的管理工具。

pbr是setuptools的輔助工具，最初為openstack開發(fā)，基于d2to1。Pbr會讀取和過濾setup.cfg中的內(nèi)容，然后將解析后的數(shù)據(jù)提供給setup.py作為參數(shù)。

setup.cfg提供setup.py的默認參數(shù)，同時易于修改。Setup.py先解析setup.cfg文件，然后執(zhí)行相關命令。包括以下功能：

1、從git中獲取Version，AUTHORS和ChangeLog信息

2、SphinxAutodoc。pbr會掃描project，找到所有模塊，生成stubfiles

3、Requirements。讀取requirements.txt文件，生成setup函數(shù)需要依賴包

4、long_description。從README.rst、README.txt或者READMEfile中生成long_description參數(shù)

Pbr的文件很簡單，如下。配置之后會自動尋找目錄下的setup.cfg文件，解析文件參數(shù)給setup.py使用。

setup.py

from setuptools import setup
setuptools.setup(
setup_requires=['pbr'],
pbr=True)
setup.cfg

[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

總結(jié)

以上所述是小編給大家介紹的python打包工具distutils、setuptools ，希望對大家有所幫助，如果大家有任何疑問請給我留言，小編會及時回復大家的。在此也非常感謝大家對腳本之家網(wǎng)站的支持！

最新評論