SignalBoxes.collect_wr_mas_dates

SignalBoxes.collect_wr_mas_dates(confirmation_required=True, verbose=False, raise_error=False)[source]

Collects data of WR (western region) MAS (multiple aspect signalling) dates from the source web page.

Parameters:

  • confirmation_required (bool) – Whether user confirmation is required; if confirmation_required=True (default), prompts the user for confirmation before proceeding with data collection.

  • verbose (bool | int) – Whether to print relevant information to the console; defaults to False.

  • raise_error (bool) – Whether to raise the provided exception; if raise_error=False (default), the error will be suppressed.

Returns:

A dictionary containing the data of WR MAS dates and the date when they were last updated, or None if no data is collected.

Return type:

dict | None

Examples:

>>> from pyrcs.other_assets import SignalBoxes  # from pyrcs import SignalBoxes
>>> sb = SignalBoxes()
>>> sb_wr_mas_dates = sb.collect_wr_mas_dates()
To collect data of WR MAS dates
? [No]|Yes: yes
>>> type(sb_wr_mas_dates)
dict
>>> list(sb_wr_mas_dates.keys())
['WR MAS dates', 'Last updated date']
>>> sb.KEY_TO_WRMASD
'WR MAS dates'
>>> sb_wr_mas_dates_dat = sb_wr_mas_dates[sb.KEY_TO_WRMASD]
>>> type(sb_wr_mas_dates_dat)
collections.defaultdict
>>> list(sb_wr_mas_dates_dat.keys())
['Paddington-Hayes',
 'Birmingham',
 'Plymouth',
 'Reading-Hayes',
 'Newport Multiple Aspect Signalling']
>>> sb_wr_mas_dates_dat['Paddington-Hayes']
  Stage             Date                        Area
0    1A    12 April 1953               Hayes-Hanwell
1    1B    20 March 1955        Hanwell-Acton Middle
2    1C  1 February 1959  Acton West-Friars Junction