diecast

package module
v1.10.8 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Feb 2, 2019 License: LGPL-2.1 Imports: 75 Imported by: 10

README

Diecast GoDoc

Introduction

Diecast is a web server that allows you to render a directory tree of template files into HTML, CSS or anything other text-based media in real-time. Data can be retrieved from remote sources during the template rendering process, creating dynamic web pages built by consuming APIs and remote files without the need to use client-side Javascript/AJAX calls or an intermediate server framework.

Documentation

You can read the complete Diecast manual at https://ghetzel.github.io/diecast.

Documentation

Index

Constants

View Source 
const (
	ActionSummarize BindingErrorAction = `summarize`
	ActionPrint                        = `print`
	ActionContinue                     = `continue`
	ActionBreak                        = `break`
	ActionIgnore                       = `ignore`
)
View Source 
const ApplicationName = `diecast`
View Source 
const ApplicationSummary = `a standalone site templating engine that consumes REST services and renders static HTML output in realtime`
View Source 
const ApplicationVersion = `1.10.8`
View Source 
const DefaultAddress = `127.0.0.1:28419`
View Source 
const DefaultConfigFile = `diecast.yml`
View Source 
const DefaultRoutePrefix = `/`

Variables

View Source 
var AllowInsecureLoopbackBindings bool
View Source 
var Base32Alphabet = base32.NewEncoding(`abcdefghijklmnopqrstuvwxyz234567`)
View Source 
var BindingClient = http.DefaultClient
View Source 
var ConvertRoundToPlaces = 12
View Source 
var DefaultAutolayoutPatterns = []string{
	`*.html`,
	`*.md`,
}
View Source 
var DefaultIndexFile = `index.html`
View Source 
var DefaultParamJoiner = `;`
View Source 
var DefaultProxyMountTimeout = time.Duration(10) * time.Second
View Source 
var DefaultRendererMappings = map[string]string{
	`md`:   `markdown`,
	`scss`: `sass`,
}
View Source 
var DefaultTemplatePatterns = []string{`*.html`, `*.md`, `*.scss`}
View Source 
var DefaultTryExtensions = []string{`html`, `md`}
View Source 
var DefaultVerifyFile = `/` + DefaultIndexFile
View Source 
var HeaderSeparator = []byte{'-', '-', '-'}
View Source 
var MaxBufferedBodySize = 16535
View Source 
var MountHaltErr = errors.New(`mount halted`)

Functions

func Dir 

func Dir(useLocal bool, name string) http.FileSystem

Dir returns a http.Filesystem for the embedded assets on a given prefix dir. If useLocal is true, the filesystem's contents are instead used.

func EvalInline 

func EvalInline(input string, data map[string]interface{}, funcs FuncMap) string

func FS 

func FS(useLocal bool) http.FileSystem

FS returns a http.Filesystem for the embedded assets. If useLocal is true, the filesystem's contents are instead used.

func FSByte 

func FSByte(useLocal bool, name string) ([]byte, error)

FSByte returns the named file from the embedded assets. If useLocal is true, the filesystem's contents are instead used.

func FSMustByte 

func FSMustByte(useLocal bool, name string) []byte

FSMustByte is the same as FSByte, but panics if name is not present.

func FSMustString 

func FSMustString(useLocal bool, name string) string

FSMustString is the string version of FSMustByte.

func FSString 

func FSString(useLocal bool, name string) (string, error)

FSString is the string version of FSByte.

func IsDirectoryError 

func IsDirectoryError(err error) bool

func IsHardStop 

func IsHardStop(err error) bool

func MinNonZero 

func MinNonZero(data stats.Float64Data) (float64, error)

func MultiReadCloser added in v1.10.7 

func MultiReadCloser(readers ...io.Reader) *multiReadCloser

func PrettifyHTML 

func PrettifyHTML(in string) (string, error)

func RegisterPostprocessor 

func RegisterPostprocessor(name string, ppfunc PostprocessorFunc)

func TrimEmptyLines 

func TrimEmptyLines(in string) (string, error)

Types

type Authenticator 

type Authenticator interface {
	Authenticate(http.ResponseWriter, *http.Request) bool
}

