turntabler 0.0.1

data/lib/turntabler.rb

@@ -0,0 +1,102 @@
+require 'logger'
+require 'em-synchrony'
+
+# Turntable.FM API for Ruby
+module Turntabler
+  autoload :Client, 'turntabler/client'
+
+  class << self
+    # The logger to use for all Turntable messages.  By default, everything is
+    # logged to STDOUT.
+    # @return [Logger]
+    attr_accessor :logger
+
+    # Whether this is going to be used in an interactive console such as IRB.
+    # If this is enabled then EventMachine will run in a separate thread.  This
+    # will allow IRB to continue to actually be interactive.
+    # 
+    # @note You must continue to run all commands on a client through Turntabler#run.
+    # @example
+    #   require 'turntabler'
+    #   
+    #   Turntabler.interactive
+    #   Turntabler.run do
+    #     @client = Turntabler::Client.new(...)
+    #     @client.start
+    #   end
+    #   
+    #   # ...later on after the connection has started and you want to interact with it
+    #   Turntabler.run do
+    #     @client.user.load
+    #     # ...
+    #   end
+    def interactive
+      Thread.new { EM.run }.abort_on_exception = true
+    end
+
+    # Sets up the proper EventMachine reactor / Fiber to run commands against a
+    # client.  If this is not in interactive mode, then the block won't return
+    # until the EventMachine reactor is stopped.
+    # 
+    # @note If you're already running within an EventMachine reactor *and* a
+    # Fiber, then there's no need to call this method prior to interacting with
+    # a Turntabler::Client instance.
+    # @example
+    #   # Non-interactive, not in reactor / fiber
+    #   Turntabler.run do
+    #     client = Turntabler::Client.new(...)
+    #     client.room.become_dj
+    #     # ...
+    #   end
+    #   
+    #   # Interactive, not in reactor / fiber
+    #   Turntabler.run do
+    #     client.room.become_dj
+    #     # ...
+    #   end
+    #   
+    #   # Non-interactive, already in reactor / fiber
+    #   client = Turntabler::Client(...)
+    #   client.room.become_dj
+    # 
+    # @example DSL
+    #   # Takes the same arguments as Turntabler::Client
+    #   Turntabler.run(USER, AUTH, :room => ROOM) do
+    #     room.become_dj
+    #     on :user_enter do
+    #       # ...
+    #     end
+    #   end
+    # 
+    # == Exception handling
+    # 
+    # Any exceptions that occur within the block will be automatically caught
+    # and logged.  This prevents the EventMachine reactor from dying.
+    def run(*args, &block)
+      if EM.reactor_running?
+        EM.next_tick do
+          EM.synchrony do
+            begin
+              if args.any?
+                # Run the block within a client
+                Client.new(*args, &block)
+              else
+                # Just run the block within a fiber
+                block.call
+              end
+            rescue Exception => ex
+              logger.error(([ex.message] + ex.backtrace) * "\n")
+            end
+          end
+        end
+      else
+        EM.synchrony { run(*args, &block) }
+      end
+    end
+  end
+
+  @logger = Logger.new(STDOUT)
+end
+
+# Provide a simple alias (akin to EM / EventMachine)
+TT = Turntabler

data/spec/spec_helper.rb

@@ -0,0 +1,7 @@
+$LOAD_PATH << File.expand_path("../../lib", __FILE__)
+
+require 'turntabler'
+
+RSpec.configure do |config|
+  config.order = 'random'
+end

data/spec/turntabler_spec.rb

@@ -0,0 +1,4 @@
+require 'spec_helper'
+
+describe Turntabler do
+end

data/turntable.gemspec

@@ -0,0 +1,24 @@
+$LOAD_PATH.unshift File.expand_path('../lib', __FILE__)
+require 'turntabler/version'
+
+Gem::Specification.new do |s|
+  s.name              = "turntabler"
+  s.version           = Turntabler::Version::STRING
+  s.authors           = ["Aaron Pfeifer"]
+  s.email             = "aaron.pfeifer@gmail.com"
+  s.homepage          = "http://github.com/obrie/turntabler"
+  s.description       = "Turntable.FM API for Ruby"
+  s.summary           = "Turntable.FM API for Ruby"
+  s.require_paths     = ["lib"]
+  s.files             = `git ls-files`.split("\n")
+  s.test_files        = `git ls-files -- test/*`.split("\n")
+  s.rdoc_options      = %w(--line-numbers --inline-source --title turntabler --main README.md)
+  s.extra_rdoc_files  = %w(README.md CHANGELOG.md LICENSE)
+
+  s.add_runtime_dependency("em-synchrony")
+  s.add_runtime_dependency("em-http-request")
+  s.add_runtime_dependency("faye-websocket")
+  s.add_development_dependency("rake")
+  s.add_development_dependency("rspec", "~> 2.11")
+  s.add_development_dependency("simplecov")
+end

metadata

@@ -0,0 +1,173 @@
+--- !ruby/object:Gem::Specification 
+name: turntabler
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Aaron Pfeifer
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-11-20 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: em-synchrony
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: em-http-request
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: faye-websocket
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "2.11"
+  type: :development
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: simplecov
+  prerelease: false
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id006
+description: Turntable.FM API for Ruby
+email: aaron.pfeifer@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.md
+- CHANGELOG.md
+- LICENSE
+files: 
+- .gitignore
+- .rspec
+- .yardopts
+- CHANGELOG.md
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- examples/Gemfile
+- examples/Gemfile.lock
+- examples/autobop.rb
+- examples/autofan.rb
+- examples/blacklist.rb
+- examples/bop.rb
+- examples/bopcount.rb
+- examples/chat_bot.rb
+- examples/modlist.rb
+- examples/switch.rb
+- examples/time_afk_list.rb
+- lib/turntabler.rb
+- lib/turntabler/assertions.rb
+- lib/turntabler/authorized_user.rb
+- lib/turntabler/avatar.rb
+- lib/turntabler/boot.rb
+- lib/turntabler/client.rb
+- lib/turntabler/connection.rb
+- lib/turntabler/digest_helpers.rb
+- lib/turntabler/error.rb
+- lib/turntabler/event.rb
+- lib/turntabler/handler.rb
+- lib/turntabler/loggable.rb
+- lib/turntabler/message.rb
+- lib/turntabler/playlist.rb
+- lib/turntabler/preferences.rb
+- lib/turntabler/resource.rb
+- lib/turntabler/room.rb
+- lib/turntabler/room_directory.rb
+- lib/turntabler/snag.rb
+- lib/turntabler/song.rb
+- lib/turntabler/sticker.rb
+- lib/turntabler/sticker_placement.rb
+- lib/turntabler/user.rb
+- lib/turntabler/version.rb
+- lib/turntabler/vote.rb
+- spec/spec_helper.rb
+- spec/turntabler_spec.rb
+- turntable.gemspec
+homepage: http://github.com/obrie/turntabler
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- turntabler
+- --main
+- README.md
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Turntable.FM API for Ruby
+test_files: []
+
+has_rdoc: