Files

109 lines
2.6 KiB
Go

package main
import (
"errors"
"net/http"
"os"
"path/filepath"
"sort"
"strings"
)
type helpArticle struct {
Name string `json:"name"`
Description Localized `json:"description"`
Website string `json:"website"`
BrowseURL string `json:"browseUrl"`
Body string `json:"body,omitempty"`
}
func publishedHelp(meta MirrorMetadata) bool {
return meta.Visible && strings.TrimSpace(meta.Help) != ""
}
func helpContent(meta MirrorMetadata, body bool) helpArticle {
article := helpArticle{Name: meta.Name, Description: meta.Description, Website: meta.Website, BrowseURL: "/mirrors/" + meta.Name + "/"}
if body {
article.Body = meta.Help
}
return article
}
func (a *App) findHelp(name string) (MirrorMetadata, error) {
var meta MirrorMetadata
if !validName(name) {
return meta, errMissing
}
record, err := a.record("mirrors", name)
if err != nil {
return meta, err
}
if err := decodeData(record.Data, &meta); err != nil {
return meta, err
}
if meta.Name != name || !publishedHelp(meta) {
return meta, errMissing
}
return meta, nil
}
func (a *App) helpIndex(w http.ResponseWriter, r *http.Request) {
records, err := a.records("mirrors")
if err != nil {
a.internal(w, err)
return
}
articles := []helpArticle{}
for _, record := range records {
var meta MirrorMetadata
if decodeData(record.Data, &meta) == nil && validName(meta.Name) && meta.Name == record.ID && publishedHelp(meta) {
articles = append(articles, helpContent(meta, false))
}
}
sort.Slice(articles, func(i, j int) bool { return articles[i].Name < articles[j].Name })
respond(w, 200, articles)
}
func (a *App) helpArticle(w http.ResponseWriter, r *http.Request) {
meta, err := a.findHelp(r.PathValue("name"))
if errors.Is(err, errMissing) {
fail(w, 404, "NOT_FOUND")
return
}
if err != nil {
a.internal(w, err)
return
}
respond(w, 200, helpContent(meta, true))
}
func (a *App) helpPage(w http.ResponseWriter, r *http.Request) {
path := strings.TrimSuffix(r.URL.Path, "/")
index := filepath.Join(a.cfg.Static, "index.html")
w.Header().Set("Cache-Control", "no-cache")
if path == "/help" {
http.ServeFile(w, r, index)
return
}
_, err := a.findHelp(strings.TrimPrefix(path, "/help/"))
if err == nil {
http.ServeFile(w, r, index)
return
}
if !errors.Is(err, errMissing) {
a.internal(w, err)
return
}
// Return the application for a friendly error page while retaining a real 404.
raw, err := os.ReadFile(index)
if err != nil {
http.NotFound(w, r)
return
}
w.Header().Set("Content-Type", "text/html; charset=utf-8")
w.WriteHeader(http.StatusNotFound)
if r.Method != http.MethodHead {
w.Write(raw)
}
}