collective.dist 0.2.5

什么是collective.dist ?

我在Python 2.6中添加了一个新功能，允许人们处理多个类似PyPI的服务器。

基本来说，您可以在.pypirc中注册的任何服务器上使用register和upload命令，这略有变化。

但是Plone和Zope运行在Python 2.4上。

因此，此包添加了两个新命令，以便您可以使用Python 2.6中可用的功能。

• mupload：允许将包上传到多个服务器的命令

• mregister：允许在多个服务器上注册的命令

此包还提供了一些将在Python 2.7中引入的新命令。

• check：允许您检查元数据是否合规。例如，它会检查long_description是否在reSt中编译。请注意，mregister会调用此命令。

如何使用collective.dist ?

mregister和mupload将替换register和upload命令，并使用扩展版本的.pypirc文件。

为了使用它，按以下方式更改您的.pypirc文件

[distutils]
index-servers =
    pypi

[pypi]
username:user
password:password

其中user和password是您的PyPI用户名。

随着最新更改，如果省略了密码，则在需要时将提示用户输入。

然后您可以使用mregister和mupload命令，而不是通常的register和upload调用。

上传文件的一个典型调用如下

$ python setup.py mregister sdist mupload

要处理多个类似PyPI的服务器，您可以将它们添加到您的.pypirc文件中。

例如，如果您想能够将软件包推送到

• PyPI

• plone.org

• 您自己的私有PyPI（例如使用PloneSoftwareCenter）

您可以这样编写您的.pypirc文件

[distutils]
index-servers =
    pypi
    plone.org
    mycompany


[pypi]
username:user
password:password

[plone.org]
repository:http://plone.org/products
username:ploneuser
password:password

[plone.org]
repository:http://my.company/products
username:user
password:password

从那里，您将能够使用不同的服务器，使用-r选项

$ python setup.py mregister sdist mupload -r http://plone.org

您甚至可以使用部分名称而不是URL

$ python setup.py mregister sdist mupload -r plone.org

如果您的包使用setuptools，您甚至可以创建别名以简化命令

$ python setup.py alias plone_release mregister sdist mupload -r plone.org  # creates the alias
$ python setup.py plone_release # run the whole sequence

另一种用法是处理PyPI本身上的多个配置文件

[distutils]
index-servers =
    pypi
    pypi-personal

[pypi]
username:user
password:password

[pypi-personal]
username:user2
password:password2

确保您的包元数据正确无误

您可以通过运行check命令来检查您的元数据是否符合规范

$ python setup.py check

如果您已安装docutils，您甚至可以使用reStructuredText选项来检查您的long_description是否编译

$ python setup.py check --restructuredtext

使用严格选项时，如果出现问题将引发错误

$ python setup.py check --restructuredtext --strict

请注意，mregister调用check并检查reStructuredText。如果您想在reStructuredText损坏时停止，请同时使用strict

$ python setup.py mregister --strict