read

Documentation

Index

• Variables
• func Dotenv(c compiler.Compiler, tf *taskfile.Taskfile, dir string) (*taskfile.Vars, error)
• func Taskfile(node Node, insecure bool, download bool, offline bool, tempDir string, ...) (*taskfile.Taskfile, error)
• func Taskvars(dir string) (*taskfile.Vars, error)
• type BaseNode
  • func NewBaseNode(opts ...NodeOption) *BaseNode
  • func (node *BaseNode) Optional() bool
  • func (node *BaseNode) Parent() Node
• type Cache
  • func NewCache(dir string) (*Cache, error)
• type FileNode
  • func NewFileNode(uri string, opts ...NodeOption) (*FileNode, error)
  • func (node *FileNode) Location() string
  • func (node *FileNode) Read(ctx context.Context) ([]byte, error)
  • func (node *FileNode) Remote() bool
• type HTTPNode
  • func NewHTTPNode(uri string, insecure bool, opts ...NodeOption) (*HTTPNode, error)
  • func (node *HTTPNode) Location() string
  • func (node *HTTPNode) Read(ctx context.Context) ([]byte, error)
  • func (node *HTTPNode) Remote() bool
• type Node
  • func NewNode(uri string, insecure bool, opts ...NodeOption) (Node, error)
• type NodeOption
  • func WithOptional(optional bool) NodeOption
  • func WithParent(parent Node) NodeOption

Variables

var (
	// ErrIncludedTaskfilesCantHaveDotenvs is returned when a included Taskfile contains dotenvs
	ErrIncludedTaskfilesCantHaveDotenvs = errors.New("task: Included Taskfiles can't have dotenv declarations. Please, move the dotenv declaration to the main Taskfile")
)

Functions

func Dotenv

func Dotenv(c compiler.Compiler, tf *taskfile.Taskfile, dir string) (*taskfile.Vars, error)

func Taskfile

func Taskfile(
	node Node,
	insecure bool,
	download bool,
	offline bool,
	tempDir string,
	l *logger.Logger,
) (*taskfile.Taskfile, error)

Taskfile reads a Taskfile for a given directory Uses current dir when dir is left empty. Uses Taskfile.yml or Taskfile.yaml when entrypoint is left empty

func Taskvars

func Taskvars(dir string) (*taskfile.Vars, error)

Taskvars reads a Taskvars for a given directory

Types

type BaseNode

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

BaseNode is a generic node that implements the Parent() and Optional() methods of the NodeReader interface. It does not implement the Read() method and it designed to be embedded in other node types so that this boilerplate code does not need to be repeated.

func NewBaseNode

func NewBaseNode(opts ...NodeOption) *BaseNode

func (*BaseNode) Optional

func (node *BaseNode) Optional() bool

func (*BaseNode) Parent

func (node *BaseNode) Parent() Node

type Cache

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

func NewCache

func NewCache(dir string) (*Cache, error)

type FileNode

type FileNode struct {
	*BaseNode
	Dir        string
	Entrypoint string
}

A FileNode is a node that reads a taskfile from the local filesystem.

func NewFileNode

func NewFileNode(uri string, opts ...NodeOption) (*FileNode, error)

func (*FileNode) Location

func (node *FileNode) Location() string

func (*FileNode) Read

func (node *FileNode) Read(ctx context.Context) ([]byte, error)

func (*FileNode) Remote

func (node *FileNode) Remote() bool

type HTTPNode

type HTTPNode struct {
	*BaseNode
	URL *url.URL
}

An HTTPNode is a node that reads a Taskfile from a remote location via HTTP.

func NewHTTPNode

func NewHTTPNode(uri string, insecure bool, opts ...NodeOption) (*HTTPNode, error)

func (*HTTPNode) Location

func (node *HTTPNode) Location() string

func (*HTTPNode) Read

func (node *HTTPNode) Read(ctx context.Context) ([]byte, error)

func (*HTTPNode) Remote

func (node *HTTPNode) Remote() bool

type Node

type Node interface {
	Read(ctx context.Context) ([]byte, error)
	Parent() Node
	Location() string
	Optional() bool
	Remote() bool
}

func NewNode

func NewNode(
	uri string,
	insecure bool,
	opts ...NodeOption,
) (Node, error)

type NodeOption

type NodeOption func(*BaseNode)

func WithOptional

func WithOptional(optional bool) NodeOption

func WithParent

func WithParent(parent Node) NodeOption