sj-tinder 1.9.3

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    Yzc5YmJkYTg5YmYyOWZiNjZmOGQyMjlkNTYwMWZhMDMyYjQ3NWNmMg==
+  data.tar.gz: !binary |-
+    NjQ5ZTk4ZTVlNmJmMzg5Zjk3YzIxMTFiY2IyZjk0Y2FjYjMxYzljNg==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    OWZlMTEwOTYyNzQ2NDFmYjE4MDg5ZTQ4MTk4MzEzYWViMTg4YTg1MDI5NzA1
+    YjM4ZjY5ZWQxOTM3ZTU5ZDM2Zjk0MTdhM2RiMzNiM2E2NjkwN2QxZjIxNDI1
+    YTg4ZDRhMWIwMjVmNThiNmUyZDY0MDAwNDkwYjA3NzI1NTY5M2I=
+  data.tar.gz: !binary |-
+    NmU4M2YwZmQ0NGVlZWE3MDA3ZTY4N2I1NDRiOWY2ZmIyZWVmZmU4ZjJkZTg2
+    YzA3ZDRhODM0MjM4ZjFjNTBkM2MxM2Q3NjFhNTQ3OGE4MWI0Y2Y3N2QxZGRk
+    ZjY1NWU1ZDQzZDYwNThiYjA5MWU5NzM2YWM4MTI2ZWQzOGI1MTI=

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+.rvmrc

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--format=nested
+--backtrace

data/.travis.yml

@@ -0,0 +1,13 @@
+language: ruby
+rvm:
+  - rbx-19mode
+  - rbx-18mode
+  - jruby-19mode
+  - jruby-18mode
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+only:
+  - master
+notifications:
+  disabled: true

data/CHANGELOG.txt

@@ -0,0 +1,79 @@
+1.9.2 - 2013-01-04
+* Update dependencies to latest versions
+
+1.9.0 - 2012-07-16
+* Add Room#recent to get a list of recent messages
+* Add Room#search to search a room's transcripts
+
+1.4.3 - 2010-12-07
+* explicitly require 'uri'
+* added Room#tweet(url)
+
+1.4.2 - 2010-11-13
+* Use Faraday instead of HTTParty [eric]
+* Fix file uploads [eric]
+
+1.4.1 - 2010-10-09
+* Make SSL the default since it is available for all Campfire accounts.
+* Added MIT License
+
+1.4 - 2010-05-11
+* Remove methods no longer supported by API
+  Campfire#available_transcripts, Room#ping, Room#destroy, Room#toggle_guest_access
+* Added Room#play
+* ActiveSupport 3.0 support
+* Fix streaming API support
+* Allow SSL for listening
+* Add support for HTTP proxies [c13bcc0b]
+
+1.3.1 - 2009-12-17
+* Declare HTTParty dependency
+* Fix Room#paste
+
+1.3.0 - 2009-12-15
+* Rewrite to use Official Campfire API
+
+1.2.2 - 2009-09-12
+* Work around CSRF protection bug
+* Fixes for changes to Campfire markup
+* Include timestamps in the transcript
+
+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/Gemfile

@@ -0,0 +1,7 @@
+source 'http://rubygems.org'
+
+platforms :jruby do
+  gem 'jruby-openssl', '~> 0.7'
+end
+
+gemspec

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2006-2010 Brandon Keepers, Collective Idea
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOa AND
+NONINFRINGEMENT. IN NO EVENT SaALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.markdown

