cerberus 0.6 → 0.7

data/lib/vendor/twitter/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2006-2007 Susan Potter <me _at_ susanpotter _dot_ net>.
+
+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 PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL 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/lib/vendor/twitter/README

@@ -0,0 +1,37 @@
+= Twitter4R
+
+* Project Website - http://twitter4r.rubyforge.org
+* Mailing List - http://groups.google.com/group/twitter4r-users
+
+== Developers
+* {Susan Potter}[http://SusanPotter.NET] <me at susanpotter dot net>
+
+== Contributors
+Code:
+* Kaiichi Matsunaga <ma2 at lifemedia dot co dot jp> - proxy code suggestion
+* Sergio Santos <> - message paging code suggestion
+* Adam Stiles <adam at stilesoft dot com> - URI.encode => CGI.escape fix
+* Carl Crawley <cwcrawley at gmail dot com> - Friendship get => post fix
+* Christian Johansen <christian at cjohansen dot no> - in_reply_to attributes in Twitter::Status
+
+Design Suggestions:
+* Bosco So <rubymeetup at boscoso dot com> - making Twitter::Error a RuntimeError instead of an Exception to prevent irb from crashing out.
+
+== Description
+Twitter4R provides an object based API to query or update your Twitter account via pure Ruby.  It hides the ugly HTTP/REST code from your code.
+
+== External Dependencies
+* Ruby 1.8 (tested with 1.8.6)
+* RSpec gem 1.0.0+ (tested with 1.1.3)
+* JSON gem 0.4.3+ (tested with versions: 1.1.1 and 1.1.2)
+* jcode (for unicode support)
+
+== Usage Examples
+Twitter4R starting with version 0.1.1 and above is organized into seven parts:
+* {Configuration API}[link:files/examples/configure_rb.html]
+* {Friendship API}[link:files/examples/friendship_rb.html]
+* {Messaging API}[link:files/examples/messaging_rb.html]
+* {Model API}[link:files/examples/model_rb.html]
+* {Status API}[link:files/examples/status_rb.html]
+* {Timeline API}[link:files/examples/timeline_rb.html]
+* {User API}[link:files/examples/user_rb.html]

data/lib/vendor/twitter/TODO

@@ -0,0 +1,7 @@
+
+0.3.1 TODO:
+* Add specs for :page, :lite and :since options support in Twitter::Client#my(...), Twitter::Client#user(....) and Twitter::User#followers calls
+* Add specs for :replies support in Twitter::Client#status(...) and Twitter::Client#timeline_for(...)
+* Add RDoc for :replies support
+* Add better RDoc for Twitter::Client.account_info(:rate_limit_status)
+* Add specs for Twitter::Client.account_info(:rate_limit_status)

data/lib/vendor/twitter/lib/twitter.rb

@@ -0,0 +1,34 @@
+#
+require('rubygems')
+
+module Twitter; end
+
+def require_local(suffix)
+  require(File.expand_path(File.join(File.dirname(__FILE__), suffix)))
+end
+
+# For better unicode support in 1.8
+if RUBY_VERSION < '1.9'
+  $KCODE = 'u'
+  require 'jcode'
+end
+
+# External requires
+require('yaml')
+require('date')
+require('time')
+require('net/https')
+require('uri')
+require('cgi')
+require('json')
+require('yaml')
+
+# Ordering matters...pay attention here!
+require_local('twitter/ext')
+require_local('twitter/version')
+require_local('twitter/meta')
+require_local('twitter/core')
+require_local('twitter/model')
+require_local('twitter/config')
+require_local('twitter/client')
+require_local('twitter/console')

data/lib/vendor/twitter/lib/twitter/client.rb

@@ -0,0 +1,24 @@
+# client.rb contains the classes, methods and extends <tt>Twitter4R</tt>
+# features to define client calls to the Twitter REST API.
+#
+# See:
+# * <tt>Twitter::Client</tt>
+
+# Used to query or post to the Twitter REST API to simplify code.
+class Twitter::Client
+  include Twitter::ClassUtilMixin
+end
+
+require('twitter/client/base')
+require('twitter/client/timeline')
+require('twitter/client/status')
+require('twitter/client/friendship')
+require('twitter/client/messaging')
+require('twitter/client/user')
+require('twitter/client/auth')
+require('twitter/client/favorites')
+require('twitter/client/blocks')
+require('twitter/client/account')
+require('twitter/client/graph')
+require('twitter/client/profile')
+require('twitter/client/search')

data/lib/vendor/twitter/lib/twitter/client/account.rb

@@ -0,0 +1,24 @@
+class Twitter::Client
+  @@ACCOUNT_URIS = {
+    :rate_limit_status => '/account/rate_limit_status',
+  }
+
+  # Provides access to the Twitter rate limit status API.
+  #
+  # You can find out information about your account status.  Currently the only
+  # supported type of account status is the <tt>:rate_limit_status</tt> which
+  # returns a <tt>Twitter::RateLimitStatus</tt> object.
+  #
+  # Example:
+  #  account_status = client.account_info
+  #  puts account_status.remaining_hits
+  def account_info(type = :rate_limit_status)
+    connection = create_http_connection
+    connection.start do |connection|
+      response = http_connect do |conn|
+        create_http_get_request(@@ACCOUNT_URIS[type])
+      end
+      bless_models(Twitter::RateLimitStatus.unmarshal(response.body))
+    end
+  end
+end

data/lib/vendor/twitter/lib/twitter/client/auth.rb

@@ -0,0 +1,27 @@
+class Twitter::Client
+  @@AUTHENTICATION_URIS = {
+    :verify => '/account/verify_credentials',
+  }
+
+	# Provides access to the Twitter verify credentials API.
+	#
+	# You can verify Twitter user credentials with minimal overhead using this method.
+  #
+	# Example:
+	#  client.authenticate?("osxisforlightweights", "l30p@rd_s^cks!")
+	def authenticate?(login, password)
+    verify_credentials(login, password)
+	end
+
+private
+  def verify_credentials(username, passwd)
+	connection = create_http_connection
+	connection.start do |connection|
+	  request = create_http_get_request("#{@@AUTHENTICATION_URIS[:verify]}.json")
+		request.basic_auth(username, passwd)
+		response = connection.request(request)
+		response.is_a?(Net::HTTPSuccess) ? true : false
+    end
+  end
+end
+

data/lib/vendor/twitter/lib/twitter/client/base.rb

@@ -0,0 +1,93 @@
+class Twitter::Client
+  alias :old_inspect :inspect
+  def inspect
+    s = old_inspect
+    s.gsub!(/@password=".*?"/, '@password="XXXX"')
+  end
+  protected
+    attr_accessor :login, :password
+
+    # Returns the response of the HTTP connection.
+    def http_connect(body = nil, require_auth = true, service = :rest, &block)
+	require_block(block_given?)
+	connection = create_http_connection(service)
+	connection.start do |connection|
+		request = yield connection if block_given?
+		request.basic_auth(@login, @password) if require_auth
+		response = connection.request(request, body)
+		handle_rest_response(response)
+		response
+      end
+    end
+
+    # "Blesses" model object with client information
+    def bless_model(model)
+	model.bless(self) if model
+    end
+
+    def bless_models(list)
+      return bless_model(list) if list.respond_to?(:client=)
+	list.collect { |model| bless_model(model) } if list.respond_to?(:collect)
+    end
+
+  private
+    @@http_header = nil
+
+    def raise_rest_error(response, uri = nil)
+      raise Twitter::RESTError.new(:code => response.code,
+                                   :message => response.message,
+                                   :uri => uri)
+    end
+
+    def handle_rest_response(response, uri = nil)
+      unless response.is_a?(Net::HTTPSuccess)
+        raise_rest_error(response, uri)
+      end
+    end
+
+    def create_http_connection(service = :rest)
+      case service
+      when :rest
+        protocol, host, port = @@config.protocol, @@config.host, @@config.port
+      when :search
+        protocol, host, port = @@config.search_protocol, @@config.search_host, @@config.search_port
+      end
+      conn = Net::HTTP.new(host, port,
+                            @@config.proxy_host, @@config.proxy_port,
+                            @@config.proxy_user, @@config.proxy_pass)
+      if protocol == :ssl
+        conn.use_ssl = true
+        conn.verify_mode = OpenSSL::SSL::VERIFY_NONE
+      end
+      conn
+    end
+
+    def http_header
+      # can cache this in class variable since all "variables" used to
+      # create the contents of the HTTP header are determined by other
+      # class variables that are not designed to change after instantiation.
+      @@http_header ||= {
+	'User-Agent' => "Twitter4R v#{Twitter::Version.to_version} [#{@@config.user_agent}]",
+	'Accept' => 'text/x-json',
+	'X-Twitter-Client' => @@config.application_name,
+	'X-Twitter-Client-Version' => @@config.application_version,
+	'X-Twitter-Client-URL' => @@config.application_url,
+      }
+      @@http_header
+    end
+
+    def create_http_get_request(uri, params = {})
+	path = (params.size > 0) ? "#{uri}?#{params.to_http_str}" : uri
+      Net::HTTP::Get.new(path, http_header)
+    end
+
+    def create_http_post_request(uri)
+	Net::HTTP::Post.new(uri, http_header)
+    end
+
+    def create_http_delete_request(uri, params = {})
+	path = (params.size > 0) ? "#{uri}?#{params.to_http_str}" : uri
+	Net::HTTP::Delete.new(path, http_header)
+    end
+end
+

data/lib/vendor/twitter/lib/twitter/client/blocks.rb

@@ -0,0 +1,35 @@
+class Twitter::Client
+  @@BLOCK_URIS = {
+    :add => '/blocks/create',
+    :remove => '/blocks/destroy',
+  }
+
+  # Provides access to the Twitter Block API.
+  #
+  # You can add and remove blocks to users using this method.
+  #
+  # <tt>action</tt> can be any of the following values:
+  # * <tt>:add</tt> - to add a block, you would use this <tt>action</tt> value
+  # * <tt>:remove</tt> - to remove a block use this.
+  #
+  # The <tt>value</tt> must be either the user screen name, integer unique user ID or Twitter::User
+  # object representation.
+  #
+  # Examples:
+  #  screen_name = 'dictionary'
+  #  client.block(:add, 'dictionary')
+  #  client.block(:remove, 'dictionary')
+  #  id = 1260061
+  #  client.block(:add, id)
+  #  client.block(:remove, id)
+  #  user = Twitter::User.find(id, client)
+  #  client.block(:add, user)
+  #  client.block(:remove, user)
+  def block(action, value)
+    raise ArgumentError, "Invalid friend action provided: #{action}" unless @@BLOCK_URIS.keys.member?(action)
+    value = value.to_i unless value.is_a?(String)
+    uri = "#{@@BLOCK_URIS[action]}/#{value}.json"
+    response = http_connect {|conn| create_http_get_request(uri) }
+    bless_model(Twitter::User.unmarshal(response.body))
+  end
+end

data/lib/vendor/twitter/lib/twitter/client/favorites.rb

@@ -0,0 +1,53 @@
+class Twitter::Client
+  # Why Twitter.com developers can't correctly document their API, I do not know!
+  @@FAVORITES_URIS = {
+    :add => '/favourings/create',
+    :remove => '/favourings/destroy',
+  }
+
+  # Provides access to the Twitter list favorites API.
+  #
+  # You can access the authenticated [Twitter] user's favorites list using this method.
+  #
+  # By default you will receive the last twenty statuses added to your favorites list.
+  # To get a previous page you can provide options to this method.  For example,
+  #  statuses = client.favorites(:page => 2)
+  # The above one-liner will get the second page of favorites for the authenticated user.
+  def favorites(options = nil)
+    def uri_suffix(opts); opts && opts[:page] ? "?page=#{opts[:page]}" : ""; end
+    uri = '/favorites.json' + uri_suffix(options)
+    response = http_connect {|conn|	create_http_get_request(uri) }
+    bless_models(Twitter::Status.unmarshal(response.body))
+  end
+
+  # Provides access to the Twitter add/remove favorite API.
+  #
+  # You can add and remove favorite status using this method.
+  #
+  # <tt>action</tt> can be any of the following values:
+  # * <tt>:add</tt> - to add a status to your favorites, you would use this <tt>action</tt> value
+  # * <tt>:remove</tt> - to remove an status from your existing favorites list use this.
+  #
+  # The <tt>value</tt> must be either the status object to add or remove or
+  # the integer unique status ID.
+  #
+  # Examples:
+  #  id = 126006103423
+  #  client.favorite(:add, id)
+  #  client.favorite(:remove, id)
+  #  status = Twitter::Status.find(id, client)
+  #  client.favorite(:add, status)
+  #  client.favorite(:remove, status)
+  def favorite(action, value)
+    raise ArgumentError, "Invalid favorite action provided: #{action}" unless @@FAVORITES_URIS.keys.member?(action)
+    value = value.to_i.to_s unless value.is_a?(String)
+    uri = "#{@@FAVORITES_URIS[action]}/#{value}.json"
+    case action
+    when :add
+      response = http_connect {|conn| create_http_post_request(uri) }
+    when :remove
+      response = http_connect {|conn| create_http_delete_request(uri) }
+    end
+    bless_model(Twitter::Status.unmarshal(response.body))
+  end
+end

data/lib/vendor/twitter/lib/twitter/client/friendship.rb

@@ -0,0 +1,35 @@
+class Twitter::Client
+  @@FRIENDSHIP_URIS = {
+    :add => '/friendships/create',
+    :remove => '/friendships/destroy',
+  }
+
+  # Provides access to the Twitter Friendship API.
+  #
+  # You can add and remove friends using this method.
+  #
+  # <tt>action</tt> can be any of the following values:
+  # * <tt>:add</tt> - to add a friend, you would use this <tt>action</tt> value
+  # * <tt>:remove</tt> - to remove an existing friend from your friends list use this.
+  #
+  # The <tt>value</tt> must be either the user to befriend or defriend's
+  # screen name, integer unique user ID or Twitter::User object representation.
+  #
+  # Examples:
+  #  screen_name = 'dictionary'
+  #  client.friend(:add, 'dictionary')
+  #  client.friend(:remove, 'dictionary')
+  #  id = 1260061
+  #  client.friend(:add, id)
+  #  client.friend(:remove, id)
+  #  user = Twitter::User.find(id, client)
+  #  client.friend(:add, user)
+  #  client.friend(:remove, user)
+  def friend(action, value)
+    raise ArgumentError, "Invalid friend action provided: #{action}" unless @@FRIENDSHIP_URIS.keys.member?(action)
+    value = value.to_i unless value.is_a?(String)
+    uri = "#{@@FRIENDSHIP_URIS[action]}/#{value}.json"
+    response = http_connect {|conn| create_http_post_request(uri) }
+    bless_model(Twitter::User.unmarshal(response.body))
+  end
+end

data/lib/vendor/twitter/lib/twitter/client/graph.rb

@@ -0,0 +1,37 @@
+class Twitter::Client
+  @@GRAPH_URIS = {
+    :friends => '/friends/ids',
+    :followers => '/followers/ids',
+  }
+
+  # Provides access to the Twitter Social Graphing API.
+  #
+  # You can retrieve the full graph of a user's friends or followers in one method call.
+  #
+  # <tt>action</tt> can be any of the following values:
+  # * <tt>:friends</tt> - retrieves ids of all friends of a given user.
+  # * <tt>:followers</tt> - retrieves ids of all followers of a given user.
+  #
+  # The <tt>value</tt> must be either the user screen name, integer unique user ID or Twitter::User
+  # object representation.
+  #
+  # Examples:
+  #  screen_name = 'dictionary'
+  #  client.graph(:friends, 'dictionary')
+  #  client.graph(:followers, 'dictionary')
+  #  id = 1260061
+  #  client.graph(:friends, id)
+  #  client.graph(:followers, id)
+  #  user = Twitter::User.find(id, client)
+  #  client.graph(:friends, user)
+  #  client.graph(:followers, user)
+  def graph(action, value = nil)
+    raise ArgumentError, "Invalid friend action provided: #{action}" unless @@GRAPH_URIS.keys.member?(action)
+    id = value.to_i unless value.nil? || value.is_a?(String)
+    id ||= value
+    id ||= @login
+    uri = "#{@@GRAPH_URIS[action]}.json"
+    response = http_connect {|conn| create_http_get_request(uri, :id => id) }
+    JSON.parse(response.body)
+  end
+end

data/lib/vendor/twitter/lib/twitter/client/messaging.rb

@@ -0,0 +1,79 @@
+class Twitter::Client
+
+  @@MESSAGING_URIS = {
+    :received => '/direct_messages.json',
+    :sent => '/direct_messages/sent.json',
+    :post => '/direct_messages/new.json',
+    :delete => '/direct_messages/destroy',
+  }
+
+  # Provides access to Twitter's Messaging API for received and
+  # sent direct messages.
+  #
+  # Example:
+  #  received_messages = @twitter.messages(:received)
+  #
+  # An <tt>ArgumentError</tt> will be raised if an invalid <tt>action</tt>
+  # is given.  Valid actions are:
+  # * +:received+
+  # * +:sent+
+  def messages(action, options = {})
+    raise ArgumentError, "Invalid messaging action: #{action}" unless [:sent, :received].member?(action)
+    uri = @@MESSAGING_URIS[action]
+    response = http_connect {|conn|	create_http_get_request(uri, options) }
+    bless_models(Twitter::Message.unmarshal(response.body))
+  end
+
+  # Provides access to Twitter's Messaging API for sending and deleting
+  # direct messages to other users.
+  #
+  # <tt>action</tt> can be:
+  # * <tt>:post</tt> - to send a new direct message, <tt>value</tt>, to <tt>user</tt> given.
+  # * <tt>:delete</tt> - to delete direct message with message ID <tt>value</tt>.
+  #
+  # <tt>value</tt> should be:
+  # * <tt>String</tt> when action is <tt>:post</tt>.  Will be the message text sent to given <tt>user</tt>.
+  # * <tt>Integer</tt> or <tt>Twitter::Message</tt> object when action is <tt>:delete</tt>.  Will refer to the unique message ID to delete.  When passing in an instance of <tt>Twitter::Message</tt> that Status will be
+  #
+  # <tt>user</tt> should be:
+  # * <tt>Twitter::User</tt>, <tt>Integer</tt> or <tt>String</tt> object when <tt>action</tt> is <tt>:post</tt>.  The <tt>Integer</tt> must be the unique ID of the Twitter user you wish to send the direct message to and any <tt>String</tt>s passed in must be the screen name of the user you wish to send the direct message to.
+  # * totally ignore when <tt>action</tt> is <tt>:delete</tt>.  It has no purpose in this use case scenario.
+  #
+  # Examples:
+  # The example below sends the message text 'Are you coming over at 6pm for the BBQ tonight?' to user with screen name 'myfriendslogin'...
+  #  @twitter.message(:post, 'Are you coming over at 6pm for the BBQ tonight?', 'myfriendslogin')
+  # The example below sends the same message text as above to user with unique integer ID of 1234567890...
+  # the example below sends the same message text as above to user represented by <tt>user</tt> object instance of <tt>Twitter::User</tt>...
+  #  @twitter.message(:post, 'Are you coming over at 6pm for the BBQ tonight?', user)
+  #  message = @twitter.message(:post, 'Are you coming over at 6pm for the BBQ tonight?', 1234567890)
+  # the example below delete's the message send directly above to user with unique ID 1234567890...
+  #  @twitter.message(:delete, message)
+  # Or the following can also be done...
+  #  @twitter.message(:delete, message.id)
+  #
+  # In both scenarios (<tt>action</tt> is <tt>:post</tt> or
+  # <tt>:delete</tt>) a blessed <tt>Twitter::Message</tt> object is
+  # returned that represents the newly posted or newly deleted message.
+  #
+  # An <tt>ArgumentError</tt> will be raised if an invalid <tt>action</tt>
+  # is given.  Valid actions are:
+  # * +:post+
+  # * +:delete+
+  #
+  # An <tt>ArgumentError</tt> is also raised when no user argument is
+  # supplied when <tt>action</tt> is +:post+.
+  def message(action, value, user = nil)
+    raise ArgumentError, "Invalid messaging action: #{action}" unless [:post, :delete].member?(action)
+    raise ArgumentError, "User argument must be supplied for :post case" if action.eql?(:post) and user.nil?
+    uri = @@MESSAGING_URIS[action]
+    user = user.to_i if user and user.is_a?(Twitter::User)
+    case action
+    when :post
+      response = http_connect({:text => value, :user => user, :source => @@config.source}.to_http_str) {|conn| create_http_post_request(uri) }
+    when :delete
+      response = http_connect {|conn| create_http_delete_request(uri, :id => value.to_i) }
+    end
+    message = Twitter::Message.unmarshal(response.body)
+    bless_model(message)
+  end
+end