Python----setuptools模块用法(python setup()函数)

网友投稿 932 2022-09-04


Python----setuptools模块用法(python setup()函数)

1 setuptools 安装,执行如下命令即可:

pip install

如下表示已经安装ok

(PythonBaseEnv) G:\study\pkg_01>pip install --upgrade setuptoolsCollecting setuptools Downloading setuptools-49.2.1-py3-none-any.whl (789 kB) |████████████████████████████████| 789 kB 273 kB/sInstalling collected packages: setuptools Attempting uninstall: setuptools Found existing installation: setuptools 49.2.0.post20200714 Uninstalling setuptools-49.2.0.post20200714: Successfully uninstalled setuptools-49.2.0.post20200714Successfully installed setuptools-49.2.1

2 将最简单的pkg_01 的包打包为.tar.gz的源码包

(1) 创建如下文件目录

pkg_01 |----pkg_01 | |----__init__.py | |----math | |----__init__.py | |----common.py |----setup.py

(2) 在setup.py文件中编写如下代码:

from setuptools import setup, find_packagessetup( name="pkg_01", version="0.0.1", package=find_packages(),)

(3) 在 pkg_01.math.common.py中写一个加法的函数

def add(a,b): return (a+b)

(4) 在cmd或者pycharm的终端中切换到pkg_01的根目录中,然后执行如下命令即可打包一个最简单的.tar.gz包

python setup.py sdist --format=gztar

(5) 在cmd或者pycharm的终端中继续执行如下命令对我们上面打的包进行安装

pip install

(6) 进入python交互式环境中,对上面的安装的pkg_01的包进行测试,如下,表示pkg_01已经安装ok,并且add方法功能也正常

(PythonBaseEnv) G:\study\pkg_01>pythonPython 3.8.3 (default, Jul 2 2020, 17:30:36) [MSC v.1916 64 bit (AMD64)] :: Anaconda, Inc. on win32Type "help", "copyright", "credits" or "license" for more information.>>> from pkg_01.math.common import add>>> a=add(100,200)>>> a300>>>

(7)源码包一般常用的就是.tar.gz和.zip包

3 将上述最简单的pkg_01打包为windows标砖软件msi格式

(1) 在cmd或者pycharm的终端中执行如下命令:

python setup bdist --format=msi

执行结果如下:

(PythonBaseEnv) G:\study\pkg_01>python setup.py bdist --format=msiD:\Miniconda\envs\PythonBaseEnv\lib\distutils\dist.py:274: UserWarning: Unknown distribution option: 'package' warnings.warn(msg)running bdistrunning bdist_msirunning buildinstalling to build\bdist.win-amd64\msirunning install_egg_inforunning egg_infowriting pkg_01.egg-info\PKG-INFOwriting dependency_links to pkg_01.egg-info\dependency_links.txtwriting top-level names to pkg_01.egg-info\top_level.txtreading manifest file 'pkg_01.egg-info\SOURCES.txt'writing manifest file 'pkg_01.egg-info\SOURCES.txt'Copying pkg_01.egg-info to build\bdist.win-amd64\msi\Lib\site-packages\pkg_01-0.0.1-py3.8.egg-inforunning install_scriptsremoving 'build\bdist.win-amd64\msi' (and everything under it)

(2)执行如下命令将已经安装的pkg_01的包卸载掉

pip uninstall pkg_01

4 将pkg_01包打包为rpm包

(1) 首先将pkg_01的源码上传至linux,在windows上是无法打包rpm包的(2) 在linux上首先执行pip list,确保当前pkg_01在linux上是没有安装

(base) [root@redrose2100 pkg_01]# pwd/opt/pkg_01(base) [root@redrose2100 pkg_01]# pip listPackage Version---------------------- -------------------certifi 2020.4.5.1cffi 1.14.0chardet 3.0.4conda 4.8.3conda-package-handling 1.7.0cryptography 2.9.2idna 2.9pip 20.0.2pycosat 0.6.3pycparser 2.20pyOpenSSL 19.1.0PySocks 1.7.1requests 2.23.0ruamel-yaml 0.15.87setuptools 46.4.0.post20200518six 1.14.0tqdm 4.46.0urllib3 1.25.8wheel 0.34.2(base) [root@redrose2100 pkg_01]#

(3) 进入到pkg_01目录下,执行如下命令将pkg_01打包为rpm包

python setup.py bdist --format=rpm

则会在dist目录下生成如下三个文件,两个rpm和一个tar.gz

(base) [root@redrose2100 pkg_01]# ls dist/

(4) 然后可以安装pkg_01-0.0.1-1.noarch.rpm包

