root

Documentation

Index

• func Lookup() string
• type Root
  • func New() Root
  • func NewAt(dir string) Root

Functions

func Lookup

func Lookup() string

Lookup derives the Thelma root directory. It will be: * The value of the THELMA_ROOT env var, if set * If a valid home directory exists for current user, it will be $HOME/.thelma * Else, /tmp/.thelma.<pid> (worst-case fallback option in weird environments) Note that this function identifies the root directory path, but does NOT create the root directory; it may or may not exist.

Types

type Root

type Root interface {
	// Dir returns the Thelma installation root directory, usually ~/.thelma
	Dir() string
	// LogDir returns the path where Thelma debug logs are stored ($ROOT/logs)
	LogDir() string
	// CachesDir returns the Thelma cache directory ($ROOT/caches)
	CachesDir() string
	// CredentialsDir returns the path to Thelma credentials directory ($ROOT/credentials)
	CredentialsDir() string
	// ConfigDir returns the path to Thelma config directory
	ConfigDir() string
	// ReleasesDir returns the Thelma installation directory ($ROOT/releases)
	ReleasesDir() string
	// ShellDir path where Thelma generates shell scripts and utilities ($ROOT/shell)
	ShellDir() string
	// CreateDirectories create directories if they do not exist. Will be called as part of Thelma initialization
	CreateDirectories() error
}

func New

func New() Root

New returns a new Root instance rooted at the directory returned by Lookup

func NewAt

func NewAt(dir string) Root

NewAt (FOR TESTING ONLY) returns a Root instance rooted at the given directory