Hook up documentation generation to dispatch.

Closes #54
Closes #55
Closes #71

Cargo.toml

@@ -28,6 +28,7 @@ jf-utils = { features = ["std"], git = "https://github.com/EspressoSystems/jelly
 lazy_static = "1.4.0"
 libc = "0.2.126"
 markdown = "0.3"
+maud = { version = "0.23", features = ["tide"] }
 parking_lot = "0.12.0"
 routefinder = "0.5.0"
 semver = "1.0"

examples/hello-world/api.toml

@@ -1,11 +1,19 @@
 [meta]
+NAME = "hello-world"
+DESCRIPTION = "An example of a simple Tide Disco module"
 FORMAT_VERSION = "0.1.0"
 
 [route.greeting]
 PATH = ["greeting/:name"]
 ":name" = "Literal"
+DOC = """
+Return a greeting personalized for `name`.
+"""
 
 [route.setgreeting]
 PATH = ["greeting/:greeting"]
 METHOD = "POST"
 ":greeting" = "Literal"
+DOC = """
+Set the personalized greeting to return from [greeting](#greeting).
+"""

examples/hello-world/main.rs

@@ -4,6 +4,8 @@ use serde::{Deserialize, Serialize};
 use snafu::Snafu;
 use std::fs;
 use std::io;
+use std::path::PathBuf;
+use std::str::FromStr;
 use tide_disco::{http::StatusCode, Api, App, Error, RequestError};
 use tracing::info;
 
@@ -41,7 +43,12 @@ async fn serve(port: u16) -> io::Result<()> {
         "examples/hello-world/api.toml",
     )?)?)
     .unwrap();
-    api.with_version(env!("CARGO_PKG_VERSION").parse().unwrap());
+    api.with_version(env!("CARGO_PKG_VERSION").parse().unwrap())
+        .with_public(
+            PathBuf::from_str(env!("CARGO_MANIFEST_DIR"))
+                .unwrap()
+                .join("public/media"),
+        );
 
     // Can invoke by browsing
     //    `http://0.0.0.0:8080/hello/greeting/dude`