support for nex protocolHEADv0.9.5main

1 files changed, 83 insertions, 0 deletions

diff --git a/nex.go b/nex.go
new file mode 100644
index 0000000..eab3def
--- /dev/null
+++ b/nex.go
@@ -0,0 +1,83 @@
+package syw
+
+import (
+	"context"
+	"text/template"
+
+	"tildegit.org/tjp/sliderule"
+	"tildegit.org/tjp/sliderule/nex"
+)
+
+// NexRouter builds a router that will handle requests into a directory of git repositories.
+//
+// The routes it defines are:
+//
+//	/                                     listing of the repositories in the directory
+//	/:repository/                         overview of the repository
+//	/:repository/branches/                list of branches/heads
+//	/:repository/tags/                    listing of tags
+//	/:repository/refs/:ref/               overview of a ref
+//	/:repository/refs/:ref/tree/*path     listing of directories, raw files
+//	/:repository/diffstat/:fromref/:toref diffstat between two refs
+//	/:repository/diff/:fromref/:toref     diff between two refs
+//
+// The overrides argument can provide templates to define the behavior of nearly all of the above
+// routes. All of them have default implementations so the argument can even be nil, but otherwise
+// the template names used are:
+//
+//	repo_root.nex.txt    at /
+//	repo_home.nex.txt    at /:repository/
+//	branch_list.nex.txt  at /:repository/branches
+//	tag_list.nex.txt     at /:repository/tags
+//	ref.nex.txt          at /:repository/refs/:ref/
+//	tree.nex.txt         for directories requested under /:repository/refs/:ref/tree/*path
+//	                     (file paths return the raw files without any template involved)
+//	diffstat.nex.txt     the plaintext diffstat at /:repository/diffstat/:fromref/:toref
+//	diff.nex.txt         the plaintext diff at /:repository/diff/:fromref/:toref
+//
+// Most of the templates above are rendered with an object with 3 fields:
+//
+//	Ctx:    the context.Context from the request
+//	Repo:   a *syw.Repository object corresponding to <repodir>/:repository
+//	Params: a map[string]string of the route parameters
+//
+// The only exception is repo_root.nex.txt, which is rendered with an object containing a single name
+// "Repos", a slice of the string repository names.
+func NexRouter(repodir string, overrides *template.Template) *sliderule.Router {
+	tmpl, err := addTemplates(nexTemplate, overrides)
+	if err != nil {
+		panic(err)
+	}
+
+	repoRouter := &sliderule.Router{}
+	repoRouter.Use(assignRepo(repodir))
+	repoRouter.Route("/", repoRouteHandler(nexProto, tmpl, "repo_home.nex.txt"))
+	repoRouter.Route("/branches/", repoRouteHandler(nexProto, tmpl, "branch_list.nex.txt"))
+	repoRouter.Route("/tags/", repoRouteHandler(nexProto, tmpl, "tag_list.nex.txt"))
+	repoRouter.Route("/refs/:ref/", repoRouteHandler(nexProto, tmpl, "ref.nex.txt"))
+	repoRouter.Route("/refs/:ref/tree/*path", treePathHandler(nexProto, tmpl, "tree.nex.txt"))
+	repoRouter.Route("/diffstat/:fromref/:toref", repoRouteHandler(nexProto, tmpl, "diffstat.nex.txt"))
+	repoRouter.Route("/diff/:fromref/:toref", repoRouteHandler(nexProto, tmpl, "diff.nex.txt"))
+
+	router := &sliderule.Router{}
+	router.Route("/", rootDirHandler(nexProto, repodir, tmpl, "repo_root.nex.txt"))
+	router.Mount("/:"+reponamekey, repoRouter)
+
+	return router
+}
+
+type nexProtocol struct{ sliderule.ServerProtocol }
+
+func (nexProtocol) TemplateBaseData(_ context.Context, _ *sliderule.Request) map[string]any {
+	return map[string]any{}
+}
+
+func (nexProtocol) TemplateRepoData(ctx context.Context, request *sliderule.Request) map[string]any {
+	return map[string]any{
+		"Ctx":    ctx,
+		"Repo":   ctx.Value(repokey),
+		"Params": sliderule.RouteParams(ctx),
+	}
+}
+
+var nexProto = nexProtocol{nex.ServerProtocol}