<script src="https://www.sherpadoc.org/example/sherpa.js"></script>
<script>
    example.requestCount()
        .then(function(count) {
            console.log('successful result', count);
        }, function(error) {
            console.error('an error occurred', error.code, error.message);
        });
</script>

/*
Run:
	go get github.com/mjl-/sherpadoc/cmd/sherpadoc
	sherpadoc Example > example.json
	go run main.go
*/
package main

import (
    "encoding/json"
    "log"
    "net/http"
    "os"
    "sync/atomic"

    "github.com/mjl-/sherpa"
    "github.com/mjl-/sherpadoc"
)

var count int64

// This is the API. These comments are added to the documentation by sherpadoc.
type Example struct {
}

// Count the number of requests. This comment and the function signature are
// automatically added to the documentation.
func (Example) RequestCount() int64 {
    return atomic.AddInt64(&count, 1)
}

func check(err error, action string) {
    if err != nil {
        log.Fatalf("%s: %s", action, err)
    }
}

func main() {
    // Read the API documentation generated by sherpadoc.
    var doc sherpadoc.Section
    f, err := os.Open("example.json")
    check(err, "open sherpadoc")
    err = json.NewDecoder(f).Decode(&doc)
    check(err, "parsing sherpadoc")
    f.Close()

    handler, err := sherpa.NewHandler("/example/", "1.0.0", Example{}, &doc, nil)
    check(err, "new sherpa handler")
    http.Handle("/example/", handler)
    log.Fatal(http.ListenAndServe(":8080", nil))
}