ifttt-twitter 2.1.1

data/lib/twitter/creatable.rb

@@ -0,0 +1,14 @@
+require 'time'
+
+module Twitter
+  module Creatable
+
+    # Time when the object was created on Twitter
+    #
+    # @return [Time]
+    def created_at
+      @created_at ||= Time.parse(@attrs['created_at']) unless @attrs['created_at'].nil?
+    end
+
+  end
+end

data/lib/twitter/cursor.rb

@@ -0,0 +1,44 @@
+require 'active_support/core_ext/kernel/singleton_class'
+require 'twitter/base'
+
+module Twitter
+  class Cursor < Twitter::Base
+    attr_reader :collection
+    lazy_attr_reader :next_cursor, :previous_cursor
+    alias :next :next_cursor
+    alias :previous :previous_cursor
+
+    # Initializes a new Cursor object
+    #
+    # @param attrs [Hash]
+    # @params method [String, Symbol] The name of the method to return the collection
+    # @params klass [Class] The class to instantiate object in the collection
+    # @return [Twitter::Cursor]
+    def initialize(attrs, method, klass=nil)
+      super(attrs)
+      @collection = Array(attrs[method.to_s]).map do |item|
+        if klass
+          klass.new(item)
+        else
+          item
+        end
+      end
+      singleton_class.class_eval do
+        alias_method method.to_sym, :collection
+      end
+    end
+
+    # @return [Boolean]
+    def first?
+      previous_cursor.zero?
+    end
+    alias :first :first?
+
+    # @return [Boolean]
+    def last?
+      next_cursor.zero?
+    end
+    alias :last :last?
+
+  end
+end

data/lib/twitter/direct_message.rb

@@ -0,0 +1,27 @@
+require 'twitter/base'
+require 'twitter/creatable'
+require 'twitter/user'
+
+module Twitter
+  class DirectMessage < Twitter::Base
+    include Twitter::Creatable
+    lazy_attr_reader :id, :text
+
+    # @param other [Twiter::DirectMessage]
+    # @return [Boolean]
+    def ==(other)
+      super || (other.class == self.class && other.id == self.id)
+    end
+
+    # @return [Twitter::User]
+    def recipient
+      @recipient ||= Twitter::User.new(@attrs['recipient']) unless @attrs['recipient'].nil?
+    end
+
+    # @return [Twitter::User]
+    def sender
+      @sender ||= Twitter::User.new(@attrs['sender']) unless @attrs['sender'].nil?
+    end
+
+  end
+end

data/lib/twitter/error.rb

@@ -0,0 +1,37 @@
+module Twitter
+  # Custom error class for rescuing from all Twitter errors
+  class Error < StandardError
+    attr_reader :http_headers
+
+    # Initializes a new Error object
+    #
+    # @param message [String]
+    # @param http_headers [Hash]
+    # @return [Twitter::Error]
+    def initialize(message, http_headers)
+      @http_headers = Hash[http_headers]
+      super(message)
+    end
+
+    # @return [Time]
+    def ratelimit_reset
+      Time.at(@http_headers.values_at('x-ratelimit-reset', 'X-RateLimit-Reset').detect{|value| value}.to_i)
+    end
+
+    # @return [Integer]
+    def ratelimit_limit
+      @http_headers.values_at('x-ratelimit-limit', 'X-RateLimit-Limit').detect{|value| value}.to_i
+    end
+
+    # @return [Integer]
+    def ratelimit_remaining
+      @http_headers.values_at('x-ratelimit-remaining', 'X-RateLimit-Remaining').detect{|value| value}.to_i
+    end
+
+    # @return [Integer]
+    def retry_after
+      [(ratelimit_reset - Time.now).ceil, 0].max
+    end
+
+  end
+end

data/lib/twitter/error/bad_gateway.rb

@@ -0,0 +1,7 @@
+require 'twitter/error/server_error'
+
+module Twitter
+  # Raised when Twitter returns the HTTP status code 502
+  class Error::BadGateway < Twitter::Error::ServerError
+  end
+end

data/lib/twitter/error/bad_request.rb

@@ -0,0 +1,7 @@
+require 'twitter/error/client_error'
+
+module Twitter
+  # Raised when Twitter returns the HTTP status code 400
+  class Error::BadRequest < Twitter::Error::ClientError
+  end
+end

