ZDDC
8b6a2dc3e3
Adds internal/apps/ package serving the five tool HTMLs at virtual paths based on the surrounding folder name convention: archive every directory (multi-project, project, archive, vendor) classifier any Incoming/Working/Staging directory and subtree mdedit any Working directory and subtree transmittal any Staging directory and subtree landing only at deployment root The current-stable build of every tool is //go:embed'd into the binary at compile time — that's the default with zero config. Operators override per-directory via .zddc apps: entries; closer-to-leaf wins. Spec syntax (in any apps: value): stable / beta / alpha / :stable channel v0.0.4 / v0.0 / v0 / :v0.0.4 version https://my-mirror/releases URL prefix only https://my-mirror/releases:beta URL prefix + channel https://my-fork/archive.html terminal full URL ./local.html / /abs/path.html terminal local path The special apps.default key provides a baseline URL prefix and channel inherited by any app not overridden per-name. Per-axis cascade: a deeper .zddc can override the URL, the channel, or both. Cascade walks root→leaf; default applies first at each level, then the per-app entry. Terminal sources (paths and full .html URLs) short-circuit composition; deeper non-terminal entries override parent terminals. URL sources fetch once on first request and cache forever in <ZDDC_ROOT>/_app/<host>/<path> — different upstreams with the same filename stay distinct. No background refresh, no SHA-256 verification: operators delete the cache file to force a refetch. Concurrent misses for the same source dedupe via a 30-line hand-rolled singleflight. Per-request override: any user can append ?v=<spec> to a tool URL (e.g. ?v=beta, ?v=v0.0.4, ?v=:alpha, ?v=https://mirror/releases:beta) to ask for a different build for one request. Security: ?v= serves ONLY versions already in the cache (cache miss returns 404; path sources are rejected outright with 400). Users cannot trigger arbitrary upstream fetches via crafted URLs. Failed URL fetches (network down, 5xx) fall back to embedded with a one-time WARN log. The X-ZDDC-Source response header reports what served: fetch:URL / cache:URL / path:/abs / embedded:<app>@<build>. Wire-in (cmd/zddc-server/main.go): dispatch routes <dir>/<app>.html through apps.MatchAppHTML + AppAvailableAt + apps.Server.Serve when no real file exists. Direct URL access to /_app/... is blocked at the dispatch layer — cached files must go through the apps resolver so they get correct Content-Type and ACL gating. Schema (internal/zddc/file.go): ZddcFile gains Apps map[string]string for cascade overrides. Validator (internal/zddc/validate.go) accepts the special "default" key alongside the five canonical app names and all spec forms. Removes ZDDC_APPS_* env vars (no admin UI, no refresh interval, no upstream allow-list — the simpler model has fewer knobs). 40+ unit tests across the new package: parser shapes, cascade resolution with default+per-app interactions, terminal short-circuit semantics, ?v= cache-only enforcement, embedded fallback, atomic cache writes, singleflight dedup. Plus end-to-end dispatch tests in cmd/zddc-server/main_test.go. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
61 lines
1.9 KiB
Go
61 lines
1.9 KiB
Go
package apps
|
|
|
|
import (
|
|
"path/filepath"
|
|
"testing"
|
|
)
|
|
|
|
func TestAppAvailableAt(t *testing.T) {
|
|
root := "/srv/zddc"
|
|
cases := []struct {
|
|
dir, app string
|
|
want bool
|
|
}{
|
|
// archive: everywhere
|
|
{root, "archive", true},
|
|
{root + "/Project-A", "archive", true},
|
|
{root + "/Project-A/Working", "archive", true},
|
|
{root + "/Project-A/Outgoing", "archive", true},
|
|
|
|
// landing: only at root
|
|
{root, "landing", true},
|
|
{root + "/Project-A", "landing", false},
|
|
|
|
// classifier: Incoming/Working/Staging and subtrees
|
|
{root, "classifier", false},
|
|
{root + "/Project-A", "classifier", false},
|
|
{root + "/Project-A/Incoming", "classifier", true},
|
|
{root + "/Project-A/Incoming/SubDir", "classifier", true},
|
|
{root + "/Project-A/Working", "classifier", true},
|
|
{root + "/Project-A/Staging", "classifier", true},
|
|
{root + "/Project-A/Outgoing", "classifier", false},
|
|
{root + "/Project-A/Working/deep/nested/path", "classifier", true},
|
|
|
|
// mdedit: Working only
|
|
{root + "/Project-A/Working", "mdedit", true},
|
|
{root + "/Project-A/Working/SubDir", "mdedit", true},
|
|
{root + "/Project-A/Incoming", "mdedit", false},
|
|
{root + "/Project-A/Staging", "mdedit", false},
|
|
|
|
// transmittal: Staging only
|
|
{root + "/Project-A/Staging", "transmittal", true},
|
|
{root + "/Project-A/Staging/SubDir", "transmittal", true},
|
|
{root + "/Project-A/Incoming", "transmittal", false},
|
|
{root + "/Project-A/Working", "transmittal", false},
|
|
|
|
// case-sensitivity: lowercase doesn't match
|
|
{root + "/Project-A/working", "mdedit", false},
|
|
{root + "/Project-A/staging", "transmittal", false},
|
|
|
|
// unknown app
|
|
{root + "/Project-A", "weird", false},
|
|
}
|
|
for _, tc := range cases {
|
|
t.Run(tc.app+"@"+tc.dir, func(t *testing.T) {
|
|
got := AppAvailableAt(root, filepath.Clean(tc.dir), tc.app)
|
|
if got != tc.want {
|
|
t.Errorf("AppAvailableAt(%q, %q) = %v, want %v", tc.dir, tc.app, got, tc.want)
|
|
}
|
|
})
|
|
}
|
|
}
|