apps

Documentation

Index

• Variables
• type Instance
  • func NewInstance(root, localID, platformID string) *Instance
  • func (i *Instance) LocalID() string
  • func (i *Instance) PlatformID() string
  • func (i *Instance) PlatformOrLocalID() string
  • func (i *Instance) Root() string
  • func (i *Instance) Watch(fn WatchFunc) error
• type Manager
  • func NewManager(db *sql.DB) *Manager
  • func (mgr *Manager) FindLatestByPlatformID(platformID string) (*Instance, error)
  • func (mgr *Manager) List() ([]*Instance, error)
  • func (mgr *Manager) RegisterAppListener(fn func(*Instance))
  • func (mgr *Manager) Track(appRoot string) (*Instance, error)
  • func (mgr *Manager) WatchAll(fn WatchFunc) error
• type WatchFunc

Variables

var ErrNotFound = errors.New("app not found")

Types

type Instance

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

Instance describes an app instance known by the Encore daemon.

func NewInstance

func NewInstance(root, localID, platformID string) *Instance

func (*Instance) LocalID

func (i *Instance) LocalID() string

LocalID reports a local, random id unique for this app, as persisted in the .encore/manifest.json file. It always returns a non-empty string.

func (*Instance) PlatformID

func (i *Instance) PlatformID() string

PlatformID reports the Encore Platform's ID for this app. If the app is not linked it reports the empty string.

func (*Instance) PlatformOrLocalID

func (i *Instance) PlatformOrLocalID() string

PlatformOrLocalID reports PlatformID() if set and otherwise LocalID().

func (*Instance) Root

func (i *Instance) Root() string

Root returns the filesystem path for the app root. It always returns a non-empty string.

func (*Instance) Watch

func (i *Instance) Watch(fn WatchFunc) error

type Manager

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

Manager keeps track of known apps and watches them for changes.

func NewManager

func NewManager(db *sql.DB) *Manager

func (*Manager) FindLatestByPlatformID

func (mgr *Manager) FindLatestByPlatformID(platformID string) (*Instance, error)

FindLatestByPlatformID finds the most recently updated app instance with the given platformID. If no such app is found it reports an error matching ErrNotFound.

func (*Manager) List

func (mgr *Manager) List() ([]*Instance, error)

List lists all known apps.

func (*Manager) RegisterAppListener

func (mgr *Manager) RegisterAppListener(fn func(*Instance))

RegisterAppListener registers a callback that gets invoked every time an app is tracked.

func (*Manager) Track

func (mgr *Manager) Track(appRoot string) (*Instance, error)

Track begins tracking an app, and marks it as updated if the app is already tracked.

func (*Manager) WatchAll

func (mgr *Manager) WatchAll(fn WatchFunc) error

WatchAll watches all apps for changes.

type WatchFunc

type WatchFunc func(*Instance, notify.EventInfo)

WatchFunc is the signature of functions registered as app watchers.