ifttt-twitter 2.1.1

data/lib/twitter/client/timelines.rb

@@ -0,0 +1,265 @@
+require 'twitter/core_ext/hash'
+require 'twitter/status'
+
+module Twitter
+  class Client
+    # Defines methods related to timelines
+    module Timelines
+
+      # Returns the 20 most recent statuses, including retweets if they exist, posted by the authenticating user and the users they follow
+      #
+      # @see https://dev.twitter.com/docs/api/1/get/statuses/home_timeline
+      # @note This method can only return up to 800 statuses, including retweets.
+      # @rate_limited Yes
+      # @requires_authentication Yes
+      # @param options [Hash] A customizable set of options.
+      # @option options [Integer] :since_id Returns results with an ID greater than (that is, more recent than) the specified ID.
+      # @option options [Integer] :max_id Returns results with an ID less than (that is, older than) or equal to the specified ID.
+      # @option options [Integer] :count Specifies the number of records to retrieve. Must be less than or equal to 200.
+      # @option options [Integer] :page Specifies the page of results to retrieve.
+      # @option options [Boolean, String, Integer] :trim_user Each tweet returned in a timeline will include a user object with only the author's numerical ID when set to true, 't' or 1.
+      # @option options [Boolean, String, Integer] :include_entities Include {https://dev.twitter.com/docs/tweet-entities Tweet Entities} when set to true, 't' or 1.
+      # @option options [Boolean, String, Integer] :exclude_replies This parameter will prevent replies from appearing in the returned timeline. Using exclude_replies with the count parameter will mean you will receive up-to count tweets — this is because the count parameter retrieves that many tweets before filtering out retweets and replies.
+      # @return [Array<Twitter::Status>]
+      # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @example Return the 20 most recent statuses, including retweets if they exist, posted by the authenticating user and the users they follow
+      #   Twitter.home_timeline
+      def home_timeline(options={})
+        get("/1/statuses/home_timeline.json", options).map do |status|
+          Twitter::Status.new(status)
+        end
+      end
+
+      # Returns the 20 most recent mentions (statuses containing @username) for the authenticating user
+      #
+      # @see https://dev.twitter.com/docs/api/1/get/statuses/mentions
+      # @note This method can only return up to 800 statuses. If the :include_rts option is set, only 800 statuses, including retweets if they exist, can be returned.
+      # @rate_limited Yes
+      # @requires_authentication Yes
+      # @param options [Hash] A customizable set of options.
+      # @option options [Integer] :since_id Returns results with an ID greater than (that is, more recent than) the specified ID.
+      # @option options [Integer] :max_id Returns results with an ID less than (that is, older than) or equal to the specified ID.
+      # @option options [Integer] :count Specifies the number of records to retrieve. Must be less than or equal to 200.
+      # @option options [Integer] :page Specifies the page of results to retrieve.
+      # @option options [Boolean, String, Integer] :trim_user Each tweet returned in a timeline will include a user object with only the author's numerical ID when set to true, 't' or 1.
+      # @option options [Boolean, String, Integer] :include_rts The timeline will contain native retweets (if they exist) in addition to the standard stream of tweets when set to true, 't' or 1.
+      # @option options [Boolean, String, Integer] :include_entities Include {https://dev.twitter.com/docs/tweet-entities Tweet Entities} when set to true, 't' or 1.
+      # @return [Array<Twitter::Status>]
+      # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @example Return the 20 most recent mentions (statuses containing @username) for the authenticating user
+      #   Twitter.mentions
+      def mentions(options={})
+        get("/1/statuses/mentions.json", options).map do |status|
+          Twitter::Status.new(status)
+        end
+      end
+
+      # Returns the 20 most recent statuses, including retweets if they exist, from non-protected users
+      #
+      # @see https://dev.twitter.com/docs/api/1/get/statuses/public_timeline
+      # @note The public timeline is cached for 60 seconds. Requesting more frequently than that will not return any more data, and will count against your rate limit usage.
+      # @rate_limited Yes
+      # @requires_authentication No
+      # @param options [Hash] A customizable set of options.
+      # @option options [Boolean, String, Integer] :trim_user Each tweet returned in a timeline will include a user object with only the author's numerical ID when set to true, 't' or 1.
+      # @option options [Boolean, String, Integer] :include_entities Include {https://dev.twitter.com/docs/tweet-entities Tweet Entities} when set to true, 't' or 1.
+      # @return [Array<Twitter::Status>]
+      # @example Return the 20 most recent statuses, including retweets if they exist, from non-protected users
+      #   Twitter.public_timeline
+      def public_timeline(options={})
+        get("/1/statuses/public_timeline.json", options).map do |status|
+          Twitter::Status.new(status)
+        end
+      end
+
+      # Returns the 20 most recent retweets posted by the specified user
+      #
+      # @see https://dev.twitter.com/docs/api/1/get/statuses/retweeted_by_me
+      # @see https://dev.twitter.com/docs/api/1/get/statuses/retweeted_by_user
+      # @rate_limited Yes
+      # @requires_authentication Supported
+      # @overload retweeted_by(options={})
+      #   @param options [Hash] A customizable set of options.
+      #   @option options [Integer] :since_id Returns results with an ID greater than (that is, more recent than) the specified ID.
+      #   @option options [Integer] :max_id Returns results with an ID less than (that is, older than) or equal to the specified ID.
+      #   @option options [Integer] :count Specifies the number of records to retrieve. Must be less than or equal to 200.
+      #   @option options [Integer] :page Specifies the page of results to retrieve.
+      #   @option options [Boolean, String, Integer] :trim_user Each tweet returned in a timeline will include a user object with only the author's numerical ID when set to true, 't' or 1.
+      #   @option options [Boolean, String, Integer] :include_entities Include {https://dev.twitter.com/docs/tweet-entities Tweet Entities} when set to true, 't' or 1.
+      #   @return [Array<Twitter::Status>]
+      #   @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      #   @example Return the 20 most recent retweets posted by the authenticating user
+      #     Twitter.retweeted_by("sferik")
+      # @overload retweeted_by(user, options={})
+      #   @param user [Integer, String] A Twitter user ID or screen name.
+      #   @param options [Hash] A customizable set of options.
+      #   @option options [Integer] :since_id Returns results with an ID greater than (that is, more recent than) the specified ID.
+      #   @option options [Integer] :max_id Returns results with an ID less than (that is, older than) or equal to the specified ID.
+      #   @option options [Integer] :count Specifies the number of records to retrieve. Must be less than or equal to 200.
+      #   @option options [Integer] :page Specifies the page of results to retrieve.
+      #   @option options [Boolean, String, Integer] :trim_user Each tweet returned in a timeline will include a user object with only the author's numerical ID when set to true, 't' or 1.
+      #   @option options [Boolean, String, Integer] :include_entities Include {https://dev.twitter.com/docs/tweet-entities Tweet Entities} when set to true, 't' or 1.
+      #   @return [Array<Twitter::Status>]
+      #   @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      #   @example Return the 20 most recent retweets posted by the authenticating user
+      #     Twitter.retweeted_by
+      def retweeted_by(*args)
+        options = args.last.is_a?(Hash) ? args.pop : {}
+        if user = args.pop
+          options.merge_user!(user)
+          get("/1/statuses/retweeted_by_user.json", options)
+        else
+          get("/1/statuses/retweeted_by_me.json", options)
+        end.map do |status|
+          Twitter::Status.new(status)
+        end
+      end
+
+      # Returns the 20 most recent retweets posted by users the specified user follows
+      #
+      # @see https://dev.twitter.com/docs/api/1/get/statuses/retweeted_to_me
+      # @see https://dev.twitter.com/docs/api/1/get/statuses/retweeted_to_user
+      # @rate_limited Yes
+      # @requires_authentication Supported
+      # @overload retweeted_to(options={})
+      #   @param options [Hash] A customizable set of options.
+      #   @option options [Integer] :since_id Returns results with an ID greater than (that is, more recent than) the specified ID.
+      #   @option options [Integer] :max_id Returns results with an ID less than (that is, older than) or equal to the specified ID.
+      #   @option options [Integer] :count Specifies the number of records to retrieve. Must be less than or equal to 200.
+      #   @option options [Integer] :page Specifies the page of results to retrieve.
+      #   @option options [Boolean, String, Integer] :trim_user Each tweet returned in a timeline will include a user object with only the author's numerical ID when set to true, 't' or 1.
+      #   @option options [Boolean, String, Integer] :include_entities Include {https://dev.twitter.com/docs/tweet-entities Tweet Entities} when set to true, 't' or 1.
+      #   @return [Array<Twitter::Status>]
+      #   @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      #   @example Return the 20 most recent retweets posted by users followed by the authenticating user
+      #     Twitter.retweeted_to
+      # @overload retweeted_to(user, options={})
+      #   @param user [Integer, String] A Twitter user ID or screen name.
+      #   @param options [Hash] A customizable set of options.
+      #   @option options [Integer] :since_id Returns results with an ID greater than (that is, more recent than) the specified ID.
+      #   @option options [Integer] :max_id Returns results with an ID less than (that is, older than) or equal to the specified ID.
+      #   @option options [Integer] :count Specifies the number of records to retrieve. Must be less than or equal to 200.
+      #   @option options [Integer] :page Specifies the page of results to retrieve.
+      #   @option options [Boolean, String, Integer] :trim_user Each tweet returned in a timeline will include a user object with only the author's numerical ID when set to true, 't' or 1.
+      #   @option options [Boolean, String, Integer] :include_entities Include {https://dev.twitter.com/docs/tweet-entities Tweet Entities} when set to true, 't' or 1.
+      #   @return [Array<Twitter::Status>]
+      #   @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      #   @example Return the 20 most recent retweets posted by users followed by the authenticating user
+      #     Twitter.retweeted_to("sferik")
+      def retweeted_to(*args)
+        options = args.last.is_a?(Hash) ? args.pop : {}
+        if user = args.pop
+          options.merge_user!(user)
+          get("/1/statuses/retweeted_to_user.json", options)
+        else
+          get("/1/statuses/retweeted_to_me.json", options)
+        end.map do |status|
+          Twitter::Status.new(status)
+        end
+      end
+
+      # Returns the 20 most recent tweets of the authenticated user that have been retweeted by others
+      #
+      # @see https://dev.twitter.com/docs/api/1/get/statuses/retweets_of_me
+      # @rate_limited Yes
+      # @requires_authentication Yes
+      # @param options [Hash] A customizable set of options.
+      # @option options [Integer] :since_id Returns results with an ID greater than (that is, more recent than) the specified ID.
+      # @option options [Integer] :max_id Returns results with an ID less than (that is, older than) or equal to the specified ID.
+      # @option options [Integer] :count Specifies the number of records to retrieve. Must be less than or equal to 200.
+      # @option options [Integer] :page Specifies the page of results to retrieve.
+      # @option options [Boolean, String, Integer] :trim_user Each tweet returned in a timeline will include a user object with only the author's numerical ID when set to true, 't' or 1.
+      # @option options [Boolean, String, Integer] :include_entities Include {https://dev.twitter.com/docs/tweet-entities Tweet Entities} when set to true, 't' or 1.
+      # @return [Array<Twitter::Status>]
+      # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @example Return the 20 most recent tweets of the authenticated user that have been retweeted by others
+      #   Twitter.retweets_of_me
+      def retweets_of_me(options={})
+        get("/1/statuses/retweets_of_me.json", options).map do |status|
+          Twitter::Status.new(status)
+        end
+      end
+
+      # Returns the 20 most recent statuses posted by the specified user
+      #
+      # @see https://dev.twitter.com/docs/api/1/get/statuses/user_timeline
+      # @note This method can only return up to 3200 statuses. If the :include_rts option is set, only 3200 statuses, including retweets if they exist, can be returned.
+      # @rate_limited Yes
+      # @requires_authentication No unless the user whose timeline you're trying to view is protected
+      # @overload user_timeline(user, options={})
+      #   @param user [Integer, String] A Twitter user ID or screen name.
+      #   @param options [Hash] A customizable set of options.
+      #   @option options [Integer] :since_id Returns results with an ID greater than (that is, more recent than) the specified ID.
+      #   @option options [Integer] :max_id Returns results with an ID less than (that is, older than) or equal to the specified ID.
+      #   @option options [Integer] :count Specifies the number of records to retrieve. Must be less than or equal to 200.
+      #   @option options [Integer] :page Specifies the page of results to retrieve.
+      #   @option options [Boolean, String, Integer] :trim_user Each tweet returned in a timeline will include a user object with only the author's numerical ID when set to true, 't' or 1.
+      #   @option options [Boolean, String, Integer] :include_rts The timeline will contain native retweets (if they exist) in addition to the standard stream of tweets when set to true, 't' or 1.
+      #   @option options [Boolean, String, Integer] :include_entities Include {https://dev.twitter.com/docs/tweet-entities Tweet Entities} when set to true, 't' or 1.
+      #   @option options [Boolean, String, Integer] :exclude_replies This parameter will prevent replies from appearing in the returned timeline. Using exclude_replies with the count parameter will mean you will receive up-to count tweets — this is because the count parameter retrieves that many tweets before filtering out retweets and replies.
+      #   @return [Array<Twitter::Status>]
+      #   @example Return the 20 most recent statuses posted by @sferik
+      #     Twitter.user_timeline("sferik")
+      def user_timeline(*args)
+        options = args.last.is_a?(Hash) ? args.pop : {}
+        if user = args.pop
+          options.merge_user!(user)
+        end
+        get("/1/statuses/user_timeline.json", options).map do |status|
+          Twitter::Status.new(status)
+        end
+      end
+
+      # Returns the 20 most recent images posted by the specified user
+      #
+      # @see https://support.twitter.com/articles/20169409
+      # @note This method can only return up to the 100 most recent images.
+      # @note Images will not be returned from tweets posted before January 1, 2010.
+      # @rate_limited Yes
+      # @requires_authentication No unless the user whose timeline you're trying to view is protected
+      # @overload media_timeline(user, options={})
+      #   @param user [Integer, String] A Twitter user ID or screen name.
+      #   @param options [Hash] A customizable set of options.
+      #   @option options [Integer] :count Specifies the number of records to retrieve. Must be less than or equal to 200.
+      #   @option options [Integer] :page Specifies the page of results to retrieve.
+      #   @option options [Boolean] :filter Include possibly sensitive media when set to false, 'f' or 0.
+      #   @option options [Boolean, String, Integer] :include_entities Include {https://dev.twitter.com/docs/tweet-entities Tweet Entities} when set to true, 't' or 1.
+      #   @return [Array<Twitter::Status>]
+      #   @example Return the 20 most recent statuses posted by @sferik
+      #     Twitter.media_timeline("sferik")
+      def media_timeline(*args)
+        options = args.last.is_a?(Hash) ? args.pop : {}
+        if user = args.pop
+          options.merge_user!(user)
+        end
+        get("/1/statuses/media_timeline.json", options).map do |status|
+          Twitter::Status.new(status)
+        end
+      end
+
+      # Returns the 20 most recent statuses from the authenticating user's network
+      #
+      # @note Undocumented
+      # @rate_limited Yes
+      # @requires_authentication Yes
+      # @param options [Hash] A customizable set of options.
+      # @option options [Integer] :since_id Returns results with an ID greater than (that is, more recent than) the specified ID.
+      # @option options [Integer] :max_id Returns results with an ID less than (that is, older than) or equal to the specified ID.
+      # @option options [Integer] :count Specifies the number of records to retrieve. Must be less than or equal to 200.
+      # @option options [Integer] :page Specifies the page of results to retrieve.
+      # @option options [Boolean, String, Integer] :trim_user Each tweet returned in a timeline will include a user object with only the author's numerical ID when set to true, 't' or 1.
+      # @option options [Boolean, String, Integer] :include_entities Include {https://dev.twitter.com/docs/tweet-entities Tweet Entities} when set to true, 't' or 1.
+      # @option options [Boolean, String, Integer] :exclude_replies This parameter will prevent replies from appearing in the returned timeline. Using exclude_replies with the count parameter will mean you will receive up-to count tweets — this is because the count parameter retrieves that many tweets before filtering out retweets and replies.
+      # @return [Array<Twitter::Status>]
+      # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @example Return the 20 most recent statuses from the authenticating user's network
+      #   Twitter.network_timeline
+      def network_timeline(options={})
+        get("/i/statuses/network_timeline.json", options).map do |status|
+          Twitter::Status.new(status)
+        end
+      end
+
+    end
+  end
+end

