Update README help display
This commit is contained in:
parent
eca5f2e439
commit
a108a0bdc3
GPG key ID:
4E535BC19C61886E
1 changed files with 54 additions and 32 deletions
86
README.md
86
README.md
|
|
@ -18,43 +18,62 @@ Most options should be pretty self-explanatory, but a few notes:
|
||||||
- You can use the price snapshots, if you decide to create them with `dump-price-snapshot`, to create pretty time series graphs
|
- You can use the price snapshots, if you decide to create them with `dump-price-snapshot`, to create pretty time series graphs
|
||||||
- Currently, we _only_ support `ntfy`, as well as the official `ntfy` server as the notification channel
|
- Currently, we _only_ support `ntfy`, as well as the official `ntfy` server as the notification channel
|
||||||
|
|
||||||
```help
|
```sh
|
||||||
Usage: nightjet [OPTIONS] TRAVEL_DATE
|
Usage: nightjet [OPTIONS] COMMAND [ARGS]...
|
||||||
|
|
||||||
|
╭─ Options ───────────────────────────────────────────────────────────────────────────────────────────────────────────╮
|
||||||
|
│ --install-completion Install completion for the current shell. │
|
||||||
|
│ --show-completion Show completion for the current shell, to copy it or customize the installation. │
|
||||||
|
│ --help Show this message and exit. │
|
||||||
|
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
|
╭─ Commands ──────────────────────────────────────────────────────────────────────────────────────────────────────────╮
|
||||||
|
│ query Check the (lowest) prices for a single connection. │
|
||||||
|
│ lastdate Check for the currently latest possible booking date. │
|
||||||
|
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
|
```
|
||||||
|
|
||||||
|
```sh
|
||||||
|
Usage: nightjet query [OPTIONS] TRAVEL_DATE
|
||||||
|
|
||||||
|
Check the (lowest) prices for a single connection.
|
||||||
|
|
||||||
|
Will run repeatedly or one-shot and query the prices for a specific connection. Can be set to output all available
|
||||||
|
prices or just output the lowest found. Outputs will (curently) always be given as csv files.
|
||||||
|
|
||||||
╭─ Arguments ─────────────────────────────────────────────────────────────────────────────────────────────────────────╮
|
╭─ Arguments ─────────────────────────────────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ * travel_date TEXT Travel day to search from. (YYYY-MM-DD) [default: None] [required] │
|
│ * travel_date TEXT Travel day to search from. (YYYY-MM-DD) [default: None] [required] │
|
||||||
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
|
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
╭─ Options ───────────────────────────────────────────────────────────────────────────────────────────────────────────╮
|
╭─ Options ───────────────────────────────────────────────────────────────────────────────────────────────────────────╮
|
||||||
│ --start-station INTEGER Departure station number. (default: Berlin Hbf) │
|
│ --start-station INTEGER Departure station number. (default: Berlin Hbf) │
|
||||||
│ [default: 8096003] │
|
│ [default: 8096003] │
|
||||||
│ --end-station INTEGER Destination station number. (default: Paris Est) │
|
│ --end-station INTEGER Destination station number. (default: Paris Est) │
|
||||||
│ [default: 8796001] │
|
│ [default: 8796001] │
|
||||||
│ --birthdate TEXT Traveller birthdate, may be important for │
|
│ --birthdate TEXT Traveller birthdate, may be important for │
|
||||||
│ discounts. (YYYY-MM-DD) │
|
│ discounts. (YYYY-MM-DD) │
|
||||||
│ [default: 1990-01-01] │
|
│ [default: 1990-01-01] │
|
||||||
│ --notification-channel TEXT ntfy channel to inform user on. │
|
│ --notification-channel TEXT ntfy channel to inform user on. │
|
||||||
│ [default: nightjet-price-notifier] │
|
│ [default: nightjet-price-notifier] │
|
||||||
│ --monitor-mode --no-monitor-mode Run queries repeatedly over time. If False only │
|
│ --monitor-mode --no-monitor-mode Run queries repeatedly over time. If False only │
|
||||||
│ runs a single query (oneshot mode). │
|
│ runs a single query (oneshot mode). │
|
||||||
│ [default: monitor-mode] │
|
│ [default: monitor-mode] │
|
||||||
│ --monitor-frequency INTEGER How often to run price queries if in monitoring │
|
│ --monitor-frequency INTEGER How often to run price queries if in monitoring │
|
||||||
│ mode, in seconds. │
|
│ mode, in seconds. │
|
||||||
│ [default: 3600] │
|
│ [default: 3600] │
|
||||||
│ --base-output-directory PATH Directory in which to output all result files. │
|
│ --base-output-directory PATH Directory in which to output all result files. │
|
||||||
│ [default: out] │
|
│ [default: out] │
|
||||||
│ --lowest-prices-filename TEXT Filename for collecting lowest found prices. │
|
│ --lowest-prices-filename TEXT Filename for collecting lowest found prices. │
|
||||||
│ [default: lowest.csv] │
|
│ [default: lowest.csv] │
|
||||||
│ --price-snapshot-pattern TEXT Filename pattern for saving all prices of each │
|
│ --price-snapshot-pattern TEXT Filename pattern for saving all prices of each │
|
||||||
│ query. Takes %%DATE%% as pattern to replace with │
|
│ query. Takes %%DATE%% as pattern to replace with │
|
||||||
│ current unix timestamp. │
|
│ current unix timestamp. │
|
||||||
│ [default: all_prices_%%DATE%%.csv] │
|
│ [default: all_prices_%%DATE%%.csv] │
|
||||||
│ --dump-price-snapshot --no-dump-price-snapshot Dump _all_ queried prices into a timestamped csv │
|
│ --dump-price-snapshot --no-dump-price-snapshot Dump _all_ queried prices into a timestamped csv │
|
||||||
│ file. │
|
│ file. │
|
||||||
│ [default: dump-price-snapshot] │
|
│ [default: dump-price-snapshot] │
|
||||||
│ --install-completion Install completion for the current shell. │
|
│ --latest-bookable-date --no-latest-bookable-date Check for latest currently possible booking date │
|
||||||
│ --show-completion Show completion for the current shell, to copy it │
|
│ only. │
|
||||||
│ or customize the installation. │
|
│ [default: no-latest-bookable-date] │
|
||||||
│ --help Show this message and exit. │
|
│ --help Show this message and exit. │
|
||||||
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
|
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
@ -83,3 +102,6 @@ Here are a bunch of things I think should definitely be considered for further w
|
||||||
|
|
||||||
5. Support more notification channels. This should be self-explanatory, and could probably be pretty
|
5. Support more notification channels. This should be self-explanatory, and could probably be pretty
|
||||||
easily be improved with a library like [apprise](https://github.com/caronc/apprise?tab=readme-ov-file#developer-api-usage).
|
easily be improved with a library like [apprise](https://github.com/caronc/apprise?tab=readme-ov-file#developer-api-usage).
|
||||||
|
|
||||||
|
6. Support simple stdout responses. We always dump to csv files for the price queries currently,
|
||||||
|
this definitely needs to change.
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue