modules

Documentation

Overview

Package modules implements all logic needed for interacting with stencil modules and their interaction with a service generated by stencil.

Index

• type Module
  • func GetModulesForService(ctx context.Context, m *configuration.ServiceManifest) ([]*Module, error)
  • func New(ctx context.Context, uri string, tr *configuration.TemplateRepository) (*Module, error)
  • func NewWithFS(ctx context.Context, name string, fs billy.Filesystem) *Module
  • func (m *Module) GetFS(ctx context.Context) (billy.Filesystem, error)
  • func (m *Module) GetTemplate() *template.Template
  • func (m *Module) Manifest(ctx context.Context) (configuration.TemplateRepositoryManifest, error)
  • func (m *Module) RegisterExtensions(ctx context.Context, log logrus.FieldLogger, ext *extensions.Host) error

Types

type Module

type Module struct {

	// Name is the name of a module. This should be a valid go
	// import path. For example: github.com/getoutreach/stencil-base
	Name string

	// URI is the underlying URI being used to download this module
	URI string

	// Version is the version of this module
	Version string
	// contains filtered or unexported fields
}

Module is a stencil module that contains template files.

func GetModulesForService

func GetModulesForService(ctx context.Context, m *configuration.ServiceManifest) ([]*Module, error)

GetModulesForService returns a list of modules that a given service manifest depends on. They are not returned in the order of their import.

func New

func New(ctx context.Context, uri string, tr *configuration.TemplateRepository) (*Module, error)

New creates a new module from a TemplateRepository. If no version is specified then the latest released revision is used. If `prerelease` is set to true then the latest revision is used, regardless of whether it is a released version or not.

uri is the URI for the module. If it is an empty string https://+name is used instead.

func NewWithFS

func NewWithFS(ctx context.Context, name string, fs billy.Filesystem) *Module

NewWithFS creates a module with the specified file system. This is generally only meant to be used in tests.

func (*Module) GetFS

func (m *Module) GetFS(ctx context.Context) (billy.Filesystem, error)

GetFS returns a billy.Filesystem that contains the contents of this module.

func (*Module) GetTemplate

func (m *Module) GetTemplate() *template.Template

GetTemplate returns the go template for this module

func (*Module) Manifest

func (m *Module) Manifest(ctx context.Context) (configuration.TemplateRepositoryManifest, error)

Manifest downloads the module if not already downloaded and returns a parsed configuration.TemplateRepositoryManifest of this module.

func (*Module) RegisterExtensions

func (m *Module) RegisterExtensions(ctx context.Context, log logrus.FieldLogger, ext *extensions.Host) error

RegisterExtensions registers all extensions provided by the given module. If the module is a local file URI then extensions will be sourced from the `./bin` directory of the base of the path.