【python开发技术】python distutils setuptools学习

distutils 与 setuptools

distutils 包为将待构建和安装的额外的模块，打包成 Python 安装包提供支持。新模块既可以是百分百的纯 Python，也可以是用 C 写的扩展模块，或者可以是一组包含了同时用 Python 和 C 编码的 Python 包。

大多数 Python 用户不会想要直接使用这个包，而是使用 Python 包官方维护的跨版本工具。即：setuptools。 setuptools是一个对于 distutils 的增强选项，它能提供：

对声明项目依赖的支持
额外的用于配置哪些文件包含在源代码发布中的机制（包括与版本控制系统集成需要的插件）
生成项目“进入点”的能力，进入点可用作应用插件系统的基础
自动在安装时间生成 Windows 命令行可执行文件的能力，而不是需要预编译它们
跨所有受支持的 Python 版本上的一致的表现

一些基础概念说明

module 模块

python中代码重用的基本单元，可通过import语句导入，可分为pure python module、extension module 以及 package三种

pure python module

纯粹使用.py构建

extension module

扩展可采用底层C/C++编写，包含动态链接库，.so,dll等

package

带有__init__.py的文件夹，用于包含其它模块

root package

包的最顶层，它不是真的包，因为没有__init__.py，含有大量标准库，使用sys.path列举出来的文件夹都是root package：

['', 'D:\\Python36\\python36.zip', 'D:\\Python36\\DLLs', 'D:\\Python36\\lib', 'D:\\Python36', 'C:\\Users\\ZhangPY\\AppData\\Roaming\\Python\\Python36\\site-packages', 'D:\\Python36\\lib\\site-packages', 'D:\\Python36\\lib\\site-packages\\pycocotools-2.0-py3.6-win-amd64.egg', 'D:\\Python36\\lib\\site-packages\\maskrcnn_benchmark-0.1-py3.6-win-amd64.egg', 'D:\\Python36\\lib\\site-packages\\spn-1.0-py3.6.egg', 'D:\\Python36\\lib\\site-packages\\isic_challenge_scoring-0.0.0-py3.6.egg', 'D:\\Python36\\lib\\site-packages\\click_pathlib-2019.6.13.1-py3.6.egg', 'D:\\Python36\\lib\\site-packages\\click-7.0-py3.6.egg', 'D:\\Python36\\lib\\site-packages\\medpy-0.4.0-py3.6-win-amd64.egg']

distribution

模块分发，归档在一起的python模块集合，可作为可下载资源方便实用

distribution root

源代码树的最顶层，就是setup.py所在的位置

示例和分发选择

如果你只是发布几个脚本文件而已，特别是它们逻辑上不属于同一个包，你可以使用 py_modules 选项一个一个地指定；

如果你需要发布的模块文件太多，使用 py_modules 一个一个指定比较麻烦，特别是模块位于多个包中，那么你可以使用 packages 指定整个包，另外只需要另外指定 package_dir，位于 distribution root 下的模块文件也可以被处理；

setuptools 帮助文档声明，package_dir 和 py_modules 也可以支持分发任何没有包含 init.py 文件夹下的模块，经测试安装过程没有报错，但是没有包含 init.py 的文件夹下的模块是没有被正确安装的！因此，如果 python 模块分布在不同的文件夹，最好是在该文件夹下创建一个 init.py 文件，以表示它是一个包。

pure python module

举个简单的例子，你需要发布两个模块 foo 以及 bar.bar，以供别人使用(import foo 和 import bar.bar)。其目录树如下：

pure_module
├── bar
│   └── bar.py
│   └── __init__.py
├── foo.py
└── setup.py

如上图所示，pure_module 目录下包含了一个 foo 模块以及一个 bar 包，同时在 bar 包下还包含了一个 bar 模块。

一个仅使用 py_modules 的 setup 脚本可以这样写：

from setuptools import setup

NAME = 'foo'
VERSION = '1.0'
PY_MODULES = ['foo', 'bar.bar']

