feat: add a banner for the DST bug (#90)

* feat: add a banner for the DST bug

* fix: fix ruff issues and update ruff

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

Author: reindervdw-cmi

.pre-commit-config.yaml

@@ -2,7 +2,7 @@ fail_fast: false
 
 repos:
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.2.2
+    rev: v0.6.8
     hooks:
       - id: ruff
       - id: ruff-format

poetry.lock

@@ -27,7 +27,7 @@ pytest = "^8.0.2"
 mypy = "^1.8.0"
 pre-commit = "^3.6.2"
 pytest-cov = "^4.1.0"
-ruff = "^0.2.2"
+ruff = "^0.6"
 pytest-mock = "^3.12.0"
 vulture = "^2.11"
 
@@ -105,10 +105,10 @@ indent-style = "space"
 skip-magic-trailing-comma = false
 line-ending = "auto"
 
-[tool.ruff.pydocstyle]
+[tool.ruff.lint.pydocstyle]
 convention = "google"
 
-[tool.ruff.per-file-ignores]
+[tool.ruff.lint.per-file-ignores]
 "tests/**/*.py" = [
     "S101", # Allow assets
     "ARG", # Unused arguments are common in tests (fixtures).

pyproject.toml

@@ -1,4 +1,5 @@
 """Entrypoints for the Actigraphy app."""
+
 import logging
 
 from actigraphy import app

src/actigraphy/__main__.py

@@ -1,4 +1,5 @@
 """Main app setup for the Actigraphy app."""
+
 import logging
 
 import dash

src/actigraphy/app.py

@@ -1,4 +1,5 @@
 """License information for the application."""
+
 from dash import html
 
 

src/actigraphy/components/app_license.py

@@ -1,4 +1,5 @@
 """Dash HTML div for a slider component for selecting days."""
+
 import datetime
 import itertools
 import logging

src/actigraphy/components/day_slider.py

@@ -0,0 +1,42 @@
+"""A warning banner for Daylight savings time."""
+
+from dash import html
+
+
+def dst_banner(day: int) -> html.Div:
+    """A warning banner for daylight savings time.
+
+    Args:
+        day: The day of daylight savings time.
+
+    Returns:
+        html.Div: A Dash HTML div containing the banner.
+
+
+    """
+    return html.Div(
+        children=[
+            html.P(
+                f"""One or more daylight savings time events were detected in this
+participant, with the first one on day {day}. Please be aware there's a known bug
+where the data is shifted on data loading of a day with daylight savings time.
+When opening these days, please ensure to restore the correct times. Note that if
+you accidentally click a DST day, and immediately click on another day, the bug
+will still occur.""",
+            ),
+        ],
+        style={
+            "backgroundColor": "#ffcc00",
+            "color": "#333",
+            "borderLeft": "4px solid #ffae42",
+            "padding": "10px 20px",
+            "margin": "0 auto",
+            "fontSize": "16px",
+            "fontFamily": "Arial, sans-serif",
+            "fontWeight": "bold",
+            "textAlign": "center",
+            "boxShadow": "0px 4px 6px rgba(0, 0, 0, 0.1)",
+            "borderRadius": "5px",
+            "maxWidth": "50rem",
+        },
+    )

src/actigraphy/components/dst_banner.py

@@ -3,13 +3,20 @@
 The file selection component contains an input box for the evaluator's name, and
 dropdown menu for selecting a subject.
 """
+
 import logging
 
 import dash
 import dash_bootstrap_components
 from dash import dcc, html
 
-from actigraphy.components import day_slider, finished_checkbox, graph, switches
+from actigraphy.components import (
+    day_slider,
+    dst_banner,
+    finished_checkbox,
+    graph,
+    switches,
+)
 from actigraphy.core import callback_manager, config, exceptions
 from actigraphy.core import utils as core_utils
 from actigraphy.database import crud, database
@@ -129,6 +136,10 @@ def parse_files(
         switches.switches(),
         graph.graph(),
     ]
+
+    if dst_index := subject.day_of_daylight_savings_time:
+        ui_components.insert(0, dst_banner.dst_banner(dst_index))
+
     return (
         ui_components,
         "",

src/actigraphy/components/file_selection.py

@@ -3,6 +3,7 @@
 The checklist allows the user to indicate whether they are done with the
 current participant and would like to proceed to the next one.
 """
+
 import logging
 
 import dash