type AuthenticatorConfig 

type AuthenticatorConfig struct {
	Type    string                 `json:"type"`
	Paths   []string               `json:"paths"`
	Except  []string               `json:"except"`
	Options map[string]interface{} `json:"options"`
	// contains filtered or unexported fields
}

type AuthenticatorConfigs 

type AuthenticatorConfigs []AuthenticatorConfig

func (AuthenticatorConfigs) Authenticator 

func (self AuthenticatorConfigs) Authenticator(req *http.Request) (Authenticator, error)

type BasicAuthenticator 

type BasicAuthenticator struct {
	// contains filtered or unexported fields
}

func NewBasicAuthenticator 

func NewBasicAuthenticator(options map[string]interface{}) (*BasicAuthenticator, error)

func (*BasicAuthenticator) AddPasswdFile 

func (self *BasicAuthenticator) AddPasswdFile(filename string) error

func (*BasicAuthenticator) Authenticate 

func (self *BasicAuthenticator) Authenticate(w http.ResponseWriter, req *http.Request) bool

type Binding 

type Binding struct {
	Name               string                     `json:"name,omitempty"`
	Restrict           []string                   `json:"restrict,omitempty"`
	OnlyIfExpr         string                     `json:"only_if,omitempty"`
	NotIfExpr          string                     `json:"not_if,omitempty"`
	Method             string                     `json:"method,omitempty"`
	Resource           string                     `json:"resource,omitempty"`
	Insecure           bool                       `json:"insecure,omitempty"`
	ParamJoiner        string                     `json:"param_joiner,omitempty"`
	Params             map[string]interface{}     `json:"params,omitempty"`
	Headers            map[string]string          `json:"headers,omitempty"`
	BodyParams         map[string]interface{}     `json:"body,omitempty"`
	RawBody            string                     `json:"rawbody,omitempty"`
	Formatter          string                     `json:"formatter,omitempty"`
	Parser             string                     `json:"parser,omitempty"`
	NoTemplate         bool                       `json:"no_template,omitempty"`
	Optional           bool                       `json:"optional,omitempty"`
	Fallback           interface{}                `json:"fallback,omitempty"`
	OnError            BindingErrorAction         `json:"on_error,omitempty"`
	IfStatus           map[int]BindingErrorAction `json:"if_status,omitempty"`
	Repeat             string                     `json:"repeat,omitempty"`
	SkipInheritHeaders bool                       `json:"skip_inherit_headers,omitempty"`
	DisableCache       bool                       `json:"disable_cache,omitempty"`
	// contains filtered or unexported fields
}

func (*Binding) Evaluate 

func (self *Binding) Evaluate(req *http.Request, header *TemplateHeader, data map[string]interface{}, funcs FuncMap) (interface{}, error)

func (*Binding) ShouldEvaluate 

func (self *Binding) ShouldEvaluate(req *http.Request) bool

type BindingErrorAction 

type BindingErrorAction string

type Engine 

type Engine int
const (
	TextEngine Engine = iota
	HtmlEngine
)

func GetEngineForFile 

func GetEngineForFile(filename string) Engine

func (Engine) String 

func (self Engine) String() string

type FileMount 

type FileMount struct {
	MountPoint  string          `json:"mount"`
	Path        string          `json:"source"`
	Passthrough bool            `json:"passthrough"`
	FileSystem  http.FileSystem `json:"-"`
}

func (*FileMount) GetMountPoint 

func (self *FileMount) GetMountPoint() string

func (*FileMount) Open 

func (self *FileMount) Open(name string) (http.File, error)

func (*FileMount) OpenWithType 

func (self *FileMount) OpenWithType(name string, req *http.Request, requestBody io.Reader) (*MountResponse, error)

func (*FileMount) String 

func (self *FileMount) String() string

func (*FileMount) WillRespondTo 

func (self *FileMount) WillRespondTo(name string, req *http.Request, requestBody io.Reader) bool

type FuncMap 

type FuncMap map[string]interface{}

func GetFunctions added in v1.10.7 

func GetFunctions() (funcGroups, FuncMap)

func GetStandardFunctions 

func GetStandardFunctions() FuncMap

type MarkdownRenderer added in v1.9.20 

type MarkdownRenderer struct {
	// contains filtered or unexported fields
}

func (*MarkdownRenderer) Render added in v1.9.20 

func (self *MarkdownRenderer) Render(w http.ResponseWriter, req *http.Request, options RenderOptions) error

func (*MarkdownRenderer) ShouldPrerender added in v1.9.22 

func (self *MarkdownRenderer) ShouldPrerender() bool

type Mount 

type Mount interface {
	Open(string) (http.File, error)
	OpenWithType(string, *http.Request, io.Reader) (*MountResponse, error)
	WillRespondTo(string, *http.Request, io.Reader) bool
	GetMountPoint() string
	String() string
}

func NewMountFromSpec 

func NewMountFromSpec(spec string) (Mount, error)

type MountConfig 

type MountConfig struct {
	Mount   string                 `json:"mount"`
	To      string                 `json:"to"`
	Options map[string]interface{} `json:"options"`
}

type MountResponse 

type MountResponse struct {
	ContentType  string
	StatusCode   int
	Metadata     map[string]interface{}
	RedirectTo   string
	RedirectCode int
	// contains filtered or unexported fields
}

func NewMountResponse 

func NewMountResponse(name string, size int64, payload interface{}) *MountResponse

func (*MountResponse) Close 

func (self *MountResponse) Close() error

func (*MountResponse) GetFile 

func (self *MountResponse) GetFile() http.File

func (*MountResponse) GetPayload 

func (self *MountResponse) GetPayload() interface{}

func (*MountResponse) IsDir 

func (self *MountResponse) IsDir() bool

func (*MountResponse) ModTime 

func (self *MountResponse) ModTime() time.Time

func (*MountResponse) Mode 

func (self *MountResponse) Mode() os.FileMode

func (*MountResponse) Name 

func (self *MountResponse) Name() string

func (*MountResponse) Read 

func (self *MountResponse) Read(p []byte) (int, error)

func (*MountResponse) Readdir 

func (self *MountResponse) Readdir(count int) ([]os.FileInfo, error)

func (*MountResponse) Seek 

func (self *MountResponse) Seek(offset int64, whence int) (int64, error)

func (*MountResponse) Size 

func (self *MountResponse) Size() int64

func (*MountResponse) Stat 

func (self *MountResponse) Stat() (os.FileInfo, error)

func (*MountResponse) Sys 

func (self *MountResponse) Sys() interface{}

type PdfRenderer added in v1.9.20 

type PdfRenderer struct {
	// contains filtered or unexported fields
}

func (*PdfRenderer) Render added in v1.9.20 

func (self *PdfRenderer) Render(w http.ResponseWriter, req *http.Request, options RenderOptions) error

func (*PdfRenderer) ShouldPrerender added in v1.9.22 

func (self *PdfRenderer) ShouldPrerender() bool

type PostprocessorFunc 

type PostprocessorFunc func(string) (string, error)

type ProxyMount 

type ProxyMount struct {
	MountPoint          string                 `json:"-"`
	URL                 string                 `json:"-"`
	Method              string                 `json:"method,omitempty"`
	Headers             map[string]interface{} `json:"headers,omitempty"`
	Params              map[string]interface{} `json:"params,omitempty"`
	Timeout             time.Duration          `json:"timeout,omitempty"`
	PassthroughRequests bool                   `json:"passthrough_requests"`
	PassthroughErrors   bool                   `json:"passthrough_errors"`
	StripPathPrefix     string                 `json:"strip_path_prefix"`
	Insecure            bool                   `json:"insecure"`
	Client              *http.Client
	// contains filtered or unexported fields
}

func (*ProxyMount) GetMountPoint 

func (self *ProxyMount) GetMountPoint() string

func (*ProxyMount) Open 

func (self *ProxyMount) Open(name string) (http.File, error)

func (*ProxyMount) OpenWithType 

func (self *ProxyMount) OpenWithType(name string, req *http.Request, requestBody io.Reader) (*MountResponse, error)

func (*ProxyMount) String 

func (self *ProxyMount) String() string

func (*ProxyMount) WillRespondTo 

func (self *ProxyMount) WillRespondTo(name string, req *http.Request, requestBody io.Reader) bool

type Redirect 

type Redirect struct {
	URL  string `json:"url"`
	Code int    `json:"code"`
}

type RedirectTo 

type RedirectTo string

func (RedirectTo) Error 

func (self RedirectTo) Error() string

type RenderOptions added in v1.9.20 

type RenderOptions struct {
	Header        *TemplateHeader
	HeaderOffset  int
	FunctionSet   FuncMap
	Input         io.ReadCloser
	Data          map[string]interface{}
	MimeType      string
	RequestedPath string
	HasLayout     bool
	Timeout       time.Duration
}

type Renderer added in v1.9.20 

type Renderer interface {
	Render(w http.ResponseWriter, req *http.Request, options RenderOptions) error
	ShouldPrerender() bool
}

func GetRenderer added in v1.9.20 

func GetRenderer(name string, server *Server) (Renderer, error)

func GetRendererForFilename added in v1.9.20 

func GetRendererForFilename(filename string, server *Server) (Renderer, bool)

type SassRenderer added in v1.10.3 

type SassRenderer struct {
	// contains filtered or unexported fields
}

func (*SassRenderer) Render added in v1.10.3 

func (self *SassRenderer) Render(w http.ResponseWriter, req *http.Request, options RenderOptions) error

func (*SassRenderer) ShouldPrerender added in v1.10.3 

func (self *SassRenderer) ShouldPrerender() bool

type Server 

type Server struct {
	BinPath             string                 `json:"-"`
	Address             string                 `json:"address"`
	Bindings            []Binding              `json:"bindings"`
	BindingPrefix       string                 `json:"bindingPrefix"`
	RootPath            string                 `json:"root"`
	LayoutPath          string                 `json:"layouts"`
	ErrorsPath          string                 `json:"errors"`
	EnableDebugging     bool                   `json:"debug"`
	EnableLayouts       bool                   `json:"enableLayouts"`
	RoutePrefix         string                 `json:"routePrefix"`
	TemplatePatterns    []string               `json:"patterns"`
	AdditionalFunctions template.FuncMap       `json:"-"`
	TryLocalFirst       bool                   `json:"localFirst"`
	IndexFile           string                 `json:"indexFile"`
	VerifyFile          string                 `json:"verifyFile"`
	Mounts              []Mount                `json:"-"`
	MountConfigs        []MountConfig          `json:"mounts"`
	BaseHeader          *TemplateHeader        `json:"header"`
	DefaultPageObject   map[string]interface{} `json:"-"`
	OverridePageObject  map[string]interface{} `json:"-"`
	PrestartCommand     StartCommand           `json:"prestart"`
	StartCommand        StartCommand           `json:"start"`
	Authenticators      AuthenticatorConfigs   `json:"authenticators"`
	TryExtensions       []string               `json:"tryExtensions"`   // try these file extensions when looking for default (i.e.: "index") files
	RendererMappings    map[string]string      `json:"rendererMapping"` // map file extensions to preferred renderers
	AutolayoutPatterns  []string               `json:"autolayoutPatterns"`
	// contains filtered or unexported fields
}

func NewServer 

func NewServer(root string, patterns ...string) *Server

func (*Server) GetTemplateData 

func (self *Server) GetTemplateData(req *http.Request, header *TemplateHeader) (FuncMap, map[string]interface{}, error)

func (*Server) GetTemplateFunctions 

func (self *Server) GetTemplateFunctions(data interface{}) FuncMap

Retrieves the set of standard template functions, as well as functions for working with data in the current request.

func (*Server) Initialize 

func (self *Server) Initialize() error

func (*Server) InjectIncludes 

func (self *Server) InjectIncludes(w io.Writer, header *TemplateHeader) error

func (*Server) ListenAndServe 

func (self *Server) ListenAndServe(address string) error

func (*Server) LoadConfig 

func (self *Server) LoadConfig(filename string) error

func (*Server) LoadLayout 

func (self *Server) LoadLayout(name string) (io.Reader, error)

func (*Server) RunStartCommand 

