ogn-client 0.9.0

A python module for the Open Glider Network

# python-ogn-client

[](https://travis-ci.org/glidernet/python-ogn-client)
[](https://pypi.python.org/pypi/ogn-client)
[](https://coveralls.io/github/glidernet/python-ogn-client?branch=master)

A python3 module for the [Open Glider Network](http://wiki.glidernet.org/).
It can be used to connect to the OGN-APRS-Servers and to parse APRS-/OGN-Messages.

A full featured gateway with build-in database is provided by [ogn-python](https://github.com/glidernet/ogn-python).


## Installation

python-ogn-client is available at PyPI. So for installation simply use pip:

```
pip install ogn-client
```

## Example Usage

Parse APRS/OGN packet.

```
from ogn.parser import parse
from datetime import datetime

beacon = parse("FLRDDDEAD>APRS,qAS,EDER:/114500h5029.86N/00956.98E'342/049/A=005524 id0ADDDEAD -454fpm -1.1rot 8.8dB 0e +51.2kHz gps4x5",
reference_timestamp=datetime(2015, 07, 31, 12, 34, 56))
```

Connect to OGN and display all incoming beacons.

```
from ogn.client import AprsClient
from ogn.parser import parse, ParseError

def process_beacon(raw_message):
try:
beacon = parse(raw_message)
print('Received {beacon_type}: {raw_message}'.format(**beacon))
except ParseError as e:
print('Error, {}'.format(e.message))

client = AprsClient(aprs_user='N0CALL')
client.connect()

try:
client.run(callback=process_beacon, autoreconnect=True)
except KeyboardInterrupt:
print('\nStop ogn gateway')
client.disconnect()
```

## License
Licensed under the [AGPLv3](LICENSE).