https://github.com/csindle/aogn
Python asyncio OGN (Open Glider Network) client.
https://github.com/csindle/aogn
aprs async asyncio ogn open-glider-network python python39
Last synced: 7 days ago
JSON representation
Python asyncio OGN (Open Glider Network) client.
- Host: GitHub
- URL: https://github.com/csindle/aogn
- Owner: csindle
- License: agpl-3.0
- Created: 2021-08-04T14:01:53.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2021-08-05T10:39:46.000Z (over 4 years ago)
- Last Synced: 2025-09-30T02:17:49.997Z (4 months ago)
- Topics: aprs, async, asyncio, ogn, open-glider-network, python, python39
- Language: Python
- Homepage:
- Size: 25.4 KB
- Stars: 4
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
## Introduction
**AOGN** is an **A**synchronous **OGN** ([Open Glider Network](http://wiki.glidernet.org/)) client for modern Python.
It connects to the APRS servers and receives the planes', gliders', receivers', etc. APRS messages,
while still allowing you control of the program flow.
This can simplify programs since:
1. There are no callback or blocking functions (e.g. `listen()` or `run_forever()`).
2. One script/thread/process can still do other useful out-of-band tasks like
computing aggregate statistics and making web requests.
To interpret the raw OGN messages, use a function like
[python-ogn-client's](https://github.com/glidernet/python-ogn-client) `ogn.parser.parse`.
## Installation
```
pip install aogn
```
## Usage
Basic example:
```python
import asyncio
import logging
import sys
import aogn
logging.basicConfig(
stream=sys.stdout,
level=logging.DEBUG,
format='%(asctime)s %(levelname)s %(module)s %(message)s',
datefmt='%b %d %H:%M:%S',
)
async def example() -> None:
conn = aogn.Client(aprs_user='NO-CALL', )
try:
while True:
# Get the APRS packet once available:
raw_message = await conn.packet()
logging.debug(raw_message)
except KeyboardInterrupt:
logging.info('OGN Gateway stopped.')
await conn.disconnect()
if __name__ == '__main__':
asyncio.run(example())
```
---
Concurrent example, with raw_message [parsing](https://github.com/glidernet/python-ogn-client):
```python
import asyncio
import logging
import sys
logging.basicConfig(
stream=sys.stdout,
level=logging.DEBUG,
format='%(asctime)s %(levelname)s %(module)s %(message)s',
datefmt='%b %d %H:%M:%S',
)
from aogn import Client
from ogn.parser import parse, ParseError
def process_beacon(raw_message):
beacon = {}
try:
beacon = parse(raw_message)
except ParseError as err:
logging.warning(f'ParseError: {err}')
except NotImplementedError as err:
logging.error(f'NotImplementedError: {err}')
except AttributeError as err:
logging.error(f'raw_message: {raw_message}')
logging.error(f'beacon: {beacon}')
logging.error(err)
return beacon
async def example() -> None:
conn = Client(aprs_user='NO-CALL', ) # aprs_filter='t/s')
try:
while True:
raw_message = await conn.packet()
if raw_message:
beacon = process_beacon(raw_message)
except KeyboardInterrupt:
logging.info('OGN Gateway stopped.')
await conn.disconnect()
async def another_io_function() -> None:
import random
while True:
sleep_duration = 120 * random.random()
logging.debug(f'Concurrently sleeping for {sleep_duration:.0f} seconds...')
await asyncio.sleep(sleep_duration)
async def main():
await asyncio.gather(example(), another_io_function())
if __name__ == '__main__':
asyncio.run(main())
```