util

Documentation

Index

• Variables
• func Capture(log ui.Logger, args ...string) ([]byte, error)
• func Command(log *ui.Task, args ...string) (*exec.Cmd, *bytes.Buffer)
• func Ext(path string) string
• func GlobOne(glob string) (string, error)
• func Hash(values ...interface{}) string
• func RealPath(path string) string
• func RelPathCWD(path string) string
• func RelPathsCWD(paths []string) []string
• func ResolveSymlinks(path string) (links []string, err error)
• func Run(log *ui.Task, args ...string) error
• func RunInDir(log *ui.Task, dir string, args ...string) error
• type FileLock
  • func NewLock(file string, checkInterval time.Duration) *FileLock
  • func (l *FileLock) Acquire(ctx context.Context, log ui.Logger) error
  • func (l *FileLock) Release(log ui.Logger)
• type FilePatcher
  • func NewFilePatcher(start, end string) *FilePatcher
  • func (fp *FilePatcher) Patch(fileName, content string) (bool, error)
• type URL
  • func ParseURL(uri string) (URL, error)
  • func (u URL) Join(paths ...string) URL
  • func (u URL) Path() string
  • func (u URL) ReplaceExt(ext string) URL
  • func (u URL) Scheme() string
  • func (u URL) String() string

Variables

var CWD = func() string {
	dir, err := os.Getwd()
	if err != nil {
		panic(err)
	}
	return dir + "/"
}()

CWD for computing RelPathCWD().

We do this once at init time, but we also make it public so we can update it with flags if necessary.

Functions

func Capture

func Capture(log ui.Logger, args ...string) ([]byte, error)

Capture runs a command, returning combined stdout and stderr.

func Command

func Command(log *ui.Task, args ...string) (*exec.Cmd, *bytes.Buffer)

Command constructs a new exec.Cmd with logging configured.

Returns the command, and a *bytes.Buffer containing the combined stdout and stderr of the execution

func Ext

func Ext(path string) string

Ext returns the full extension of a path.

func GlobOne

func GlobOne(glob string) (string, error)

GlobOne globs exactly one file.

func Hash

func Hash(values ...interface{}) string

Hash computes a (probably) unique hash of "values".

func RealPath

func RealPath(path string) string

RealPath converts a path into its absolute, symlink-expanded form.

func RelPathCWD

func RelPathCWD(path string) string

RelPathCWD returns "path" relative to the current working directory.

func RelPathsCWD

func RelPathsCWD(paths []string) []string

RelPathsCWD returns "paths" relative to the current working directory.

func ResolveSymlinks

func ResolveSymlinks(path string) (links []string, err error)

ResolveSymlinks returns all symlinks in a chain, including the final file, as absolute paths.

func Run

func Run(log *ui.Task, args ...string) error

Run a command, outputting to stdout and stderr.

func RunInDir

func RunInDir(log *ui.Task, dir string, args ...string) error

RunInDir runs a command in the given directory.

Types

type FileLock

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

FileLock abstracts away the file locking mechanism. One FileLock corresponds to a one file on disk. This does not support multi-threading. Use only from within one go routine.

func NewLock

func NewLock(file string, checkInterval time.Duration) *FileLock

NewLock creates a new file lock.

func (*FileLock) Acquire

func (l *FileLock) Acquire(ctx context.Context, log ui.Logger) error

Acquire takes the lock. For every Acquire, Release needs to be called later. Returns immediately if this process already holds the lock.

func (*FileLock) Release

func (l *FileLock) Release(log ui.Logger)

Release releases the lock. If there is an error while releasing, the error is logged

type FilePatcher

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

FilePatcher is used to update or set lines in a text file, separated by given start and end line markers

func NewFilePatcher

func NewFilePatcher(start, end string) *FilePatcher

NewFilePatcher creates a new FilePatcher

func (*FilePatcher) Patch

func (fp *FilePatcher) Patch(fileName, content string) (bool, error)

Patch updates the contents in a file.

type URL

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

URL is a builder with convenience methods for manipulating the path component of URLs.

This exists because directly using filepath on a URL string makes it explode.

func ParseURL

func ParseURL(uri string) (URL, error)

ParseURL returns a fluent-style URL manipulator.

func (URL) Join

func (u URL) Join(paths ...string) URL

Join a dir to the URL path.

func (URL) Path

func (u URL) Path() string

Path component of the URL.

func (URL) ReplaceExt

func (u URL) ReplaceExt(ext string) URL

ReplaceExt replaces the path file extension with ext.

func (URL) Scheme

func (u URL) Scheme() string

Scheme of the URL

func (URL) String

func (u URL) String() string