data/lib/twitter/error/client_error.rb

@@ -0,0 +1,7 @@
+require 'twitter/error'
+
+module Twitter
+  # Raised when Twitter returns a 4xx HTTP status code
+  class Error::ClientError < Twitter::Error
+  end
+end

data/lib/twitter/error/enhance_your_calm.rb

@@ -0,0 +1,13 @@
+require 'twitter/error/client_error'
+
+module Twitter
+  # Raised when Twitter returns the HTTP status code 420
+  class Error::EnhanceYourCalm < Twitter::Error::ClientError
+    # The number of seconds your application should wait before requesting date from the Search API again
+    #
+    # @see http://dev.twitter.com/pages/rate-limiting
+    def retry_after
+      @http_headers.values_at('retry-after', 'Retry-After').detect{|value| value }.to_i
+    end
+  end
+end

data/lib/twitter/error/forbidden.rb

@@ -0,0 +1,7 @@
+require 'twitter/error/client_error'
+
+module Twitter
+  # Raised when Twitter returns the HTTP status code 403
+  class Error::Forbidden < Twitter::Error::ClientError
+  end
+end

data/lib/twitter/error/internal_server_error.rb

@@ -0,0 +1,7 @@
+require 'twitter/error/server_error'
+
+module Twitter
+  # Raised when Twitter returns the HTTP status code 500
+  class Error::InternalServerError < Twitter::Error::ServerError
+  end
+end

data/lib/twitter/error/not_acceptable.rb

@@ -0,0 +1,7 @@
+require 'twitter/error/client_error'
+
+module Twitter
+  # Raised when Twitter returns the HTTP status code 406
+  class Error::NotAcceptable < Twitter::Error::ClientError
+  end
+end

data/lib/twitter/error/not_found.rb

@@ -0,0 +1,7 @@
+require 'twitter/error/client_error'
+
+module Twitter
+  # Raised when Twitter returns the HTTP status code 404
+  class Error::NotFound < Twitter::Error::ClientError
+  end
+end

data/lib/twitter/error/server_error.rb

@@ -0,0 +1,7 @@
+require 'twitter/error'
+
+module Twitter
+  # Raised when Twitter returns a 5xx HTTP status code
+  class Error::ServerError < Twitter::Error
+  end
+end

data/lib/twitter/error/service_unavailable.rb

@@ -0,0 +1,7 @@
+require 'twitter/error/server_error'
+
+module Twitter
+  # Raised when Twitter returns the HTTP status code 503
+  class Error::ServiceUnavailable < Twitter::Error::ServerError
+  end
+end

data/lib/twitter/error/unauthorized.rb

@@ -0,0 +1,7 @@
+require 'twitter/error/client_error'
+
+module Twitter
+  # Raised when Twitter returns the HTTP status code 401
+  class Error::Unauthorized < Twitter::Error::ClientError
+  end
+end

data/lib/twitter/favorite.rb

@@ -0,0 +1,28 @@
+require 'twitter/action'
+require 'twitter/status'
+require 'twitter/user'
+
+module Twitter
+  class Favorite < Twitter::Action
+    lazy_attr_reader :target_objects
+
+    # A collection of users who favorited a status
+    #
+    # @return [Array<Twitter::User>]
+    def sources
+      @sources = Array(@attrs['sources']).map do |user|
+        Twitter::User.new(user)
+      end
+    end
+
+    # A collection containing the favorited status
+    #
+    # @return [Array<Twitter::Status>]
+    def targets
+      @targets = Array(@attrs['targets']).map do |status|
+        Twitter::Status.new(status)
+      end
+    end
+
+  end
+end

data/lib/twitter/follow.rb

@@ -0,0 +1,27 @@
+require 'twitter/action'
+require 'twitter/user'
+
+module Twitter
+  class Follow < Twitter::Action
+    lazy_attr_reader :target_objects
+
+    # A collection of users who followed a user
+    #
+    # @return [Array<Twitter::User>]
+    def sources
+      @sources = Array(@attrs['sources']).map do |user|
+        Twitter::User.new(user)
+      end
+    end
+
+    # A collection containing the followed user
+    #
+    # @return [Array<Twitter::User>]
+    def targets
+      @targets = Array(@attrs['targets']).map do |user|
+        Twitter::User.new(user)
+      end
+    end
+
+  end
+end

