PR2: Add new preference and AnnouncementChecker class

docs/bulletin.md

@@ -1,6 +1,9 @@
 # Bulletin
 
 ## SLEAP v1.3.2
+
+_mm/dd/yyyy_
+
 SLEAP 1.3.2 adds some nice usability features thanks to both the community ideas and new contributors! See [1.3.0](https://github.com/talmolab/sleap/releases/tag/v1.3.0) and [1.3.1](https://github.com/talmolab/sleap/releases/tag/v1.3.1) for previous notable changes. As a reminder:
 
 > The 1.3.1 dependency update requires [Mamba](https://mamba.readthedocs.io/en/latest/index.html) for faster dependency resolution. If you already have anaconda installed, then you _can_ set the solver to libmamba in the base environment:

docs/make_bulletin_json.py

@@ -0,0 +1,30 @@
+import json
+
+# Set the file paths
+input_md_file = 'D:\TalmoLab\sleap\docs\bulletin.md'
+output_json_file = 'D:\TalmoLab\sleap\docs\\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 = ''
+
+    for line in markdown_content.split('\n'):
+        if line.startswith('---'):
+            bulletin_json.append({'title': title, 'date': date, 'content':content})
+            content = ''
+        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,7 @@ def __init__(
         self.state.connect("show non-visible nodes", self.plotFrame)
 
         self.release_checker = ReleaseChecker()
+        self.announcement_checker = AnnouncementChecker()
 
         if self.state["share usage data"]:
             ping_analytics()
@@ -215,6 +218,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,14 @@
 import attr
 import pandas as pd
 import requests
-from typing import List, Dict, Any
+from typing import List, Dict, Any, Optional, Tuple
+from sleap import prefs
+import json
 
 
 REPO_ID = "talmolab/sleap"
 ANALYTICS_ENDPOINT = "https://analytics.sleap.ai/ping"
+BULLETIN_JSON = "D:\TalmoLab\sleap\docs\\bulletin.json"
 
 
 @attr.s(auto_attribs=True)
@@ -146,6 +149,49 @@ def get_release(self, version: str) -> Release:
         )
 
 
+@attr.s(auto_attribs=True)
+class AnnouncementChecker:
+    """Checker for new announcements on the bulletin page of sleap."""
+
+    bulletin_json_path: str = BULLETIN_JSON
+    previous_announcement_date: str = prefs.prefs["announcement last seen date"]
+
+    def check_for_announcement(self) -> bool:
+        """Returns if new announcements are available."""
+        try:
+            # Attempt to open the file in read mode
+            with open(self.bulletin_json_path, 'r', encoding='utf-8') as jsf:
+                # Load the JSON data into a Python data structure
+                data = json.load(jsf)
+                latest_data = data[0]
+
+                if latest_data['date'] != self.previous_announcement_date:
+                    return True
+        except FileNotFoundError:
+            return False
+
+    def get_latest_announcement(self) -> Optional[Tuple[str, str]]:
+        """Return latest announcements on the releases page not seen by user."""
+        success = self.check_for_announcement()
+        if success:
+            # Attempt to open the file in read mode
+            with open(self.bulletin_json_path, 'r', encoding='utf-8') as jsf:
+                # Load the JSON data into a Python data structure
+                data = json.load(jsf)
+                latest_data = data[0]
+
+                if latest_data['date'] != self.previous_announcement_date:
+                    return (latest_data['date'], 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 not None:
+            prefs.prefs["announcement last seen date"] = announcement[0]
+            prefs.prefs["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"