mirror of
https://github.com/kaaninchen/Gleiswechsel.git
synced 2026-09-17 16:52:47 +00:00
transitous rewrite: retry on roundtrip connections
This commit is contained in:
Kaaninchen
@@ -1,175 +1 @@
|
|||||||
# Gleiswechsel
|
# Gleiswechsel
|
||||||
Gleiswechel ist ein Discord Bot, welcher einen Sprachkanal zu einer real-existierenden, aktuell befahrenden Zugverbindung umbenennt. Diesen Namen behält der Kanal so lange, wie die Verbindung in echt dauert.
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Der Bot stellt außerdem den `/info` Befehl dar, welcher einem weitere Informationen zur Verbindung zurückgibt
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
## Setup
|
|
||||||
```sh
|
|
||||||
git clone https://github.com/kaaninchen/Gleiswechsel.git
|
|
||||||
|
|
||||||
# Mit Python
|
|
||||||
python -m venv venv
|
|
||||||
source venv/bin/activate
|
|
||||||
pip install -r requirements.txt
|
|
||||||
|
|
||||||
# Mit uv
|
|
||||||
uv venv venv
|
|
||||||
source venv/bin/activate
|
|
||||||
uv pip install -r requirements.txt
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
### Config
|
|
||||||
|
|
||||||
`$ cp config.json.example config.json`
|
|
||||||
```jsonc
|
|
||||||
{
|
|
||||||
"token": "", // Token des Bots
|
|
||||||
"stations": [ "Berlin Hbf", "Hamburg Hbf", "München Hbf", "Amsterdam Centraal"], // Bahnhöfe, von denen die Anzeigetafelns gelesen werden. Namen kann man auf https://dbf.finalrewind.org/ nachschlagen.
|
|
||||||
"dbf": "https://dbf.finalrewind.org", // Die DBF Instanz. Normalerweise müsste man hier nichts ändern
|
|
||||||
"server": , // Discord Server ID
|
|
||||||
"vc": , // Server VC ID
|
|
||||||
"random": true, // Random Zug aus der Anzeigetafel (true) oder erster Zug, der angezeigt wird (false)
|
|
||||||
"emojis": true, // Emoji Namen beim Channel-Namen (true) oder nicht (false),
|
|
||||||
"formatting": "┇", // VC Name. Davor steht der Emoji, danach der Zug.
|
|
||||||
"announcemenents": true, // Announcements zur aktuellen Zugreise im VC-Kanal ja (true) oder nein (false)
|
|
||||||
"voice_announcements": [ // siehe weitere config erklärungen in der README, benötigt extra setup
|
|
||||||
{
|
|
||||||
"enabled": false,
|
|
||||||
"stations": {
|
|
||||||
"general": ""
|
|
||||||
}
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"blacklist": [] // Blacklist für bestimmte Zug-Typen
|
|
||||||
}
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
<details>
|
|
||||||
<summary>weitere Config Erklärungen</summary>
|
|
||||||
|
|
||||||
#### dbf:
|
|
||||||
Falls, aus irgendwelchem Gründen, man nicht die [offizielle DBF Instanz](https://dbf.finalrewind.org) nutzen möchte, hat man die Möglichkeiten seine eigene zu hosten. Instruction dazu gibts auf dem [zuständigen Repo](https://github.com/derf/db-fakedisplay). Dafür kann man das Feld in der config mit der eigenen URL austauschen.
|
|
||||||
|
|
||||||
#### random:
|
|
||||||
Bei kleineren Bahnhöfen stehen an den Anzeigetafeln öfters die Züge lange vor Abfahrt da, weil sonst der Bahnhof leer steht. Dadurch wird auch der Name des VC sehr lange gleich bleiben.
|
|
||||||
Sollte man `random = false` setzen, würde immer der erste Zug an der Anzeigetafel genommen werden, welcher auch der wäre welcher am frühesten losfährt. Wenn man viele Bahnhöfe hat besteht darin keine Gefahr.
|
|
||||||
|
|
||||||
Wenn man nur einen Bahnhof hat ist es stark empfohlen random zu nutzen. Sonst könnte der Bot bei unvollständigen Einträgen in einer Schleife immer wieder vergeblich den selben unvollständigen Zug probieren.
|
|
||||||
|
|
||||||
#### announcements:
|
|
||||||
Der Bot kann während der Zugreise Ankündigungen in den Textkanal vom Sprachkanal schicken. Das würde er aber auch nur machen wenn sich dort mindestens eine Person aufhält. Aktuelle Announcements:
|
|
||||||
- 3-5 Min vor Umstieg gibt es eine Ankündigung dafür
|
|
||||||
- Info Embed bei Umstieg
|
|
||||||
- voice_announcements
|
|
||||||
|
|
||||||
#### voice_announcements:
|
|
||||||
⚠️ Announcements muss aktiviert sein
|
|
||||||
|
|
||||||
Der Bot kann 3-5 Min vor Umstieg den VC joinen und eine Audiodatei abspielen. Dafür braucht der Bot ffmpeg.
|
|
||||||
|
|
||||||
```sh
|
|
||||||
$ sudo apt install ffmpeg # Debian/Ubuntu
|
|
||||||
|
|
||||||
$ brew install ffmpeg # macOS (brew)
|
|
||||||
```
|
|
||||||
|
|
||||||
##### Voice_announcements config:
|
|
||||||
|
|
||||||
```json
|
|
||||||
"voice_announcements": [
|
|
||||||
{
|
|
||||||
"enabled": true,
|
|
||||||
"stations": {
|
|
||||||
"general": "general.aac",
|
|
||||||
"Hannover": "hannover.aac"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
],
|
|
||||||
```
|
|
||||||
|
|
||||||
Audiodateien werden in [src/data/announcements](src/data/announcements) platziert. In der Config wird der Name der Station (z.B. Hannover) zu dem Namen der Audiodatei (z.B. hannover.aac) zugewiesen. Die Audiodatei braucht keinen Path.
|
|
||||||
|
|
||||||
Der Eintrag `general` meint die allgemeine Audiodatei, welche bei jeder Endstation (mit Ausnahme der zugewiesenen) spielt. Sollte man nur Audios bei zugewiesenen Endstationen abspielen wollen kann man `general` leerlassen, der bot skipped das ganze dann:
|
|
||||||
|
|
||||||
```json
|
|
||||||
"stations": {
|
|
||||||
"general": ""
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Es gibt außerdem die Möglichkeit, mehrere Audiodateien zu einer Endstation durch Listen zuzuweisen. Der Bot sucht sich dann jedes mal wenn er den vc joined eine davon aus.
|
|
||||||
|
|
||||||
```json
|
|
||||||
"stations": {
|
|
||||||
"general": ["general_1.aac", "general_2.aac"]
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
#### blacklist:
|
|
||||||
Die Blacklist ist dafür gedacht, ganze Zugtypen zu ignorieren. Beispielsweise möchte man, dass der Bot keine ICE's, keine NightJets und keine European Sleepers auswählt, da diese sehr lange Strecken fahren und der VC somit lange unverändert bleibt:
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"blacklist": [
|
|
||||||
"ICE",
|
|
||||||
"NJ",
|
|
||||||
"ES"
|
|
||||||
]
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Die Namen der einzelnen Zugtypen kann im Footer von `/info` oder im Terminal log erfahren.
|
|
||||||
|
|
||||||
#### src/data
|
|
||||||
Es kann vorkommen, dass während dem `/info` Befehl das Logo und die Farbe des Bahnuntermehns fehlt.
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Die zugehörigen Daten lassen sich innerhalb [src/data/operators.py](src/data/operators.py) ergänzen. Der Aufbau dabei sollte selbsterklärend sein, dennoch habe ich eine kleine Beschreibung in die Datei hinzugefügt. Bei Änderungen sind PR's willkommen.
|
|
||||||
|
|
||||||
Emojis für die Formattierung werden dynamisch anhand des Zugtypens gepulled. Dabei wird zwischen Nahverkehr und Fernverkehr unterschieden. Bei einem Zugtyp, welcher zu keiner der Kategorie assigned ist, wird ein Fallback Emoji eingesetzt. Sollte man einen Zugtypen hinzufügen wollen oder die Emojis ändern/deaktivieren wollen ist dies in [src/data/emojis.py](src/data/emojis.py) möglich. Die Namen der einzelnen Zugtypen kann im Footer von `/info` oder im Terminal log erfahren.
|
|
||||||
|
|
||||||
Den Status, den sich der Bot alle 5 Minuten random auswählt, kann man in [src/data/status.py](src/data/status.py) anpassen.
|
|
||||||
|
|
||||||
</details>
|
|
||||||
|
|
||||||
### Running
|
|
||||||
|
|
||||||
```sh
|
|
||||||
# Python
|
|
||||||
python main.py
|
|
||||||
# ODER
|
|
||||||
python3 main.py
|
|
||||||
|
|
||||||
# uv
|
|
||||||
uv run main.py
|
|
||||||
```
|
|
||||||
|
|
||||||
## Bekannte Bugs
|
|
||||||
#### Stuttgart in Berlin
|
|
||||||
Ich weiß nicht ganz wieso, aber die API vertauscht manchmal die S-Bahn von Berlin mit der S-Bahn von Stuttgart. Es scheint eher ein API-Issue zu sein, weswegen ich da leider mit dem Bot nicht viel ändern kann.
|
|
||||||
Der Bug führt dazu, dass bei manchen S-Bahn Verbindungen `DB Regio AG S-Bahn Stuttgart` als Betreiber der Berlin S-Bahn angezeigt wird. Außerdem gibt die API dem Bot die Ankunftszeiten einer S-Bahn Verbindung von Stuttgart wieder, während die Route von der aus Berlin stammt (Die Route und die Ankunftszeiten werden von zwei verschiedenen Endpoints gepulled: Route: `{dbf}/Berlin%20Hbf.json`, Ankunftszeit: `{dbf}/z/S%20{ID}/Berlin Hbf.json`).
|
|
||||||
Falls das einem zu sehr stört kann man S-Bahns auf die Blacklist packen.
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"blacklist": [
|
|
||||||
"S "
|
|
||||||
]
|
|
||||||
}
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
#### Nahreisezug
|
|
||||||
Der Bot empfängt durch die dbf API ein Operator Field, wo der Betreiber des Züges angezeigt wird. Dadurch kann im `/info` Embed das Logo durch [src/data/operators.py](src/data/operators.py) zugewiesen werden. Manchmal schmeißt die API aber als Operator "Nahreisezug" aus.
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Wenn mehrere Betreiber angezeigt werden (bspw `["SBB", "Nahreisezug"]`) versucht der Bot immer, den Embed den bekannten Betreiber (in dem Fall SBB) zuzuweisen. Sollte allerdings nur Nahreisezug angezeigt werden, kann damit nicht gearbeitet werden, wodurch die Fallback Metadaten genutzt werden.
|
|
||||||
|
|
||||||
Die Fallback Metadaten können in [src/data/operators.py](src/data/operators.py) angepasst werden.
|
|
||||||
@@ -21,16 +21,13 @@ if len(sys.argv) > 1:
|
|||||||
async def on_ready():
|
async def on_ready():
|
||||||
global _bot_initialized
|
global _bot_initialized
|
||||||
|
|
||||||
logger(f"{bot.user} ist online")
|
|
||||||
|
|
||||||
if not _bot_initialized:
|
if not _bot_initialized:
|
||||||
|
logger(f"{bot.user} ist online")
|
||||||
_bot_initialized = True
|
_bot_initialized = True
|
||||||
server_id = config.discord.server
|
server_id = config.discord.server
|
||||||
server_vc_id = config.discord.vc
|
server_vc_id = config.discord.vc
|
||||||
channel = validate_channel(bot=bot, server_id=server_id, channel_id=server_vc_id)
|
channel = validate_channel(bot=bot, server_id=server_id, channel_id=server_vc_id)
|
||||||
await rename_vc(bot, voice_channel=channel)
|
await rename_vc(bot, voice_channel=channel)
|
||||||
else:
|
|
||||||
logger("Reconnected to discord gateway, this wont disturb your current ride")
|
|
||||||
|
|
||||||
try:
|
try:
|
||||||
bot.run(config.discord.token)
|
bot.run(config.discord.token)
|
||||||
|
|||||||
@@ -211,6 +211,10 @@ def get_trip_details(random_connection: dict | None) -> dict | None:
|
|||||||
start_time = legs["startTime"]
|
start_time = legs["startTime"]
|
||||||
mode = legs["mode"]
|
mode = legs["mode"]
|
||||||
|
|
||||||
|
if goes_to == train_from:
|
||||||
|
logger(f"Bot doesn't know what to do with round trips, I'll have to implement this some day", "error")
|
||||||
|
return None # TODO actually handel this
|
||||||
|
|
||||||
arrival_dt = parse_iso(end_time)
|
arrival_dt = parse_iso(end_time)
|
||||||
departure_dt = parse_iso(start_time)
|
departure_dt = parse_iso(start_time)
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user