4

我正在开发包并将我的包的开发/测试/等版本上传到本地 devpi 服务器。

为了防止意外上传到 PyPi，我采用了以下常见做法：

setup(...,
      classifiers=[
        "Programming Language :: Python",
        "Programming Language :: Python :: 2",
        "Programming Language :: Python :: 2.7",
        "Private :: Do not Upload"
     ],
     ...)

效果很好，但是当我终于准备好将包上传到 PyPi 时呢？

我想出了一个完全丑陋但简单的 hack，它要求我将分类器定义为 setup() 调用之外的全局变量，如下所示：

CLASSIFIERS = [
    "Programming Language :: Python",
    "Programming Language :: Python :: 2",
    "Programming Language :: Python :: 2.7"
]


if "--public" not in sys.argv:
     CLASSIFIERS.append("Private :: Do Not Upload")
else:
     sys.argv.remove("--public")

setup(...
      classifiers=CLASSIFIERS,
      ...)

另一个，也许更简单的选择是仅仅注释掉“Private :: Do not Upload”，但这似乎并不比我的黑客更专业。

我想做的是创建一个适当的上传命令的子类，SafeUpload并让它检查--publiccmd-line 选项。也许，因为在上传之前可能存在构建，SafeBuild可能是一个更好的选择。

不幸的是，我无法理解有关创建自定义命令的 setuptools 文档。

有谁知道如何实现这个？我不清楚自定义命令是否可以访问传递给的参数setup()，即它是否可以直接操纵classifiers传递给的参数setup()，或者它是否需要命令的用户遵循将 CLASSIFIERS 定义为全局变量的约定？

4

1 回答 1

4

在你的问题上倒退；虽然它非常广泛，但主题仍然足够受限。

我可以告诉你，分类器没有被操纵，而是从命令中读取然后写入PKG-INFO文件，然后查找函数将执行实际写入egg_info的所有egg_info.writersentry_points 。setuptools.command.egg_info:write_pkg_info据我所知，尝试在外部利用该分类器并不是一个好方法，但是您可以覆盖所有您想要的东西，setuptools这样您就可以创建自己的write_pkg_info函数，弄清楚如何读取元数据（您可以看到在 maindistutils.command.upload:upload.upload_file方法中）并在 upload_file 最终读取它之前进一步操作。在这一点上，您可能会认为操纵和使用这个系统会很烦人。

正如我所提到的，一切都可以被覆盖。您可以制作一个带有公共标志的上传命令，如下所示：

from distutils.log import warn
from distutils.command.upload import upload as orig
# alternatively, for later versions of setuptools:
# from setuptools.command.upload import upload as orig

class upload(orig):
    description = "customized upload command"

    user_options = orig.user_options + [
        ('public', None,
         'make package public on pypi'),
    ]

    def initialize_options(self):
        orig.initialize_options(self)
        self.public = False

    def run(self):
        if not self.public:
            warn('not public, not uploading')
            return
        return orig.run(self)

陪同人员setup.py可能看起来像这样。

from setuptools import setup

setup(
    name='my_pypi_uploader',
    version='0.0',
    description='"safer" pypi uploader',
    py_modules=['my_pypi_uploader'],  # assuming above file is my_py_uploader.py
    entry_points={
        'distutils.commands': [
            'upload = my_pypi_uploader:upload',
        ],
    },
)

将它作为一个包安装到您的环境中，上传命令将被您的版本替换。示例运行：

$ python setup.py upload
running upload
not public, not uploading

用公共标志再试一次

$ python setup.py upload --public
running upload
error: No dist file created in earlier command

这很好，因为我根本没有创建任何 dist 文件。您当然可以通过重写方法（在您的代码中复制）来进一步扩展该命令，upload_file并更改部分以在您的子类中执行您想要的操作（例如在那里注入私有分类器），由您决定。

您可能还想知道为什么类名是小写的（违反 pep8），这是由于遗留问题以及如何生成给定命令的帮助。

$ python setup.py upload --help
...
Options for 'upload' command:

使用“正确”命名的类（例如SafeUpload；记住还要更新entry_pointinsetup.py以指向这个新的类名）

$ python setup.py upload --help
...
Options for 'SafeUpload' command:

当然，如果此输出是意图，则可以使用标准类命名约定。

虽然老实说，您根本不应该在生产中指定上传，而是在构建服务器上将其作为 post-push 挂钩的一部分，因此当项目被推送（或标记）时，构建完成并且文件被加载到您的私人服务器上，然后只有进一步的手动干预（或者如果推送特定标签则自动干预）才能将包上传到 pypi。然而，上面的例子应该让你开始你最初打算做的事情。

最后一件事：如果未设置标志，您可以更改self.repository为您的私有 devpi 位置。--public您可以在调用orig.upload_file方法之前覆盖它（通过您的自定义版本），或者在run; 因此，您的代码可以验证存储库 url 不是公共 PyPI 实例，而不是退出。或者，通过self.distribution.metadata(self作为upload实例) 操纵分布元数据（即分类器）。你当然可以创建一个全新的命令来玩这个你的心内容（通过创建一个新的Command子类，并为此添加一个新的 entry_point）。

于 2016-09-16T01:25:54.873 回答