Merge pull request #782 from lonvia/rework-postcodes

[nominatim.git] / test / README.md

diff --git a/test/README.md b/test/README.md
index f6112620018513f6ef49e1db7833eb8ca0ccccef..f6c1ac2a9edeb816f20865ea4b5558ce4b7d1556 100644 (file)
--- a/test/README.md
+++ b/test/README.md
@@ -120,6 +120,21 @@ 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. On Debian/Ubuntu run:
+
+    apt-get install php-codecoverage
+
+The run the API tests as follows:
+
+    behave api -DPHPCOV=<coverage output dir>
+
+To generate reports, you can use the phpcov tool:
+
+    phpcov merge --html=<report output dir> <coverage output dir>
+
 ### Indexing Tests (`test/bdd/db`)
 
 These tests check the import and update of the Nominatim database. They do not