Koleo CLI

Installation

install via pip by running pip install koleo-cli

gif showcasing the functionality

it currently allows you to:

get departures/arrival list for a station
get train info given its number and name(pull requests are welcome if you know how to get a train object by just the number)
find a station or list all known stations
find a connection from station a to b, with filtering by operators
save a station as your favourite to quickly check it's departures

additionally you can also use the KoleoAPI wrapper directly in your own projects, all returns are fully typed using typing.TypedDict

MY(possibly controversial) design choices:

platforms and track numbers are shown using arabic numerals instead of roman
- you can change it by adding use_roman_numerals: true to your config.json file
most api queries are cached for 24h
- you can change it by adding disable_cache: true to your config.json file
the cli.py code is really dirty but printing formatted data is hard :<

pull requests are welcome!!

usage: koleo [-h] [-c CONFIG] [--nocolor] {departures,d,dep,odjazdy,o,arrivals,a,arr,przyjazdy,p,trainroute,r,tr,t,poc,pociąg,stations,s,find,f,stacje,ls,connections,do,z,szukaj,path} ...

Koleo CLI

options:
  -h, --help            show this help message and exit
  -c CONFIG, --config CONFIG
                        Custom config path.
  --nocolor             Disable color output and formatting

actions:
  {departures,d,dep,odjazdy,o,arrivals,a,arr,przyjazdy,p,trainroute,r,tr,t,poc,pociąg,stations,s,find,f,stacje,ls,connections,do,z,szukaj,path}
    departures (d, dep, odjazdy, o)
                        Allows you to list station departures
    arrivals (a, arr, przyjazdy, p)
                        Allows you to list station departures
    trainroute (r, tr, t, poc, pociąg)
                        Allows you to show the train's route
    stations (s, find, f, stacje, ls)
                        Allows you to find stations by their name
    connections (do, z, szukaj, path)
                        Allows you to search for connections from a to b

Metadata

Release files for koleo-cli 0.2.137.17

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for koleo-cli 0.2.137.17
File	Size	Uploaded
koleo_cli-0.2.137.17.tar.gz	27.2 kB	Apr 4, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for koleo-cli 0.2.137.17
File	Interpreter	ABI	Platform	Reset
koleo_cli-0.2.137.17-py3-none-any.whl 26.6 kB Apr 4, 2025	Python 3	none	any	Details

Total release size: 53.8 kB

Release files / koleo_cli-0.2.137.17.tar.gz

Download URL	koleo_cli-0.2.137.17.tar.gz
Size	27.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`f39e098e776bfc14a8bef3db3d967eef6d7ecc56a0a90ad8aaf591491c6315dc`
BLAKE2b-256 checksum How to use checksums	`8051665ab9d9eab7ec6e74aebe747a0b680e147943b8c8a85ac78f5e41c8b20f`
Upload date	Apr 4, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.9.21`

Release files / koleo_cli-0.2.137.17-py3-none-any.whl

Download URL	koleo_cli-0.2.137.17-py3-none-any.whl
Size	26.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`0ed1b60b54532b8dfc3ab6765920ae56d64282213a5c797799744bb0a83e2442`
BLAKE2b-256 checksum How to use checksums	`3aa46e8972fb21bcc942ce0ce149f4203cbe9e6338d2f100198e55a09f56c2bc`
Upload date	Apr 4, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.9.21`