maint: comment source code

TODO

@@ -1,5 +1,4 @@
 maint: clean up source code
-maint: comment source code
 maint: document more
 feat: improve flags
 feat: replace uuid dep with custom id generator

cmd/lash/main.go

@@ -23,6 +23,7 @@ func main() {
 
 	srv := app.New()
 
+	// TODO(vxc): Make this more portable
 	errx.Log("Your token is \033[1;92m%s\033[0m", lash.Token)
 
 	errx.Log("starting server at http://0.0.0.0:%d", *port)

internal/app/routes.go

@@ -22,7 +22,7 @@ func New() http.Handler {
 	}
 
 	share := handlers.ShareData{
-		Version:  lash.Version,
+		Version: lash.Version,
 	}
 
 	file := handlers.FileData{

internal/handlers/file.go

@@ -32,6 +32,7 @@ func (h FileData) APIHandler(w http.ResponseWriter, r *http.Request) {
 		return
 	}
 
+	// Send the file over as a stream of bytes
 	w.Header().Set("Content-Disposition", fmt.Sprintf("attachment; filename=%s", h.FileName))
 	w.Header().Set("Content-Type", "application/octet-stream")
 	w.Header().Set("Content-Length", strconv.Itoa(len(h.Contents)))

internal/handlers/share.go

@@ -13,6 +13,7 @@ type ShareData struct {
 }
 
 func (h *ShareData) Handler(w http.ResponseWriter, r *http.Request) {
+	// Although `Must` can fail since `Templates` is embeded these files will always exist.
 	tmpl := template.Must(template.ParseFS(lash.Templates, "templates/share.html"))
 
 	if err := tmpl.ExecuteTemplate(w, "share.html", h); err != nil {

lash.go

@@ -12,4 +12,5 @@ var Templates embed.FS
 //go:embed version
 var Version string
 
+// TODO(vxc): Replace this with custom token generator
 var Token string = uuid.New().String()