CI updates

.github/workflows/pythonapp.yml

@@ -12,8 +12,8 @@ jobs:
     timeout-minutes: 5
 
     steps:
-      - uses: actions/checkout@v5
-      - uses: actions/setup-python@v4
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
         with:
           python-version: '3.11'
 

floodsystem/datafetcher.py

@@ -46,6 +46,12 @@ def fetch_station_data(use_cache=True):
     retrieval over the Internet and avoids excessive calls to the
     Environment Agency service.
 
+    Args:
+        use_cache: If ``True``, use file cache. Otherwise fetch data
+            over the Internet.
+
+    Returns:
+        River level data.
     """
 
     # URL for retrieving data for active stations with river level

floodsystem/station.py

@@ -12,6 +12,7 @@ class MonitoringStation:
 
     def __init__(self, station_id, measure_id, label, coord, typical_range,
                  river, town):
+        """Create a monitoring station."""
 
         self.station_id = station_id
         self.measure_id = measure_id

floodsystem/stationdata.py

@@ -1,7 +1,7 @@
 # Copyright (C) 2018 Garth N. Wells
 #
 # SPDX-License-Identifier: MIT
-"""This module provides interface for extracting statiob data from
+"""This module provides interface for extracting station data from
 JSON objects fetched from the Internet and
 
 """

floodsystem/utils.py

@@ -10,12 +10,12 @@ def sorted_by_key(x, i, reverse=False):
     """For a list of lists/tuples, return list sorted by the ith
     component of the list/tuple, E.g.
 
-    Sort on first entry of tuple:
+    Sort on first entry of tuple::
 
       > sorted_by_key([(1, 2), (5, 1]), 0)
       >>> [(1, 2), (5, 1)]
 
-    Sort on second entry of tuple:
+    Sort on second entry of tuple::
 
       > sorted_by_key([(1, 2), (5, 1]), 1)
       >>> [(5, 1), (1, 2)]

setup.cfg

@@ -1,5 +1,5 @@
 [flake8]
-max-line-length = 60
+max-line-length = 120
 exclude = .git
 # Line length
 ignore = W503