bitbucket-distutils 0.1.2

简介

Distribute/setuptools/distutils命令，用于Bitbucket。您可以使用Bitbucket的下载来替代PyPI的下载进行发布。

要使用此命令，请按照以下说明操作。

说明

首先，您的软件必须按照标准分发方式打包：使用distutils，Distribute或setuptools。此软件包包含一个扩展命令。

然后，将此软件包添加到您的setup.py脚本中的setup_requires参数中。

setup(name='YourPackageName',
      version='1.2.3',
      ...,
      setup_requires=['bitbucket-distutils >= 0.1.2'])

现在，您的setup.py将有一个覆盖的upload命令。

$ python setup.py upload --help
Common commands: (see '--help-commands' for more)

...

Options for 'upload' command:
  --bb-repository (-R)  Bitbucket repository name e.g. user/reponame
  --bb-username (-u)    Bitbucket username
  --bb-password (-p)    Bitbucket password

...

如您所见，命令中存在以--bb-为前缀的选项。如果未提供-u（或--bb-username）和--p（或--bb-password），则会显示提示。需要-R（或--bb-repository）。

上传

上传非常简单

$ python setup.py sdist upload -R user/reponame register

通过说明

sdist

生成源分发文件。如果您的包名为YourPackageName，版本为1.2.3，那么其文件名将变为YourPackageName-1.2.3.tar.gz。

upload -R user/reponame

将构建的源分发文件上传到您的Bitbucket仓库。这并不意味着它会受到版本控制，但它会被简单地上传到其下载页面。

register

使用Bitbucket下载URL将此版本的包注册到PyPI。PyPI页面的URL将是http://pypi.python.org/YourPackageName/1.2.3

默认选项

您可以通过在setup.cfg配置文件中指定来为这些选项设置默认值。例如，如果您想为--bb-repository设置默认值，请创建一个如下的（连字符变为下划线）setup.cfg文件：

[upload]
bb_repository = user/reponame

您还可以创建一个简短的别名

[aliases]
release = sdist upload register

作者和许可

它属于公共领域。您只需做您想做的。由Hong Minhee编写。

您可以从其Bitbucket Mercurial仓库中检出源代码。

$ hg clone https://bitbucket.org/dahlia/bitbucket-distutils

如果您发现了错误，请向问题跟踪器报告。