Pyrcs

(*16 May 2022*)

**Notable [changes](https://github.com/mikeqfu/pyrcs/compare/0.2.15...0.3.0) since [0.2.15](https://pypi.org/project/pyrcs/0.2.15/):**

- Split the module old [utils](https://github.com/mikeqfu/pyrcs/blob/dd7bb9df95ee86939b790eaba1f79e10bc54d1a4/pyrcs/utils.py) into three new modules: [utils](https://github.com/mikeqfu/pyrcs/commit/c55830dd3c250425916ba275eb9429972441b7e5), [converter](https://github.com/mikeqfu/pyrcs/commit/19c8d3911c86db02fbc94f64bb4a22e9de88fa6c) and [parser](https://github.com/mikeqfu/pyrcs/commit/34be0c12604694eb580bf55192e2ebe7fa0645d1).
- Made extensive modifications (with bug fixes).

**For more information and detailed specifications, check out [PyRCS 0.3.0 documentation](https://pyrcs.readthedocs.io/en/0.3.0/).**

<br/>

(*27 March 2021*)

**Notable [changes](https://github.com/mikeqfu/pyrcs/compare/0.2.14...0.2.15) since [0.2.14](https://pypi.org/project/pyrcs/0.2.14/):**

- Changed the [dependency requirements](https://github.com/mikeqfu/pyrcs/commit/99c6b5400b0cc89540bd9de7060cb4562ff0b684) for the package.

**For more information and detailed specifications, check out [PyRCS 0.2.15 documentation](https://pyrcs.readthedocs.io/en/0.2.15/).**

<br/>

(*22 March 2021*)

**Notable [changes](https://github.com/mikeqfu/pyrcs/compare/0.2.13...0.2.14) since [0.2.13](https://pypi.org/project/pyrcs/0.2.13/):**

- Improved the following functions and class methods with bug fixes:
- [get_site_map()](https://github.com/mikeqfu/pyrcs/commit/1231bdb62914485acead5751ea055e063c0fa711#diff-b10b1cca28c0fc2ed0bdb1f92c3c9f58dcc4279b09ad28a2a4c513a35861c282L636-R814) and [get_catalogue()](https://github.com/mikeqfu/pyrcs/commit/1231bdb62914485acead5751ea055e063c0fa711#diff-b10b1cca28c0fc2ed0bdb1f92c3c9f58dcc4279b09ad28a2a4c513a35861c282L844-R991) in the module [utils](https://github.com/mikeqfu/pyrcs/blob/fd7e40834af60dc80d334e541cd26fe9d88865bc/pyrcs/utils.py);
- [LocationIdentifiers.collect_loc_codes_by_initial()](https://github.com/mikeqfu/pyrcs/commit/ca7bd7132bfc1c40327425335934a019fd69388e);
- [Stations.collect_station_data_by_initial()](https://github.com/mikeqfu/pyrcs/commit/69df19d4e3692ca6f1642c7e029a61fd6ec72fa3).

**For more information and detailed specifications, check out [PyRCS 0.2.14 documentation](https://pyrcs.readthedocs.io/en/0.2.14/).**

<br/>

(*9 January 2021*)

**Notable [changes](https://github.com/mikeqfu/pyrcs/compare/0.2.12...0.2.13) since [0.2.12](https://pypi.org/project/pyrcs/0.2.12/):**

- Improved the following functions and classes/methods with bug fixes:
- [parse_tr()](https://github.com/mikeqfu/pyrcs/commit/e9b081523afad4ba5b43173e1f877964e2998c0b#diff-b10b1cca28c0fc2ed0bdb1f92c3c9f58dcc4279b09ad28a2a4c513a35861c282R426) and [parse_date()](https://github.com/mikeqfu/pyrcs/commit/e9b081523afad4ba5b43173e1f877964e2998c0b#diff-b10b1cca28c0fc2ed0bdb1f92c3c9f58dcc4279b09ad28a2a4c513a35861c282R622) in the module [utils](https://github.com/mikeqfu/pyrcs/blob/19429031fdd3ea8d0bfab8cdea43e2804636e278/pyrcs/utils.py);
- [Electrification.get_indep_line_names()](https://github.com/mikeqfu/pyrcs/commit/e539d508b97bfa1ca6740fd5bd281e60c23e94dc), [ELRMileage.collect_mileage_file()](https://github.com/mikeqfu/pyrcs/commit/d67827f636c9cd5a7bf43c64c1fff226c09f4625) and [LOR.collect_elr_lor_converter()](https://github.com/mikeqfu/pyrcs/commit/ab2d79b9ed96f71083bf0656d0b1f1bde214837d) in the sub-package [line_data](https://github.com/mikeqfu/pyrcs/tree/19429031fdd3ea8d0bfab8cdea43e2804636e278/pyrcs/line_data);
- [Depots.collect_four_digit_pre_tops_codes](https://github.com/mikeqfu/pyrcs/commit/af2c62b1807325351a4f5217c710919d25ffc629), [Tunnels.parse_length()](https://github.com/mikeqfu/pyrcs/commit/20b8036d923ea2f36dcb0b9e175afda5182f3e19) and [Stations](https://github.com/mikeqfu/pyrcs/commit/b6c075026d62e771c40a5f5b4934b72f9682dfc4) in the sub-package [other_assets](https://github.com/mikeqfu/pyrcs/tree/19429031fdd3ea8d0bfab8cdea43e2804636e278/pyrcs/other_assets).

**For more information and detailed specifications, check out [PyRCS 0.2.13 documentation](https://pyrcs.readthedocs.io/en/0.2.13/).**

<br/>

(*11 November 2020*)

**Notable [changes](https://github.com/mikeqfu/pyrcs/compare/0.2.11...0.2.12) since [0.2.11](https://pypi.org/project/pyrcs/0.2.11/):**

- Enabled an offline mode (when Internet connection is lost).
- Renamed the following:
- class methods:
- in the class [SignalBoxes](https://github.com/mikeqfu/pyrcs/blob/bb66ee658a2b60e2ffe5e16381e8737b57c65b3d/pyrcs/other_assets/sig_box.py#L28):
- [~~.collect_signal_box_prefix_codes()~~](https://github.com/mikeqfu/pyrcs/commit/8996f89566f53b4d2e24d8f99b1e0b0444ee0b40#diff-325f75b3f2452c2629af384b19046b16d42d4500c6cba2ca5cf0db5fc0772f4bL99) to [.collect_prefix_codes()](https://github.com/mikeqfu/pyrcs/blob/bb66ee658a2b60e2ffe5e16381e8737b57c65b3d/pyrcs/other_assets/sig_box.py#L107);
- [~~.fetch_signal_box_prefix_codes()~~](https://github.com/mikeqfu/pyrcs/commit/8996f89566f53b4d2e24d8f99b1e0b0444ee0b40#diff-325f75b3f2452c2629af384b19046b16d42d4500c6cba2ca5cf0db5fc0772f4bL188) to [.fetch_prefix_codes()](https://github.com/mikeqfu/pyrcs/blob/bb66ee658a2b60e2ffe5e16381e8737b57c65b3d/pyrcs/other_assets/sig_box.py#L203);
- in the class [Tunnels](https://github.com/mikeqfu/pyrcs/blob/bb66ee658a2b60e2ffe5e16381e8737b57c65b3d/pyrcs/other_assets/tunnel.py#L27):
- [~~.collect_tunnel_lengths_by_page()~~](https://github.com/mikeqfu/pyrcs/commit/a2df5ad0f6d6a8758a9f0ac122487f09a1ec0a61#diff-d4156e818eca514e7b6c1b2bfbf2ac0a4a1ee2392a31b56a2c5771e87fae14c1L167) to [.collect_lengths_by_page()](https://github.com/mikeqfu/pyrcs/blob/bb66ee658a2b60e2ffe5e16381e8737b57c65b3d/pyrcs/other_assets/tunnel.py#L177);
- in the class [Viaducts](https://github.com/mikeqfu/pyrcs/blob/bb66ee658a2b60e2ffe5e16381e8737b57c65b3d/pyrcs/other_assets/viaduct.py#L23):
- [~~.collect_railway_viaducts_by_page()~~](https://github.com/mikeqfu/pyrcs/commit/aa5325bc12b84b0f18ef39548efc1f7d268d5347#diff-f4e1105c5b49529eafc015218cb58dc9b9483837fb76542988186546b44745efL82) to [.collect_viaduct_codes_by_page()](https://github.com/mikeqfu/pyrcs/blob/bb66ee658a2b60e2ffe5e16381e8737b57c65b3d/pyrcs/other_assets/viaduct.py#L99);
- [~~.fetch_railway_viaducts()~~](https://github.com/mikeqfu/pyrcs/commit/aa5325bc12b84b0f18ef39548efc1f7d268d5347#diff-f4e1105c5b49529eafc015218cb58dc9b9483837fb76542988186546b44745efL151) to [.fetch_viaduct_codes()](https://github.com/mikeqfu/pyrcs/blob/bb66ee658a2b60e2ffe5e16381e8737b57c65b3d/pyrcs/other_assets/viaduct.py#L177);
- functions in the module [utils](https://github.com/mikeqfu/pyrcs/blob/bb66ee658a2b60e2ffe5e16381e8737b57c65b3d/pyrcs/utils.py):
- [~~fetch_location_names_repl_dict()~~](https://github.com/mikeqfu/pyrcs/commit/e923c3780a5f8dbe856f0d19a87fb09cd3ae7315#diff-b10b1cca28c0fc2ed0bdb1f92c3c9f58dcc4279b09ad28a2a4c513a35861c282L952) to [fetch_loc_names_repl_dict()](https://github.com/mikeqfu/pyrcs/blob/bb66ee658a2b60e2ffe5e16381e8737b57c65b3d/pyrcs/utils.py#L1037);
- [~~update_location_name_repl_dict()~~](https://github.com/mikeqfu/pyrcs/commit/e923c3780a5f8dbe856f0d19a87fb09cd3ae7315#diff-b10b1cca28c0fc2ed0bdb1f92c3c9f58dcc4279b09ad28a2a4c513a35861c282L1009) to [update_loc_names_repl_dict()](https://github.com/mikeqfu/pyrcs/blob/bb66ee658a2b60e2ffe5e16381e8737b57c65b3d/pyrcs/utils.py#L1094).
- Removed the functions [~~collect_site_map()~~](https://github.com/mikeqfu/pyrcs/commit/5a9b983ea55c22edf04fe4be1711b6ded7a3eccc#diff-4fe83da7eb97d70cc844349191441cf8ecb65e67ee655989e774a44c2cd4eb6dL20) and [~~fetch_site_map()~~](https://github.com/mikeqfu/pyrcs/commit/5a9b983ea55c22edf04fe4be1711b6ded7a3eccc#diff-4fe83da7eb97d70cc844349191441cf8ecb65e67ee655989e774a44c2cd4eb6dL110) from the module [updater](https://github.com/mikeqfu/pyrcs/blob/bb66ee658a2b60e2ffe5e16381e8737b57c65b3d/pyrcs/updater.py).
- Added the following:
- a new module [collector](https://github.com/mikeqfu/pyrcs/blob/bb66ee658a2b60e2ffe5e16381e8737b57c65b3d/pyrcs/collector.py) - combining two modules [~~_line_data~~](https://github.com/mikeqfu/pyrcs/commit/ac477c9dc6d76a7400ffcf9d031ffd545d662fac#diff-51811be1398d2439ca84a8504b8531b0411773c357881c423df0922f44e6923b) and [~~_other_assets~~](https://github.com/mikeqfu/pyrcs/commit/ac477c9dc6d76a7400ffcf9d031ffd545d662fac#diff-b7304475ca50edd2572798e94bb2d0d5e2f627c6f5470d1ad24722efdb803609);
- new functions [print_connection_error()](https://github.com/mikeqfu/pyrcs/commit/2886648b04174692ff0be58183ec56da27d1c120#diff-b10b1cca28c0fc2ed0bdb1f92c3c9f58dcc4279b09ad28a2a4c513a35861c282R1192-R1205), [print_conn_err()](https://github.com/mikeqfu/pyrcs/commit/b42f0e36a5f231763fd8879c3e50f2e83ca000c4#diff-b10b1cca28c0fc2ed0bdb1f92c3c9f58dcc4279b09ad28a2a4c513a35861c282R1206-R1225), [is_internet_connected()](https://github.com/mikeqfu/pyrcs/commit/03486c21048282d9033bda915924a70f1033645e#diff-b10b1cca28c0fc2ed0bdb1f92c3c9f58dcc4279b09ad28a2a4c513a35861c282R1262-R1283) and [get_site_map()](https://github.com/mikeqfu/pyrcs/blob/bb66ee658a2b60e2ffe5e16381e8737b57c65b3d/pyrcs/utils.py#L631) to the module [utils](https://github.com/mikeqfu/pyrcs/blob/bb66ee658a2b60e2ffe5e16381e8737b57c65b3d/pyrcs/utils.py);
- a new method [TrackDiagrams.get_track_diagrams_items()](https://github.com/mikeqfu/pyrcs/blob/bb66ee658a2b60e2ffe5e16381e8737b57c65b3d/pyrcs/line_data/trk_diagr.py#L85) - adapted from the function [~~get_track_diagrams_items()~~](https://github.com/mikeqfu/pyrcs/commit/0216bf07d00769f08a6a7e09c6a0a08a42c5fb56#diff-3bd1279c5db5b09065ddf6468e4acfb650e3402d8b0c410ce7beaacb667a8135R78) previously in the module [utils](https://github.com/mikeqfu/pyrcs/blob/bb66ee658a2b60e2ffe5e16381e8737b57c65b3d/pyrcs/utils.py).
- Enabled direct access to all classes from importing the package, without having to specifying the sub-modules in which they each reside.

**For more information and detailed specifications, check out [PyRCS 0.2.12 documentation](https://pyrcs.readthedocs.io/en/0.2.12/).**

<br/>

(*31 October 2020*)

**Notable [changes](https://github.com/mikeqfu/pyrcs/compare/0.2.10...0.2.11) since [0.2.10](https://pypi.org/project/pyrcs/0.2.10/):**

- Renamed the following methods of the class [Stations](https://github.com/mikeqfu/pyrcs/blob/81fe73e419597868e58731cb9417f4583b5a3611/pyrcs/other_assets/station.py#L31):
- [~~.collect_railway_station_data_by_initial()~~](https://github.com/mikeqfu/pyrcs/commit/6dd583dfbb0fc5d88c4f39d337dd4a438034a46c#diff-86956d6a0963926f04ed9d7c6bf99fb9763a0c7cabb22c88c3fa8f68e5a31e19L127) to [.collect_station_data_by_initial()](https://github.com/mikeqfu/pyrcs/blob/81fe73e419597868e58731cb9417f4583b5a3611/pyrcs/other_assets/station.py#L127);
- [~~.fetch_railway_station_data()~~](https://github.com/mikeqfu/pyrcs/commit/6dd583dfbb0fc5d88c4f39d337dd4a438034a46c#diff-86956d6a0963926f04ed9d7c6bf99fb9763a0c7cabb22c88c3fa8f68e5a31e19L246) to [.fetch_station_data()](https://github.com/mikeqfu/pyrcs/blob/81fe73e419597868e58731cb9417f4583b5a3611/pyrcs/other_assets/station.py#L245).

**For more information and detailed specifications, check out [PyRCS 0.2.11 documentation](https://pyrcs.readthedocs.io/en/0.2.11/).**

<br/>