1
0
Fork 0
mirror of https://github.com/Luzifer/korvike.git synced 2024-11-08 23:40:05 +00:00
korvike/README.md
Knut Ahlers a14b2e78f4
Add vault template function
Signed-off-by: Knut Ahlers <knut@ahlers.me>
2017-06-20 11:24:02 +02:00

46 lines
1.5 KiB
Markdown

![license](https://badges.fyi/github/license/Luzifer/badge-gen)
[![Go Report Card](https://goreportcard.com/badge/github.com/Luzifer/korvike)](https://goreportcard.com/report/github.com/Luzifer/korvike)
# Luzifer / korvike
`korvike` is the finnish translation to the word "replacer" and that is what it does: It takes a Go template and executes it.
## Available functions
- `{{ .<variable name> }}`
Take key-value pairs from the CLI and replace them inside the template
```bash
# echo "{{ .foo }}" | korvike -v foo=bar
bar
```
- `{{ env <variable name> [default value] }}`
Read environment variables and replace them inside the template
```bash
# export FOO=bar
# echo '{{env "FOO"}}' | korvike
bar
```
- `{{ file <file name> [default value] }}`
Read a file and place it inside the template
```bash
# echo "Hello World" > hello
# echo '{{file "hello"}}' | korvike
Hello World
```
- `{{ now <format string> }}`
Format the current date into the template (uses [Go time format](https://golang.org/pkg/time/#Time.Format))
```bash
# echo '{{now "2006-01-02 15:04:05"}}' | korvike
2017-04-17 16:27:34
```
- `{{ vault <path> <key> [default value] }}`
Read a key from Vault using `VAULT_ADDR` and `VAULT_TOKEN` environment variables (or `~/.vault-token` file) for authentication.
```bash
# vault write secret/test foo=bar
# echo '{{vault "secret/test" "foo"}}' | korvike
bar
```
----
![project status](https://d2o84fseuhwkxk.cloudfront.net/korvike.svg)