# Koleo CLI
[](https://pypi.org/project/koleo-cli)
[](https://pypi.org/project/koleo-cli)
## Installation
**install via pip by running** `pip install koleo-cli`
## 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
```
Raw data
{
"_id": null,
"home_page": "https://github.com/lzgirlcat/koleo-cli",
"name": "koleo-cli",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": "cb98uzhd@duck.com",
"keywords": "koleo, timetable, trains, rail, poland",
"author": "Zoey !",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/47/42/b266c6e12cfa90c32ca30b3461602d188001023c20a5976bf264817d8be1/koleo_cli-0.2.137.16.tar.gz",
"platform": null,
"description": "# Koleo CLI\n[](https://pypi.org/project/koleo-cli)\n[](https://pypi.org/project/koleo-cli)\n\n## Installation\n**install via pip by running** `pip install koleo-cli`\n\n\n\n\n## it currently allows you to:\n - get departures/arrival list for a station\n - 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)\n - find a station or list all known stations\n - find a connection from station a to b, with filtering by operators\n - save a station as your favourite to quickly check it's departures\n\nadditionally you can also use the KoleoAPI wrapper directly in your own projects, all returns are fully typed using `typing.TypedDict`\n\n## MY(possibly controversial) design choices:\n - platforms and track numbers are shown using arabic numerals instead of roman\n - you can change it by adding `use_roman_numerals: true` to your config.json file\n - most api queries are cached for 24h\n - you can change it by adding `disable_cache: true` to your config.json file\n - the cli.py code is really dirty but printing formatted data is hard :<\n\npull requests are welcome!!\n\n```\nusage: koleo [-h] [-c CONFIG] [--nocolor] {departures,d,dep,odjazdy,o,arrivals,a,arr,przyjazdy,p,trainroute,r,tr,t,poc,poci\u0105g,stations,s,find,f,stacje,ls,connections,do,z,szukaj,path} ...\n\nKoleo CLI\n\noptions:\n -h, --help show this help message and exit\n -c CONFIG, --config CONFIG\n Custom config path.\n --nocolor Disable color output and formatting\n\nactions:\n {departures,d,dep,odjazdy,o,arrivals,a,arr,przyjazdy,p,trainroute,r,tr,t,poc,poci\u0105g,stations,s,find,f,stacje,ls,connections,do,z,szukaj,path}\n departures (d, dep, odjazdy, o)\n Allows you to list station departures\n arrivals (a, arr, przyjazdy, p)\n Allows you to list station departures\n trainroute (r, tr, t, poc, poci\u0105g)\n Allows you to show the train's route\n stations (s, find, f, stacje, ls)\n Allows you to find stations by their name\n connections (do, z, szukaj, path)\n Allows you to search for connections from a to b\n```\n",
"bugtrack_url": null,
"license": "GNU General Public License v3.0",
"summary": "Koleo CLI",
"version": "0.2.137.16",
"project_urls": {
"Homepage": "https://github.com/lzgirlcat/koleo-cli",
"Issue Tracker": "https://github.com/lzgirlcat/koleo-cli/issues",
"Source (GitHub)": "https://github.com/lzgirlcat/koleo-cli"
},
"split_keywords": [
"koleo",
" timetable",
" trains",
" rail",
" poland"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c39e28b3f0f49e3708d86eca75dfcc70ca9e60e62a99575ee3d230c957a169d2",
"md5": "f2cf1525ee936bed49d9d5ac8ca0aedd",
"sha256": "a321ec62583c9408ef1d68da9f014431e0f59e8de8bd2ff83681cf6a31a211da"
},
"downloads": -1,
"filename": "koleo_cli-0.2.137.16-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f2cf1525ee936bed49d9d5ac8ca0aedd",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 25917,
"upload_time": "2025-01-06T13:13:51",
"upload_time_iso_8601": "2025-01-06T13:13:51.621341Z",
"url": "https://files.pythonhosted.org/packages/c3/9e/28b3f0f49e3708d86eca75dfcc70ca9e60e62a99575ee3d230c957a169d2/koleo_cli-0.2.137.16-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4742b266c6e12cfa90c32ca30b3461602d188001023c20a5976bf264817d8be1",
"md5": "9b39adaad593d9141cf8ff295671b141",
"sha256": "6f05dbbfb11d1bada9a922ca9d58a8defc49970ab1a27b89ca6f12375750f007"
},
"downloads": -1,
"filename": "koleo_cli-0.2.137.16.tar.gz",
"has_sig": false,
"md5_digest": "9b39adaad593d9141cf8ff295671b141",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 26468,
"upload_time": "2025-01-06T13:13:53",
"upload_time_iso_8601": "2025-01-06T13:13:53.756804Z",
"url": "https://files.pythonhosted.org/packages/47/42/b266c6e12cfa90c32ca30b3461602d188001023c20a5976bf264817d8be1/koleo_cli-0.2.137.16.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-06 13:13:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "lzgirlcat",
"github_project": "koleo-cli",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "rich",
"specs": [
[
"~=",
"13.7"
]
]
},
{
"name": "requests",
"specs": [
[
"~=",
"2.32"
]
]
}
],
"lcname": "koleo-cli"
}
JSON
