cerberus 0.7.6 → 0.7.7

data/lib/vendor/shout-bot/shout-bot.gemspec

@@ -0,0 +1,13 @@
+Gem::Specification.new do |s|
+  s.name = "shout-bot"
+  s.date = "2009-10-17"
+  s.version = "0.0.5"
+  s.description = "Ridiculously simple library to quickly say something on IRC"
+  s.summary = "Ridiculously simple library to quickly say something on IRC"
+  s.homepage = "http://github.com/sr/shout-bot"
+  s.authors = ["Simon Rozet", "Harry Vangberg"]
+  s.email = "simon@rozet.name"
+  s.files = ["lib/shout-bot.rb"]
+  s.require_paths = ["."]
+  s.add_dependency("addressable")
+end

data/lib/vendor/tinder/CHANGELOG.txt

@@ -0,0 +1,39 @@
+1.2.1 - 2009-08-27
+* Fixes for listening after campfire updates [Jordan Byron]
+
+1.2.0 - 2009-01-28
+* Get the list of available files [Christopher MacGown]
+* Upload files [Joshua Wand]
+* Find rooms even when full [Josh Owens]
+* Join rooms as a guest [Ian Lesperance]
+
+1.1.7 - 2008-07-24
+* Don't join the room when only speaking [Brian Donovan]
+* Added support for HTTP proxies
+* Fix listening for messages that contain URLs [Jared Kuolt]
+
+0.1.6 - 2008-03-07
+* Added Room#topic for getting the current topic [Even Weaver]
+* Trap INT in #listen(&block) [borrowed from Chris Shea's Pyre]
+
+0.1.5 - 2008-01-25
+* Fixed Room#listen, which was broken by latest Campfire deploy
+* Fixed timeout when listening but not speaking that will eventually log you out [Clinton R. Nixon]
+
+0.1.4 - 2007-07-23
+* Support for transcripts
+* Fixed Room#leave, which was broken by a Campfire deployment [Andy Smith]
+
+0.1.3 - 2007-02-12
+* added ssl support [Tero Parviainen]
+
+0.1.2 - 2007-01-27
+* fixed bug preventing #listen from working without a block
+
+0.1.1 - 2007-01-27
+* fix bug preventing speak from working
+* incorporated "watching" from http://soylentfoo.jnewland.com/articles/2006/12/07/updates-to-marshmallow-the-campfire-bot
+
+0.1.0 - 2007-01-23
+* Initial release as gem
+* Get the users in a room [Tero Parviainen]

data/lib/vendor/tinder/Manifest.txt

@@ -0,0 +1,10 @@
+CHANGELOG.txt
+Manifest.txt
+README.txt
+Rakefile
+init.rb
+lib/tinder.rb
+lib/tinder/campfire.rb
+lib/tinder/multipart.rb
+lib/tinder/room.rb
+lib/tinder/version.rb

data/lib/vendor/tinder/README.txt

