renfe-cli 6.0.0__tar.gz → 6.2.0__tar.gz

{renfe_cli-6.0.0 → renfe_cli-6.2.0}/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## v6.2.0 (2026-09-13)
+
+* Allow selecting a station when a name matches multiple stations [#211](https://github.com/gerardcl/renfe-cli/issues/211)
+
+## v6.1.0 (2026-09-12)
+
+* Add GTFS data caching [#209](https://github.com/gerardcl/renfe-cli/issues/209)
+* Add transfer infos [#208](https://github.com/gerardcl/renfe-cli/issues/208)
+
 ## v6.0.0 (2026-09-08)
 
 * General maintenance and improvements on GTFS data handling and algorithms [#206](https://github.com/gerardcl/renfe-cli/issues/206)

{renfe_cli-6.0.0 → renfe_cli-6.2.0}/Cargo.lock

@@ -58,6 +58,15 @@ version = "0.22.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "72b3254f16251a8381aa12e40e3c4d2f0199f8c6508fbecb9d91f575e0fbb8c6"
 
+[[package]]
+name = "bincode"
+version = "1.3.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b1f45e9417d87227c7a56d22e471c6206462cba514c7590c09aff4cf6d1ddcad"
+dependencies = [
+ "serde",
+]
+
 [[package]]
 name = "bitflags"
 version = "1.3.2"
@@ -306,6 +315,27 @@ dependencies = [
  "digest",
 ]
 
+[[package]]
+name = "directories"
+version = "6.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "16f5094c54661b38d03bd7e50df373292118db60b585c08a411c6d840017fe7d"
+dependencies = [
+ "dirs-sys",
+]
+
+[[package]]
+name = "dirs-sys"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e01a3366d27ee9890022452ee61b2b63a67e6f13f58900b651ff5665f0bb1fab"
+dependencies = [
+ "libc",
+ "option-ext",
+ "redox_users",
+ "windows-sys 0.61.2",
+]
+
 [[package]]
 name = "displaydoc"
 version = "0.2.7"
@@ -878,6 +908,15 @@ version = "0.2.189"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "3eaf3ede3fee6db1a4c2ee091bf8a8b4dccdc6d17f656fb07896ee72867612f2"
 
+[[package]]
+name = "libredox"
+version = "0.1.23"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8d8f1ea3f21fd3405dcaf6c9b5c1630af9afc422d9073ea39c5f6d6c772e08ed"
+dependencies = [
+ "libc",
+]
+
 [[package]]
 name = "litemap"
 version = "0.8.3"
@@ -934,6 +973,12 @@ version = "0.2.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "7c87def4c32ab89d880effc9e097653c8da5d6ef28e6b539d313baaacfbafcbe"
 
+[[package]]
+name = "option-ext"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "04744f49eae99ab78e0d5c0b603ab218f515ea8cfe5a456d7629ad883a3b6e7d"
+
 [[package]]
 name = "percent-encoding"
 version = "2.3.2"
@@ -1140,16 +1185,30 @@ dependencies = [
  "rand_core",
 ]
 
+[[package]]
+name = "redox_users"
+version = "0.5.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a4e608c6638b9c18977b00b475ac1f28d14e84b27d8d42f70e0bf1e3dec127ac"
+dependencies = [
+ "getrandom 0.2.17",
+ "libredox",
+ "thiserror",
+]
+
 [[package]]
 name = "renfe-cli"
-version = "6.0.0"
+version = "6.2.0"
 dependencies = [
+ "bincode",
  "chrono",
+ "directories",
  "getopts",
  "gtfs-structures",
  "jiff",
  "pyo3",
  "reqwest",
+ "serde",
 ]
 
 [[package]]
@@ -1368,6 +1427,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "4148590afebada386688f18773da617792bf2ef03ffc1e4cbd2b1d45b023e0ba"
 dependencies = [
  "serde_core",
+ "serde_derive",
 ]
 
 [[package]]

{renfe_cli-6.0.0 → renfe_cli-6.2.0}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "renfe-cli"
-version = "6.0.0"
+version = "6.2.0"
 edition = "2024"
 rust-version = "1.98"
 authors = ["Gerard C.L. <gerardcl@gmail.com>"]
@@ -23,5 +23,8 @@ pyo3 = { version = "0.29", features = ["abi3-py310"] }
 getopts = "0.2.24"
 chrono = "0.4.45"
 gtfs-structures = { version = "0.50", default-features = false }
-jiff = "0.2.35"
+jiff = { version = "0.2.35", features = ["serde"] }
 reqwest = { version = "0.13", default-features = false, features = ["blocking", "rustls"] }
+serde = { version = "1.0", features = ["derive"] }
+bincode = "1.3"
+directories = "6.0"

{renfe_cli-6.0.0 → renfe_cli-6.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: renfe-cli
-Version: 6.0.0
+Version: 6.2.0
 Classifier: Programming Language :: Rust
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
@@ -97,8 +97,6 @@ Let's show an example of minimal inputs (origin and destination stations) with s
 ```bash
 $ renfe-cli  -f girona -t "puerta de atocha" -d 30
 Loading default GTFS data from Renfe web - Alta velocidad, Larga distancia y Media distancia
-Provided input 'girona' does a match with 'Estación de tren Girona'
-Provided input 'puerta de atocha' does a match with 'Estación de tren Madrid-Puerta de Atocha'
 Today is: 2024-9-29
 Searching timetable for date: 2024-9-30
 Origin station: Estación de tren Girona
@@ -126,8 +124,6 @@ Let's show an example using Renfe Cercanías GTFS dataset:
 ```bash
 $ renfe-cli -f chamartín -t "tres cantos" -c
 Loading Cercanías GTFS data from Renfe web - long load time
-Provided input 'chamartín' does a match with 'Station { name: "Estación de tren Madrid-Chamartín-Clara Campoamor", id: "17000" }'
-Provided input 'tres cantos' does a match with 'Station { name: "Estación de tren Tres Cantos (apt)", id: "17004" }'
 Today is: 2024-10-2
 Searching timetable for date: 2024-10-2
 Origin station: Estación de tren Madrid-Chamartín-Clara Campoamor
@@ -153,6 +149,48 @@ Destination station: Estación de tren Tres Cantos (apt)
 ===========================================================
 ```
 
+### Selecting a station
+
+Station names are matched case-insensitively and may be abbreviated. If the
+provided text matches more than one station, the CLI sorts the matches by name
+and asks which station to use. Select it by entering its 1-based ordinal number:
+
+```text
+$ renfe-cli -f madrid -t girona
+Multiple stations match 'madrid':
+  1. Estación de tren Madrid - Atocha Cercanias
+  2. Estación de tren Madrid-Chamartin
+  3. Estación de tren Madrid-Nuevos Ministerios
+  4. Estación de tren Madrid-Principe Pio
+  5. Estación de tren Madrid-Puerta de Atocha
+  6. Estación de tren Madrid-Ramon Y Cajal
+  7. Estación de tren Madrid-Recoletos
+Select a station [1-7]: 5
+```
+
+Invalid numbers are rejected and the CLI asks again. If the provided text does
+not match any station, it reports the input without presenting a selection:
+
+```text
+ValueError: Provided input 'unknown' does not match any station name
+```
+
+Journeys with connections include the details of every transfer directly
+below the timetable row. The arrival and departure are the times at which the
+transfer starts and ends; the duration is the total time available to change
+trains. Transfers between different stops show both station names:
+
+```text
+      Transfer 1 at Madrid-Chamartín: arrive 10:05, depart 10:20 (00:15)
+      Transfer 2 at Madrid-Atocha → Madrid-Puerta de Atocha: arrive 10:45, depart 11:10 (00:25)
+```
+
+Downloaded feeds are converted to routing data and cached in the operating
+system's user cache directory. On later runs, `renfe-cli` sends Renfe the
+stored HTTP `ETag`; when the feed has not changed, Renfe returns `304 Not
+Modified` and the processed data is loaded directly from the local cache.
+Set `RENFE_CLI_CACHE_DIR` to use a custom cache location.
+
 ## Usage (Library)
 
 `renfe-cli` can be imported as a python package into your project, offering utilities when willing to deal with the Renfe search web site.
@@ -179,13 +217,10 @@ GTFS data:
   Shapes: 0
   Fare attributes: 0
   Feed info: 0
->>> renfe.filter_station("madrid")
-Traceback (most recent call last):
-  File "<stdin>", line 1, in <module>
-ValueError: Provided input 'madrid' does match with '[Station { name: "Estación de tren Madrid-Puerta de Atocha", id: "60000" }, Station { name: "Estación de tren Madrid - Atocha Cercanias", id: "18000" }, Station { name: "Estación de tren Madrid-Principe Pio", id: "10000" }, Station { name: "Estación de tren Madrid-Ramon Y Cajal", id: "97201" }, Station { name: "Estación de tren Madrid-Nuevos Ministerios", id: "18002" }, Station { name: "Estación de tren Madrid-Chamartin", id: "17000" }, Station { name: "Estación de tren Madrid-Recoletos", id: "18001" }]' -> There must be ONLY one match
->>> renfe.filter_station("girona")
-Provided input 'girona' does a match with 'Station { name: "Estación de tren Girona", id: "79300" }'
-<builtins.Station object at 0x77f04173d070>
+>>> len(renfe.stations_match("madrid"))
+7
+>>> len(renfe.stations_match("girona"))
+1
 >>> renfe.print_timetable()
 
 No schedules available...won't print timetable.

{renfe_cli-6.0.0 → renfe_cli-6.2.0}/README.md

@@ -61,8 +61,6 @@ Let's show an example of minimal inputs (origin and destination stations) with s
 ```bash
 $ renfe-cli  -f girona -t "puerta de atocha" -d 30
 Loading default GTFS data from Renfe web - Alta velocidad, Larga distancia y Media distancia
-Provided input 'girona' does a match with 'Estación de tren Girona'
-Provided input 'puerta de atocha' does a match with 'Estación de tren Madrid-Puerta de Atocha'
 Today is: 2024-9-29
 Searching timetable for date: 2024-9-30
 Origin station: Estación de tren Girona
@@ -90,8 +88,6 @@ Let's show an example using Renfe Cercanías GTFS dataset:
 ```bash
 $ renfe-cli -f chamartín -t "tres cantos" -c
 Loading Cercanías GTFS data from Renfe web - long load time
-Provided input 'chamartín' does a match with 'Station { name: "Estación de tren Madrid-Chamartín-Clara Campoamor", id: "17000" }'
-Provided input 'tres cantos' does a match with 'Station { name: "Estación de tren Tres Cantos (apt)", id: "17004" }'
 Today is: 2024-10-2
 Searching timetable for date: 2024-10-2
 Origin station: Estación de tren Madrid-Chamartín-Clara Campoamor
@@ -117,6 +113,48 @@ Destination station: Estación de tren Tres Cantos (apt)
 ===========================================================
 ```
 
+### Selecting a station
+
+Station names are matched case-insensitively and may be abbreviated. If the
+provided text matches more than one station, the CLI sorts the matches by name
+and asks which station to use. Select it by entering its 1-based ordinal number:
+
+```text
+$ renfe-cli -f madrid -t girona
+Multiple stations match 'madrid':
+  1. Estación de tren Madrid - Atocha Cercanias
+  2. Estación de tren Madrid-Chamartin
+  3. Estación de tren Madrid-Nuevos Ministerios
+  4. Estación de tren Madrid-Principe Pio
+  5. Estación de tren Madrid-Puerta de Atocha
+  6. Estación de tren Madrid-Ramon Y Cajal
+  7. Estación de tren Madrid-Recoletos
+Select a station [1-7]: 5
+```
+
+Invalid numbers are rejected and the CLI asks again. If the provided text does
+not match any station, it reports the input without presenting a selection:
+
+```text
+ValueError: Provided input 'unknown' does not match any station name
+```
+
+Journeys with connections include the details of every transfer directly
+below the timetable row. The arrival and departure are the times at which the
+transfer starts and ends; the duration is the total time available to change
+trains. Transfers between different stops show both station names:
+
+```text
+      Transfer 1 at Madrid-Chamartín: arrive 10:05, depart 10:20 (00:15)
+      Transfer 2 at Madrid-Atocha → Madrid-Puerta de Atocha: arrive 10:45, depart 11:10 (00:25)
+```
+
+Downloaded feeds are converted to routing data and cached in the operating
+system's user cache directory. On later runs, `renfe-cli` sends Renfe the
+stored HTTP `ETag`; when the feed has not changed, Renfe returns `304 Not
+Modified` and the processed data is loaded directly from the local cache.
+Set `RENFE_CLI_CACHE_DIR` to use a custom cache location.
+
 ## Usage (Library)
 
 `renfe-cli` can be imported as a python package into your project, offering utilities when willing to deal with the Renfe search web site.
@@ -143,13 +181,10 @@ GTFS data:
   Shapes: 0
   Fare attributes: 0
   Feed info: 0
->>> renfe.filter_station("madrid")
-Traceback (most recent call last):
-  File "<stdin>", line 1, in <module>
-ValueError: Provided input 'madrid' does match with '[Station { name: "Estación de tren Madrid-Puerta de Atocha", id: "60000" }, Station { name: "Estación de tren Madrid - Atocha Cercanias", id: "18000" }, Station { name: "Estación de tren Madrid-Principe Pio", id: "10000" }, Station { name: "Estación de tren Madrid-Ramon Y Cajal", id: "97201" }, Station { name: "Estación de tren Madrid-Nuevos Ministerios", id: "18002" }, Station { name: "Estación de tren Madrid-Chamartin", id: "17000" }, Station { name: "Estación de tren Madrid-Recoletos", id: "18001" }]' -> There must be ONLY one match
->>> renfe.filter_station("girona")
-Provided input 'girona' does a match with 'Station { name: "Estación de tren Girona", id: "79300" }'
-<builtins.Station object at 0x77f04173d070>
+>>> len(renfe.stations_match("madrid"))
+7
+>>> len(renfe.stations_match("girona"))
+1
 >>> renfe.print_timetable()
 
 No schedules available...won't print timetable.