add details about how tests+submodules work - refs #2789 [skip ci]
This commit is contained in:
parent
404f942e4b
commit
ff3289abe9
2 changed files with 25 additions and 1 deletions
5
Makefile
5
Makefile
|
@ -58,7 +58,10 @@ rebuild:
|
||||||
uninstall:
|
uninstall:
|
||||||
@$(PYTHON) scons/scons.py -j$(JOBS) --config=cache --implicit-cache --max-drift=1 uninstall
|
@$(PYTHON) scons/scons.py -j$(JOBS) --config=cache --implicit-cache --max-drift=1 uninstall
|
||||||
|
|
||||||
test:
|
test/data:
|
||||||
|
git submodule update --init
|
||||||
|
|
||||||
|
test: ./test/data
|
||||||
@./test/run
|
@./test/run
|
||||||
|
|
||||||
check: test
|
check: test
|
||||||
|
|
|
@ -1,5 +1,26 @@
|
||||||
# Contributing
|
# Contributing
|
||||||
|
|
||||||
|
## Testing
|
||||||
|
|
||||||
|
Developers adding new features or fixing bugs should always write tests alongside.
|
||||||
|
|
||||||
|
Mapnik has both C++ unit tests in `./test/unit` and visual tests in `./test/visual`.
|
||||||
|
|
||||||
|
Test data for the unit and visual tests is pulled in from standalone repos via git submodules.
|
||||||
|
|
||||||
|
After building Mapnik (see INSTALL.md), the submodules can be loaded and the tests can be run like:
|
||||||
|
|
||||||
|
make test
|
||||||
|
|
||||||
|
Developers with commit access can update test data like:
|
||||||
|
|
||||||
|
cd test/data
|
||||||
|
git remote set-url origin git@github.com:mapnik/test-data
|
||||||
|
git commit -a -m "update test data"
|
||||||
|
git push origin HEAD:master
|
||||||
|
cd ../../
|
||||||
|
git commit test/data -m "update test-data submodule"
|
||||||
|
|
||||||
## Community
|
## Community
|
||||||
|
|
||||||
Mapnik is a creative community focused on making beautiful maps with beautiful software.
|
Mapnik is a creative community focused on making beautiful maps with beautiful software.
|
||||||
|
|
Loading…
Reference in a new issue