84 lines
3.4 KiB
Go
84 lines
3.4 KiB
Go
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}
|