@@ -0,0 +1,48 @@
+= Tinder - get the Campfire started
+
+Tinder is a library for interfacing with Campfire, the chat application from 37Signals, allowing you to programmatically manage and speak/listen in chat rooms.  As of December 2009, thanks to initial work from Joshua Peek at 37signals, it now makes use of the official Campfire API (described at: http://developer.37signals.com/campfire/).
+
+== Usage
+
+  campfire = Tinder::Campfire.new 'mysubdomain', :token => '546884b3d8fee4d80665g561caf7h9f3ea7b999e'
+  # or you can still use username/password and Tinder will look up your token
+  # campfire = Tinder::Campfire.new 'mysubdomain', :username => 'user', :password => 'pass'
+  
+  room = campfire.rooms.first
+  room.rename 'New Room Names'
+  room.speak 'Hello world!'
+  room.paste "my pasted\ncode"
+
+  room = campfire.find_room_by_guest_hash 'abc123', 'John Doe'
+  room.speak 'Hello world!'
+  
+  See the RDoc for more details.
+
+== Installation
+
+Tinder can be installed as a gem or a Rails plugin:
+
+  gem install tinder
+  
+  script/plugin install git://github.com/collectiveidea/tinder.git
+  
+== How to contribute
+
+If you find what looks like a bug:
+
+1. Check the GitHub issue tracker to see if anyone else has had the same issue.
+   http://github.com/collectiveidea/tinder/issues/
+2. If you don't see anything, create an issue with information on how to reproduce it.
+
+If you want to contribute an enhancement or a fix:
+
+1. Fork the project on github.
+   http://github.com/collectiveidea/tinder
+2. Make your changes with tests.
+3. Commit the changes without making changes to the Rakefile, VERSION, or any other files that aren't related to your enhancement or fix
+4. Send a pull request.
+
+== ToDo
+
+* Tests! (unit and remote)
+* Marshmallow-style integration scripts for exception notification and continuous integration

data/lib/vendor/tinder/Rakefile

@@ -0,0 +1,45 @@
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "tinder"
+    gem.summary = "Ruby wrapper for the Campfire API"
+    gem.description = "A Ruby API for interfacing with Campfire, the 37Signals chat application."
+    gem.authors = ['Brandon Keepers']
+    gem.email = 'brandon@opensoul.org'
+    gem.homepage = 'http://github.com/collectiveidea/tinder'
+    gem.rubyforge_project = "tinder"
+    gem.add_dependency "activesupport"
+    gem.add_dependency "httparty"
+    gem.add_dependency "mime-types"
+    gem.add_development_dependency "rspec"
+    gem.add_development_dependency "fakeweb"
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION')
+    version = File.read('VERSION')
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "tinder #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+require 'spec/rake/spectask'
+desc "Run the specs under spec"
+Spec::Rake::SpecTask.new do |t|
+  t.spec_opts = ['--options', "spec/spec.opts"]
+  t.spec_files = FileList['spec/**/*_spec.rb']
+end
+task :spec => :check_dependencies
+
+desc "Run tests"
+task :default => :spec

data/lib/vendor/tinder/VERSION

@@ -0,0 +1 @@
+1.3.1

data/lib/vendor/tinder/init.rb

@@ -0,0 +1 @@
+require 'tinder'

data/lib/vendor/tinder/lib/tinder.rb

@@ -0,0 +1,12 @@
+require 'active_support'
+
+require 'tinder/connection'
+require 'tinder/multipart'
+require 'tinder/campfire'
+require 'tinder/room'
+
+module Tinder
+  class Error < StandardError; end
+  class SSLRequiredError < Error; end
+  class AuthenticationFailed < Error; end
+end

data/lib/vendor/tinder/lib/tinder/campfire.rb

@@ -0,0 +1,75 @@
+module Tinder
+
+  # == Usage
+  #
+  #   campfire = Tinder::Campfire.new 'mysubdomain', :token => 'xyz'
+  #
+  #   room = campfire.create_room 'New Room', 'My new campfire room to test tinder'
+  #   room.speak 'Hello world!'
+  #   room.destroy
+  #
+  #   room = campfire.find_room_by_guest_hash 'abc123', 'John Doe'
+  #   room.speak 'Hello world!'
+  class Campfire
+    attr_reader :connection
+
+    # Create a new connection to the campfire account with the given +subdomain+.
+    #
+    # == Options:
+    # * +:ssl+: use SSL for the connection, which is required if you have a Campfire SSL account.
+    #           Defaults to false
+    # * +:proxy+: a proxy URI. (e.g. :proxy => 'http://user:pass@example.com:8000')
+    #
+    #   c = Tinder::Campfire.new("mysubdomain", :ssl => true)
+    def initialize(subdomain, options = {})
+      @connection = Connection.new(subdomain, options)
+    end
+
+    # Get an array of all the available rooms
+    # TODO: detect rooms that are full (no link)
+    def rooms
+      connection.get('/rooms.json')['rooms'].map do |room|
+        Room.new(connection, room)
+      end
+    end
+
+    # Find a campfire room by name
+    def find_room_by_name(name)
+      rooms.detect { |room| room.name == name }
+    end
+
+    # Find a campfire room by its guest hash
+    def find_room_by_guest_hash(hash, name)
+      rooms.detect { |room| room.guest_invite_code == hash }
+    end
+
+    # Creates and returns a new Room with the given +name+ and optionally a +topic+
+    def create_room(name, topic = nil)
+      connection.post('/rooms.json', :body => { :room => { :name => name, :topic => topic } }.to_json)
+      find_room_by_name(name)
+    end
+
+    def find_or_create_room_by_name(name)
+      find_room_by_name(name) || create_room(name)
+    end
+
+    # List the users that are currently chatting in any room
+    def users
+      rooms.map(&:users).flatten.compact.uniq.sort_by {|u| u[:name]}
+    end
+
+    # get the user info of the current user
+    def me
+      connection.get("/users/me.json")["user"]
+    end
+    
+    # Get the dates of the available transcripts by room
+    #
+    #   campfire.available_transcripts
+    #   #=> {"15840" => [#<Date: 4908311/2,0,2299161>, #<Date: 4908285/2,0,2299161>]}
+    #
+    def available_transcripts(room = nil)
+      raise NotImplementedError
+    end
+  end
+end

data/lib/vendor/tinder/lib/tinder/connection.rb

@@ -0,0 +1,74 @@
+require 'httparty'
+
+# override HTTParty's json parser to return a HashWithIndifferentAccess
+module HTTParty
+  class Parser
+    protected
+    def json
+      result = Crack::JSON.parse(body)
+      if result.is_a?(Hash)
+        result = HashWithIndifferentAccess.new(result)
+      end
+      result
+    end
+  end
+end
+
+module Tinder
+  class Connection
+    HOST = "campfirenow.com"
+
+    attr_reader :subdomain, :uri, :options
+    
+    def initialize(subdomain, options = {})
+      @subdomain = subdomain
+      @options = { :ssl => false, :proxy => ENV['HTTP_PROXY'] }.merge(options)
+      @uri = URI.parse("#{@options[:ssl] ? 'https' : 'http' }://#{subdomain}.#{HOST}")
+      @token = options[:token]
+      
+      
+      class << self
+        include HTTParty
+        extend HTTPartyExtensions
+        
+        headers 'Content-Type' => 'application/json'
+      end
+      
+      if @options[:proxy]
+        proxy_uri = URI.parse(@options[:proxy])
+        http_proxy proxy_uri.host, proxy_uri.port
+      end
+      base_uri @uri.to_s
+      basic_auth token, 'X'
+    end
+    
+    module HTTPartyExtensions
+      def perform_request(http_method, path, options) #:nodoc:
+        response = super
+        raise AuthenticationFailed if response.code == 401
+        response
+      end
+    end
+    
+    def token
+      @token ||= begin
+        self.basic_auth(options[:username], options[:password])
+        self.get('/users/me.json')['user']['api_auth_token']
+      end
+    end
+
+    def metaclass
+      class << self; self; end
+    end
+
+    def method_missing(*args, &block)
+      metaclass.send(*args, &block)
+    end
+    
+    # Is the connection to campfire using ssl?
+    def ssl?
+      uri.scheme == 'https'
+    end
+    
+  end
+end

data/lib/vendor/tinder/lib/tinder/multipart.rb

@@ -0,0 +1,63 @@
+require 'mime/types'
+require 'net/http'
+require 'cgi'
+
+module Multipart #:nodoc:
+  # From: http://deftcode.com/code/flickr_upload/multipartpost.rb
+  ## Helper class to prepare an HTTP POST request with a file upload
+  ## Mostly taken from
+  #http://blade.nagaokaut.ac.jp/cgi-bin/scat.rb/ruby/ruby-talk/113774
+  ### WAS:
+  ## Anything that's broken and wrong probably the fault of Bill Stilwell
+  ##(bill@marginalia.org)
+  ### NOW:
+  ## Everything wrong is due to keith@oreilly.com
+
+  class Param #:nodoc:
+    attr_accessor :k, :v
+    def initialize(k, v)
+      @k = k
+      @v = v
+    end
+
+    def to_multipart
+      "Content-Disposition: form-data; name=\"#{k}\"\r\n\r\n#{v}\r\n"
+    end
+  end
+
+  class FileParam #:nodoc:
+    attr_accessor :k, :filename, :content
+    def initialize(k, filename, content)
+      @k = k
+      @filename = filename
+      @content = content
+    end
+
+    def to_multipart
+      "Content-Disposition: form-data; name=\"#{k}\"; filename=\"#{filename}\"\r\n" +
+        "Content-Transfer-Encoding: binary\r\n" +
+        "Content-Type: #{MIME::Types.type_for(@filename)}\r\n\r\n" +
+        @content + "\r\n"
+    end
+  end
+
+  class MultipartPost #:nodoc:
+    BOUNDARY = 'campfire-is-awesome'
+    HEADER = {"Content-type" => "multipart/form-data, boundary=" + BOUNDARY + " "}
+    TIMEOUT_SECONDS = 30
+
+    attr_accessor :params, :query, :headers
+    def initialize(params)
+      @params = params
+      @query = {}
+      self.prepare_query
+    end
+
+    def prepare_query()
+      @query = @params.map do |k,v|
+        param = v.respond_to?(:read) ? FileParam.new(k, v.path, v.read) : Param.new(k, v)
+        "--#{BOUNDARY}\r\n#{param.to_multipart}"
+      end.join("") + "--#{BOUNDARY}--"
+    end
+  end
+end

data/lib/vendor/tinder/lib/tinder/room.rb

@@ -0,0 +1,225 @@
+module Tinder
+  # A campfire room
+  class Room
+    attr_reader :id, :name
+
+    def initialize(connection, attributes = {})
+      @connection = connection
+      @id = attributes['id']
+      @name = attributes['name']
+      @loaded = false
+    end
+
+    # Join the room. Pass +true+ to join even if you've already joined.
+    def join(force = false)
+      post 'join'
+    end
+
+    # Leave a room
+    def leave
+      post 'leave'
+    end
+
+    # Get the url for guest access
+    def guest_url
+      "#{@connection.uri}/#{guest_invite_code}" if guest_access_enabled?
+    end
+
+    def guest_access_enabled?
+      load
+      @open_to_guests ? true : false
+    end
+
+    # The invite code use for guest
+    def guest_invite_code
+      load
+      @active_token_value
+    end
+
+    # Change the name of the room
+    def name=(name)
+      connection.put("/room/#{@id}.json", :body => {:room => {:name => name}}.to_json)
+    end
+    alias_method :rename, :name=
+
+    # Change the topic
+    def topic=(topic)
+      connection.put("/room/#{@id}.json", :body => {:room => {:topic => topic}}.to_json)
+    end
+
+    # Get the current topic
+    def topic
+      load
+      @topic
+    end
+
+    # Lock the room to prevent new users from entering and to disable logging
+    def lock
+      post :lock
+    end
+
+    # Unlock the room
+    def unlock
+      post :unlock
+    end
+
+    def ping(force = false)
+      raise NotImplementedError
+    end
+
+    def destroy
+      raise NotImplementedError
+    end
+
+    # Post a new message to the chat room
+    def speak(message, options = {})
+      send_message(message)
+    end
+
+    def paste(message)
+      send_message(message, 'PasteMessage')
+    end
+
+    def play(sound)
+      send_message(sound, 'SoundMessage')
+    end
+
+    # Get the list of users currently chatting for this room
+    def users
+      reload!
+      @users
+    end
+
+    # return the user with the given id; if it isn't in our room cache, do a request to get it
+    def user(id)
+      if id
+        user = users.detect {|u| u[:id] == id }
+        unless user
+          user_data = connection.get("/users/#{id}.json")
+          user = user_data && user_data[:user]
+        end
+        user[:created_at] = Time.parse(user[:created_at])        
+        user
+      end
+    end
+    
+    # Listen for new messages in the room, yielding them to the provided block as they arrive.
+    # Each message is a hash with:
+    # * +:body+: the body of the message
+    # * +:user+: Campfire user, which is itself a hash, of:
+    #   * +:id+: User id
+    #   * +:name+: User name
+    #   * +:email_address+: Email address
+    #   * +:admin+: Boolean admin flag
+    #   * +:created_at+: User creation timestamp
+    #   * +:type+: User type (e.g. Member)
+    # * +:id+: Campfire message id
+    # * +:type+: Campfire message type
+    # * +:room_id+: Campfire room id
+    # * +:created_at+: Message creation timestamp
+    #
+    #   room.listen do |m|
+    #     room.speak "Go away!" if m[:body] =~ /Java/i
+    #   end
+    def listen
+      raise "no block provided" unless block_given?
+      
+      require 'twitter/json_stream'
+      
+      join # you have to be in the room to listen
+      auth = connection.default_options[:basic_auth]
+      options = {
+        :host => "streaming.#{Connection::HOST}",
+        :path => room_url_for(:live),
+        :auth => "#{auth[:username]}:#{auth[:password]}",
+        :timeout => 2
+      }
+      EventMachine::run do
+        stream = Twitter::JSONStream.connect(options)
+        stream.each_item do |message|
+          message = HashWithIndifferentAccess.new(JSON.parse(message))
+          message[:user] = user(message.delete(:user_id))
+          message[:created_at] = Time.parse(message[:created_at])
+          yield(message)
+        end
+      end
+    end
+
+    # Get the dates for the available transcripts for this room
+    def available_transcripts
+      raise NotImplementedError
+    end
+
+    # Get the transcript for the given date (Returns a hash in the same format as #listen)
+    #
+    #   room.transcript(room.available_transcripts.first)
+    #   #=> [{:message=>"foobar!",
+    #         :user_id=>"99999",
+    #         :person=>"Brandon",
+    #         :id=>"18659245",
+    #         :timestamp=>=>Tue May 05 07:15:00 -0700 2009}]
+    #
+    # The timestamp slot will typically have a granularity of five minutes.
+    #
+    def transcript(transcript_date)
+      url = "/room/#{@id}/transcript/#{transcript_date.to_date.strftime('%Y/%m/%d')}.json"
+      connection.get(url)['messages'].map do |room|
+        { :id => room['id'],
+          :user_id => room['user_id'],
+          :message => room['body'],
+          :timestamp => Time.parse(room['created_at']) }
+      end
+    end
+
+    def upload(filename)
+      File.open(filename, "rb") do |file|
+        params = Multipart::MultipartPost.new('upload' => file)
+        post(:uploads, :body => params.query)
+      end
+    end
+
+    # Get the list of latest files for this room
+    def files(count = 5)
+      get(:uploads)['uploads'].map { |u| u['full_url'] }
+    end
+
+    protected
+      def load
+        reload! unless @loaded
+      end
+
+      def reload!
+        attributes = connection.get("/room/#{@id}.json")['room']
+
+        @id = attributes['id']
+        @name = attributes['name']
+        @topic = attributes['topic']
+        @full = attributes['full']
+        @open_to_guests = attributes['open_to_guests']
+        @active_token_value = attributes['active_token_value']
+        @users = attributes['users']
+
+        @loaded = true
+      end
+
+      def send_message(message, type = 'TextMessage')
+        post 'speak', :body => {:message => {:body => message, :type => type}}.to_json
+      end
+
+      def get(action, options = {})
+        connection.get(room_url_for(action), options)
+      end
+
+      def post(action, options = {})
+        connection.post(room_url_for(action), options)
+      end
+
+      def room_url_for(action)
+        "/room/#{@id}/#{action}.json"
+      end
+
+      def connection
+        @connection
+      end
+  end
+end