setup(name = NAME
        , version = VERSION
        , py_modules = PY_MODULES)
py_modules 指定了 foo 模块以及 bar.bar 模块。

通过 python setup.py install --user --prefix= 进行安装后，便可以直接通过 import foo 和 import bar.bar 直接使用了。

注意：经测试，如果 .py 文件位于其他文件夹，该文件夹需要创建一个允许为空的 __init__.py 文件，表示为一个 package，否则安装后不能正常使用其他文件夹的模块。

package

上一节的例子中，bar.bar 属于 bar 包，foo 位于 distribution root，安装后属于 root package，在 Setuptools 中 “” 可以用于表示 root package。所以下面展示两种 setup 脚本的写法：

pure_module
├── bar
│   └── bar.py
│   └── __init__.py
├── foo.py
└── setup.py

仅使用 packages 的 setup.py 文件如下：

from setuptools import setup

NAME = 'foo'
VERSION = '1.0'
PACKAGES = ['', 'bar']

setup(name = NAME
        , version = VERSION
        , packages = PACKAGES
        ) 

如上，packages 包含了 package 的列表 root package 以及 bar，这样便能轻松覆盖到 distribution root 下的 foo.py 和 bar 文件夹下的 bar.py 了，在存在大量模块的情况下，省去像 py_modules 一样穷举模块的麻烦。在 python 中，默认的情况下，包的名字和目录的名字是一致的，比如 bar 包对应了 bar 目录，且包的路径表示是相对于 distribution root 的（也就是 setup.py 所在目录）。比如 packages = ['foo'] ，Setuptools 会在 setup.py 所在目录下寻找 foo/__init__.py，并将 foo/ 下的所有模块包含进去。

另外一个关键字是 package_dir，它的作用是将 package 映射到其他目录，这样的一个好处是方便将 package 移到其他目录而不用修改 packages 的参数值。举个例子，假设我们现在需要把 bar 移到 foobar 目录下，按照原来的脚本，Setuptools 是无法成功找到 bar 包的。

package_dir
├── foobar
│   ├── bar.py
│   └── __init__.py
├── foo.py
└── setup.py

通过 package_dir = = {'bar':'foobar'}，将原来的 bar package 映射到 foobar 下。完整的脚本如下：

from setuptools import setup

NAME = 'foo'
VERSION = '1.0'
PACKAGE_DIR = {'bar':'foobar'}
PACKAGES = ['', 'bar']

setup(name = NAME
        , version = VERSION
        , package_dir = PACKAGE_DIR
        , packages = PACKAGES
        ) 

package_dir 是一个字典，它的 key 是 package 名（”” 表示 root package），value 是相对于 distribution root 的目录名。在上面的例子中， package_dir = = {'bar':'foobar'} 改变了 packages 中 package 对应的目录位置，这样当 Setuptools 在找 bar package 时，会在 foobar目录下找相应的 __init__.py 文件。

注意，package_dir 会影响 packages 下列出的所有 package，比如，packages =['bar', 'bar.lib']，package_dir 不仅会影响所有和 bar 有关的 package，bar.lib 也会相应被映射到 foorbar.lib。

extension module

扩展模块需要使用 ext_modules 参数。上面所说的 package_dir 和 packages 都是针对纯 python 模块，而 ext_modules 针对的是使用 C/C++ 底层语言所写的模块。下面举个最简单的例子，扩展模块仅包含一个 foo.cpp 文件，其中定义了可供 python 调用的 myPrint 函数。

// fool.cpp
#include <iostream>
#include <string>

using namespace std;

void myPrint(string text)
{
    cout <<  text << endl;
}

.
├── setup.py
├── foo
│   └──__init__.py
│   └── test
│       └──__init__.py
└── src
    ├── foo.cpp
    ├── foo.h
    └── PythonWrapAPI.cpp

