Metadata-Version: 2.1
Name: fasva-osmserver
Version: 0.1.3
Summary: Server to forward requests to the overpass server.
Home-page: UNKNOWN
Author: Lars Klitzke
Author-email: lars.klitzke@hs-emden-leer.de
License: UNKNOWN
Platform: UNKNOWN
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Natural Language :: English
Classifier: Intended Audience :: Developers
Description-Content-Type: text/markdown
Requires-Dist: aiohttp
Requires-Dist: pymodconf

# FASva-OSMServer

This is a server to forward requests to the local Overpass server.

## Installation

You can find the latest version on [PyPi](https://pypi.org/project/fasva-osmserver/). So simply use `pip` with

```bash
pip install fasva-osmserver
```

After the installation, a configuration file `osmserver.cfg` is installed into the `<venv>/share` directory. Adapt the
options to your needs.

## Usage

Start the server with and either specify the `--config` flag to explicitly point to a configuration file or
let the server use the installed configuration file.

```bash
osmserver --config <directory>/osmserver.cfg
```

## System service

Instead of calling `osmserver` directly, you can install it as a system service to automatically
start it on system startup.

Therefore, a file `osmserver.service` can be found in `<venv>/share/` next to the configuration
file. Before installing the service, you may have to adapt the path to osmserver. Then, copy the service
file to `/etc/systemd/system` with

```bash
cp <venv>/share/osmserver.service /etc/systemd/service
```

and enable the service with

```bash
systemctl enable osmservice.service
```



