yashiro

README

Yashiro

Yashiro is a templating engine with the external stores.

Service

AWS

• Systems Manager Parameter Store
• Secrets Manager

Usage

See Godoc.

go get github.com/dwango/yashiro

CLI Tool

Installation

From release page

Download binary from release page.

Homebrew Users

Download and install by homebrew.

brew tap dwango/yashiro
brew install ysr

Example

See example.

Documentation

Overview

Example

package main

import (
	"context"
	"log"
	"os"

	awsconfig "github.com/aws/aws-sdk-go-v2/config"
	"github.com/dwango/yashiro"
	"github.com/dwango/yashiro/pkg/config"
)

func main() {
	ctx := context.TODO()

	sdkConfig, err := awsconfig.LoadDefaultConfig(ctx)
	if err != nil {
		log.Fatalf("failed to load config: %s", err)
	}

	refName := "example"
	cfg := &config.Config{
		Aws: &config.AwsConfig{
			ParameterStoreValues: []config.AwsParameterStoreValueConfig{
				{
					ValueConfig: config.ValueConfig{
						Name:   "/example",
						Ref:    &refName,
						IsJSON: true,
					},
				},
			},
			SdkConfig: &sdkConfig,
		},
	}

	eng, err := yashiro.NewEngine(cfg)
	if err != nil {
		log.Fatalf("failed to create engine: %s", err)
	}

	text := `This is example code. The message is {{ .example.message }}.`

	if err := eng.Render(ctx, text, os.Stdout); err != nil {
		log.Fatalf("failed to render text: %s", err)
	}
}

Index

• Variables
• type Engine

Examples

• Package

Variables

var (
	// NewConfigFromFile returns a new Config from file.
	NewConfigFromFile = config.NewFromFile

	// NewEngine returns a new Engine.
	NewEngine = engine.New
)

Types

type Engine

type Engine = engine.Engine

Engine initializes external store client and template.