Skip to main content

edfh-data

Python library for the E:D Faction Hub application backend data services:

  • EDDN listener service, receives messages from the EDDN stream and publishes them to a RabbitMQ exchange.
  • EDDN handler service, polls message from a RabbitMQ queue, parses them and stores the relevant info in a relational database.

Requirements

  • Python 3.13 available in the sytem path.
  • Running RabbitMQ and MariaDB instances (the included docker-compose.yaml file can set them up for development).

Configuration

The following configuration variables are defined are defined as environment variables, or, for local development, specified in a .env configuration file:

DB_USER=dbuser
DB_PASSWD=<db_password>
DB_HOST=localhost
DB_PORT=3306
DB_NAME=edfh
RMQ_USER=rmquser
RMQ_PASSWD=<rabbitmq_password>
RMQ_HOST=localhost
RMQ_HANDLER_PREFETCH=10
EDFH_EDDN_MESSAGE_MAX_AGE_DAYS=7

Usage

Install the package with the eddn extra:

python -m pip install edfh-data[eddn]

Launch the EDDN message handler service with:

eddn-handle

Launch the EDDN listener service with:

eddn-listen

Development

Python environment

Create a virtual environment using Python 3.13:

python3.13 -m venv .venv --prompt edfh-data --upgrade-deps
source .venv/bin/activate

Install the package in development mode along with the development dependencies:

python -m pip install -e .[dev]

Install pre-commit hooks:

pre-commit install

Database service

Migrate the database with:

alembic upgrade head

Generate a new revision:

alembic revision --autogenerate -m "Revision message"

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

edfh_data-0.18.0.tar.gz (16.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

edfh_data-0.18.0-py3-none-any.whl (16.4 kB view details)

Uploaded Python 3

File details

Details for the file edfh_data-0.18.0.tar.gz.

File metadata

  • Download URL: edfh_data-0.18.0.tar.gz
  • Upload date:
  • Size: 16.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.14

File hashes

Hashes for edfh_data-0.18.0.tar.gz
Algorithm Hash digest
SHA256 10400149885b42ae78263b6ebd2a3d6800c7b27d47803e40a4b9e41d2e26903d
MD5 3072268f083807c21ca694ca74aeee9f
BLAKE2b-256 104d36a04262ec826f9ebadf284d74662b6d13f28e244a95fb2c0e23f297ee42

See more details on using hashes here.

File details

Details for the file edfh_data-0.18.0-py3-none-any.whl.

File metadata

  • Download URL: edfh_data-0.18.0-py3-none-any.whl
  • Upload date:
  • Size: 16.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.14

File hashes

Hashes for edfh_data-0.18.0-py3-none-any.whl
Algorithm Hash digest
SHA256 156598320fa6b84f5bbd4ab0e942a7f7297d704dfb26708afabb3584c311f958
MD5 bc87df797ffc05a24f92f83d5249f1aa
BLAKE2b-256 7e58cd4de4432b01f05c85511439c6fad16ee6aaa5ec8a95d98d999c426b5f1c

See more details on using hashes here.

Release history Release notifications | RSS feed

0.20.1

2 files

0.20.0

2 files

0.19.0

2 files

0.18.1

2 files

This release

0.18.0 This release

2 files

0.17.0

2 files

0.16.1

2 files

0.16.0

2 files

0.15.0

1 file

0.14.1

2 files

0.14.0

2 files

0.13.0

2 files

0.12.0

2 files

0.11.1

2 files

0.11.0

2 files

0.10.0

2 files

0.9.2

2 files

0.9.1

2 files

0.9.0

2 files

0.8.1

2 files

0.8.0

2 files

0.7.1

2 files

0.7.0

2 files

0.6.0

2 files

0.5.2

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page