X-Git-Url: https://git.openstreetmap.org./nominatim.git/blobdiff_plain/308bfcbf257c5dae3c8e178a53db00f5851b041c..2bf546fbf4a4e3509978d3360060a3d2dc665c5c:/test/README.md?ds=inline diff --git a/test/README.md b/test/README.md index f6112620..2a357e40 100644 --- a/test/README.md +++ b/test/README.md @@ -100,7 +100,7 @@ be documented. These tests are meant to test the different API endpoints and their parameters. They require a preimported test database, which consists of the import of a planet extract. A precompiled PBF with the necessary data can be downloaded from -http://www.nominatim.org/data/test/nominatim-api-testdata.pbf +https://www.nominatim.org/data/test/nominatim-api-testdata.pbf The polygons defining the extract can be found in the test/testdb directory. There is also a reduced set of wikipedia data for this extract, @@ -112,7 +112,7 @@ planets are likely to work as well but you may see isolated test failures where the data has changed. To recreate the input data for the test database run: - wget http://free.nchc.org.tw/osm.planet/pbf/planet-160725.osm.pbf + wget https://free.nchc.org.tw/osm.planet/pbf/planet-160725.osm.pbf osmconvert planet-160725.osm.pbf -B=test/testdb/testdb.polys -o=testdb.pbf Before importing make sure to add the following to your local settings: @@ -120,6 +120,23 @@ Before importing make sure to add the following to your local settings: @define('CONST_Database_DSN', 'pgsql://@/test_api_nominatim'); @define('CONST_Wikipedia_Data_Path', CONST_BasePath.'/test/testdb'); +#### Code Coverage + +The API tests also support code coverage tests. You need to install +[PHP_CodeCoverage](https://github.com/sebastianbergmann/php-code-coverage). +On Debian/Ubuntu run: + + apt-get install php-codecoverage php-xdebug + +The run the API tests as follows: + + behave api -DPHPCOV= + +The output directory must be an absolute path. To generate reports, you can use +the [phpcov](https://github.com/sebastianbergmann/phpcov) tool: + + phpcov merge --html= + ### Indexing Tests (`test/bdd/db`) These tests check the import and update of the Nominatim database. They do not