你想改进maproxy,找到一个bug并修复它吗?伟大的!本文档为您提供了一些有用的信息。
版本可从 PyPI project page of MapProxy . 也有 an archive of all releases .
MapProxy使用 Git 作为源代码管理工具。如果您不熟悉分布式SCMS或Git,我们建议您阅读 Pro Git .
主(权威)存储库位于http://github.com/mapproxy/mapproxy
要获取存储库的副本,请调用:
git clone https://github.com/mapproxy/mapproxy
如果你想贡献一个补丁,请考虑 `creating a "fork"`_ 代替。这使我们所有人的生活更容易。
这是您正在阅读的文档。原始文件可以在 doc/
. HTML版本用户文档是用 Sphinx . 要重建此文档,请安装sphinx pip install sphinx sphinx-bootstrap-theme
并打电话 python setup.py build_sphinx
. 输出显示在 build/sphinx/html
. 最新文档可在 http://mapproxy.org/docs/lates/
.
我们正在使用 the issue tracker at GitHub 管理所有的bug报告、增强功能和对maproxy的新功能请求。往前走 create new tickets . 随时可以发布到 mailing list 首先,如果您不确定是否真的发现了错误,或者功能请求是否在maproxy范围内。
maproxy包含许多自动测试。如果你不算在 mapproxy-seed
-工具和wsgi应用程序,测试覆盖率约为95%。我们希望保持这个数字很高,所以所有新的开发都应该包括一些测试。
MapProxy使用 pytest 作为测试加载器和运行程序。
pip安装pytest
要运行实际测试,请调用:
pytest
所有与maproxy相关讨论的首选媒介是我们的邮件列表maproxy@lists.osgeo.org您必须 subscribe 在你能写之前把它放到列表上。档案馆是 available here .
你正在使用 virtualenv 如上所述 安装 对吧?
在开始对maproxy进行黑客攻击之前,应该在开发模式下安装它。在mapproxy调用的根目录中 pip install -e ./
. 而不是安装并将maproxy复制到 virtualenv ,这将只链接到源目录。如果现在启动maproxy,将使用maproxy目录中的源。如果重新启动maproxy,代码中所做的任何更改都将可用。如果您使用 mapproxy-util serve-develop
命令,源中的任何更改都将发出maproxy服务器的重新加载。
maproxy通常遵循 Style Guide for Python Code . 唯一的例外是我们允许大约90个字符的行宽。新文件应自动格式化为 black .