vvspy 0.2.1

API Wrapper for VVS (Verkehrsverbund Stuttgart)

VVS API Wrapper

Fully object-oriented library to integrate the VVS API into your project.

Installation

pip install vvspy

Requirement: Python 3.6 or higher

Examples

• Detect delay in upcoming departures:

from vvspy import get_departures

deps = get_departures("5006115", limit=3)  # Stuttgart main station
for dep in deps:
    if dep.delay > 0:
        print("Alarm! Delay detected.")
        print(dep)  # Timestamp @ Station: Train: Origin - Destination

• Get complete trip info between two stations (including interchanges):

from vvspy import get_trips

trips = get_trips("5000355", "5005600", limit=1)  # Stuttgart main station
for trip in trips:
    print(f"Duration: {trip.duration / 60} minutes")
    for connection in trip.connections:
        print(f"From: {connection.origin.name} - To: {connection.destination.name}")

# Output:
Duration: 58 minutes
From: Wallgraben - To: Hauptbf (A.-Klett-Pl.)
From: Hauptbf (Arnulf-Klett-Platz) - To: Stuttgart Hauptbahnhof (tief)
From: Stuttgart Hauptbahnhof (tief) - To: Marbach (N)
From: Marbach (N) Bf - To: Murr Hardtlinde

• Filter for specific lines:

from vvspy import get_departures

deps = get_departures("5006118")  # Stuttgart main station (lower)
for dep in deps:
    if dep.serving_line.symbol == "S4":
        print(f"Departure of S4 at {dep.real_datetime}")

Features

• [x] fully object oriented results

• [ ] full customizable requests and parameters # coming soon

• [x] parsing all available info into result obj

• [x] Well tested and maintained

• [x] Departures, Arrivals, Trips, Station info, Upcoming events, Maintenance work

• See issues/projects on GitHub for upcoming features

Contributors

License:

This project is licensed under MIT.