convert_2to3_doctests：

需要用2to3转换的doctest源文件列表。有关更多详细信息，请参阅通过SetupTools同时支持Python2和Python3。

依赖关系链接：

指定满足依赖项时要搜索的URL的字符串列表。如果需要安装由setup_requires或tests_require指定的包，将使用这些链接。它们还将写入EasyInstall等工具的EasyInstall元数据中，以便在安装.egg文件时使用。

EAGER_RESOURCES：

命名资源的字符串列表，这些资源应该一起提取，如果需要其中任何一个，或者如果导入了项目中包含的任何C扩展。仅当项目将作为zipfile安装，并且需要将列出的所有资源作为一个单元解压缩到文件系统时，此参数才有用。这里列出的资源应该是‘/’分隔的路径，相对于源根目录，因此要在包bar.baz中列出资源foo.png，应该在此参数中包括字符串bar/baz/foo.png。 如果您一次只需要获取一个资源，或者您没有任何访问项目中其他文件(如数据文件或共享库)的C扩展名，那么您可能不需要这个参数，也不应该干扰它。有关此参数如何工作的更多详细信息，请参阅下面关于自动资源提取的部分。

Entry_Points：

将入口点组名称映射到定义入口点的字符串或字符串列表的字典。入口点用于支持动态发现项目提供的服务或插件。有关此参数格式的详细信息和示例，请参阅服务和插件的动态发现。此外，此关键字还用于支持自动脚本创建。

排除程序包数据：

将包名称映射到应从包目录中排除的GLOB模式列表的字典。您可以使用它来削减INCLUDE_PACKAGE_DATA包含的任何多余文件。有关完整的说明和示例，请参阅下面关于包括数据文件的部分。

附加要求：

将"Extras"(项目的可选功能)的名称映射到字符串或字符串列表的词典，指定必须安装哪些其他发行版才能支持这些功能。有关此参数格式的详细信息和示例，请参阅下面关于声明依赖项的部分。

注意：对于extras_require字典，在54.1.0之前的版本中，如果在键中使用破折号，则会将转换为下划线。更高版本允许使用破折号，如果用户使用的别名包含应使用下划线的破折号，则会发出警告。author-email而不是author_email)，并且在这种情况下仍执行转换。在未来，这种转换将不再自动完成。

Include_Package_Data：

如果设置为True，则告诉setupTools自动包括它在MANIFEST.in文件指定的包目录中找到的任何数据文件。有关详细信息，请参阅下面关于包括数据文件的部分。

安装要求：

指定在安装此发行版时需要安装哪些其他发行版的字符串或字符串列表。有关此参数格式的详细信息和示例，请参阅下面关于声明依赖项的部分。

NAMESPACE_PACKAGE：

命名项目的"命名空间包"的字符串列表。命名空间包是可以跨多个项目发行版拆分的包。例如，Zope3的zope包是一个命名空间包，因为像zope.interface和zope.publisher这样的子包可能是分开分发的。只要您在包含命名空间包的任何子包的每个项目中声明它们，并且只要命名空间包的__init__.py不包含除命名空间声明之外的任何代码，EGG运行时系统就可以在运行时自动将这些子包合并到单个父包中。有关详细信息，请参阅下面关于命名空间包的部分。

Package_Data：

将包名称映射到GLOB模式列表的词典。有关完整的说明和示例，请参阅下面关于包括数据文件的部分。如果您正在使用INCLUDE_PACKAGE_DATA，则不需要使用此选项，除非您需要添加由安装脚本和构建过程生成的文件。(因此不在源代码管理中，或者是您不希望包含在源代码分发中的文件。)

project_urls：

URL名称到超链接的任意映射，与简单的url和ownload_url选项提供的文档相比，允许在何处找到各种资源的更具可扩展性的文档。

Python_Requires：

与版本说明符(如PEP 440中定义的)对应的字符串，用于指定PEP 345中定义的Requires-Python。

Setup_Requires：

指定安装脚本运行所需的其他分发版本的字符串或字符串列表。在处理其余的安装脚本或命令之前，setupTools将尝试获取这些脚本或命令(甚至使用EasyInstall下载它们)。如果将distutils扩展用作构建过程的一部分，则需要此参数；例如，处理setup()参数并将其转换为蛋信息元数据文件的扩展。 (注意：setup_requires中列出的项目不会自动安装在运行安装脚本的系统上。如果它们在本地还不可用，则只需将它们下载到./.eggs目录。如果希望安装它们，并且在运行安装脚本时可用，则应将它们添加到install_requires和setup_requires中。)

