move table creation to jinja-based preprocessing

add new jinja2 requirement

introduce jinja2 for preprocessing SQL

Replaces various hand-crafted replacements of varying format with
a single Jinja2 templating mechanism. Allows full access to
configuration if necessary.

Merge pull request #2192 from lonvia/database-versioning

Introduce database versioning

document new status fields

return database version with status API

add database_version setting to tests

do not depend on cmdline parameter for creating partition tables

The partition numbers in use only depend on the entries in search_name.

save software version in the database

The version represents the software version that was used to
import the data.

report software version of status call

introduce database patch level for version

This will be needed later for automatic migrations.

make sure that calls to PHP legacy scripts are fatal on error

introduce table for in-database properties

Adds a simple table where settings for the database can be
saved. This is useful for state that must not change after
import.

remove unused import

use tmp_path fixture in config tests

fix typo

Merge pull request #2186 from lonvia/port-import-to-python

Move setup procedure to Python

make sure psql always finishes

If an execption is raised by other means, we still have to close
the stdin pipe to psql to make sure that it exits and releases its
connection to the database.

older versions of Postgresql need explicit return type

do not truncate search_name in reverse-only mode

actions: add psutil dependency

fix verbose flag for PHP wrapper scripts

The flag must come after the command.

bdd: use python library where possible

Replace calls to PHP scripts with direct calls into the
nominatim Python library where possible. This speed up
tests quite a bit.

move setup function to python

There are still back-calls to PHP for some of the sub-steps.
These needs some larger refactoring to be moved to Python.

properly close connections of indexer after use

prot load-data function to python

add a function for the intial indexing run

Also moves postcodes to fully parallel indexing.

remove unused partitionfunction function

port wikipedia importance functions to python

move import-data option to native python

This adds a new dependecy to the Python psutil package.

introduce custom object for cmdline arguments

Allows to define special functions over the arguments.

Also splits CLI tests in two files as they have become too many.

port database setup function to python

Hide the former PHP functions in a transition command until
they are removed.

use psql for executing sql files

This allows to run larger files without needing to keep
them in memory.

add function to set up libpq environment

Instead of parsing the DSN for each external libpq program we
are going to execute, provide a function that feeds them all
necessary parameters through the environment.

osm2pgsql is the first user.

convert connect() into a context manager

Merge pull request #2185 from lonvia/fix-deadlock-handling-for-psycopg27

Improve deadlock detection for various versions of psycopg2

improve deadlock detection for various versions of psycopg2

Psycopg2 has changed the kind of exception that is emitted on
deadlocks between versions 2.7 and 2.8. The code was already
trying to catch both kind of errors but because the
psycopg2.errors package is unknown in 2.7 and below, the
code would throw an exception on anything but a deadlock error.

This commit wraps the deadlock handling into a context manager
to avoid code duplication and uses module imports to detect if
the new error codes are available.

Also sets the required psycopg2 version to 2.7 or bigger as
versions below are difficult to test.

Merge pull request #2182 from lonvia/change-error-for-details

Return 404 for details when no object is found in database

return 404 for details when no bject is found in database

Fixes #2157.

Merge pull request #2181 from lonvia/port-more-tool-functions-to-python

Port more tool functions to python

avoid os.environ as default valie

fix return code for check database run with 'not applicable'

bdd tests: directly call python code for setup-website

port setup-website to python

add unit tests for new check_database code

port check-database function to python

This change also adapts the hints to use the nominatim tool.
Slightly changed checks, so that they are just as effective on
a frozen database.

use a frozen DB for API tests

This way we also test that dropping does the right thing.

remove unused code

port freeze function to python

Merge pull request #2173 from lonvia/penality-for-housenumberless-places

Increase penalty for places without housenumber

Merge pull request #2174 from lonvia/disable-jit-for-osm2pgsql-again

Disable JIT and parallel execution for osm2pgsql updates again

disable JIT and parallel execution for osm2pgsql updates again

