X-Git-Url: https://git.openstreetmap.org./nominatim.git/blobdiff_plain/bc7f6209d83dcc161f093ce9907991facabb3491..32dbf83747e0339d93d6200ff43f73221e9e863c:/docs/develop/Development-Environment.md diff --git a/docs/develop/Development-Environment.md b/docs/develop/Development-Environment.md index 65dc7990..3234b8cb 100644 --- a/docs/develop/Development-Environment.md +++ b/docs/develop/Development-Environment.md @@ -1,6 +1,6 @@ # Setting up Nominatim for Development -This chapter gives an overview how to set up Nominatim for developement +This chapter gives an overview how to set up Nominatim for development and how to run tests. !!! Important @@ -36,11 +36,20 @@ It has the following additional requirements: * [mypy](http://mypy-lang.org/) (plus typing information for external libs) * [Python Typing Extensions](https://github.com/python/typing_extensions) (for Python < 3.9) * [pytest](https://pytest.org) +* [pytest-asyncio](https://pytest-asyncio.readthedocs.io) + +For testing the Python search frontend, you need to install extra dependencies +depending on your choice of webserver framework: + +* [sanic-testing](https://sanic.dev/en/plugins/sanic-testing/getting-started.html) (sanic only) +* [httpx](https://www.python-httpx.org/) (starlette only) +* [asgi-lifespan](https://github.com/florimondmanca/asgi-lifespan) (starlette only) The documentation is built with mkdocs: * [mkdocs](https://www.mkdocs.org/) >= 1.1.2 -* [mkdocstrings](https://mkdocstrings.github.io/) +* [mkdocstrings](https://mkdocstrings.github.io/) >= 0.16 +* [mkdocstrings-python-legacy](https://mkdocstrings.github.io/python-legacy/) ### Installing prerequisites on Ubuntu/Debian @@ -54,8 +63,10 @@ To install all necessary packages run: sudo apt install php-cgi phpunit php-codesniffer \ python3-pip python3-setuptools python3-dev -pip3 install --user behave mkdocs mkdocstrings pytest \ - pylint mypy types-PyYAML types-jinja2 types-psycopg2 +pip3 install --user behave mkdocs mkdocstrings pytest pytest-asyncio pylint \ + mypy types-PyYAML types-jinja2 types-psycopg2 types-psutil \ + types-ujson types-requests types-Pygments typing-extensions\ + sanic-testing httpx asgi-lifespan ``` The `mkdocs` executable will be located in `.local/bin`. You may have to add