Add alerts support

[PardhavMaradani]

Changes made in this Pull Request:

• Backend support for creating and managing alerts
• Frontend support for displaying alerts
• Command line option to clear alerts during startup
• Backend and Frontend tests for all new functionality

PR Checklist

• Tests?
• Docs?
• CHANGELOG updated?
• Issue raised/referenced?

---

Hi @orbeckst, @jeremyleung521, @amruthesht, @HeydenLabASU,

This PR adds support for alerts. Widget classes can now create alerts based on any runtime conditions and they will now show up on the dashboard GUI. Currently, only the 'COMDistance' widget uses this feature. It has the following config:

In addition to creating an alert, widgets can also invoke a method from the base class to pause the simulation if needed (added as part of PR #27 ).

Here is the main dashboard page that updates the alerts badge in realtime when they are triggered:

Here is the alerts page that shows all the alerts and allows users to delete individual alerts, all alerts, search / filter, paginate etc:

With alerts support, we now have all the core functionality in place.

Thanks

[read-the-docs-community]

Documentation build overview

📚 mdadash | 🛠️ Build #33519182 | 📁 Comparing d43f455 against latest (b244b73)

  🔍 Preview build  

9 files changed · ± 9 modified

± Modified

• genindex.html
• getting_started.html
• autosummary/mdadash.backend.kernel.core.html
• autosummary/mdadash.backend.state.manager.html
• autosummary/mdadash.backend.widgets.base.html
• _modules/mdadash/backend/analyses/com_distance.html
• _modules/mdadash/backend/kernel/manager.html
• _modules/mdadash/backend/state/manager.html
• _modules/mdadash/backend/widgets/base.html

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (b244b73) to head (e7a3d6a).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

Components	Coverage Δ
frontend	100.00% <100.00%> (ø)
backend	100.00% <100.00%> (ø)

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.