Class: Muzak::Instance
- Inherits:
-
Object
- Object
- Muzak::Instance
- Defined in:
- lib/muzak/instance.rb
Overview
Encapsulates the entirety of muzak's running state.
Instance Attribute Summary collapse
-
#index ⇒ Index
readonly
The instance's music index.
-
#player ⇒ StubPlayer
readonly
The instance's player.
-
#playlists ⇒ Hash{String => Playlist}
readonly
The instance's playlists.
-
#plugins ⇒ Array<StubPlugin>
readonly
The instance's plugins.
Instance Method Summary collapse
-
#command(cmd, *args) ⇒ Hash
Sends a command to the instance.
-
#event(type, *args) ⇒ void
Dispatch an event to all plugins.
-
#initialize ⇒ Instance
constructor
A new instance of Instance.
Methods included from Utils
album_art?, #build_response, #danger, #debug, #debug?, #error, #error!, music?, #output, #pretty, #verbose, #verbose?, which?
Methods included from Cmd
#albums_by_artist, #clear_queue, commands, #config_get, #enqueue_album, #enqueue_artist, #enqueue_playlist, #help, #jukebox, #list_albums, #list_artists, #list_playlists, #list_plugins, #list_queue, #next, #now_playing, #pause, #ping, #play, #player_activate, #player_deactivate, #playlist_add_album, #playlist_add_artist, #playlist_add_current, #playlist_del_current, #playlist_delete, #playlist_shuffle, #previous, #quit, #shuffle_queue, #songs_by_artist, #toggle
Constructor Details
#initialize ⇒ Instance
Returns a new instance of Instance.
40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 |
# File 'lib/muzak/instance.rb', line 40 def initialize verbose "muzak is starting..." error! "#{Config.music} doesn't exist" unless File.exist?(Config.music) @index = Index.load_index! @player = Player.load_player!(self) @plugins = Plugin.load_plugins! @playlists = Playlist.load_playlists! enqueue_playlist Config.default_playlist if Config.default_playlist event :instance_started, self end |
Instance Attribute Details
#index ⇒ Index (readonly)
Returns the instance's music index.
29 30 31 |
# File 'lib/muzak/instance.rb', line 29 def index @index end |
#player ⇒ StubPlayer (readonly)
Returns the instance's player.
32 33 34 |
# File 'lib/muzak/instance.rb', line 32 def player @player end |
#playlists ⇒ Hash{String => Playlist} (readonly)
Returns the instance's playlists.
38 39 40 |
# File 'lib/muzak/instance.rb', line 38 def playlists @playlists end |
#plugins ⇒ Array<StubPlugin> (readonly)
Returns the instance's plugins.
35 36 37 |
# File 'lib/muzak/instance.rb', line 35 def plugins @plugins end |
Instance Method Details
#command(cmd, *args) ⇒ Hash
Sends a command to the instance.
14 15 16 17 18 19 20 21 22 23 24 25 26 |
# File 'lib/muzak/instance.rb', line 14 def command(cmd, *args) if Cmd.commands.include?(cmd) meth = method(Config.resolve_command(cmd)) if meth.arity == args.size || meth.arity <= -1 meth.call *args else build_response error: "got #{args.size} args, needed #{meth.arity}" end else danger "unknown command: '#{cmd}'" build_response error: "unknown command '#{cmd}'" end end |
#event(type, *args) ⇒ void
Config::PLUGIN_EVENTS contains all valid events.
This method returns an undefined value.
Dispatch an event to all plugins.
63 64 65 66 67 68 69 70 71 72 73 74 75 |
# File 'lib/muzak/instance.rb', line 63 def event(type, *args) return unless Config::PLUGIN_EVENTS.include?(type) plugins.each do |plugin| Thread.new do begin plugin.send(type, *args) rescue => e error "something went wrong in #{plugin.class.plugin_name}: #{e}" end end end end |