Support Hamsat alerts and use an AMSAT SIG for satellite spots

config-example.yml

@@ -162,6 +162,9 @@ alert_providers:
   - class: "BOTA"
     enabled: true
 
+  - class: "Hamsat"
+    enabled: true
+
   - class: "NG3K"
     enabled: true
 

core/constants.py

@@ -359,6 +359,14 @@ SIGS = [
         region_flag="🇵🇱",
         refs_globally_unique=False,
     ),
+    SIG(
+        name="AMSAT",
+        comment_names=[],
+        description="Amateur Radio Satellites",
+        sig_type=SIGType.WORLDWIDE,
+        icon="fa-satellite",
+        refs_globally_unique=False,
+    ),
     SIG(
         name="Toilets",
         comment_names=[],

core/enums.py

@@ -116,6 +116,7 @@ class AlertType(str, Enum):
     """Type of an alert."""
 
     XOTA = "XOTA"
+    SATELLITE = "SATELLITE"
     DXPEDITION = "DXPEDITION"
     CONTEST = "CONTEST"
 

data/alert.py

@@ -158,6 +158,8 @@ class Alert:
                 self.icon = "fa-globe-africa"
             elif self.alert_type == AlertType.CONTEST:
                 self.icon = "fa-trophy"
+            elif self.alert_type == AlertType.CONTEST:
+                self.icon = "fa-satellite"
             elif self.sig_refs and len(self.sig_refs) > 0 and self.sig_refs[0].icon:
                 self.icon = self.sig_refs[0].icon
 

data/spot.py

@@ -359,6 +359,12 @@ class Spot:
                             self.propagation_mode = mode_tag
                             logger.info(f"Seen a new propagation mode tag not yet in the system: {mode_tag}")
 
+                        # Tag satellite contacts as AMSAT SIG
+                        if self.propagation_mode == "Satellite":
+                            if not self.sig:
+                                self.sig = "AMSAT"
+                            self.sig_refs.append(SIGRef(sig="AMSAT"))
+
             # Parse "de_grid -> dx_grid" structures from the comment
             if self.comment:
                 grid_mode_grid_match = re.search(

providers/alert/hamsat.py

@@ -0,0 +1,49 @@
+from datetime import datetime
+
+import pytz
+
+from core.enums import AlertType
+from data.alert import Alert
+from data.sig_ref import SIGRef
+from providers.alert.http_alert_provider import HTTPAlertProvider
+
+
+class Hamsat(HTTPAlertProvider):
+    """Alert provider for Hamsat (hams.at)"""
+
+    POLL_INTERVAL_SEC = 1800
+    ALERTS_URL = "https://hams.at/api/alerts"
+
+    def __init__(self, provider_config):
+        super().__init__("Hamsat", provider_config, self.ALERTS_URL, self.POLL_INTERVAL_SEC)
+
+    def _http_response_to_alerts(self, http_response):
+        new_alerts = []
+        # Iterate through source data
+        for source_alert in http_response.json()["data"]:
+            # Convert to our alert format
+            alert = Alert(
+                source=self.name,
+                source_id=source_alert["id"],
+                dx_calls=[source_alert["callsign"].upper()],
+                freqs_modes=f"{source_alert['mhz']!s} {source_alert['mhz_direction']}, {source_alert['mode']}",
+                comment=source_alert["comment"],
+                # Fudge a SIG ref to provide the remaining bits of data we need: the satellite and the operator's grid
+                sig_refs=[
+                    SIGRef(
+                        sig="AMSAT",
+                        id=f"{source_alert['satellite']['name']} from {source_alert['grids'][0]}",
+                    )
+                ],
+                start_time=datetime.strptime(source_alert["aos_at"], "%Y-%m-%dT%H:%M:%SZ")
+                .replace(tzinfo=pytz.UTC)
+                .timestamp(),
+                end_time=datetime.strptime(source_alert["los_at"], "%Y-%m-%dT%H:%M:%SZ")
+                .replace(tzinfo=pytz.UTC)
+                .timestamp(),
+                alert_type=AlertType.SATELLITE,
+            )
+
+            # Add to our list
+            new_alerts.append(alert)
+        return new_alerts

templates/add_spot.html

@@ -77,7 +77,7 @@
 
 </div>
 
-<script src="/static/js/add-spot.js?v=1789108335"></script>
+<script src="/static/js/add-spot.js?v=1789111115"></script>
 <script>$(document).ready(function () {
     $("#nav-link-add-spot").addClass("active");
 }); <!-- highlight active page in nav --></script>

templates/alerts.html

@@ -83,7 +83,7 @@
 
 </div>
 
-<script src="/static/js/alerts.js?v=1789108335"></script>
+<script src="/static/js/alerts.js?v=1789111115"></script>
 <script>$(document).ready(function () {
     $("#nav-link-alerts").addClass("active");
 }); <!-- highlight active page in nav --></script>

templates/bands.html

@@ -76,8 +76,8 @@
 
 </div>
 
-<script src="/static/js/spotsbandsandmap.js?v=1789108335"></script>
+<script src="/static/js/spotsbandsandmap.js?v=1789111115"></script>
-<script src="/static/js/bands.js?v=1789108335"></script>
+<script src="/static/js/bands.js?v=1789111115"></script>
 <script>$(document).ready(function () {
     $("#nav-link-bands").addClass("active");
 }); <!-- highlight active page in nav --></script>

templates/base.html

@@ -1,6 +1,6 @@
 {% extends "skeleton.html" %}
 {% block head_extra %}
-<link rel="stylesheet" href="/static/css/style.css?v=1789108335" type="text/css">
+<link rel="stylesheet" href="/static/css/style.css?v=1789111115" type="text/css">
 <link href="/static/vendor/css/bootstrap-5.3.8.min.css" rel="stylesheet">
 <link href="/static/vendor/css/fontawesome-6.7.2.min.css" rel="stylesheet">
 <link href="/static/vendor/css/solid-6.7.2.min.css" rel="stylesheet">
@@ -16,10 +16,10 @@
     window.fetchEventSource = fetchEventSource;
 </script>
 
-<script src="/static/js/utils.js?v=1789108335"></script>
+<script src="/static/js/utils.js?v=1789111115"></script>
-<script src="/static/js/ui-ham.js?v=1789108335"></script>
+<script src="/static/js/ui-ham.js?v=1789111115"></script>
-<script src="/static/js/geo.js?v=1789108335"></script>
+<script src="/static/js/geo.js?v=1789111115"></script>
-<script src="/static/js/common.js?v=1789108335"></script>
+<script src="/static/js/common.js?v=1789111115"></script>
 {% end %}
 {% block body %}
 <div class="container">

templates/conditions.html

@@ -284,7 +284,7 @@
 </div>
 
 <script src="/static/vendor/js/chart-4.4.9.umd.min.js"></script>
-<script src="/static/js/conditions.js?v=1789108335"></script>
+<script src="/static/js/conditions.js?v=1789111115"></script>
 <script>$(document).ready(function () {
     $("#nav-link-conditions").addClass("active");
 }); <!-- highlight active page in nav --></script>

templates/map.html

@@ -113,8 +113,8 @@
     const CARTODB_API_KEY = "{{ web_ui_options.get('cartodb_api_key', '') }}";
 </script>
 
-<script src="/static/js/spotsbandsandmap.js?v=1789108335"></script>
+<script src="/static/js/spotsbandsandmap.js?v=1789111115"></script>
-<script src="/static/js/map.js?v=1789108335"></script>
+<script src="/static/js/map.js?v=1789111115"></script>
 <script>$(document).ready(function () {
     $("#nav-link-map").addClass("active");
 }); <!-- highlight active page in nav --></script>

templates/spots.html

@@ -113,8 +113,8 @@
 
 </div>
 
-<script src="/static/js/spotsbandsandmap.js?v=1789108335"></script>
+<script src="/static/js/spotsbandsandmap.js?v=1789111115"></script>
-<script src="/static/js/spots.js?v=1789108335"></script>
+<script src="/static/js/spots.js?v=1789111115"></script>
 <script>$(document).ready(function () {
     $("#nav-link-spots").addClass("active");
 }); <!-- highlight active page in nav --></script>

templates/status.html

@@ -86,7 +86,7 @@
     </div>
 </div>
 
-<script src="/static/js/status.js?v=1789108335"></script>
+<script src="/static/js/status.js?v=1789111115"></script>
 <script>
     $(document).ready(function () {
         $("#nav-link-status").addClass("active");