data/lib/twitter/geo_factory.rb

@@ -0,0 +1,22 @@
+require 'twitter/point'
+require 'twitter/polygon'
+
+module Twitter
+  class GeoFactory
+
+    # Instantiates a new geo object
+    #
+    # @param attrs [Hash]
+    # @raise [ArgumentError] Error raised when supplied argument is missing a 'type' key.
+    # @return [Twitter::Point, Twitter::Polygon]
+    def self.new(geo={})
+      type = geo.delete('type')
+      if type
+        Twitter.const_get(type.capitalize.to_sym).new(geo)
+      else
+        raise ArgumentError, "argument must have a 'type' key"
+      end
+    end
+
+  end
+end

data/lib/twitter/language.rb

@@ -0,0 +1,7 @@
+require 'twitter/base'
+
+module Twitter
+  class Language < Twitter::Base
+    lazy_attr_reader :code, :name, :status
+  end
+end

data/lib/twitter/list.rb

@@ -0,0 +1,22 @@
+require 'twitter/base'
+require 'twitter/user'
+
+module Twitter
+  class List < Twitter::Base
+    lazy_attr_reader :description, :following, :full_name, :id, :member_count,
+      :mode, :name, :slug, :subscriber_count, :uri
+    alias :following? :following
+
+    # @param other [Twitter::List]
+    # @return [Boolean]
+    def ==(other)
+      super || (other.class == self.class && other.id == self.id)
+    end
+
+    # @return [Twitter::User]
+    def user
+      @user ||= Twitter::User.new(@attrs['user']) unless @attrs['user'].nil?
+    end
+
+  end
+end

data/lib/twitter/list_member_added.rb

@@ -0,0 +1,36 @@
+require 'twitter/action'
+require 'twitter/list'
+require 'twitter/user'
+
+module Twitter
+  class ListMemberAdded < Twitter::Action
+    lazy_attr_reader :target_objects
+
+    # A collection of users who added to the list
+    #
+    # @return [Array<Twitter::User>]
+    def sources
+      @sources = Array(@attrs['sources']).map do |user|
+        Twitter::User.new(user)
+      end
+    end
+
+    # A collection of lists that were added to
+    #
+    # @return [Array<Twitter::List>]
+    def target_objects
+      @target_objects = Array(@attrs['target_objects']).map do |list|
+        Twitter::List.new(list)
+      end
+    end
+
+    # A collection of users who were added to the list
+    #
+    # @return [Array<Twitter::User>]
+    def targets
+      @targets = Array(@attrs['targets']).map do |user|
+        Twitter::User.new(user)
+      end
+    end
+  end
+end

data/lib/twitter/media_factory.rb

@@ -0,0 +1,21 @@
+require 'twitter/photo'
+
+module Twitter
+  class MediaFactory
+
+    # Instantiates a new media object
+    #
+    # @param attrs [Hash]
+    # @raise [ArgumentError] Error raised when supplied argument is missing a 'type' key.
+    # @return [Twitter::Photo]
+    def self.new(media={})
+      type = media.delete('type')
+      if type
+        Twitter.const_get(type.capitalize.to_sym).new(media)
+      else
+        raise ArgumentError, "argument must have a 'type' key"
+      end
+    end
+
+  end
+end

data/lib/twitter/mention.rb

@@ -0,0 +1,43 @@
+require 'twitter/action'
+require 'twitter/status'
+require 'twitter/user'
+
+module Twitter
+  class Mention < Twitter::Action
+
+    # A collection of users who mentioned a user
+    #
+    # @return [Array<Twitter::User>]
+    def sources
+      @sources = Array(@attrs['sources']).map do |user|
+        Twitter::User.new(user)
+      end
+    end
+
+    # The user who mentioned a user
+    #
+    # @return [Twitter::User]
+    def source
+      @source = sources.first
+    end
+
+    # A collection of statuses that mention a user
+    #
+    # @return [Array<Twitter::Status>]
+    def target_objects
+      @target_objects = Array(@attrs['target_objects']).map do |status|
+        Twitter::Status.new(status)
+      end
+    end
+
+    # A collection containing the mentioned user
+    #
+    # @return [Array<Twitter::User>]
+    def targets
+      @targets = Array(@attrs['targets']).map do |user|
+        Twitter::User.new(user)
+      end
+    end
+
+  end
+end