data/lib/twitter/client/trends.rb

@@ -0,0 +1,55 @@
+require 'twitter/trend'
+
+module Twitter
+  class Client
+    # Defines methods related to global trends
+    # @see Twitter::Client::LocalTrends
+    module Trends
+
+      # Returns the top 20 trending topics for each hour in a given day
+      #
+      # @see https://dev.twitter.com/docs/api/1/get/trends/daily
+      # @rate_limited Yes
+      # @requires_authentication No
+      # @param date [Date] The start date for the report. A 404 error will be thrown if the date is older than the available search index (7-10 days). Dates in the future will be forced to the current date.
+      # @param options [Hash] A customizable set of options.
+      # @option options [String] :exclude Setting this equal to 'hashtags' will remove all hashtags from the trends list.
+      # @return [Hash]
+      # @example Return the top 20 trending topics for each hour of October 24, 2010
+      #   Twitter.trends_daily(Date.parse("2010-10-24"))
+      def trends_daily(date=Date.today, options={})
+        trends = {}
+        get("/1/trends/daily.json", options.merge(:date => date.strftime('%Y-%m-%d')))['trends'].each do |key, value|
+          trends[key] = []
+          value.each do |trend|
+            trends[key] << Twitter::Trend.new(trend)
+          end
+        end
+        trends
+      end
+
+      # Returns the top 30 trending topics for each day in a given week
+      #
+      # @see https://dev.twitter.com/docs/api/1/get/trends/weekly
+      # @rate_limited Yes
+      # @requires_authentication No
+      # @param date [Date] The start date for the report. A 404 error will be thrown if the date is older than the available search index (7-10 days). Dates in the future will be forced to the current date.
+      # @param options [Hash] A customizable set of options.
+      # @option options [String] :exclude Setting this equal to 'hashtags' will remove all hashtags from the trends list.
+      # @return [Hash]
+      # @example Return the top ten topics that are currently trending on Twitter
+      #   Twitter.trends_weekly(Date.parse("2010-10-24"))
+      def trends_weekly(date=Date.today, options={})
+        trends = {}
+        get("/1/trends/weekly.json", options.merge(:date => date.strftime('%Y-%m-%d')))['trends'].each do |key, value|
+          trends[key] = []
+          value.each do |trend|
+            trends[key] << Twitter::Trend.new(trend)
+          end
+        end
+        trends
+      end
+
+    end
+  end
+end