The gazetteer output doesn't disable these functions when
writing to the place table but the triggers may contain
operations that cause misplanning for the query planner.

add simple test for result splitting with multiple ranks

increase penalty for places without housenumber

Results where the housenumber was dropped are an unlikely result
when they refer to something other than a street. Therefore
increase their result rank so that other matches are tried first
before choosing them as a result.

Improves #2167.

Merge pull request #2166 from mtmail/tiger-2020

documentation: 2020 TIGER data got released

Merge pull request #2171 from lonvia/update-vagrant-scripts-for-make-install

Update vagrant scripts for make install

switch vagrant scripts to make install

use file copy on older cmake to install osm2pgsql

Fixes #2170.

ignore failure to get replication date

documentation: 2020 TIGER data got released

Merge pull request #2164 from lonvia/add-make-install

Make Nominatim installable

always return 0 for updates unless there is an error

This is more in line with previous behavioru than returning
a status code when no updates are available.

docs: adapt check-database command

actions: remove install directories before import

This ensures that any dangling references to the build
or source directory are caught by the CI.

need test database for analysing cli test

actions: test import with installed version of Nominatim

add 'make install' to installation instructions

test for existance of country grid in cmake already

Given that the file potentially gets installed, it needs to be
present during build time already. Checking during the import
is too late.

make installation targets conditional to what is built

add make install target

Installation includes PHP andPython libraries, settings, the basic
country data, the postgresql module and our custom version of
osm2pgsql. The latter is installed in our private library directory
so that it does not get in the way of a potentially installed
osm2pgsql from the distribution.

adapt unit tests to new directory structure

use DataDir constant for data only

So far the data directory constant has pointed to the source
directory to be usable with different subdirectories. Now only
the data subdirectory itself is being used with the constant,
so point to the directory directly.

forgot to replace one occurence of sql_dir

remove unused BINDIR constant

introduce constant for configuration directory

This replaces {data_dir}/settings throughout the code, so that
the configuration may be placed somewhere else in the directory
structure (e.g. in /etc).

rename sql directory to lib-sql

Also introduces a separate constant for the sql directory, so that
it can be put separately from the rest of the data if required.

rename lib to lib-php

update osm2pgsql (disable install rule)

integrate analyse of indexing into nominatim tool

consolidate warm and db-check into single admin command

split cli.py by subcommands

Reduces file size below 1000 lines.

move website into php library directory

move postcode table setup to sql/

Also moves the call to the setup from the setup-db
step to the calculate-postcodes step. The tables also need
no longer be accessible by the webservice.

remove unused SQL script

fix off-by-one error in replication download

Merge pull request #2161 from lonvia/timeout-for-replication

Reintroduce timeout for replication file download

reintroduce timeout for replication file download

This ports the --socket-timeout parameter from
pyosmium-get-changes which ensures that the update
process eventually times out on hanging network connections.

Merge pull request #2160 from lonvia/introduce-project-dir

Officially introduce and recommend use of a project directory

replace make serve with nominatim serve command

With the website directory now tied to the project directory instead
of the build directory, it is no longer possible to use make for
running the web server.

add migration info for status table

Revert "increase splitting for large geometries"

This reverts commit 559fe513fa8ffa3a5bc3a7d07c252a872614c073.

Increasing the splitting results in geometries where with rounding
issues at the split points, so that contain operations do not
work as expected anymore.

Fixes #2137.

adapt quick start instructions in README to project dir

do not overwrite custom set module paths

Given that the module is now copied to the project directory
when no module path is set, we need the information that the
module path is empty. Therefore hand in the default module path
in a separate variable.

print project directory before running any command

make phpcs happy

actions: switch to using separate project dir

Also fixes reverse-only import which not run at all.

docs: add hint about putting the nominatim tool into the PATH

copy database module on install

When no explicity database module is configured, then the
module is now copied into the project directory and used from
there. This means that Nominatim can be updated to a new
version of the module while existing installation keep their
version of normalisation.

hand in absolute path to nominatim tool to php scripts

refer to new nominatim tool in configuration comments