Pycsw 项目是开源的,欢迎贡献 (bug 报告、 bug 修复、 代码增强功能等)。 此篇文章将概述pycsw 的一些作用。 pycsw community ,就是提供一些建议,应该如何连接和参与 pycsw 社区,并如何更好地发展。
以下是几项pycsw做出的贡献:
贡献者应当符合 许可证 准则。
大家好,我愿意在pycsw贡献 <feature X|bugfix Y|docs|something else>。我确认,我对pycsw的贡献将与pycsw 许可指南兼容。
docs/
中管理,以 reStructuredText 格式pycsw 的 问题跟踪器 ,是报告错误或要求改进的地方。当您提交出现的错误时,一定要指定您正在使用的pycsw版本,相应的组件,如何操作显示的错误信息,以及Python和平台的版本。为方便起见,你可以运行 pycsw-admin.py -c get_sysprof
,并将输出信息复制、粘贴到您的问题中。
通过 GitHub pull 请求后,贡献是最容易管理的。 'Fork <https: github.com/geopython/pycsw/fork>' _ pycsw 放到你自己 GitHub 存储库中,这样可以轻松地提交你的工作,并提交pull请求。
[ci skip]
也是做为提交消息的一部分,则不需要运行 Travis CI#1234
)pep8
与 pylint,运行除了 C0111
的源代码。sbin/pycsw-pylint.sh
是为了方便起见ExceptionReport
XML运行方式为个别例外,通常会指定合适的 '定位器 '和' 代码 ' 参数这一节将指导您操作pycsw的步骤。 本节假定在您自己GitHub资料库中,有分叉的 pycsw。
# setup a virtualenv
virtualenv mypycsw && cd mypycsw
. ./bin/activate
# clone the repository locally
git clone git@github.com:USERNAME/pycsw.git
cd pycsw
pip install -e . && pip install -r requirements-standalone.txt
# add the main pycsw master branch to keep up to date with upstream changes
git remote add upstream https://github.com/geopython/pycsw.git
git pull upstream master
# create a local branch off master
# The name of the branch should include the issue number if it exists
git branch issue-72
git checkout issue-72
#
# make code/doc changes
#
git commit -am 'fix xyz (#72)'
git push origin issue-72
您的更改在 GitHub自己的 pycsw 存储库为可见状态。 现在你要创建pull请求。Pycsw的团队成员将审查你的pull请求,若您有需要,团队成员会提供给您反馈建议。如果需要改动,要另立分支,并push以上步骤 (pull请求中所有更改的分支)。
然后pycsw 团队将合并pull请求。 你可以删除掉你本地的分支(在 GitHub),更新您自己的库,以确保您的 pycsw 存储库与pycsw总站是同步的:
git checkout master
git pull upstream master