func (self *Server) RunStartCommand(scmd *StartCommand, waitForCommand bool) error

func (*Server) Serve 

func (self *Server) Serve() error

func (*Server) ServeHTTP 

func (self *Server) ServeHTTP(w http.ResponseWriter, req *http.Request)

func (*Server) SetFileSystem 

func (self *Server) SetFileSystem(fs http.FileSystem)

func (*Server) SetMounts 

func (self *Server) SetMounts(mounts []Mount)

func (*Server) ShouldReturnSource 

func (self *Server) ShouldReturnSource(req *http.Request) bool

func (*Server) ToTemplateName 

func (self *Server) ToTemplateName(requestPath string) string

type StartCommand 

type StartCommand struct {
	Command          string                 `json:"command"`
	Directory        string                 `json:"directory"`
	Environment      map[string]interface{} `json:"env"`
	WaitBefore       string                 `json:"delay"`
	Wait             string                 `json:"timeout"`
	ExitOnCompletion bool                   `json:"exitOnCompletion"`
	// contains filtered or unexported fields
}

type SwitchCase added in v1.9.9 

type SwitchCase struct {
	Condition string `json:"condition,omitempty"`
	UsePath   string `json:"use,omitempty"`
}

type Template 

type Template struct {
	// contains filtered or unexported fields
}

func NewTemplate 

func NewTemplate(name string, engine Engine) *Template

func (*Template) AddPostProcessors 

func (self *Template) AddPostProcessors(postprocessors ...string) error

func (*Template) Engine 

func (self *Template) Engine() Engine

func (*Template) Funcs 

func (self *Template) Funcs(funcs FuncMap)

func (*Template) Parse 

func (self *Template) Parse(input string) error

func (*Template) ParseFrom 

func (self *Template) ParseFrom(r io.Reader) error

func (*Template) Render 

func (self *Template) Render(w io.Writer, data interface{}, subtemplate string) error

func (*Template) SetDelimiters added in v1.10.7 

func (self *Template) SetDelimiters(open string, close string)

func (*Template) SetEngine 

func (self *Template) SetEngine(engine Engine)

func (*Template) SetHeaderOffset 

func (self *Template) SetHeaderOffset(offset int)

type TemplateHeader 

type TemplateHeader struct {
	Page           map[string]interface{} `json:"page,omitempty"`
	Bindings       []Binding              `json:"bindings,omitempty"`
	Defaults       map[string]string      `json:"defaults,omitempty"`
	DefaultHeaders map[string]string      `json:"default_headers,omitempty"`
	Redirect       *Redirect              `json:"redirect,omitempty"`
	Switch         []*SwitchCase          `json:"switch,omitempty"`
	Layout         string                 `json:"layout,omitempty"`
	Includes       map[string]string      `json:"includes,omitempty"`
	Headers        map[string]interface{} `json:"headers,omitempty"`
	UrlParams      map[string]interface{} `json:"params,omitempty"`
	FlagDefs       map[string]interface{} `json:"flags,omitempty"`
	Postprocessors []string               `json:"postprocessors,omitempty"`
	Renderer       string                 `json:"renderer,omitempty"`
	// contains filtered or unexported fields
}

func SplitTemplateHeaderContent 

func SplitTemplateHeaderContent(reader io.Reader) (*TemplateHeader, []byte, error)

func (*TemplateHeader) Merge 

func (self *TemplateHeader) Merge(other *TemplateHeader) (*TemplateHeader, error)

type TemplateRenderer added in v1.9.20 

type TemplateRenderer struct {
	// contains filtered or unexported fields
}

func (*TemplateRenderer) Render added in v1.9.20 

func (self *TemplateRenderer) Render(w http.ResponseWriter, req *http.Request, options RenderOptions) error

func (*TemplateRenderer) ShouldPrerender added in v1.9.22 

func (self *TemplateRenderer) ShouldPrerender() bool

type Templated 

type Templated interface {
	Parse(text string) error
	Funcs(FuncMap)
	Render(io.Writer, interface{}, string) error
}

Source Files

View all Source files

Directories

Path Synopsis
cmd
diecast
funcdoc

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.