mirror of
https://git.mills.io/prologic/zs.git
synced 2024-09-07 12:44:15 -04:00
rewritten using zs templates, allowing go templates using <% %> delimiters
This commit is contained in:
parent
097012ddbd
commit
2ce4b993b0
17
testdata/blog/.test/index.html
vendored
17
testdata/blog/.test/index.html
vendored
@ -1,17 +0,0 @@
|
||||
<html>
|
||||
<head>
|
||||
<title>My blog</title>
|
||||
<link href="styles.css" rel="stylesheet" type="text/css" />
|
||||
</head>
|
||||
<body>
|
||||
<p>Here goes list of posts</p>
|
||||
<ul>
|
||||
<li>
|
||||
<a href="/posts/hello.html">First post</a>
|
||||
</li>
|
||||
<li>
|
||||
<a href="/posts/update.html">Second post</a>
|
||||
</li>
|
||||
</ul>
|
||||
</body>
|
||||
</html>
|
3
testdata/page/.test/index.html
vendored
3
testdata/page/.test/index.html
vendored
@ -1,6 +1,5 @@
|
||||
<html>
|
||||
<body>
|
||||
<h1>Hello
|
||||
</h1>
|
||||
<h1>Hello</h1>
|
||||
</body>
|
||||
</html>
|
||||
|
2
testdata/page/index.html
vendored
2
testdata/page/index.html
vendored
@ -1,5 +1,5 @@
|
||||
<html>
|
||||
<body>
|
||||
<h1>{{ println "Hello" }}</h1>
|
||||
<h1>{{ printf Hello }}</h1>
|
||||
</body>
|
||||
</html>
|
||||
|
192
zs.go
192
zs.go
@ -8,7 +8,6 @@ import (
|
||||
"log"
|
||||
"os"
|
||||
"os/exec"
|
||||
"path"
|
||||
"path/filepath"
|
||||
"strings"
|
||||
"text/template"
|
||||
@ -17,6 +16,7 @@ import (
|
||||
"github.com/eknkc/amber"
|
||||
"github.com/russross/blackfriday"
|
||||
"github.com/yosssi/gcss"
|
||||
"gopkg.in/yaml.v1"
|
||||
)
|
||||
|
||||
const (
|
||||
@ -26,17 +26,22 @@ const (
|
||||
|
||||
type Vars map[string]string
|
||||
|
||||
func renameExt(path, from, to string) string {
|
||||
if from == "" {
|
||||
from = filepath.Ext(path)
|
||||
// renameExt renames extension (if any) from oldext to newext
|
||||
// If oldext is an empty string - extension is extracted automatically.
|
||||
// If path has no extension - new extension is appended
|
||||
func renameExt(path, oldext, newext string) string {
|
||||
if oldext == "" {
|
||||
oldext = filepath.Ext(path)
|
||||
}
|
||||
if strings.HasSuffix(path, from) {
|
||||
return strings.TrimSuffix(path, from) + to
|
||||
if oldext == "" || strings.HasSuffix(path, oldext) {
|
||||
return strings.TrimSuffix(path, oldext) + newext
|
||||
} else {
|
||||
return path
|
||||
}
|
||||
}
|
||||
|
||||
// globals returns list of global OS environment variables that start
|
||||
// with ZS_ prefix as Vars, so the values can be used inside templates
|
||||
func globals() Vars {
|
||||
vars := Vars{}
|
||||
for _, e := range os.Environ() {
|
||||
@ -48,25 +53,28 @@ func globals() Vars {
|
||||
return vars
|
||||
}
|
||||
|
||||
// Converts zs markdown variables into environment variables
|
||||
func env(vars Vars) []string {
|
||||
// run executes a command or a script. Vars define the command environment,
|
||||
// each zs var is converted into OS environemnt variable with ZS_ prefix
|
||||
// prepended. Additional variable $ZS contains path to the zs binary. Command
|
||||
// stderr is printed to zs stderr, command output is returned as a string.
|
||||
func run(vars Vars, cmd string, args ...string) (string, error) {
|
||||
// First check if partial exists (.amber or .html)
|
||||
if b, err := ioutil.ReadFile(filepath.Join(ZSDIR, cmd+".amber")); err == nil {
|
||||
return string(b), nil
|
||||
}
|
||||
if b, err := ioutil.ReadFile(filepath.Join(ZSDIR, cmd+".html")); err == nil {
|
||||
return string(b), nil
|
||||
}
|
||||
|
||||
var errbuf, outbuf bytes.Buffer
|
||||
c := exec.Command(cmd, args...)
|
||||
env := []string{"ZS=" + os.Args[0], "ZS_OUTDIR=" + PUBDIR}
|
||||
env = append(env, os.Environ()...)
|
||||
if vars != nil {
|
||||
for k, v := range vars {
|
||||
env = append(env, "ZS_"+strings.ToUpper(k)+"="+v)
|
||||
}
|
||||
}
|
||||
return env
|
||||
}
|
||||
|
||||
// Runs command with given arguments and variables, intercepts stderr and
|
||||
// redirects stdout into the given writer
|
||||
func run(cmd string, args []string, vars Vars, output io.Writer) error {
|
||||
var errbuf bytes.Buffer
|
||||
c := exec.Command(cmd, args...)
|
||||
c.Env = env(vars)
|
||||
c.Stdout = output
|
||||
c.Env = env
|
||||
c.Stdout = &outbuf
|
||||
c.Stderr = &errbuf
|
||||
|
||||
err := c.Run()
|
||||
@ -74,79 +82,97 @@ func run(cmd string, args []string, vars Vars, output io.Writer) error {
|
||||
if errbuf.Len() > 0 {
|
||||
log.Println("ERROR:", errbuf.String())
|
||||
}
|
||||
|
||||
if err != nil {
|
||||
return err
|
||||
return "", err
|
||||
}
|
||||
return nil
|
||||
return string(outbuf.Bytes()), nil
|
||||
}
|
||||
|
||||
// Splits a string in exactly two parts by delimiter
|
||||
// If no delimiter is found - the second string is be empty
|
||||
func split2(s, delim string) (string, string) {
|
||||
parts := strings.SplitN(s, delim, 2)
|
||||
if len(parts) == 2 {
|
||||
return parts[0], parts[1]
|
||||
} else {
|
||||
return parts[0], ""
|
||||
}
|
||||
}
|
||||
|
||||
// Parses markdown content. Returns parsed header variables and content
|
||||
func md(path string, globals Vars) (Vars, string, error) {
|
||||
// getVars returns list of variables defined in a text file and actual file
|
||||
// content following the variables declaration. Header is separated from
|
||||
// content by an empty line. Header can be either YAML or JSON.
|
||||
// If no empty newline is found - file is treated as content-only.
|
||||
func getVars(path string, globals Vars) (Vars, string, error) {
|
||||
b, err := ioutil.ReadFile(path)
|
||||
if err != nil {
|
||||
return nil, "", err
|
||||
}
|
||||
s := string(b)
|
||||
url := path[:len(path)-len(filepath.Ext(path))] + ".html"
|
||||
v := Vars{
|
||||
"title": "",
|
||||
"description": "",
|
||||
"keywords": "",
|
||||
}
|
||||
|
||||
// Copy globals first
|
||||
v := Vars{}
|
||||
for name, value := range globals {
|
||||
v[name] = value
|
||||
}
|
||||
|
||||
// Override them by default values extracted from file name/path
|
||||
if _, err := os.Stat(filepath.Join(ZSDIR, "layout.amber")); err == nil {
|
||||
v["layout"] = "layout.amber"
|
||||
} else {
|
||||
v["layout"] = "layout.html"
|
||||
}
|
||||
v["file"] = path
|
||||
v["url"] = url
|
||||
v["output"] = filepath.Join(PUBDIR, url)
|
||||
v["url"] = path[:len(path)-len(filepath.Ext(path))] + ".html"
|
||||
v["output"] = filepath.Join(PUBDIR, v["url"])
|
||||
|
||||
if strings.Index(s, "\n\n") == -1 {
|
||||
if sep := strings.Index(s, "\n\n"); sep == -1 {
|
||||
return v, s, nil
|
||||
} else {
|
||||
header := s[:sep]
|
||||
body := s[sep+len("\n\n"):]
|
||||
vars := Vars{}
|
||||
if err := yaml.Unmarshal([]byte(header), &vars); err != nil {
|
||||
fmt.Println("ERROR: failed to parse header", err)
|
||||
} else {
|
||||
for key, value := range vars {
|
||||
v[key] = value
|
||||
}
|
||||
header, body := split2(s, "\n\n")
|
||||
for _, line := range strings.Split(header, "\n") {
|
||||
key, value := split2(line, ":")
|
||||
v[strings.ToLower(strings.TrimSpace(key))] = strings.TrimSpace(value)
|
||||
}
|
||||
if strings.HasPrefix(v["url"], "./") {
|
||||
v["url"] = v["url"][2:]
|
||||
}
|
||||
return v, body, nil
|
||||
}
|
||||
}
|
||||
|
||||
// Use standard Go templates
|
||||
// Render expanding zs plugins and variables
|
||||
func render(s string, vars Vars) (string, error) {
|
||||
tmpl, err := template.New("").Parse(s)
|
||||
if err != nil {
|
||||
return "", err
|
||||
}
|
||||
delim_open := "{{"
|
||||
delim_close := "}}"
|
||||
|
||||
out := &bytes.Buffer{}
|
||||
if err := tmpl.Execute(out, vars); err != nil {
|
||||
return "", err
|
||||
for {
|
||||
if from := strings.Index(s, delim_open); from == -1 {
|
||||
out.WriteString(s)
|
||||
return out.String(), nil
|
||||
} else {
|
||||
if to := strings.Index(s, delim_close); to == -1 {
|
||||
return "", fmt.Errorf("Close delim not found")
|
||||
} else {
|
||||
out.WriteString(s[:from])
|
||||
cmd := s[from+len(delim_open) : to]
|
||||
s = s[to+len(delim_close):]
|
||||
m := strings.Fields(cmd)
|
||||
if len(m) == 1 {
|
||||
if v, ok := vars[m[0]]; ok {
|
||||
out.WriteString(v)
|
||||
continue
|
||||
}
|
||||
return string(out.Bytes()), nil
|
||||
}
|
||||
if res, err := run(vars, m[0], m[1:]...); err == nil {
|
||||
out.WriteString(res)
|
||||
} else {
|
||||
fmt.Println(err)
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
return s, nil
|
||||
}
|
||||
|
||||
// Renders markdown with the given layout into html expanding all the macros
|
||||
func buildMarkdown(path string, w io.Writer, vars Vars) error {
|
||||
v, body, err := md(path, vars)
|
||||
v, body, err := getVars(path, vars)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
@ -172,11 +198,14 @@ func buildMarkdown(path string, w io.Writer, vars Vars) error {
|
||||
|
||||
// Renders text file expanding all variable macros inside it
|
||||
func buildHTML(path string, w io.Writer, vars Vars) error {
|
||||
b, err := ioutil.ReadFile(path)
|
||||
v, body, err := getVars(path, vars)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
content, err := render(string(b), vars)
|
||||
if body, err = render(body, v); err != nil {
|
||||
return err
|
||||
}
|
||||
tmpl, err := template.New("").Delims("<%", "%>").Parse(body)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
@ -188,21 +217,22 @@ func buildHTML(path string, w io.Writer, vars Vars) error {
|
||||
defer f.Close()
|
||||
w = f
|
||||
}
|
||||
_, err = io.WriteString(w, content)
|
||||
return err
|
||||
return tmpl.Execute(w, vars)
|
||||
}
|
||||
|
||||
// Renders .amber file into .html
|
||||
func buildAmber(path string, w io.Writer, vars Vars) error {
|
||||
a := amber.New()
|
||||
err := a.ParseFile(path)
|
||||
v, body, err := getVars(path, vars)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
if body, err = render(body, v); err != nil {
|
||||
return err
|
||||
}
|
||||
|
||||
data := map[string]interface{}{}
|
||||
for k, v := range vars {
|
||||
data[k] = v
|
||||
a := amber.New()
|
||||
if err := a.Parse(body); err != nil {
|
||||
return err
|
||||
}
|
||||
|
||||
t, err := a.Compile()
|
||||
@ -217,7 +247,7 @@ func buildAmber(path string, w io.Writer, vars Vars) error {
|
||||
defer f.Close()
|
||||
w = f
|
||||
}
|
||||
return t.Execute(w, data)
|
||||
return t.Execute(w, vars)
|
||||
}
|
||||
|
||||
// Compiles .gcss into .css
|
||||
@ -298,9 +328,8 @@ func buildAll(watch bool) {
|
||||
return nil
|
||||
} else if info.ModTime().After(lastModified) {
|
||||
if !modified {
|
||||
// About to be modified, so run pre-build hook
|
||||
// FIXME on windows it might not work well
|
||||
run(filepath.Join(ZSDIR, "pre"), []string{}, nil, nil)
|
||||
// First file in this build cycle is about to be modified
|
||||
run(vars, "prehook")
|
||||
modified = true
|
||||
}
|
||||
log.Println("build:", path)
|
||||
@ -312,9 +341,8 @@ func buildAll(watch bool) {
|
||||
log.Println("ERROR:", err)
|
||||
}
|
||||
if modified {
|
||||
// Something was modified, so post-build hook
|
||||
// FIXME on windows it might not work well
|
||||
run(filepath.Join(ZSDIR, "post"), []string{}, nil, nil)
|
||||
// At least one file in this build cycle has been modified
|
||||
run(vars, "posthook")
|
||||
modified = false
|
||||
}
|
||||
if !watch {
|
||||
@ -325,6 +353,13 @@ func buildAll(watch bool) {
|
||||
}
|
||||
}
|
||||
|
||||
func init() {
|
||||
// prepend .zs to $PATH, so plugins will be found before OS commands
|
||||
p := os.Getenv("PATH")
|
||||
p = ZSDIR + ":" + p
|
||||
os.Setenv("PATH", p)
|
||||
}
|
||||
|
||||
func main() {
|
||||
if len(os.Args) == 1 {
|
||||
fmt.Println(os.Args[0], "<command> [args]")
|
||||
@ -350,7 +385,7 @@ func main() {
|
||||
fmt.Println("var: filename expected")
|
||||
} else {
|
||||
s := ""
|
||||
if vars, _, err := md(args[0], globals()); err != nil {
|
||||
if vars, _, err := getVars(args[0], globals()); err != nil {
|
||||
fmt.Println("var: " + err.Error())
|
||||
} else {
|
||||
if len(args) > 1 {
|
||||
@ -366,9 +401,10 @@ func main() {
|
||||
fmt.Println(strings.TrimSpace(s))
|
||||
}
|
||||
default:
|
||||
err := run(path.Join(ZSDIR, cmd), args, globals(), os.Stdout)
|
||||
if err != nil {
|
||||
log.Println("ERROR:", err)
|
||||
if s, err := run(globals(), cmd, args...); err != nil {
|
||||
fmt.Println(err)
|
||||
} else {
|
||||
fmt.Println(s)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
185
zs_test.go
185
zs_test.go
@ -1,146 +1,107 @@
|
||||
package main
|
||||
|
||||
import (
|
||||
"bytes"
|
||||
"fmt"
|
||||
"io/ioutil"
|
||||
"log"
|
||||
"os"
|
||||
"strings"
|
||||
"path/filepath"
|
||||
"testing"
|
||||
)
|
||||
|
||||
func TestSplit2(t *testing.T) {
|
||||
if a, b := split2("a:b", ":"); a != "a" || b != "b" {
|
||||
t.Fail()
|
||||
func TestRenameExt(t *testing.T) {
|
||||
if s := renameExt("foo.amber", ".amber", ".html"); s != "foo.html" {
|
||||
t.Error(s)
|
||||
}
|
||||
if a, b := split2(":b", ":"); a != "" || b != "b" {
|
||||
t.Fail()
|
||||
if s := renameExt("foo.amber", "", ".html"); s != "foo.html" {
|
||||
t.Error(s)
|
||||
}
|
||||
if a, b := split2("a:", ":"); a != "a" || b != "" {
|
||||
t.Fail()
|
||||
if s := renameExt("foo.amber", ".md", ".html"); s != "foo.amber" {
|
||||
t.Error(s)
|
||||
}
|
||||
if a, b := split2(":", ":"); a != "" || b != "" {
|
||||
t.Fail()
|
||||
if s := renameExt("foo", ".amber", ".html"); s != "foo" {
|
||||
t.Error(s)
|
||||
}
|
||||
if a, b := split2("a", ":"); a != "a" || b != "" {
|
||||
t.Fail()
|
||||
}
|
||||
if a, b := split2("", ":"); a != "" || b != "" {
|
||||
t.Fail()
|
||||
if s := renameExt("foo", "", ".html"); s != "foo.html" {
|
||||
t.Error(s)
|
||||
}
|
||||
}
|
||||
|
||||
func tmpfile(path, s string) string {
|
||||
ioutil.WriteFile(path, []byte(s), 0644)
|
||||
return path
|
||||
func TestRun(t *testing.T) {
|
||||
// external command
|
||||
if s, err := run(Vars{}, "echo", "hello"); err != nil || s != "hello\n" {
|
||||
t.Error(s, err)
|
||||
}
|
||||
// passing variables to plugins
|
||||
if s, err := run(Vars{"foo": "bar"}, "sh", "-c", "echo $ZS_FOO"); err != nil || s != "bar\n" {
|
||||
t.Error(s, err)
|
||||
}
|
||||
|
||||
func TestMD(t *testing.T) {
|
||||
defer os.Remove("foo.md")
|
||||
v, body, _ := md(tmpfile("foo.md", `
|
||||
// custom plugin overriding external command
|
||||
os.Mkdir(ZSDIR, 0755)
|
||||
script := `#!/bin/sh
|
||||
echo foo
|
||||
`
|
||||
ioutil.WriteFile(filepath.Join(ZSDIR, "echo"), []byte(script), 0755)
|
||||
if s, err := run(Vars{}, "echo", "hello"); err != nil || s != "foo\n" {
|
||||
t.Error(s, err)
|
||||
}
|
||||
os.Remove(filepath.Join(ZSDIR, "echo"))
|
||||
os.Remove(ZSDIR)
|
||||
}
|
||||
|
||||
func TestVars(t *testing.T) {
|
||||
tests := map[string]Vars{
|
||||
`
|
||||
foo: bar
|
||||
title: Hello, world!
|
||||
keywords: foo, bar, baz
|
||||
empty:
|
||||
bayan: [:|||:]
|
||||
|
||||
this: is a content`), Vars{})
|
||||
if v["title"] != "Hello, world!" {
|
||||
t.Error()
|
||||
}
|
||||
if v["keywords"] != "foo, bar, baz" {
|
||||
t.Error()
|
||||
}
|
||||
if s, ok := v["empty"]; !ok || len(s) != 0 {
|
||||
t.Error()
|
||||
}
|
||||
if v["bayan"] != "[:|||:]" {
|
||||
t.Error()
|
||||
}
|
||||
if body != "this: is a content" {
|
||||
t.Error(body)
|
||||
Some content in markdown
|
||||
`: Vars{
|
||||
"foo": "bar",
|
||||
"title": "Hello, world!",
|
||||
"url": "test.html",
|
||||
"file": "test.md",
|
||||
"output": filepath.Join(PUBDIR, "test.html"),
|
||||
"__content": "Some content in markdown\n",
|
||||
},
|
||||
`url: "example.com/foo.html"
|
||||
|
||||
Hello
|
||||
`: Vars{
|
||||
"url": "example.com/foo.html",
|
||||
"__content": "Hello\n",
|
||||
},
|
||||
}
|
||||
|
||||
// Test empty md
|
||||
v, body, _ = md(tmpfile("foo.md", ""), Vars{})
|
||||
if v["url"] != "foo.html" || len(body) != 0 {
|
||||
t.Error(v, body)
|
||||
for script, vars := range tests {
|
||||
ioutil.WriteFile("test.md", []byte(script), 0644)
|
||||
if v, s, err := getVars("test.md", Vars{"baz": "123"}); err != nil {
|
||||
t.Error(err)
|
||||
} else if s != vars["__content"] {
|
||||
t.Error(s, vars["__content"])
|
||||
} else {
|
||||
for key, value := range vars {
|
||||
if key != "__content" && v[key] != value {
|
||||
t.Error(key, v[key], value)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// Test empty header
|
||||
v, body, _ = md(tmpfile("foo.md", "Hello"), Vars{})
|
||||
if v["url"] != "foo.html" || body != "Hello" {
|
||||
t.Error(v, body)
|
||||
}
|
||||
}
|
||||
|
||||
func TestRender(t *testing.T) {
|
||||
vars := map[string]string{"foo": "bar"}
|
||||
funcs := Funcs{
|
||||
"greet": func(s ...string) string {
|
||||
if len(s) == 0 {
|
||||
return "hello"
|
||||
} else {
|
||||
return "hello " + strings.Join(s, " ")
|
||||
}
|
||||
},
|
||||
}
|
||||
|
||||
if s, err := render("plain text", funcs, vars); err != nil || s != "plain text" {
|
||||
t.Error(s, err)
|
||||
if s, _ := render("foo bar", vars); s != "foo bar" {
|
||||
t.Error(s)
|
||||
}
|
||||
if s, err := render("a {{greet}} text", funcs, vars); err != nil || s != "a hello text" {
|
||||
t.Error(s, err)
|
||||
if s, _ := render("a {{printf short}} text", vars); s != "a short text" {
|
||||
t.Error(s)
|
||||
}
|
||||
if s, err := render("{{greet}} x{{foo}}z", funcs, vars); err != nil || s != "hello xbarz" {
|
||||
t.Error(s, err)
|
||||
if s, _ := render("{{printf Hello}} x{{foo}}z", vars); s != "Hello xbarz" {
|
||||
t.Error(s)
|
||||
}
|
||||
// Test error case
|
||||
if s, err := render("a {{greet text ", funcs, vars); err == nil || len(s) != 0 {
|
||||
t.Error(s, err)
|
||||
if _, err := render("a {{greet text ", vars); err == nil {
|
||||
t.Error("error expected")
|
||||
}
|
||||
}
|
||||
|
||||
func TestEnv(t *testing.T) {
|
||||
e := env(map[string]string{"foo": "bar", "baz": "hello world"})
|
||||
mustHave := []string{"ZS=" + os.Args[0], "ZS_FOO=bar", "ZS_BAZ=hello world", "PATH="}
|
||||
for _, s := range mustHave {
|
||||
found := false
|
||||
for _, v := range e {
|
||||
if strings.HasPrefix(v, s) {
|
||||
found = true
|
||||
break
|
||||
}
|
||||
}
|
||||
if !found {
|
||||
t.Error("Missing", s)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
func TestRun(t *testing.T) {
|
||||
out := bytes.NewBuffer(nil)
|
||||
err := run("some_unbelievable_command_name", []string{}, map[string]string{}, out)
|
||||
if err == nil {
|
||||
t.Error()
|
||||
}
|
||||
|
||||
out = bytes.NewBuffer(nil)
|
||||
err = run(os.Args[0], []string{"-test.run=TestHelperProcess"},
|
||||
map[string]string{"helper": "1", "out": "foo", "err": "bar"}, out)
|
||||
if err != nil {
|
||||
t.Error(err)
|
||||
}
|
||||
if out.String() != "foo\n" {
|
||||
t.Error(out.String())
|
||||
}
|
||||
}
|
||||
|
||||
func TestHelperProcess(*testing.T) {
|
||||
if os.Getenv("ZS_HELPER") != "1" {
|
||||
return
|
||||
}
|
||||
defer os.Exit(0) // TODO check exit code
|
||||
log.Println(os.Getenv("ZS_ERR")) // stderr
|
||||
fmt.Println(os.Getenv("ZS_OUT")) // stdout
|
||||
}
|
||||
|
Loading…
Reference in New Issue
Block a user