mirror of
https://github.com/rcourtman/Pulse.git
synced 2026-07-18 20:26:53 +00:00
91 lines
3.2 KiB
Python
91 lines
3.2 KiB
Python
#!/usr/bin/env python3
|
|
"""Guardrails for first-wave localized public docs."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from pathlib import Path
|
|
import unittest
|
|
|
|
|
|
ROOT = Path(__file__).resolve().parents[2]
|
|
|
|
|
|
def read(rel: str) -> str:
|
|
return (ROOT / rel).read_text(encoding="utf-8")
|
|
|
|
|
|
LOCALIZED_DOCS = (
|
|
"docs/i18n/de/README.md",
|
|
"docs/i18n/es/README.md",
|
|
)
|
|
|
|
MACHINE_FACING_STRINGS = (
|
|
"export PULSE_VERSION=vX.Y.Z",
|
|
"curl -fsSLO \"https://github.com/rcourtman/Pulse/releases/download/${PULSE_VERSION}/install.sh\"",
|
|
"curl -fsSLO \"https://github.com/rcourtman/Pulse/releases/download/${PULSE_VERSION}/install.sh.sshsig\"",
|
|
"ssh-keygen -Y verify",
|
|
"bash install.sh --version \"${PULSE_VERSION}\"",
|
|
"docker run -d",
|
|
"rcourtman/pulse:vX.Y.Z",
|
|
"image: ${PULSE_IMAGE:-rcourtman/pulse:vX.Y.Z}",
|
|
"PULSE_AUTH_USER=admin",
|
|
"PULSE_AUTH_PASS=secret123",
|
|
"docker exec pulse /app/pulse bootstrap-token",
|
|
"kubectl exec -it <pod> -- /app/pulse bootstrap-token",
|
|
"sudo pulse bootstrap-token",
|
|
"Settings → Infrastructure → Install on a host",
|
|
"Settings → Plans → Existing purchases",
|
|
"ppk_live_",
|
|
"http://<your-ip>:7655",
|
|
"/install.sh",
|
|
"https://pulserelay.pro/download.html",
|
|
)
|
|
|
|
|
|
class LocalizedPublicDocsTest(unittest.TestCase):
|
|
def test_public_indexes_link_to_localized_getting_started_docs(self) -> None:
|
|
root_readme = read("README.md")
|
|
docs_index = read("docs/README.md")
|
|
|
|
self.assertIn("[Deutsch](docs/i18n/de/README.md)", root_readme)
|
|
self.assertIn("[Español](docs/i18n/es/README.md)", root_readme)
|
|
self.assertIn("[Deutsch](i18n/de/README.md)", docs_index)
|
|
self.assertIn("[Español](i18n/es/README.md)", docs_index)
|
|
|
|
def test_localized_docs_preserve_machine_facing_strings(self) -> None:
|
|
for rel in LOCALIZED_DOCS:
|
|
content = read(rel)
|
|
for value in MACHINE_FACING_STRINGS:
|
|
with self.subTest(path=rel, value=value):
|
|
self.assertIn(value, content)
|
|
|
|
def test_localized_docs_point_back_to_canonical_english_docs(self) -> None:
|
|
for rel in LOCALIZED_DOCS:
|
|
content = read(rel)
|
|
with self.subTest(path=rel):
|
|
self.assertIn("[docs/README.md](../../README.md)", content)
|
|
self.assertIn("[Installation Guide](../../INSTALL.md)", content)
|
|
self.assertIn("[Configuration](../../CONFIGURATION.md)", content)
|
|
self.assertIn("[Troubleshooting](../../TROUBLESHOOTING.md)", content)
|
|
self.assertIn("[Agent Security](../../AGENT_SECURITY.md)", content)
|
|
self.assertIn("[Plans and entitlements](../../PULSE_PRO.md)", content)
|
|
|
|
def test_localized_docs_do_not_reintroduce_paid_capacity_claims(self) -> None:
|
|
forbidden = (
|
|
"unlimited",
|
|
"uncapped",
|
|
"no cap",
|
|
"no-cap",
|
|
"sin límite",
|
|
"ilimitado",
|
|
"unbegrenzt",
|
|
)
|
|
for rel in LOCALIZED_DOCS:
|
|
content = read(rel).lower()
|
|
for phrase in forbidden:
|
|
with self.subTest(path=rel, phrase=phrase):
|
|
self.assertNotIn(phrase, content)
|
|
|
|
|
|
if __name__ == "__main__":
|
|
unittest.main()
|