data/lib/twitter/client/tweets.rb

@@ -0,0 +1,191 @@
+require 'twitter/status'
+require 'twitter/oembed'
+
+module Twitter
+  class Client
+    # Defines methods related to tweets
+    module Tweets
+
+      # Show up to 100 users who retweeted the status
+      #
+      # @see https://dev.twitter.com/docs/api/1/get/statuses/:id/retweeted_by
+      # @see https://dev.twitter.com/docs/api/1/get/statuses/:id/retweeted_by/ids
+      # @rate_limited Yes
+      # @requires_authentication Yes
+      # @param id [Integer] The numerical ID of the desired status.
+      # @param options [Hash] A customizable set of options.
+      # @option options [Integer] :count Specifies the number of records to retrieve. Must be less than or equal to 100.
+      # @option options [Integer] :page Specifies the page of results to retrieve.
+      # @option options [Boolean, String, Integer] :trim_user Each tweet returned in a timeline will include a user object with only the author's numerical ID when set to true, 't' or 1.
+      # @option options [Boolean, String, Integer] :include_entities Include {https://dev.twitter.com/docs/tweet-entities Tweet Entities} when set to true, 't' or 1.
+      # @option options [Boolean] :ids_only ('false') Only return user ids instead of full user objects.
+      # @return [Array]
+      # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @example Show up to 100 users who retweeted the status with the ID 28561922516
+      #   Twitter.retweeters_of(28561922516)
+      def retweeters_of(id, options={})
+        if ids_only = !!options.delete(:ids_only)
+          get("/1/statuses/#{id}/retweeted_by/ids.json", options)
+        else
+          get("/1/statuses/#{id}/retweeted_by.json", options).map do |user|
+            Twitter::User.new(user)
+          end
+        end
+      end
+
+      # Returns up to 100 of the first retweets of a given tweet
+      #
+      # @see https://dev.twitter.com/docs/api/1/get/statuses/retweets/:id
+      # @rate_limited Yes
+      # @requires_authentication Yes
+      # @param id [Integer] The numerical ID of the desired status.
+      # @param options [Hash] A customizable set of options.
+      # @option options [Integer] :count Specifies the number of records to retrieve. Must be less than or equal to 100.
+      # @option options [Boolean, String, Integer] :trim_user Each tweet returned in a timeline will include a user object with only the author's numerical ID when set to true, 't' or 1.
+      # @option options [Boolean, String, Integer] :include_entities Include {https://dev.twitter.com/docs/tweet-entities Tweet Entities} when set to true, 't' or 1.
+      # @return [Array<Twitter::Status>]
+      # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @example Return up to 100 of the first retweets of the status with the ID 28561922516
+      #   Twitter.retweets(28561922516)
+      def retweets(id, options={})
+        get("/1/statuses/retweets/#{id}.json", options).map do |status|
+          Twitter::Status.new(status)
+        end
+      end
+
+      # Returns a single status, specified by ID
+      #
+      # @see https://dev.twitter.com/docs/api/1/get/statuses/show/:id
+      # @rate_limited Yes
+      # @requires_authentication No unless the author of the status is protected
+      # @param id [Integer] The numerical ID of the desired status.
+      # @param options [Hash] A customizable set of options.
+      # @option options [Boolean, String, Integer] :trim_user Each tweet returned in a timeline will include a user object with only the author's numerical ID when set to true, 't' or 1.
+      # @option options [Boolean, String, Integer] :include_entities Include {https://dev.twitter.com/docs/tweet-entities Tweet Entities} when set to true, 't' or 1.
+      # @return [Twitter::Status] The requested status.
+      # @example Return the status with the ID 25938088801
+      #   Twitter.status(25938088801)
+      def status(id, options={})
+        status = get("/1/statuses/show/#{id}.json", options)
+        Twitter::Status.new(status)
+      end
+
+      # Returns an oEmbed version of a single status, specified by ID or url to the tweet
+      #
+      # @see https://dev.twitter.com/docs/api/1/get/statuses/oembed
+      # @rate_limited Yes
+      # @requires_authentication No unless the author of the status is protected
+      # @param id [Integer] The numerical ID of the desired status to be embedded.
+      # @param url [String] The url to the status to be embedded. ex: https://twitter.com/#!/twitter/status/25938088801
+      # @param options [Hash] A customizable set of options.
+      # @option options [Integer] :maxwidth The maximum width in pixels that the embed should be rendered at. This value is constrained to be between 250 and 550 pixels.
+      # @option options [Boolean, String, Integer] :hide_media Specifies whether the embedded Tweet should automatically expand images which were uploaded via {https://dev.twitter.com/docs/api/1/post/statuses/update_with_media POST statuses/update_with_media}. When set to either true, t or 1 images will not be expanded. Defaults to false.
+      # @option options [Boolean, String, Integer] :hide_thread Specifies whether the embedded Tweet should automatically show the original message in the case that the embedded Tweet is a reply. When set to either true, t or 1 the original Tweet will not be shown. Defaults to false.
+      # @option options [Boolean, String, Integer] :omit_script Specifies whether the embedded Tweet HTML should include a `<script>` element pointing to widgets.js. In cases where a page already includes widgets.js, setting this value to true will prevent a redundant script element from being included. When set to either true, t or 1 the `<script>` element will not be included in the embed HTML, meaning that pages must include a reference to widgets.js manually. Defaults to false.
+      # @option options [String] :align Specifies whether the embedded Tweet should be left aligned, right aligned, or centered in the page. Valid values are left, right, center, and none. Defaults to none, meaning no alignment styles are specified for the Tweet.
+      # @option options [String] :related A value for the TWT related parameter, as described in {https://dev.twitter.com/docs/intents Web Intents}. This value will be forwarded to all Web Intents calls.
+      # @option options [String] :lang Language code for the rendered embed. This will affect the text and localization of the rendered HTML.
+      def oembed(id_or_url, options={})
+        case id_or_url
+        when Integer
+          id = id_or_url
+          oembed = get("/1/statuses/oembed.json?id=#{id}", options)
+        when String
+          url = id_or_url
+          escaped_url = URI.escape(url, Regexp.new("[^#{URI::PATTERN::UNRESERVED}]"))
+          oembed = get("/1/statuses/oembed.json?url=#{escaped_url}", options)
+        end
+        Twitter::OEmbed.new(oembed)
+      end
+      # Destroys the specified status
+      #
+      # @see https://dev.twitter.com/docs/api/1/post/statuses/destroy/:id
+      # @note The authenticating user must be the author of the specified status.
+      # @rate_limited No
+      # @requires_authentication Yes
+      # @param id [Integer] The numerical ID of the desired status.
+      # @param options [Hash] A customizable set of options.
+      # @option options [Boolean, String, Integer] :trim_user Each tweet returned in a timeline will include a user object with only the author's numerical ID when set to true, 't' or 1.
+      # @option options [Boolean, String, Integer] :include_entities Include {https://dev.twitter.com/docs/tweet-entities Tweet Entities} when set to true, 't' or 1.
+      # @return [Twitter::Status] The deleted status.
+      # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @example Destroy the status with the ID 25938088801
+      #   Twitter.status_destroy(25938088801)
+      def status_destroy(id, options={})
+        status = delete("/1/statuses/destroy/#{id}.json", options)
+        Twitter::Status.new(status)
+      end
+
+      # Retweets a tweet
+      #
+      # @see https://dev.twitter.com/docs/api/1/post/statuses/retweet/:id
+      # @rate_limited Yes
+      # @requires_authentication Yes
+      # @param id [Integer] The numerical ID of the desired status.
+      # @param options [Hash] A customizable set of options.
+      # @option options [Boolean, String, Integer] :trim_user Each tweet returned in a timeline will include a user object with only the author's numerical ID when set to true, 't' or 1.
+      # @option options [Boolean, String, Integer] :include_entities Include {https://dev.twitter.com/docs/tweet-entities Tweet Entities} when set to true, 't' or 1.
+      # @return [Twitter::Status] The original tweet with retweet details embedded.
+      # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @example Retweet the status with the ID 28561922516
+      #   Twitter.retweet(28561922516)
+      def retweet(id, options={})
+        new_status = post("/1/statuses/retweet/#{id}.json", options)
+        orig_status = new_status.delete('retweeted_status')
+        orig_status['retweeted_status'] = new_status
+        Twitter::Status.new(orig_status)
+      end
+
+      # Updates the authenticating user's status
+      #
+      # @see https://dev.twitter.com/docs/api/1/post/statuses/update
+      # @note A status update with text identical to the authenticating user's current status will be ignored to prevent duplicates.
+      # @rate_limited No
+      # @requires_authentication Yes
+      # @param status [String] The text of your status update, up to 140 characters.
+      # @param options [Hash] A customizable set of options.
+      # @option options [Integer] :in_reply_to_status_id The ID of an existing status that the update is in reply to.
+      # @option options [Float] :lat The latitude of the location this tweet refers to. This option will be ignored unless it is inside the range -90.0 to +90.0 (North is positive) inclusive. It will also be ignored if there isn't a corresponding :long option.
+      # @option options [Float] :long The longitude of the location this tweet refers to. The valid ranges for longitude is -180.0 to +180.0 (East is positive) inclusive. This option will be ignored if outside that range, if it is not a number, if geo_enabled is disabled, or if there not a corresponding :lat option.
+      # @option options [String] :place_id A place in the world. These IDs can be retrieved from {Twitter::Client::Geo#reverse_geocode}.
+      # @option options [String] :display_coordinates Whether or not to put a pin on the exact coordinates a tweet has been sent from.
+      # @option options [Boolean, String, Integer] :trim_user Each tweet returned in a timeline will include a user object with only the author's numerical ID when set to true, 't' or 1.
+      # @option options [Boolean, String, Integer] :include_entities Include {https://dev.twitter.com/docs/tweet-entities Tweet Entities} when set to true, 't' or 1.
+      # @return [Twitter::Status] The created status.
+      # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @example Update the authenticating user's status
+      #   Twitter.update("I'm tweeting with @gem!")
+      def update(status, options={})
+        status = post("/1/statuses/update.json", options.merge(:status => status))
+        Twitter::Status.new(status)
+      end
+
+      # Updates with media the authenticating user's status
+      #
+      # @see http://dev.twitter.com/docs/api/1/post/statuses/update_with_media
+      # @note A status update with text/media identical to the authenticating user's current status will NOT be ignored
+      # @requires_authentication Yes
+      # @rate_limited No
+      # @param status [String] The text of your status update, up to 140 characters.
+      # @param media [File] A File object with your picture (PNG, JPEG or GIF)
+      # @param options [Hash] A customizable set of options.
+      # @option options [Integer] :in_reply_to_status_id The ID of an existing status that the update is in reply to.
+      # @option options [Float] :lat The latitude of the location this tweet refers to. This option will be ignored unless it is inside the range -90.0 to +90.0 (North is positive) inclusive. It will also be ignored if there isn't a corresponding :long option.
+      # @option options [Float] :long The longitude of the location this tweet refers to. The valid ranges for longitude is -180.0 to +180.0 (East is positive) inclusive. This option will be ignored if outside that range, if it is not a number, if geo_enabled is disabled, or if there not a corresponding :lat option.
+      # @option options [String] :place_id A place in the world. These IDs can be retrieved from {Twitter::Client::Geo#reverse_geocode}.
+      # @option options [String] :display_coordinates Whether or not to put a pin on the exact coordinates a tweet has been sent from.
+      # @option options [Boolean, String, Integer] :trim_user Each tweet returned in a timeline will include a user object with only the author's numerical ID when set to true, 't' or 1.
+      # @option options [Boolean, String, Integer] :include_entities Include {http://dev.twitter.com/pages/tweet_entities Tweet Entities} when set to true, 't' or 1.
+      # @return [Twitter::Status] The created status.
+      # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @example Update the authenticating user's status
+      #   Twitter.update_with_media("I'm tweeting with @gem!", File.new('my_awesome_pic.jpeg'))
+      #   Twitter.update_with_media("I'm tweeting with @gem!", {'io' => StringIO.new(pic), 'type' => 'jpg'})
+      def update_with_media(status, image, options={})
+        status = post("/1/statuses/update_with_media.json", options.merge('media[]' => image, 'status' => status), :endpoint => media_endpoint)
+        Twitter::Status.new(status)
+      end
+
+    end
+  end
+end