现在，我们想要发布扩展模块供别人使用我们的 myPrint 方法。想要 python 中成功导入你的包，需要利用额外的代码封装将被调用的方法。这里的 PythonWrapAPI.cpp 的作用就是使用 Python 提供的库封装你所写的接口，它是处在 python 和 C++ 间的胶水库，当 python 调用你的 C++ 方法时，由于语言类型的差别，需要做转换。

#include "foo.h"
#include <string>
#include <Python.h>

using namespace std;

static PyObject * _myPrint(PyObject *self, PyObject *args)
{
    char *text;
    // 解析Python传过来的参数
    if(!PyArg_ParseTuple(args, "s", &text))
        return NULL;
    myPrint(text);
    return Py_None;
}

static PyMethodDef ExtestMethods[] = 
{
    {"myPrint", _myPrint, METH_VARARGS},
    {NULL, NULL},
};


static struct PyModuleDef cModPyDem =
{
    PyModuleDef_HEAD_INIT,
    "foo", /* name of module */
    "",          /* module documentation, may be NULL */
    -1,          /* size of per-interpreter state of the module, or -1 if the module keeps state in global variables. */
    ExtestMethods
};


// 针对python3.5以后的
PyMODINIT_FUNC PyInit_myprint(void)
{
    return PyModule_Create(&cModPyDem);
}

setpy.py内容：

from setuptools import setup, Extension, find_packages

# package name, import NAME
NAME = "foo"
VERSION = "1.0.0"

# an Extension instance list
EXT_MODULES = [
    Extension(
        # 生成的myprint.cp36-win_amd64.pyd会放在foo.test.路径下，让foo.test包可以调用
        name="foo.test.myprint", 
        sources=["src/foo.cpp", "src/PythonWrapAPI.cpp"],
        include_dirs=["src", "D:\\Python36\\include"],

    )
]

PACKAGES= [
    'foo', # 顶层包的名字，foo文件夹下应该有__init__.py
    'foo.test', # foo/test文件夹下应该有 __init__.py
]

setup(
    name=NAME,
    version=VERSION,
    ext_modules=EXT_MODULES, # 会
    packages=PACKAGES,
)

ext_modules 是一个 Extension 实例列表，Extension 的参数 sources 用于指定所有源文件位置，include_dirs 指定头文件位置，同时还可以使用 library_dirs 和 libraries 指定外部链接库，以及 extra_compile_args 指定额外的编译参数。

setuptools

一个最简单的例子：

from setuptools import setup, find_packages
setup(
    name="helloworld",
    version="0.1",
    packages=find_packages(),
)

随着不断维护，可以添加一些依赖：

from setuptools import setup, find_packages
setup(
    name="helloworld",
    version="0.1",
    packages=find_packages(),

    scripts=["say_hello.py"],
    
    # Project uses reStructureText, 要保证docutils工具得到了加载
    install_requires=["docutils>0.3"],

    package_data={
        # 如果有packages包含了*.txt, *.rst文件，则包含这些文件
        "": ["*.txt", "*.rst"],
        # 在"hello" package中包含任何后缀为.msg的文件
        "hello": ["*.msg"],
    },

    author="Me",
    author_email="me@example.com",
    description="This is an Example Package",
    keywords="hello world example examples",
    url="http://example.com/HelloWorld/", # 工程主页
    project_urls={
        "Bug Tracker": "https://bugs.example.com/HelloWorld",
        "Documentation": "https://docs.example.com/HelloWorld/",
        "Source Code": "https://code.example.com/HelloWorld",
    }, 

    classifiers=[
        "License :: OSI Approved :: Python Software Foundation License"
    ],

)

下面详细介绍具体参数的功能：

# Legal keyword arguments for the setup() function
# 此为setup可提供的关键字典
setup_keywords = ('distclass', 'script_name', 'script_args', 'options',
                'name', 'version', 'author', 'author_email',
                'maintainer', 'maintainer_email', 'url', 'license',
                'description', 'long_description', 'keywords',
                'platforms', 'classifiers', 'download_url',
                'requires', 'provides', 'obsoletes',
                )

