package main import ( "crypto/sha1" "fmt" "io/ioutil" "net/http" "os" "os/exec" "path/filepath" "regexp" "strings" "text/template" "github.com/russross/blackfriday" ) // siteDir is the target directory into which the HTML gets generated. Its // default is set here but can be changed by an argument passed into the // program. var siteDir = "./public" var cacheDir = "/tmp/gobyexample-cache" var pygmentizeBin = "./vendor/pygments/pygmentize" func verbose() bool { return len(os.Getenv("VERBOSE")) > 0 } func check(err error) { if err != nil { panic(err) } } func ensureDir(dir string) { err := os.MkdirAll(dir, 0755) check(err) } func copyFile(src, dst string) { dat, err := ioutil.ReadFile(src) check(err) err = ioutil.WriteFile(dst, dat, 0644) check(err) } func pipe(bin string, arg []string, src string) []byte { cmd := exec.Command(bin, arg...) in, err := cmd.StdinPipe() check(err) out, err := cmd.StdoutPipe() check(err) err = cmd.Start() check(err) _, err = in.Write([]byte(src)) check(err) err = in.Close() check(err) bytes, err := ioutil.ReadAll(out) check(err) err = cmd.Wait() check(err) return bytes } func sha1Sum(s string) string { h := sha1.New() h.Write([]byte(s)) b := h.Sum(nil) return fmt.Sprintf("%x", b) } func mustReadFile(path string) string { bytes, err := ioutil.ReadFile(path) check(err) return string(bytes) } func cachedPygmentize(lex string, src string) string { ensureDir(cacheDir) arg := []string{"-l", lex, "-f", "html"} cachePath := cacheDir + "/pygmentize-" + strings.Join(arg, "-") + "-" + sha1Sum(src) cacheBytes, cacheErr := ioutil.ReadFile(cachePath) if cacheErr == nil { return string(cacheBytes) } renderBytes := pipe(pygmentizeBin, arg, src) // Newer versions of Pygments add silly empty spans. renderCleanString := strings.Replace(string(renderBytes), "", "", -1) writeErr := ioutil.WriteFile(cachePath, []byte(renderCleanString), 0600) check(writeErr) return renderCleanString } func markdown(src string) string { return string(blackfriday.MarkdownCommon([]byte(src))) } func readLines(path string) []string { src := mustReadFile(path) return strings.Split(src, "\n") } func mustGlob(glob string) []string { paths, err := filepath.Glob(glob) check(err) return paths } func whichLexer(path string) string { if strings.HasSuffix(path, ".go") { return "go" } else if strings.HasSuffix(path, ".sh") { return "console" } panic("No lexer for " + path) } func debug(msg string) { if os.Getenv("DEBUG") == "1" { fmt.Fprintln(os.Stderr, msg) } } var docsPat = regexp.MustCompile("^\\s*(\\/\\/|#)\\s") var dashPat = regexp.MustCompile("\\-+") // Seg is a segment of an example type Seg struct { Docs, DocsRendered string Code, CodeRendered, CodeForJs string CodeEmpty, CodeLeading, CodeRun bool } // Example is info extracted from an example file type Example struct { ID, Name string GoCode, GoCodeHash, URLHash string Segs [][]*Seg PrevExample *Example NextExample *Example } func parseHashFile(sourcePath string) (string, string) { lines := readLines(sourcePath) return lines[0], lines[1] } func resetURLHashFile(codehash, code, sourcePath string) string { if verbose() { fmt.Println(" Sending request to play.golang.org") } payload := strings.NewReader(code) resp, err := http.Post("https://play.golang.org/share", "text/plain", payload) if err != nil { panic(err) } defer resp.Body.Close() body, err := ioutil.ReadAll(resp.Body) urlkey := string(body) data := fmt.Sprintf("%s\n%s\n", codehash, urlkey) ioutil.WriteFile(sourcePath, []byte(data), 0644) return urlkey } func parseSegs(sourcePath string) ([]*Seg, string) { var ( lines []string source []string ) // Convert tabs to spaces for uniform rendering. for _, line := range readLines(sourcePath) { lines = append(lines, strings.Replace(line, "\t", " ", -1)) source = append(source, line) } filecontent := strings.Join(source, "\n") segs := []*Seg{} lastSeen := "" for _, line := range lines { if line == "" { lastSeen = "" continue } matchDocs := docsPat.MatchString(line) matchCode := !matchDocs newDocs := (lastSeen == "") || ((lastSeen != "docs") && (segs[len(segs)-1].Docs != "")) newCode := (lastSeen == "") || ((lastSeen != "code") && (segs[len(segs)-1].Code != "")) if newDocs || newCode { debug("NEWSEG") } if matchDocs { trimmed := docsPat.ReplaceAllString(line, "") if newDocs { newSeg := Seg{Docs: trimmed, Code: ""} segs = append(segs, &newSeg) } else { segs[len(segs)-1].Docs = segs[len(segs)-1].Docs + "\n" + trimmed } debug("DOCS: " + line) lastSeen = "docs" } else if matchCode { if newCode { newSeg := Seg{Docs: "", Code: line} segs = append(segs, &newSeg) } else { segs[len(segs)-1].Code = segs[len(segs)-1].Code + "\n" + line } debug("CODE: " + line) lastSeen = "code" } } for i, seg := range segs { seg.CodeEmpty = (seg.Code == "") seg.CodeLeading = (i < (len(segs) - 1)) seg.CodeRun = strings.Contains(seg.Code, "package main") } return segs, filecontent } func parseAndRenderSegs(sourcePath string) ([]*Seg, string) { segs, filecontent := parseSegs(sourcePath) lexer := whichLexer(sourcePath) for _, seg := range segs { if seg.Docs != "" { seg.DocsRendered = markdown(seg.Docs) } if seg.Code != "" { seg.CodeRendered = cachedPygmentize(lexer, seg.Code) // adding the content to the js code for copying to the clipboard if strings.HasSuffix(sourcePath, ".go") { seg.CodeForJs = strings.Trim(seg.Code, "\n") + "\n" } } } // we are only interested in the 'go' code to pass to play.golang.org if lexer != "go" { filecontent = "" } return segs, filecontent } func parseExamples() []*Example { var exampleNames []string for _, line := range readLines("examples.txt") { if line != "" && !strings.HasPrefix(line, "#") { exampleNames = append(exampleNames, line) } } examples := make([]*Example, 0) for i, exampleName := range exampleNames { if verbose() { fmt.Printf("Processing %s [%d/%d]\n", exampleName, i+1, len(exampleNames)) } example := Example{Name: exampleName} exampleID := strings.ToLower(exampleName) exampleID = strings.Replace(exampleID, " ", "-", -1) exampleID = strings.Replace(exampleID, "/", "-", -1) exampleID = strings.Replace(exampleID, "'", "", -1) exampleID = dashPat.ReplaceAllString(exampleID, "-") example.ID = exampleID example.Segs = make([][]*Seg, 0) sourcePaths := mustGlob("examples/" + exampleID + "/*") for _, sourcePath := range sourcePaths { if strings.HasSuffix(sourcePath, ".hash") { example.GoCodeHash, example.URLHash = parseHashFile(sourcePath) } else { sourceSegs, filecontents := parseAndRenderSegs(sourcePath) if filecontents != "" { example.GoCode = filecontents } example.Segs = append(example.Segs, sourceSegs) } } newCodeHash := sha1Sum(example.GoCode) if example.GoCodeHash != newCodeHash { example.URLHash = resetURLHashFile(newCodeHash, example.GoCode, "examples/"+example.ID+"/"+example.ID+".hash") } examples = append(examples, &example) } for i, example := range examples { if i > 0 { example.PrevExample = examples[i-1] } if i < (len(examples) - 1) { example.NextExample = examples[i+1] } } return examples } func renderIndex(examples []*Example) { if verbose() { fmt.Println("Rendering index") } indexTmpl := template.New("index") _, err := indexTmpl.Parse(mustReadFile("templates/index.tmpl")) check(err) indexF, err := os.Create(siteDir + "/index.html") check(err) err = indexTmpl.Execute(indexF, examples) check(err) } func renderExamples(examples []*Example) { if verbose() { fmt.Println("Rendering examples") } exampleTmpl := template.New("example") _, err := exampleTmpl.Parse(mustReadFile("templates/example.tmpl")) check(err) for _, example := range examples { exampleF, err := os.Create(siteDir + "/" + example.ID) check(err) exampleTmpl.Execute(exampleF, example) } } func main() { if len(os.Args) > 1 { siteDir = os.Args[1] } ensureDir(siteDir) copyFile("templates/site.css", siteDir+"/site.css") copyFile("templates/site.js", siteDir+"/site.js") copyFile("templates/favicon.ico", siteDir+"/favicon.ico") copyFile("templates/404.html", siteDir+"/404.html") copyFile("templates/play.png", siteDir+"/play.png") copyFile("templates/clipboard.png", siteDir+"/clipboard.png") examples := parseExamples() renderIndex(examples) renderExamples(examples) }