Documentation
¶
Index ¶
- Variables
- type LauncherManager
- type State
- func (s *State) ActiveMedia() *models.ActiveMedia
- func (s *State) BootUUID() string
- func (s *State) GetActiveCard() tokens.Token
- func (s *State) GetActivePlaylist() *playlists.Playlist
- func (s *State) GetContext() context.Context
- func (s *State) GetLastScanned() tokens.Token
- func (s *State) GetReader(device string) (readers.Reader, bool)
- func (s *State) GetSoftwareToken() *tokens.Token
- func (s *State) GetWroteToken() *tokens.Token
- func (s *State) Inbox() *inbox.Service
- func (s *State) LauncherManager() *LauncherManager
- func (s *State) ListReaders() []string
- func (s *State) RemoveReader(device string)
- func (s *State) RunZapScriptEnabled() bool
- func (s *State) SetActiveCard(card tokens.Token)
- func (s *State) SetActiveMedia(media *models.ActiveMedia)
- func (s *State) SetActivePlaylist(playlist *playlists.Playlist)
- func (s *State) SetInbox(svc *inbox.Service)
- func (s *State) SetOnMediaStartHook(hook func(*models.ActiveMedia))
- func (s *State) SetReader(device string, reader readers.Reader)
- func (s *State) SetRunZapScript(run bool)
- func (s *State) SetSoftwareToken(token *tokens.Token)
- func (s *State) SetWroteToken(token *tokens.Token)
- func (s *State) StopService()
Constants ¶
This section is empty.
Variables ¶
var ErrLaunchInProgress = errors.New("launch already in progress")
ErrLaunchInProgress is returned when a launch is attempted while another is in progress.
Functions ¶
This section is empty.
Types ¶
type LauncherManager ¶ added in v2.7.0
type LauncherManager struct {
// contains filtered or unexported fields
}
LauncherManager manages the lifecycle of launcher contexts across the application. It provides thread-safe access to a shared context that gets canceled whenever a new launcher starts, allowing previous launcher cleanup routines to detect when they've been superseded and should skip their cleanup actions.
func NewLauncherManager ¶ added in v2.7.0
func NewLauncherManager() *LauncherManager
func (*LauncherManager) EndLaunch ¶ added in v2.8.0
func (lm *LauncherManager) EndLaunch()
EndLaunch releases the launch lock.
func (*LauncherManager) GetContext ¶ added in v2.7.0
func (lm *LauncherManager) GetContext() context.Context
GetContext returns the current launcher context. This context will be canceled when a new launcher starts.
func (*LauncherManager) NewContext ¶ added in v2.7.0
func (lm *LauncherManager) NewContext() context.Context
NewContext cancels the current launcher context and creates a new one. This should be called when starting a new launcher to invalidate any cleanup routines from previous launchers. Returns the newly created context.
func (*LauncherManager) TryStartLaunch ¶ added in v2.8.0
func (lm *LauncherManager) TryStartLaunch() error
TryStartLaunch attempts to acquire the launch lock. Returns ErrLaunchInProgress if a launch is already in progress.
type State ¶
type State struct {
Notifications chan<- models.Notification
// contains filtered or unexported fields
}
State holds the runtime state of the Zaparoo service.
LOCKING RULES: The mu mutex protects all mutable fields. To prevent deadlocks:
- Never send to channels while holding the lock (notifications, callbacks)
- Never call external methods (reader.OnMediaChange, hooks) while holding the lock
- Pattern: lock → modify state → copy needed data → unlock → send notifications
See SetActiveCard, SetActiveMedia, SetReader, RemoveReader for examples.
func (*State) ActiveMedia ¶
func (s *State) ActiveMedia() *models.ActiveMedia
func (*State) GetActiveCard ¶
func (*State) GetActivePlaylist ¶
func (*State) GetContext ¶
func (*State) GetLastScanned ¶
func (*State) GetSoftwareToken ¶
func (*State) GetWroteToken ¶
func (*State) Inbox ¶ added in v2.8.0
Inbox returns the inbox service for adding system notifications.
func (*State) LauncherManager ¶ added in v2.7.0
func (s *State) LauncherManager() *LauncherManager
func (*State) ListReaders ¶
func (*State) RemoveReader ¶
func (*State) RunZapScriptEnabled ¶
func (*State) SetActiveCard ¶
func (*State) SetActiveMedia ¶
func (s *State) SetActiveMedia(media *models.ActiveMedia)
func (*State) SetActivePlaylist ¶
func (*State) SetInbox ¶ added in v2.8.0
SetInbox sets the inbox service. Called during service startup after database is ready.
func (*State) SetOnMediaStartHook ¶
func (s *State) SetOnMediaStartHook(hook func(*models.ActiveMedia))
func (*State) SetRunZapScript ¶
func (*State) SetSoftwareToken ¶
func (*State) SetWroteToken ¶
func (*State) StopService ¶
func (s *State) StopService()
Source Files