# Legal keyword arguments for the Extension constructor
# 此为extension可提供的关键字典
extension_keywords = ('name', 'sources', 'include_dirs',
                    'define_macros', 'undef_macros',
                    'library_dirs', 'libraries', 'runtime_library_dirs',
                    'extra_objects', 'extra_compile_args', 'extra_link_args',
                    'swig_opts', 'export_symbols', 'depends', 'language')

版本控制关键字 version

version=”0.1”, 要注意版本有不同的写法

名字 name

name=’MedPy’

include_package_data

True表示自动包含由MANIFEST.in文件中列出的任何数据文件

MANIFEST.in中类似的内容如下为：
include *.txt
include *.md

include ez_setup.py

include lib/maxflow/src/*.h
include lib/maxflow/src/*.cpp
include lib/maxflow/src/instances.inc
include lib/maxflow/src/readme

packages

packages 是一个包名列表，packages 参数告诉 Setuptools 处理列举出的 package 下所有纯 python 模块。在文件系统中，默认地，package 的名字与目录是一一对应的，也就是说，packages = ['foo']，Setuptools 会去查找 foo/__init__.py 文件

`install_requires` 和 `dependency_links` 安装依赖模块

install_requires 可以声明 package 安装时所需的依赖模块及其版本。安装 package 时，Setuptools 便能够从 PyPi 上自动下载其所依赖的模块，并且将依赖信息包含进 Python Eggs 中。

比如我们在自己的 package 中用到了一个 python 非标准库 pycurl 和 xmltodict，当我们的 package 在别的机器上使用时便会报错。为了解决这个问题，我们可以使用 install_requires = ['pycurl', 'xmltodict'] 将 pycurl 和 xmltodict 加入 package 依赖。

install_requires 可以是 string 或 string list，指明所需要依赖的模块。当 install_requires 为 string 类型，并且依赖多于 1 个时，每个依赖的声明都要另起一行。

最新版本的 Setuptools 的install_requires 有另外两个作用：

在运行时，任何脚本都会检查其依赖模块的正确性，并且确保正确的依赖版本都加入到 sys.path 中（假如有多个版本的话）。

Python Egg distributions 将会包含依赖相关的元信息。前面说到， Setuptools 便能够从 PyPi 上自动下载其所依赖的模块，但是在某些环境下无法正常访问 Pypi 下，我们也可以通过 dependency_links 参数指定到自己的 python 源，这样便可以解决下载问题。

比如，dependency_links = ['http://xxx/xmltodict', 'http://xxx/pycurl']。

dependency_links 是一个字符串列表，包含了依赖的下载 URL。

Setuptools 对链接的支持比较强大！

下载的资源可以满足以下条件：

通过 python setup.py sdist 进行分发的压缩文件，默认情况下在 linux 为 .tar.gz，在 windows 为 zip 单一的 py 文件

当包含资源下载链接的网页 URL 中存在多个版本时，Setuptools 会根据版本要求下载合适的版本。

一般，比较好的方式是网页 URL 方式。我们也可以使用 SourceForge 的 showfiles.php 链接来下载我们所依赖的模块。

如果依赖的模块是一个 py 文件时，你必须在 URL 添加 "#egg=project-version" 后缀，以指出模块的名字和版本，另外需要确保将模块名和版本中出现的 - 替换为 _。EasyInstall 将会识别这个后缀并且自动创建一个 setup.py 脚本，将我们的 py 文件包装为 egg 文件。如果为 VCS，将会 checkout 对应的版本，创建一个临时文件夹并执行 setup.py bdist_egg，安装所需的依赖。

在使用 VCS 的情况下，你也可以使用 #egg=project-version 指定要使用的版本。你可以通过在 #egg=project-version 前加入 @REV 来指定要 checkout 的版本。另外你也可以通过在 URL 前加上以下标识显式声明 URL 使用的是 VCS：

Subversion：svn+URL

Git：git+URL

Mercurial：hg+URL

因此使用 VCS 更复杂的一个示例为： vcs+proto://host/path@revision#egg=project-version

ext_module Python 调用 C/C++

Python 的可扩展性特别强，不仅支持 python 语言的扩展模块，而且支持其他语言的扩展。

Python 调用 C++ 的详细文档可以查看 https://docs.python.org/2/extending/building.html

这里假设已经懂得怎么调用 C++ 方法了，接下来只需要使用 ext_module 参数，使 Setuptools 能够编译和安装扩展模块了。

ext_module 参数是一个 Extension 实例列表，Extension 类似于 gcc/g++ 的所需参数，包含了指定源文件、头文件、依赖的静态库或动态库、额外的编译参数、宏定义等功能。

`name` 扩展模块名字

name 是一个字符串，用于指定扩展模块的名字。

`packages` 和 `package_dir`

用于支持 python 语言编写模块，其 import 语句使用的包名与 packages 和 package_dir 中所指定的名字是一致的。但是扩展模块的名字是由 Extension 实例的 name 参数决定的，且需要和导出函数对应的initxxx 名字以及 Py_InitModule 方法对应的第一个参数相同。定义好模块的名字 xxx 后，我们便可以使用 import xxx` 使用我们自己的模块了。

`sources` 和 `include_dirs`

`sources` 为用于指定要编译源文件的字符串列表，比如，`sources=['foo/foo.cpp', 'bar/bar.cpp']`，`Setuptools` 支持 `C/C++` 以及 `Objective-C`。 `include_dirs` 为用于指定编译需要的头文件目录的字符串列表，比如，`include_dirs=['foo/include', 'bar/include']`。如果头文件位于 `distribution root` 目录，需要使用 `'.'` 表示头文件位于当前目录，不能为 `''`，否则将找不到头文件。

另外还支持 extra_objects 向链接程序传递 object 文件，比如 .o 文件。

`define_macros` 和 `undef_macros`

gcc 支持在编译的时候定义新的宏变量和取消某个宏变量的定义，具体的选项 [-Dmacro[=defn]...] [-Umacro]。Extension 也支持这样的选项。

你可以使用 define_macros 和 undef_macros 定义新的宏变量和取消某个宏变量的定义。

define_macros 是一个 (name, value) 元组列表，其中的 name 为宏变量名字符串，value 为对应的值，可以为字符串、数字或为 None 类型（说明：官方文档没有声明 value 可以为数字，但是经过测试，只要是 python 支持的数字类型都可以用于 value，但是最好还是使用字符串的形式，这样脚本的兼容性会更好）.

比如，define_macros=[('DEBUG', None), ('FOO', '1'), ('BAR', 2), ('FOOBAR', '"abc"')]，gcc 对应的编译选项结果为 -DDEBUG -DFOO=1 -DBAR=2 -DFOOBAR="abc"。

undef_macros 比 define_macros 简单得多，它就是一个宏变量字符串列表，举个例子，我们想要取消以上定义的宏变量，对应的 undef_macros 值为 undef_macros=['DEBUG', 'FOO', 'BAR', 'FOOBAR']。

`libraries` 和 `library_dirs`

Setuptools 对 C/C++ 库的引用方法和 gcc 一样，具体的规则可以参考 gcc。

libraries 为要添加的库的名字字符串列表，而 library_dirs 为要添加的库所在的目录，举个例子：

.
├── setup.py
└── curl
    ├── include
        ├── curl.h
        ├── test.h
    ├── lib
        ├── libcurl.a
        ├── libtest.a
其对应的参数为 libraries=['curl', 'test']、library_dirs=['curl/lib']、include_dirs=[‘curl/include’]

注意：在实际的使用过程中碰到过一个链接错误的坑，Setuptools 在编译的时候报错：

libcurl.a : relocation against .rodata can not be used when making a shared object:recompile with -fPIC
libcurl.a : could not read symbols:Bad value

前面提到，python 在创建扩展模块时会将源文件编译为动态链接库，动态链接库在加载的时候，内存位置是不固定的，所以我们链接的外部库代码也需要全部使用相对地址，这样代码便可以加载到内存的任意位置。因为有的库没有使用 -fPIC 选项进行编译，导致库最终在链接到 so 文件时报错。

解决方案是使用 -fPIC 重新编译 libcurl.a 库。

`extra_compile_args`

在编译扩展模块时，Setuptools 会自动指定编译参数，比如下面一个模块的编译：

gcc -pthread -fno-strict-aliasing -O2 -g -pipe -Wall -Wp,-D_FORTIFY_SOURCE=2 -fexceptions -fstack-protector --param=ssp-buffer-size=4 -m64 -mtune=generic -D_GNU_SOURCE -fPIC -fwrapv -DNDEBUG -O2 -g -pipe -Wall -Wp,-D_FORTIFY_SOURCE=2 -fexceptions -fstack-protector --param=ssp-buffer-size=4 -m64 -mtune=generic -D_GNU_SOURCE -fPIC -fwrapv -fPIC -DDEBUG -DFOO=1 -DBAR=2 -DFOOBAR="abc" -Isrc -I/usr/include/python2.6 -c src/foo.cpp -o build/temp.linux-x86_64-2.6/src/foo.o
gcc -pthread -fno-strict-aliasing -O2 -g -pipe -Wall -Wp,-D_FORTIFY_SOURCE=2 -fexceptions -fstack-protector --param=ssp-buffer-size=4 -m64 -mtune=generic -D_GNU_SOURCE -fPIC -fwrapv -DNDEBUG -O2 -g -pipe -Wall -Wp,-D_FORTIFY_SOURCE=2 -fexceptions -fstack-protector --param=ssp-buffer-size=4 -m64 -mtune=generic -D_GNU_SOURCE -fPIC -fwrapv -fPIC -DDEBUG -DFOO=1 -DBAR=2 -DFOOBAR="abc" -Isrc -I/usr/include/python2.6 -c src/PythonWrapAPI.cpp -o build/temp.linux-x86_64-2.6/src/PythonWrapAPI.o
g++ -pthread -shared build/temp.linux-x86_64-2.6/src/foo.o build/temp.linux-x86_64-2.6/src/PythonWrapAPI.o -L/usr/lib64 -lpython2.6 -o build/lib.linux-x86_64-2.6/myprint.so

这么多的编译参数绝大部分是 Setuptools 自动指定的，但是如果我们还想要在每个文件的编译再加上额外的编译选项，可以使用 extra_compile_args 和 extra_link_args，其中 extra_link_args 选项用于链接。

extra_compile_args 是一个编译选项字符串列表，每个编译选项都要单独作为一个字符串，不能并在一起，否则会报错。

创建源码分发

建议使用源码分发的形式发布你的包，而不是二进制发布形式，这样包将更方便跨平台。

`sdist` 命令

创建源码分发的命令为：python setup.py sdist，命令执行后会创建 dist 目录，收集一些必要的文件以及 setup 脚本，生成一个压缩文件，用户安装时，只需要解压，然后执行 python setup.py install 命令，将进行编译和安装，将相应的文件存放到 python 第三方库目录下。

sdist 比较常用的一个选项是 --format，选择压缩的格式。比如，使用 zip 进行压缩，python setup.py sdist --format=zip。

说明：python setup.py sdist –format=zip, tar，Setuptools 会分别使用 zip 和 tar 进行压缩，将同时产生两个压缩文件。

setuptools 和 distutils 对于文件查找的算法是一样的：

所有在 py_modules 和 packages 指定的对应模块文件
所有在 ext_modules 和 libraries 选项指定的源文件和库
scripts 选项指定的脚本文件
所有类似测试脚本的文件，比如：test/test*.py (低版本的包管理工具可能不支持)
README.txt（或 README），setup.py 以及 setup.cfg（README 文件目前无法支持更多的后缀格式）
package_data 选项指定的文件
data_files 选项指定的文件

另外在使用过程中，遇到 Setuptools 的一个巨坑，确实可以包含文件，但是它并不总能包含文件，这是有前提的。

bdist是发布二进制文件，sdist是发布源文件。而在旧版本的 python 中(2.7 以前)， package_data只有在使用 bdist 时候才有用，也就是如果使用 sdist，是无法正确包含文件的。而在新版本中，会自动把package_data 里面的内容添加到 MANIFEST 文件中。

`MANIFEST.in` 模版文件

当我们使用 sdist 进行分发包时，如果需要包含额外的文件，可以使用 MANIFEST.in 文件，在该文件中列举出需要包含的文件。当我们执行 sdist 时，将会对 MANIFEST.in 文件进行检查，读取解释并生成 MANIFEST 文件，该文件列举了所有需要包含进包的文件。位于 distribution root 下的 MANIFEST.in 文件每行对应一条包含一系列文件的命令。

.egg

实际上是python包的一种分发格式，对于纯python包，它也是完全跨平台的

.egg文件实际上是.zip文件，可以看到存档。可以直接用easy_install 安装.egg文件。

easy_install 与 pip 都是用来下载安装Python一个公共资源库PyPI 的相关资源包的，pip是easy_install的改进版，提供更好的提示信息，删除package等功能。老版本的python中只有easy_install，没有pip。
easy_install 打包和发布 Python 包

    安装一个包

    easy_install 包名
    easy_install "包名 == 包的版本号"
    升级一个包

    easy_install -U "包名 >= 包的版本号"

pip 是包管理

    安装一个包

    pip install 包名

    pip install 包名 == 包的版本号
    升级一个包 (如果不提供version号，升级到最新版本）

    pip install --upgrade 包名 >= 包的版本号
    删除一个包

    pip uninstall  包名

在移动python路径后，需要重新更新这两个东西就可以正确使用了！

一个创建.gg文件的样例：

# setup.py
from setuptools import setup, find_packages
setup(
    name="mymath",
    version="0.1",
    packages=find_packages()
)

# 执行命令
$ python setup.py bdist_egg
会在目录下创建三个新目录：build, dist, mymath.egg-info。dist即为分发的.egg文件。

【python开发技术】python distutils setuptools学习

python distutils setuptools学习

【python开发技术】python distutils setuptools学习

distutils 与 setuptools

一些基础概念说明

module 模块

pure python module

extension module

package

root package

distribution

distribution root

示例和分发选择

pure python module

package

extension module

setuptools

版本控制关键字 version

名字 name

include_package_data

packages

`install_requires` 和 `dependency_links` 安装依赖模块

ext_module Python 调用 C/C++

`name` 扩展模块名字

`packages` 和 `package_dir`

`sources` 和 `include_dirs`

`define_macros` 和 `undef_macros`

`libraries` 和 `library_dirs`

`extra_compile_args`

创建源码分发

`sdist` 命令

`MANIFEST.in` 模版文件

.egg

CATALOG

FEATURED TAGS

【python开发技术】python distutils setuptools学习

distutils 与 setuptools

一些基础概念说明

module 模块

pure python module

extension module

package

root package

distribution

distribution root

示例和分发选择

pure python module

package

extension module

setuptools

版本控制关键字 version

名字 name

include_package_data

packages

install_requires 和 dependency_links 安装依赖模块

ext_module Python 调用 C/C++

name 扩展模块名字

packages 和 package_dir

sources 和 include_dirs

define_macros 和 undef_macros

libraries 和 library_dirs

extra_compile_args

创建源码分发

sdist 命令

MANIFEST.in 模版文件

.egg

CATALOG

FEATURED TAGS

`install_requires` 和 `dependency_links` 安装依赖模块

`name` 扩展模块名字

`packages` 和 `package_dir`

`sources` 和 `include_dirs`

`define_macros` 和 `undef_macros`

`libraries` 和 `library_dirs`

`extra_compile_args`

`sdist` 命令

`MANIFEST.in` 模版文件