rpm -ivh dist/pkg_01-0.0.1-1.noarch.rpm(base) [root@redrose2100 pkg_01]# rpm -ivh dist/pkg_01-0.0.1-1.noarch.rpmPreparing... ################################# [100%]Updating / installing... 1:pkg_01-0.0.1-1 ################################# [100%]

(5) 再次执行pip list,发现此时pkg-01已经安装ok了

(base) [root@redrose2100 pkg_01]# pip listPackage Version---------------------- -------------------certifi 2020.4.5.1cffi 1.14.0chardet 3.0.4conda 4.8.3conda-package-handling 1.7.0cryptography 2.9.2idna 2.9pip 20.0.2pkg-01 0.0.1pycosat 0.6.3pycparser 2.20pyOpenSSL 19.1.0PySocks 1.7.1requests 2.23.0ruamel-yaml 0.15.87setuptools 46.4.0.post20200518six 1.14.0tqdm 4.46.0urllib3 1.25.8wheel 0.34.2(base) [root@redrose2100 pkg_01]#

5 打包方式常用的基本就上面集中,下面重点就是详细配置setup.py文件了

名称

含义

name

包的名称

version

软件包的版本号

description

软件包的描述

long_description

软件包的详细描述

long_description_context_type

软件包详细描述的类型,比如text/markdown

author

软件包的作者

author_email

软件包的作者的邮件地址

maintainer

当前维护者

maintainer_email

当前维护者的电子邮箱

url

指定软件包主页的url

download_url

指定要下载软件包的url

package

指定setuptools将操作的软件包

py_modules

指定setuptools将操作的模块

scripts

用于呀构建和安装的独立脚本文件

ext_package

软件包提供的扩展的基本软件包

ext_module

指定要构建的python扩展列表的实例列表

classifiers

描述程序包类别的字符串列表

distclass

要使用的子类

script_name

用于是定setup.py脚本的名称,默认为 sys.argv[0]

script_args

用于指定setup.py脚本的参数列表

options

用于给setup.py脚本提供的默认的options

license

指定软件包的约束协议

keywords

用于描述元数据的字符串列表或者逗号隔开的字符串

platform

字符串列表或者逗号隔开的字符串,表示软件支持的平台

cmdclass

字典提供命令名到Command子类的映射

data_files

指定要分发的文件列表

package_dir

提供程序包到目录名称的映射

install_requires

安装依赖

include_package_data

如果设置为True,setuptools则表示将在MANIFEST.in文件指定的包目录中自动包含找到的所有数据文件

exclude_package_data

字典将包名称映射到应从包目录中排除的全局模式列表。您可以使用它来修剪包含的所有多余文件include_package_data

package_data

包数据文件

entry_points

字典将入口点组名称映射到定义入口点的字符串或字符串列表。入口点用于支持动态发现项目提供的服务或插件

python_requires

与Python版本的版本说明符(在PEP 440中定义)相对应的字符串

namespace_packages

命名项目的“命名空间包”的字符串列表。名称空间包是可以拆分为多个项目发行版的包

6 将pkg_01包继续丰富,最后上传至github以及pypi上

(1) 在工程根目录新建一个README.rst文件,文件内容比如如下:采用markdown语法

#### 功能:用于演示一个简单打包流程以及上传pypi流程的包

(2) 将代码包上传至github:将setup.py文件丰富为如下内容:

from setuptools import setup, find_packagessetup( name="pkg_01", version="0.0.1", descriptions=("used to demo distribute python package"), package=find_packages(), author="redrose2100", author_email="hitredrose@163.com", license="GPLv3", url=" install_requires=[])

(4) 在pypi上注册账号,并邮件激活(5) windows在C:\Users\Administrator 目录下创建 .pypirc文件,内容为:

[distutils]index-servers =pypi[pypi]

(6) 使用如下命令安装twine

pip install

(7) 执行如下命令将打的包上传

twine upload dist/*

执行结果如下:

(PythonBaseEnv) G:\study\pkg_01>twine upload dist/*Uploading distributions to pkg_01-0.0.1.tar.gz100%|██████████████████████████████████████████████████████████████████████████████████100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 3.62k/3.62k [00:04<00:00, 826B/s]View at:G:\study\pkg_01>

打开浏览器 输入 既可以看到发布的包了


版权声明:本文内容由网络用户投稿,版权归原作者所有,本站不拥有其著作权,亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容,请联系我们jiasou666@gmail.com 处理,核实后本网站将在24小时内删除侵权内容。

上一篇:mybatisPlus 实体类与数据库表映射关系详解
下一篇:Java在指定路径下执行cmd命令的方法(cmd进入路径执行命令)
相关文章

 发表评论

暂时没有评论,来抢沙发吧~