@@ -0,0 +1,45 @@
+# 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'
+    # or if you have an OAuth token then you can use that to connect
+    # campfire = Tinder::Campfire.new 'mysubdomain', :oauth_token => '546884b3d8fee4d80665g561caf7h9f3ea7b999e'
+
+    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
+
+    gem install tinder
+
+## Continuous Integration
+
+[![Build Status](https://secure.travis-ci.org/collectiveidea/tinder.png)](http://travis-ci.org/collectiveidea/tinder) [![Dependency Status](https://gemnasium.com/collectiveidea/tinder.png)](https://gemnasium.com/collectiveidea/tinder)
+
+## 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.

data/Rakefile

@@ -0,0 +1,9 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+desc 'Run the specs'
+RSpec::Core::RakeTask.new
+
+task :default => :spec
+task :test => :spec

data/init.rb

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

data/lib/faraday/response/raise_on_authentication_failure.rb

@@ -0,0 +1,10 @@
+# encoding: UTF-8
+require 'faraday'
+
+module Faraday
+  class Response::RaiseOnAuthenticationFailure < Response::Middleware
+    def on_complete(response)
+      raise Tinder::AuthenticationFailed if [401, 404].include?(response[:status])
+    end
+  end
+end

data/lib/faraday/response/remove_whitespace.rb

@@ -0,0 +1,10 @@
+# encoding: UTF-8
+require 'faraday'
+
+module Faraday
+  class Response::RemoveWhitespace < Response::Middleware
+    def parse(body)
+      body =~ /^\s+$/ ? "" : body
+    end
+  end
+end

data/lib/tinder.rb

@@ -0,0 +1,20 @@
+# encoding: UTF-8
+require 'tinder/connection'
+require 'tinder/campfire'
+require 'tinder/room'
+require 'logger'
+
+module Tinder
+  class Error < StandardError; end
+  class SSLRequiredError < Error; end
+  class AuthenticationFailed < Error; end
+  class ListenFailed < Error; end
+
+  def self.logger
+    @logger ||= Logger.new(ENV['TINDER_LOGGING'] ? STDOUT : nil)
+  end
+
+  def self.logger=(logger)
+    @logger = logger
+  end
+end

data/lib/tinder/campfire.rb

@@ -0,0 +1,76 @@
+# encoding: UTF-8
+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 true
+    # * +:ssl_options+: SSL options passed to the underlaying Faraday connection. Allows to specify if the SSL certificate should be verified (:verify => true|false) and to specify the path to the ssl certs directory (:ca_path => "path/certs")
+    #           Defaults to {:verify => true}
+    # * +: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 id
+    # NOTE: id should be of type Integer
+    def find_room_by_id(id)
+      id = id.to_i
+      rooms.detect { |room| room.id == id }
+    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', { :room => { :name => name, :topic => topic } })
+      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
+  end
+end

data/lib/tinder/connection.rb

@@ -0,0 +1,115 @@
+# encoding: UTF-8
+require 'faraday'
+require 'faraday/response/raise_on_authentication_failure'
+require 'faraday/response/remove_whitespace'
+require 'faraday_middleware'
+require 'json'
+require 'uri'
+
+module Tinder
+  class Connection
+    HOST = 'campfirenow.com'
+
+    attr_reader :subdomain, :uri, :options
+
+    def self.connection
+      @connection ||= Faraday.new do |builder|
+        builder.use     FaradayMiddleware::EncodeJson
+        builder.use     FaradayMiddleware::Mashify
+        builder.use     FaradayMiddleware::ParseJson
+        builder.use     Faraday::Response::RemoveWhitespace
+        builder.use     Faraday::Response::RaiseOnAuthenticationFailure
+        builder.adapter Faraday.default_adapter
+      end
+    end
+
+    def self.raw_connection
+      @raw_connection ||= Faraday.new do |builder|
+        builder.use     Faraday::Request::Multipart
+        builder.use     FaradayMiddleware::Mashify
+        builder.use     FaradayMiddleware::ParseJson
+        builder.use     Faraday::Response::RemoveWhitespace
+        builder.use     Faraday::Response::RaiseOnAuthenticationFailure
+        builder.adapter Faraday.default_adapter
+      end
+    end
+
+    def initialize(subdomain, options = {})
+      @subdomain = subdomain
+      @options = {:ssl => true, :ssl_options => {:verify => true}, :proxy => ENV['HTTP_PROXY']}
+      @options[:ssl_options][:verify] = options.delete(:ssl_verify) unless options[:ssl_verify].nil?
+      @options.merge!(options)
+      @uri = URI.parse("#{@options[:ssl] ? 'https' : 'http' }://#{subdomain}.#{HOST}")
+      @token = options[:token]
+      @oauth_token = options[:oauth_token]
+
+      if @oauth_token
+        connection.headers["Authorization"] = "Bearer #{@oauth_token}"
+        raw_connection.headers["Authorization"] = "Bearer #{@oauth_token}"
+      else
+        connection.basic_auth token, 'X'
+        raw_connection.basic_auth token, 'X'
+      end
+    end
+
+    def basic_auth_settings
+      {:username => token, :password => 'X'}
+    end
+
+    def connection
+      @connection ||= begin
+        conn = self.class.connection.dup
+        set_connection_options(conn)
+        conn
+      end
+    end
+
+    def raw_connection
+      @raw_connection ||= begin
+        conn = self.class.raw_connection.dup
+        set_connection_options(conn)
+        conn
+      end
+    end
+
+    def token
+      @token ||= begin
+        connection.basic_auth(options[:username], options[:password])
+        get('/users/me.json')['user']['api_auth_token']
+      end
+    end
+
+    def get(url, *args)
+      response = connection.get(url, *args)
+      response.body
+    end
+
+    def post(url, body = nil, *args)
+      response = connection.post(url, body, *args)
+      response.body
+    end
+
+    def raw_post(url, body = nil, *args)
+      response = raw_connection.post(url, body, *args)
+    end
+
+    def put(url, body = nil, *args)
+      response = connection.put(url, body, *args)
+      response.body
+    end
+
+    # Is the connection to campfire using ssl?
+    def ssl?
+      uri.scheme == 'https'
+    end
+
+  private
+    def set_connection_options(conn)
+      conn.url_prefix = @uri.to_s
+      conn.proxy options[:proxy]
+      if options[:ssl_options]
+        conn.ssl.merge!(options[:ssl_options])
+      end
+    end
+  end
+end