github-distutils 0.1.1

简介

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

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

说明

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

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

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

现在，您的setup.py将有一个名为github_upload的命令。

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

...

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

...

如果未提供-u/--username和-p/--password，则会显示提示。需要-R/--repository。

上传

上传非常简单

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

通过说明

构建源分发包

生成源分发包文件。如果你的包名为YourPackageName，版本号为1.2.3，那么它的文件名将是YourPackageName-1.2.3.tar.gz。

github_upload -R 用户/仓库名

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

注册

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

默认选项

您可以通过在setup.cfg配置文件中指定来为这些选项设置默认值。例如，如果您想为--repository设置默认值，创建一个类似于以下内容的setup.cfg文件（短划线变为下划线）

[upload]
repository = user/reponame

您还可以创建一个简写别名

[aliases]
release = sdist github_upload register

作者和许可证

它是在公共领域下分发的。只需做你想做的。由Hong Minhee编写。

您可以从其GitHub仓库检出源代码

$ git clone git://github.com/dahlia/github-distutils.git

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

针对Bitbucket用户

如果您使用的是Bitbucket而不是GitHub，请使用同一作者编写的bitbucket-distutils包。

变更日志