mirror of
https://github.com/rcourtman/Pulse.git
synced 2026-10-25 13:10:03 +00:00
pulse-triage[bot]
55ed040364
Distinguish required and active members from spare-inclusive totals using the supplied clean-array case. Preserve genuine loss/recovery warnings, private evidence and unknown observations. Link the existing guide from symptom selection and keep its shipped copy identical. Contract-Neutral: Existing troubleshooting guidance and its safety checks only; no runtime, storage policy, API, permission, dependency or navigation-surface change. Change-source: pulse-maintainer
78 lines
3.2 KiB
Python
78 lines
3.2 KiB
Python
#!/usr/bin/env python3
|
|
"""Preserve spare-aware RAID help without implying storage recovery.
|
|
|
|
Browser verification covers navigation and the shipped renderer separately.
|
|
These checks guard the documented distinctions and avoid unsafe recipes.
|
|
"""
|
|
|
|
from pathlib import Path
|
|
import unittest
|
|
|
|
|
|
ROOT = Path(__file__).resolve().parents[2]
|
|
HEADING = "#### RAID array is degraded with a spare\n"
|
|
|
|
|
|
class RAIDTroubleshootingDocsTest(unittest.TestCase):
|
|
def section(self):
|
|
guide = (ROOT / "docs/TROUBLESHOOTING.md").read_text(encoding="utf-8")
|
|
self.assertEqual(guide.count(HEADING), 1)
|
|
return " ".join(guide.split(HEADING, 1)[1].split("\n#### ", 1)[0].split())
|
|
|
|
def test_required_members_are_not_spare_inclusive_totals(self):
|
|
text = self.section()
|
|
for distinction in (
|
|
"same array's **existing** native status",
|
|
"observation time",
|
|
"**Raid Devices** is the required member count",
|
|
"**Total Devices** can include a spare",
|
|
"Active **4**, Total **5**, Working **5**, Spare **1**, Failed **0**",
|
|
"Raid Devices **4**, Active **3**",
|
|
"Do not subtract the spare from the required count",
|
|
"Missing counts, an old reading or different array identities",
|
|
):
|
|
with self.subTest(distinction=distinction):
|
|
self.assertIn(distinction, text)
|
|
|
|
def test_correction_is_not_every_alert_or_installed_recovery(self):
|
|
text = self.section()
|
|
for limit in (
|
|
"Pulse **v6.5.0**",
|
|
"reports from older collectors",
|
|
"does not establish that every RAID alert has this cause",
|
|
"an affected installation has recovered",
|
|
"data integrity, backup completeness or restore readiness",
|
|
"Failed devices, a degraded/unavailable state, or recovery/reshape",
|
|
):
|
|
with self.subTest(limit=limit):
|
|
self.assertIn(limit, text)
|
|
|
|
def test_diagnosis_does_not_require_mutation_or_raw_public_output(self):
|
|
text = self.section()
|
|
for boundary in (
|
|
"independent monitoring",
|
|
"Keep RAID alerts enabled",
|
|
"do not remove a spare",
|
|
"fail a member",
|
|
"assemble/rebuild an array",
|
|
"start a scrub",
|
|
"reboot or change collection settings",
|
|
"No new `mdadm` command, Diagnostics run or induced failure",
|
|
"reported as unknown",
|
|
"consistent private aliases",
|
|
"UUIDs, serial numbers, private paths and full command output",
|
|
"Do not repeat an array operation",
|
|
):
|
|
with self.subTest(boundary=boundary):
|
|
self.assertIn(boundary, text)
|
|
self.assertNotIn("```", text, "existing observations, not a command recipe")
|
|
|
|
def test_entrypoint_and_shipped_copy_match(self):
|
|
source = (ROOT / "docs/TROUBLESHOOTING.md").read_bytes()
|
|
self.assertEqual(source, (ROOT / "frontend-modern/public/docs/TROUBLESHOOTING.md").read_bytes())
|
|
self.assertIn(b"[required members, active members and spares](TROUBLESHOOTING.md#raid-array-is-degraded-with-a-spare)", source)
|
|
|
|
|
|
if __name__ == "__main__":
|
|
unittest.main()
|