setup.py可以在两种情况下使用，首先，您需要安装Python包。其次，您希望创建自己的Python包。通常，标准Python包有几个重要的文件，如setup.py、setup.cfg和Manifest.in。当您创建Python包时，这三个文件将确定（PKG-INFO中egg-INFO文件夹下的内容）名称、版本、描述、其他所需安装（通常在.txt文件中）和其他一些参数。setup.py在创建包时读取setup.cfg（可以是tar.gz）。Manifest.in是您可以定义包中应包含的内容的地方。无论如何，你可以用setup.py做很多事情，比如

python setup.py build
python setup.py install
python setup.py sdist <distname> upload [-r urltorepo]  (to upload package to pypi or local repo)

有很多其他命令可以与setup.py一起使用

python setup.py --help-commands

为了简单起见，当您调用安装函数时，setup.py会以“__main__”的形式运行，其他答案也会提到。在setup.py中，您应该放置安装软件包所需的一切。

常用setup.py函数

以下两个部分讨论了许多setup.py模块具有的两个功能。

设置工具。设置

此函数允许您指定项目属性，如项目名称、版本。。。。最重要的是，该功能允许您安装其他功能（如果它们打包正确）。有关setuptools.setup的示例，请参见此网页setuptools.setup的这些属性允许安装以下类型的软件包：

使用setuptools.findpackages导入到项目并在PyPI中列出的包：packages=find_packages（exclude=[“docs”，“tests”，”.gitignore“，”README.rst“，”DESCRIPTION.rst“]）包不在PyPI中，但可以使用dependency_links从URL下载dependency_links=[“http://peak.telecommunity.com/snapshots/",]

自定义函数

在理想的世界中，setuptools.setup将为您处理一切。不幸的是，情况并非总是如此。有时，您必须执行特定的操作，例如使用subprocess命令安装依赖项，以使正在安装的系统处于适合您的包的正确状态。为了避免这种情况，这些功能会变得混乱，并且在操作系统甚至发行版之间经常会有所不同。

当您下载带有setup.py的软件包时，请打开终端（Mac、Linux）或命令提示符（Windows）。使用cd并帮助您使用Tab按钮，将路径设置为您下载文件的文件夹和setup.py所在的文件夹：

iMac:~ user $ cd path/pakagefolderwithsetupfile/

按回车键，您将看到如下内容：

iMac:pakagefolderwithsetupfile user$

然后在python setup.py安装之后键入：

iMac:pakagefolderwithsetupfile user$ python setup.py install

按enter键。完成！

若您下载的包在根文件夹中有“setup.py”，您可以通过运行

python setup.py install

如果您正在开发一个项目，并且想知道该文件对什么有用，请查看Python文档中有关编写安装脚本的内容

它有助于在您的机器上安装python包foo（也可以在virtualenv中），以便您可以从其他项目以及[I]python提示中导入包foo。

它完成了pip、easy_install等类似的工作。，

---

使用setup.py

让我们从一些定义开始：

包-包含__init__.py文件的文件夹/目录。模块-扩展名为.py的有效python文件。分发-一个包与其他包和模块的关系。

假设您想安装一个名为foo的包。然后你会，

$ git clone https://github.com/user/foo
$ cd foo
$ python setup.py install

相反，如果你不想实际安装它，但仍然想使用它，

$ python setup.py develop

此命令将在站点包中创建指向源目录的符号链接，而不是复制内容。正因为如此，它的速度相当快（特别是对于大包裹）。

---

正在创建setup.py

如果你的包树是这样的，

foo
├── foo
│   ├── data_struct.py
│   ├── __init__.py
│   └── internals.py
├── README
├── requirements.txt
└── setup.py

然后，在setup.py脚本中执行以下操作，以便将其安装在某台计算机上：

from setuptools import setup

setup(
   name='foo',
   version='1.0',
   description='A useful module',
   author='Man Foo',
   author_email='foomail@foo.example',
   packages=['foo'],  #same as name
   install_requires=['wheel', 'bar', 'greek'], #external packages as dependencies
)

相反，如果您的包树更复杂，如下图所示：

foo
├── foo
│   ├── data_struct.py
│   ├── __init__.py
│   └── internals.py
├── README
├── requirements.txt
├── scripts
│   ├── cool
│   └── skype
└── setup.py

那么，在这种情况下，setup.py将如下所示：

from setuptools import setup

setup(
   name='foo',
   version='1.0',
   description='A useful module',
   author='Man Foo',
   author_email='foomail@foo.example',
   packages=['foo'],  #same as name
   install_requires=['wheel', 'bar', 'greek'], #external packages as dependencies
   scripts=[
            'scripts/cool',
            'scripts/skype',
           ]
)

---

将更多内容添加到（setup.py）并使其变得得体：

from setuptools import setup

with open("README", 'r') as f:
    long_description = f.read()

setup(
   name='foo',
   version='1.0',
   description='A useful module',
   license="MIT",
   long_description=long_description,
   author='Man Foo',
   author_email='foomail@foo.example',
   url="http://www.foopackage.example/",
   packages=['foo'],  #same as name
   install_requires=['wheel', 'bar', 'greek'], #external packages as dependencies
   scripts=[
            'scripts/cool',
            'scripts/skype',
           ]
)

long_description在pypi.org中用作包的自述描述。

---

最后，您现在可以将您的包上传到PyPi.org，以便其他人可以使用pipinstallyourpackage安装您的包。

此时有两种选择。

在临时test.pypi.org服务器上发布以使自己熟悉该过程，然后将其发布在永久pypi.org服务器上，供公众使用您的包。如果您已经熟悉该过程并拥有用户凭据（例如用户名、密码、包名），请立即在永久pypi.org服务器上发布

一旦您的包名在pypi.org中注册，就没有人可以声明或使用它。Python打包建议将twin包用于上传目的（将您的包上传到pypi）。因此

第一步是使用以下方法在本地构建分布：#前提条件：轮子（pip安装轮子）$python setup.py sdist bdist_wheel然后使用twine上传到test.pypi.org或pypi.org：$twine上载--存储库testpypi dist/*用户名：***密码：***

该包需要几分钟的时间才能出现在test.pypi.org上。一旦你对它感到满意，你就可以简单地将你的包上传到pypi.org的真实和永久索引中：

$ twine upload dist/*

或者，您也可以通过以下方式使用GPG对包中的文件进行签名：

$ twine upload dist/* --sign

---

奖金阅读：

在这里查看来自真实项目的示例setup.py：torchvision-setup.pyPEP 517，设置工具为什么缠绕？使用绳线

setup.py是一个Python脚本，通常随库或程序一起提供，用该语言编写。其目的是正确安装软件。

许多软件包结合setup.py使用distutils框架。

http://docs.python.org/distutils/