测试加载器：

如果您希望使用一种不同于setupTools通常使用的方式来查找要运行的测试，您可以在此参数中指定一个模块名称和类名。命名类必须是不带参数的可实例化类，并且其实例必须支持在Pythonunittest模块的TestLoader类中定义的loadTestsFromNames()方法。SetupTools将只在names参数中传递一个测试"name"：为test_suite参数提供的值。您指定的加载器可以以它喜欢的任何方式解释此字符串，因为test_suite字符串中可能包含的内容没有任何限制。 模块名称和类名必须用:分隔。此参数的默认值为setuptools.command.test:ScanningLoader。如果希望使用默认的unittest行为，则可以将unittest:TestLoader指定为test_loader参数。这将阻止对子模块和子包进行自动扫描。 您在此处指定的模块和类可能包含在另一个包中，只要您使用TESTS_REQUIRED选项确保在运行测试命令时包含加载器类的包可用。

测试套件：

命名unittest.TestCase子类(或包含一个或多个子类的包或模块，或此类子类的方法)的字符串，或命名可以不带参数调用并返回unittest.TestSuite的函数。如果命名的套件是一个模块，并且该模块有一个additional_tests()函数，则会调用该函数并将结果添加到要运行的测试中。如果命名套件是一个包，则任何子模块和子包都会递归添加到整个测试套件中。 指定此参数允许使用测试命令运行指定的测试套件，例如通过setup.py测试。有关更多详细信息，请参阅下面有关测试命令的部分。

测试要求：

如果您的项目测试除了安装所需的包之外还需要一个或多个其他包，您可以使用此选项来指定它们。它应该是一个字符串或字符串列表，指定需要存在哪些其他发行版才能运行包的测试。当您运行测试命令时，setupTools将尝试获取它们(甚至使用EasyInstall下载它们)。请注意，这些必需的项目不会安装在运行测试的系统上，而只有在尚未在本地安装它们的情况下才会下载到项目的安装目录。

Use_2to3：

在构建过程中使用2to3将源代码从Python2转换为Python3。有关更多详细信息，请参阅通过SetupTools同时支持Python2和Python3。

use_2to3_exclude_fixers：

默认情况下，转换使用lib2to3.fixers包中的所有修复程序。要使用其他修复程序，可以将参数use_2to3_fixers设置为包含修复程序的包的名称列表。要排除修复程序，可以将参数use_2to3_exclude_fixers设置为要跳过的修复程序名称。

use_2to3_fixers：

用于搜索要在2to3转换期间使用的其他修复程序的模块列表。有关更多详细信息，请参阅通过SetupTools同时支持Python2和Python3。

ZIP_SAFE：

一个布尔值(True或False)标志，指定是否可以安全地安装项目并从Zip文件运行。如果未提供此参数，bdist_egg命令将不得不在每次生成鸡蛋时分析项目的所有内容，以查找可能存在的问题。

扩展

    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')

ext_modules：

扩展实例列表，每个扩展实例描述一个扩展模块。假设您的发行版只包含一个名为foo并由foo.c实现的扩展名。如果不需要编译器/链接器的额外指令，则描述此扩展非常简单：

   from distutils.core import setup, Extension
   setup(name='foo',
         version='1.0',
         ext_modules=[Extension('foo', ['foo.c'])],
         )

其他

最后，甚至还有更多的kwarg可以在setuptools.dist和其他地方实现，但由于某种原因从未添加到任何主要的setupTools/distutils文档中：

功能(已弃用)：

将选项名称映射到setuptools.Feature对象的词典。功能是分发的一部分，可以根据用户选项、功能间相关性和当前系统上的可用性来包括或排除这些功能。所有安装命令(包括源代码和二进制分发版本)中都省略了排除的功能，因此您可以从同一源代码树创建多个分发版本。

long_description_content_type(PERMaking a PyPI-friendly README)：

设置为自述文件标记的可接受的Content-Type-Style值，例如text/plain、text/x-rst(表示reStruredText)或text/markdown。

提供附加服务(按PEP566, listed as "Provides-Extra")：

包含可选功能名称的字符串。必须是有效的Python标识符。可用于使依赖项以是否已请求可选功能为条件。

这篇关于Setuptools.setup()接受哪些关键字参数？的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持编程学习网！