Documentation ¶
Overview ¶
Package bus provides access to a singleton instance of an event bus (provided by the calling application). The event bus is intended to allow for the library to publish events which library consumers can subscribe to. These events can provide static information, but also have an object as a payload for which the consumer can poll for updates. This is akin to a logger, except instead of only allowing strings to be logged, rich objects that can be interacted with.
Note that the singleton instance is only allowed to publish events and not subscribe to them --this is intentional. Internal library interactions should continue to use traditional in-execution-path approaches for data sharing (e.g. function returns and channels) and not depend on bus subscriptions for critical interactions (e.g. one part of the lib publishes an event and another part of the lib subscribes and reacts to that event). The bus is provided only as a means for consumers to observe events emitted from the library (such as to provide a rich UI) and not to allow consumers to augment or otherwise change execution.
Index ¶
- func Exit()
- func Get() partybus.Publisher
- func Notify(message string)
- func PromptForInput(message string, sensitive bool, validators ...func(string) error) *bubbly.Prompter
- func PublishTask(titles event.Title, context string, total int) *event.ManualStagedProgress
- func Report(report string)
- func Set(p partybus.Publisher)
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func PromptForInput ¶
func PublishTask ¶
Types ¶
This section is empty.