gpt4 book ai didi

浅析python打包工具distutils、setuptools

转载 作者:qq735679552 更新时间:2022-09-28 22:32:09 26 4
gpt4 key购买 nike

CFSDN坚持开源创造价值,我们致力于搭建一个资源共享平台,让每一个IT人在这里找到属于你的精彩世界.

这篇CFSDN的博客文章浅析python打包工具distutils、setuptools由作者收集整理,如果你对这篇文章有兴趣,记得点赞哟.

python中安装包的方式有很多种:

  1. 源码包:python setup.py install
  2. 在线安装:pip install 包名(linux) / easy_install 包名(window)

python包在开发中十分常见,一般的使用套路是所有的功能做一个python模块包,打包模块,然后发布,安装使用。打包和安装包就是最常见的工作。学习中遇到distutils和setuptools两种打包的工具,学习之后做笔记记录.

distutils 。

distutils 是 python 标准库的一部分,这个库的目的是为开发者提供一种方便的打包方式, 同时为使用者提供方便的安装方式。当我们开发了自己的模块之后,使用distutils的setup.py打包.

1、完成功能python

  。

浅析python打包工具distutils、setuptools

hello.py 。

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

2、建立setup.py文件

  。

setup.py 。

?
1
2
3
4
5
6
7
8
from distutils.core import setup
setup(
  name = "hello_module" ,
  version = "1.0" ,
  author = "ljk" ,
  author_email = "wilber@sh.com" ,
  py_modules = [ 'hello' ],
)

3、执行打包命令

  。

浅析python打包工具distutils、setuptools

再次查看当前目录下自动生成了一个文件夹dist,文件夹中有一个压缩包即为我们的目标文件。另外有一个记录文件manifest.

浅析python打包工具distutils、setuptools

4、安装模块

  。

hello_module-1.0.tar.gz 是生成的python模块。切换到的我的python虚拟环境中,安装该模块.

浅析python打包工具distutils、setuptools

浅析python打包工具distutils、setuptools

使用python setup.py install 安装该模块。从路径可以看出,该模块安装到标准库的制定路径下.

浅析python打包工具distutils、setuptools

5、使用模块

  。

 安装好模块之后,在python的交互环境中导入模块。模块就是hello.py文件,引用hello.py文件中的hello_fun()函数.

浅析python打包工具distutils、setuptools

setuptools 。

setuptools是distutils的增强版。setuptools有一个entry_points功能很方便,类似linux启动某个服务,如在linux命令行里firefox能启动火狐浏览器.

首先检验没有安装之前,命令path没有作用.

浅析python打包工具distutils、setuptools

 1、创建功能包 。

创建一个文件夹demo,在文件夹里创建get_path.py和__init__.py两个文件。get_path.py是功能函数,__init__.py是包的标识文件.

浅析python打包工具distutils、setuptools

get_path.py 。

?
1
2
3
4
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
#-*- 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 data - filtered = "filtered" ><br data - filtered = "filtered" >

在配置中将该模块需要的依赖全部都写好,安装时指定地址去下载。这种方式简化了使用时的安装过程,但是还不够好。最好的方式是pip的自动下载.

3、打包 。

浅析python打包工具distutils、setuptools

打包之后多出两个文件夹,分别是demo.egg-info和dist。demo.egg-info是必要的安装信息,而dist中的压缩包就是安装包.

浅析python打包工具distutils、setuptools

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

浅析python打包工具distutils、setuptools

4、安装包 。

浅析python打包工具distutils、setuptools

5、使用包 。

安装之后在命令行中直接输入path,回车能够看到调用了get_path.py中的函数fun(),输出字符串.

浅析python打包工具distutils、setuptools

同时也可以导入使用.

浅析python打包工具distutils、setuptools

 setuptools的进阶使用 。

上面使用setuptools时只是简单的用一个配置文件setup.py就完成了打包信息填写。在真实的开发环境中,往往是多个文件配合。以openstack的打包为例。openstack中引入了pbr的管理工具.

pbr是setuptools的辅助工具,最初为openstack开发,基于d2to1。pbr会读取和过滤setup.cfg中的内容,然后将解析后的数据提供给setup.py作为参数.

setup.cfg提供setup.py的默认参数,同时易于修改。setup.py先解析setup.cfg文件,然后执行相关命令。包括以下功能:

1、从git中获取version,authors和changelog信息 。

2、sphinxautodoc。pbr会扫描project,找到所有模块,生成stubfiles 。

3、requirements。读取requirements.txt文件,生成setup函数需要依赖包 。

4、long_description。从readme.rst、readme.txt或者readmefile中生成long_description参数 。

pbr的文件很简单,如下。配置之后会自动寻找目录下的setup.cfg文件,解析文件参数给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
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

总结 。

以上所述是小编给大家介绍的python打包工具distutils、setuptools ,希望对大家有所帮助,如果大家有任何疑问请给我留言,小编会及时回复大家的。在此也非常感谢大家对我网站的支持! 。

原文链接:https://www.cnblogs.com/goldsunshine/p/8872623.html 。

最后此篇关于浅析python打包工具distutils、setuptools的文章就讲到这里了,如果你想了解更多关于浅析python打包工具distutils、setuptools的内容请搜索CFSDN的文章或继续浏览相关文章,希望大家以后支持我的博客! 。

26 4 0
Copyright 2021 - 2024 cfsdn All Rights Reserved 蜀ICP备2022000587号
广告合作:1813099741@qq.com 6ren.com