PR2: Add new preference and AnnouncementChecker class

docs/make_bulletin_json.py

@@ -0,0 +1,38 @@
+import json
+import os
+
+# Set the file paths
+input_md_file = os.path.join(os.path.dirname(__file__), 'bulletin.md')
+output_json_file = os.path.join(os.path.dirname(__file__), 'bulletin.json')
+
+def generate_json_file():
+    with open(input_md_file, 'r', encoding='utf-8') as md_file:
+        markdown_content = md_file.read()
+    bulletin_json = []
+    content = ''
+
+    # Initialize title and date with default values
+    title = "DEFAULT_TITLE"
+    date = "DEFAULT_DATE"
+
+    for line in markdown_content.split('\n'):
+        if line.startswith('---'):
+            bulletin_json.append({'title': title, 'date': date, 'content':content})
+            content = ''
+            # Reset title and date to their default values after each section
+            title = "DEFAULT_TITLE"
+            date = "DEFAULT_DATE"
+        elif line.startswith('##'):
+            title = line[3:].strip()
+        elif line.startswith('_'):
+            date = line[1:len(line)-1].strip()
+        else:
+            content += (line + '\n')
+    # Append last section   
+    bulletin_json.append({'title': title, 'date': date, 'content':content})
+
+    with open(output_json_file, 'w', encoding='utf-8') as json_file:
+        json.dump(bulletin_json, json_file, ensure_ascii=False, indent=4)
+
+if __name__ == '__main__':
+    generate_json_file()

sleap/gui/app.py

@@ -67,7 +67,7 @@
 from sleap.gui.overlays.tracks import TrackListOverlay, TrackTrailOverlay
 from sleap.gui.shortcuts import Shortcuts
 from sleap.gui.state import GuiState
-from sleap.gui.web import ReleaseChecker, ping_analytics
+from sleap.gui.web import ReleaseChecker, AnnouncementChecker, ping_analytics
 from sleap.gui.widgets.docks import (
     InstancesDock,
     SkeletonDock,
@@ -152,6 +152,8 @@ def __init__(
         self.state["share usage data"] = prefs["share usage data"]
         self.state["skeleton_preview_image"] = None
         self.state["skeleton_description"] = "No skeleton loaded yet"
+        self.state["announcement last seen date"] = prefs["announcement last seen date"]
+        self.state["announcement"] = prefs["announcement"]
         if no_usage_data:
             self.state["share usage data"] = False
         self.state["clipboard_track"] = None
@@ -162,6 +164,9 @@ def __init__(
         self.state.connect("show non-visible nodes", self.plotFrame)
 
         self.release_checker = ReleaseChecker()
+        self.announcement_checker = AnnouncementChecker(
+            app = self
+        )
 
         if self.state["share usage data"]:
             ping_analytics()
@@ -215,6 +220,8 @@ def closeEvent(self, event):
         prefs["color predicted"] = self.state["color predicted"]
         prefs["trail shade"] = self.state["trail_shade"]
         prefs["share usage data"] = self.state["share usage data"]
+        prefs["announcement last seen date"] = self.state["announcement last seen date"]
+        prefs["announcement"] = self.state["announcement"]
 
         # Save preferences.
         prefs.save()

sleap/gui/web.py

@@ -3,11 +3,15 @@
 import attr
 import pandas as pd
 import requests
-from typing import List, Dict, Any
+from typing import List, Dict, Any, Optional, Tuple
+import json
+import os
 
 
 REPO_ID = "talmolab/sleap"
 ANALYTICS_ENDPOINT = "https://analytics.sleap.ai/ping"
+BASE_DIR = os.path.dirname(os.path.abspath(__file__))
+BULLETIN_JSON = os.path.join(BASE_DIR, "..", "docs", "bulletin.json")
 
 
 @attr.s(auto_attribs=True)
@@ -146,6 +150,40 @@ def get_release(self, version: str) -> Release:
         )
 
 
+@attr.s(auto_attribs=True)
+class AnnouncementChecker:
+    """Checker for new announcements on the bulletin page of sleap."""
+
+    app: "MainWindow"
+    bulletin_json_path: str = BULLETIN_JSON
+    previous_announcement_date: str = app.state["announcement last seen date"]
+    _latest_data: Optional[Dict[str, str]] = None
+
+    def _read_bulletin_data(self) -> Dict[str, str]:
+        """Reads the bulletin data from the JSON file."""
+        try:
+            with open(self.bulletin_json_path, 'r', encoding='utf-8') as jsf:
+                data = json.load(jsf)
+                return data[0]
+        except FileNotFoundError:
+            return {}
+
+    def get_latest_announcement(self) -> Optional[Tuple[str, str]]:
+        """Return latest announcements on the releases page not seen by user."""
+        self._latest_datalatest_data = self._read_bulletin_data()
+        if self._latest_data and self._latest_data['date'] != self.previous_announcement_date:
+            return (self._latest_data['date'], self._latest_data['content'])
+        return None
+
+    def update_announcement(self):
+        """Update the last seen date of announcement in preferences."""
+        announcement = self.get_latest_announcement()
+        if announcement is None:
+            return
+        self.app.state["announcement last seen date"] = announcement[0]
+        self.app.state["announcement"] = announcement[1]
+
+
 def get_analytics_data() -> Dict[str, Any]:
     """Gather data to be transmitted to analytics backend."""
     import os

sleap/prefs.py

@@ -5,6 +5,7 @@
 """
 
 from sleap import util
+from datetime import date
 
 
 class Preferences(object):
@@ -28,6 +29,8 @@ class Preferences(object):
         "node label size": 12,
         "show non-visible nodes": True,
         "share usage data": True,
+        "announcement last seen date": None,
+        "announcement": None,
     }
     _filename = "preferences.yaml"