Improved API documentation

pages/apiview/api.go

@@ -1,22 +1,37 @@
 package apiview
 
 import (
+	"path"
 	"sort"
 
 	"github.com/aerogo/aero"
 	"github.com/animenotifier/arn"
+	"github.com/animenotifier/arn/autodocs"
 	"github.com/animenotifier/notify.moe/components"
+	"github.com/fatih/color"
 )
 
 // Get api page.
 func Get(ctx *aero.Context) string {
-	types := []string{}
+	types := []*autodocs.Type{}
 
 	for typeName := range arn.DB.Types() {
-		types = append(types, typeName)
+		if typeName == "Session" {
+			continue
+		}
+
+		typ, err := autodocs.GetTypeDocumentation(typeName, path.Join(arn.Root, "..", "arn", typeName+".go"))
+		types = append(types, typ)
+
+		if err != nil {
+			color.Red(err.Error())
+			continue
+		}
 	}
 
-	sort.Strings(types)
+	sort.Slice(types, func(i, j int) bool {
+		return types[i].Name < types[j].Name
+	})
 
 	return ctx.HTML(components.API(types))
 }

pages/apiview/api.pixy

@@ -1,4 +1,4 @@
-component API(types []string)
+component API(types []*autodocs.Type)
 	.api-docs-page
 		h1 API
 
@@ -12,13 +12,10 @@ component API(types []string)
 				span https://notify.moe/graphql
 		
 		h2 Types
-		table
+		table.api-types
-			//- thead
-			//- 	tr
-			//- 		th Table
 			tbody
-				each typeName in types
+				each typ in types
 					tr
-						td= typeName
 						td
-							a(href="/api/" + strings.ToLower(typeName) + "/")= "/api/" + strings.ToLower(typeName) + "/"
+							a(href=typ.Endpoint())= typ.Name
+						td= typ.Comment

pages/apiview/api.scarlet

@@ -0,0 +1,2 @@
+.api-types
+	max-width 100%