前言

setuptools可以帮助我们创建和分发Python包，而当用户在使用setuptools创建的包时，就可以像调用标准库或者是python第三方库那样直接使用，并不需要安装setuptools，只要一个启动模块就可以。

一、安装

# 
pip install setuptools

二、源码包介绍

首先python库的打包分发方式有两种：源码包source dist（sdist）、二进制包binary dist（bdist）。

2-1、源码包sdist

2-1-1、打包成源码包sdist

python setup.py sdist
# 源码包sdist就是我们熟悉的.zip、.tar.gz等后缀文件，就是一个压缩包。
# setup.py 在第三里会介绍，它指定了打包分发的一些配置信息。
# 不指定格式的话，sdist会根据当前平台创建默认格式，在类 Unix 平台上，将创建后缀名为.tar.gz分发包，而在Windows上为 .zip 文件。
# 加参数可以指定文件格式 --formats=gztar

2-1-2、安装源码包

打包后的文件在新生成的dist文件夹下，以及多了一些中间临时配置信息（egg-info文件）
先把源码包进行解压缩，之后再执行setup.py

python setup.py install

或者是用pip命令直接安装源码包

pip install xxx.zip
# notice：该命令会将当前的Python应用安装到当前的Python环境的“site-packages”目录下，这样其他程序就可以像导入标准库一样导入该应用的代码了

2-2、二进制包bdist

2-2-1、打包成源码包bdist

与源码包相比，二进制包的特点是不用再编译，也就是安装更快。

# python目前主流的二进制包格式是wheel（.whl后缀），它的前身是egg。wheel本质也还是一个压缩包，可以像zip一样解压缩。还有其他一些格式诸如rpm、wininst等。
# 在使用wheel之前，需要先安装wheel： pip install wheel
# 这里以打包成rpm格式为例：
python setup.py bdist --format=rpm
# 等价于
python setup.py build_rpm
# 等价于
python setup.py bdist_rpm

# 还有目前的主流二进制包，wheel是目前官方推荐的打包方式。
python setup.py build_wheel 
# 等价于
python setup.py bdist_wheel

# 生成源码包的路径和sdist相同
# eg: 如果使用bdist_wininst,打出来的是exe安装文件，可以点击安装

2-2-2、安装源码包bdist

pip install xxx.whl

三、setup文件以及相关参数介绍

3-1、setup文件简介

构建前的结构应该包含：

# notice: 应该包含文件夹：demo、dist、docs，包含代码文件setup.py

setup.py文件：

# encoding: utf-8
from setuptools import setup, find_packages

import refrigerator_apc

setup(
	  # name: 应用名, 即包名
	  name='refrigerator_apc',
	  # version：版本号
      version=refrigerator_apc.__version__,
      # 包括在安装包内的Python包
      packages=find_packages(),
      # author：作者名
      author='wang',
      # author_email: 作者邮箱
      # description: 描述
      # url: 项目主页
      # python_requires: 对python版本进行限制。
      python_requires='>=3.6',
      platforms='any',
      # install_requires: 自动安装依赖
      install_requires=[
          "pandas",
          "numpy",
      ]
      )

3-2、setup其他参数介绍

3-2-1、find_packages()函数和find_namespace_packages()函数

这两个函数都是用来指定packages参数的，而packages参数是用来指示打包分发时需要包含的package，类型为list[str]
1、find_packages()函数：

# 只会打包包含__init__.py的package以及setup.py文件
# notice:假设包含__init__.py的文件夹里还有一个文件data，data文件夹里没有__init__.py，那么data文件将不会被打包

from setuptools import setup
setup(
	packages=find_packages()
)

2、find_namespace_packages()函数

# 为了打包所有的文件，我们会使用find_namespace_packages()函数

from setuptools import setup
setup(
	packages=find_namespace_packages()
	# notice: 如果只想指定某个文件夹，那么我们可以直接在find_namespace_packages中加参数。
	# packages=find_namespace_packages('src')
)

3-2-2、include_package_data（MANIFEST.in）

find_packages()函数和find_namespace_packages()函数打包的是源码文件和setup.py文件。非源码文件(如.dat和.txt文件)需要别的参数（include_package_data）来打包

# include_package_data：bool类型，默认为True，当为True时，根据MANIFEST.in文件来打包分发库

3-2-3、MANIFEST.in 文件介绍

# define: 该文件指定了一些语法规则，主要是用来打包非源码文件的
# 
include pat1: 添加与任何列出的模式匹配得所有文件
exclude pat1: 删除
recursive-include dir-pattern pat1: 递归dir-pattern及其子文件夹，添加
recursive-exclude dir-pattern pat1: 删除
graft dir-pattern: 添加匹配目录下的所有文件
prune dir-pattern: 删除
global-include pat1

# eg:
include src/pack1/*.txt
# 更多信息请参考结尾第二个链接

3-2-4、依赖包安装与版本管理

from setuptools import setup,find_packages
setup(
    # 表明当前模块依赖哪些包，若环境中没有，则会从pypi中自动下载安装
    # 只包含包名，这种形式只检查包的存在性，不检查版本。
	install_requires=['numpy']
    
    # setup.py本身要依赖的包，这里列出的包，不会自动安装
    setup_requires = ['']
    
    # 测试时使用的依赖
    # 执行python setup.py test时，可以自动安装，确保测试的正常运行
    tests_require=[
        # 自动保持版本为最新
    	'pandas>=3.1.1'
    	# 指定了版本，把风险降到了最低，确保了开发，测试与部署的版本一致，不会出现意外，但是不利于更新。
    	'tensorflow==2.7.1'
    ]
)