Files
flexly-cms/tests/test_preview_001.py
phelex 88ac95dd19 Integrate Antirion admin with FastAPI and htmx
Add the shared document API, constructor and expert editors, isolated preview, and fragment catalog metadata with typed block IDs.

Include design references, specification 001, QA scripts, project guidance, and cached Docker dependency installation. Leave example sites for a separate commit.
2026-11-12 21:55:36 +03:00

190 lines
8.9 KiB
Python

"""Preview tokens, origins, protected assets and public-build separation."""
import os
from unittest.mock import patch
from urllib.parse import urlsplit
from fastapi.testclient import TestClient
from helpers import SiteTestCase
from site_engine.build.pipeline import build_site
from site_engine.errors import UnsafePathError
from site_engine.services.auth import Principal
from site_engine.services.pages import PageService
from site_engine.services.preview import PreviewConfig, PreviewStore, asset_path
from site_engine.web.preview_app import create_preview_app
class PreviewTests(SiteTestCase):
def setUp(self):
super().setUp()
self.state = self.tmp / "state"
self.config = PreviewConfig("http://127.0.0.1:9100", "http://127.0.0.1:9101")
self.time = [1000.0]
self.store = PreviewStore(
self.state, b"secret-" * 8, self.config, clock=lambda: self.time[0]
)
self.svc = PageService(self.site)
self.principal = Principal("admin", "session")
self.s = self.svc.get("index")
def preview(self):
return self.store.render(self.svc, "index", self.s.source, self.s.etag, 4, self.principal)
def token(self, p):
return urlsplit(p["url"]).query.removeprefix("token=")
def test_token_identity_expiry_epoch_and_cleanup(self):
p = self.preview()
token = self.token(p)
folder, data = self.store.authorize(p["snapshot"], token)
self.assertEqual(data["revision"], 4)
for snapshot, tok in ((p["snapshot"], token + "bad"), ("a" * 32, token)):
with self.assertRaises(PermissionError):
self.store.authorize(snapshot, tok)
self.time[0] += 601
with self.assertRaises(PermissionError):
self.store.authorize(p["snapshot"], token)
self.time[0] = 1000
self.state.joinpath("auth_epoch").write_text("1")
with self.assertRaises(PermissionError):
self.store.authorize(p["snapshot"], token)
self.preview()
self.assertFalse(folder.exists())
def test_last_twenty_snapshots_per_session_document(self):
first = self.preview()
for i in range(21):
self.time[0] += 1
self.preview()
self.assertEqual(len(list(self.store.directory.iterdir())), 20)
with self.assertRaises(PermissionError):
self.store.authorize(first["snapshot"], self.token(first))
def test_immutable_assets_unsaved_source_and_no_canonical_write(self):
self.write("assets/new.svg", '<svg xmlns="http://www.w3.org/2000/svg"/>')
original = (self.site / self.s.path).read_bytes()
source = self.s.source.replace("title: Главная", "title: Unsaved preview")
p = self.store.render(self.svc, "index", source, self.s.etag, 5, self.principal)
folder, _ = self.store.authorize(p["snapshot"], self.token(p))
html = (folder / "index.html").read_text()
self.assertIn("Unsaved preview", html)
self.assertIn('data-preview-scope="page"', html)
self.assertIn('data-preview-scope="layout"', html)
self.assertIn("preview:ready", html)
self.assertEqual(
(folder / "assets/new.svg").read_bytes(), (self.site / "assets/new.svg").read_bytes()
)
self.write("assets/new.svg", "changed")
self.assertIn("<svg", (folder / "assets/new.svg").read_text())
self.assertEqual((self.site / self.s.path).read_bytes(), original)
self.assertFalse((self.out / "current").exists())
def test_scriptless_preview_has_selection_markers_without_enabling_scripts(self):
from site_engine.web.preview_app import snapshot_response
with patch.object(self.store, "config", None):
preview = self.preview()
folder, _ = self.store.authorize(preview["snapshot"], self.token(preview))
html = (folder / "index.html").read_text()
self.assertIn('data-preview-scope="page"', html)
self.assertIn('data-preview-scope="layout"', html)
self.assertIn("data-preview-selected", html)
self.assertNotIn("preview:ready", html)
self.assertFalse(preview["interactive"])
response = snapshot_response(self.store, preview["snapshot"], self.token(preview))
self.assertIn("script-src 'none'", response.headers["content-security-policy"])
self.assertEqual(response.headers["x-frame-options"], "SAMEORIGIN")
def test_symlink_and_traversal_rejected(self):
self.write("assets/real.txt", "inside")
(self.site / "assets/link.txt").symlink_to(self.site / "assets/real.txt")
for rel in ("../site.yaml", "link.txt", "a/../real.txt", "/etc/passwd"):
with self.assertRaises((UnsafePathError, FileNotFoundError)):
asset_path(self.site / "assets", rel)
with self.assertRaises(UnsafePathError):
self.preview()
def test_separate_app_has_no_admin_and_checks_every_resource(self):
p = self.preview()
env = {
"SITE_ADMIN_ORIGIN": self.config.admin,
"SITE_PREVIEW_ORIGIN": self.config.preview,
"SITE_STATE_DIR": str(self.state),
"SITE_SECRET_KEY": ("secret-" * 8),
}
with patch.dict(os.environ, env):
app = create_preview_app()
# Factory uses wall clock: use a live-clock snapshot for actual ASGI requests.
store = PreviewStore(self.state, b"secret-" * 8, self.config)
self.write("assets/new.svg", '<svg xmlns="http://www.w3.org/2000/svg"/>')
p = store.render(self.svc, "index", self.s.source, self.s.etag, 4, self.principal)
parsed = urlsplit(p["url"])
with TestClient(app) as client:
self.assertEqual(client.get("/admin/login").status_code, 404)
self.assertEqual(client.get("/admin/api/v1/site").status_code, 404)
self.assertEqual(client.get(parsed.path).status_code, 403)
response = client.get(parsed.path + "?" + parsed.query)
self.assertEqual(response.status_code, 200)
self.assertNotIn("x-frame-options", response.headers)
self.assertIn(
"frame-ancestors " + self.config.admin, response.headers["content-security-policy"]
)
self.assertNotIn("script-src 'self'", response.headers["content-security-policy"])
asset = f"/s/{p['snapshot']}/assets/new.svg"
self.assertEqual(client.get(asset).status_code, 403)
self.assertEqual(client.get(asset + "?" + parsed.query).status_code, 200)
self.state.joinpath("auth_epoch").write_text("1")
self.assertEqual(client.get(asset + "?" + parsed.query).status_code, 403)
def test_display_markers_and_public_build_no_bridge(self):
from site_engine.services.entries import EntryService
svc = EntryService(self.site, collection="services")
s = svc.get("bots")
p = self.store.render(svc, "bots", s.source, s.etag, 1, self.principal)
folder, _ = self.store.authorize(p["snapshot"], self.token(p))
self.assertIn('data-preview-scope="display"', (folder / "index.html").read_text())
build_site(self.site, self.out)
html = "".join(p.read_text() for p in (self.out / "current").rglob("*.html"))
self.assertNotIn("data-preview-", html)
self.assertNotIn("preview:ready", html)
def test_origin_validation(self):
invalid = [
("https://cms.example", "https://cms.example"),
("http://cms.example", "https://p.example"),
("https://cms.example/", "https://p.example"),
("https://cms.example", ""),
("https://CMS.example", "https://cms.example:443"),
]
for a, p in invalid:
with (
patch.dict(os.environ, {"SITE_ADMIN_ORIGIN": a, "SITE_PREVIEW_ORIGIN": p}),
self.assertRaises(ValueError),
):
PreviewConfig.from_env()
def test_css_dependencies_have_tokens_and_normalized_paths(self):
from site_engine.services.preview import rewrite_css
text = rewrite_css(
'@import "other.css";a{background:url(../image.svg?v=1)}',
"css/main.css",
"/s/snapshot/assets/",
"TOKEN",
)
self.assertIn("/s/snapshot/assets/css/other.css?token=TOKEN", text)
self.assertIn("/s/snapshot/assets/image.svg?v=1&token=TOKEN", text)
def test_markers_do_not_add_wrappers_or_confuse_scopes(self):
from site_engine.core.preview_marks import mark_roots
html = '<section><img src="x"><p>Text</p></section><aside>Other</aside>'
page = mark_roots(html, "page", "index", "same")
layout = mark_roots(html, "layout", "default", "same")
self.assertEqual(page.count('data-preview-id="same"'), 2)
self.assertEqual(page.count("<section"), 1)
self.assertIn('data-preview-scope="layout"', layout)
self.assertIn('data-preview-owner="default"', layout)