twitter 5.4.1 → 5.5.0

data/lib/twitter/rest/api/utils.rb

@@ -49,7 +49,7 @@ module Twitter
         # @param path [String]
         # @param args [Array]
         # @return [Array<Twitter::User>]
-        def threaded_user_objects_from_response(request_method, path, args)
+        def parallel_user_objects_from_response(request_method, path, args)
           arguments = Twitter::Arguments.new(args)
           Twitter::Utils.parallel_map(arguments) do |user|
             object_from_response(Twitter::User, request_method, path, merge_user(arguments.options, user))
@@ -101,7 +101,7 @@ module Twitter
         # @param path [String]
         # @param args [Array]
         # @return [Array]
-        def threaded_objects_from_response(klass, request_method, path, args) # rubocop:disable ParameterLists
+        def parallel_objects_from_response(klass, request_method, path, args) # rubocop:disable ParameterLists
           arguments = Twitter::Arguments.new(args)
           Twitter::Utils.parallel_map(arguments) do |object|
             id = extract_id(object)

data/lib/twitter/rest/client.rb

@@ -139,8 +139,8 @@ module Twitter
           end
         end
         response.env
-      rescue Faraday::Error::ClientError, JSON::ParserError
-        raise Twitter::Error
+      rescue Faraday::Error::ClientError, JSON::ParserError => error
+        raise Twitter::Error.new(error) # rubocop:disable RaiseArgs
       end
 
       def auth_token(method, path, params = {}, signature_params = params) # rubocop:disable ParameterLists

data/lib/twitter/search_results.rb

@@ -34,7 +34,7 @@ module Twitter
       @path = path
       @options = options
       @collection = []
-      set_attrs(attrs)
+      self.attrs = attrs
     end
 
   private
@@ -66,10 +66,10 @@ module Twitter
 
     def fetch_next_page
       response = @client.send(@request_method, @path, next_page)
-      set_attrs(response[:body])
+      self.attrs = response[:body]
     end
 
-    def set_attrs(attrs)
+    def attrs=(attrs)
       @attrs = attrs
       Array(@attrs[:statuses]).map do |tweet|
         @collection << Tweet.new(tweet)

data/lib/twitter/streaming/client.rb

@@ -58,6 +58,7 @@ module Twitter
       # @see https://dev.twitter.com/docs/api/1.1/get/site
       # @see https://dev.twitter.com/docs/streaming-apis/streams/site
       # @see https://dev.twitter.com/docs/streaming-apis/parameters
+      # @note Site Streams is currently in a limited beta. Access is restricted to whitelisted accounts.
       # @param follow [Enumerable<Integer, String, Twitter::User>] A list of user IDs, indicating the users to return statuses for in the stream.
       # @param options [Hash] A customizable set of options.
       # @option options [String] :with Specifies whether to return information for just the users specified in the follow parameter, or include messages from accounts they follow.

data/lib/twitter/trend_results.rb

@@ -38,7 +38,7 @@ module Twitter
     #
     # @return [Time]
     def as_of
-      Time.parse(@attrs[:as_of]) if @attrs[:as_of]
+      Time.parse(@attrs[:as_of]) unless @attrs[:as_of].nil?
     end
     memoize :as_of
 

data/lib/twitter/tweet.rb

@@ -1,15 +1,19 @@
 require 'twitter/creatable'
+require 'twitter/entities'
+require 'twitter/identity'
 
 module Twitter
   class Tweet < Twitter::Identity
     include Twitter::Creatable
-    attr_reader :favorite_count, :favorited, :in_reply_to_screen_name,
-                :in_reply_to_attrs_id, :in_reply_to_status_id,
-                :in_reply_to_user_id, :lang, :retweet_count, :retweeted,
-                :source, :text, :truncated
+    include Twitter::Entities
+    attr_reader :favorite_count, :favorited, :filter_level,
+                :in_reply_to_screen_name, :in_reply_to_attrs_id,
+                :in_reply_to_status_id, :in_reply_to_user_id, :lang,
+                :retweet_count, :retweeted, :source, :text, :truncated
     alias_method :favorites_count, :favorite_count
     alias_method :favoriters_count, :favorite_count
     alias_method :in_reply_to_tweet_id, :in_reply_to_status_id
+    alias_method :reply?, :in_reply_to_status_id?
     alias_method :retweeters_count, :retweet_count
     object_attr_reader :GeoFactory, :geo
     object_attr_reader :Metadata, :metadata
@@ -21,21 +25,10 @@ module Twitter
     alias_method :retweeted_tweet?, :retweeted_status?
     object_attr_reader :User, :user, :status
 
-    # @return [Boolean]
-    def entities?
-      !@attrs[:entities].nil? && @attrs[:entities].any? { |_, array| !array.empty? }
-    end
-    memoize :entities?
-
-    def filter_level
-      @attrs[:filter_level] || 'none'
-    end
-    memoize :filter_level
-
-    # @return [String]
     # @note May be > 140 characters.
+    # @return [String]
     def full_text
-      if retweeted_status?
+      if retweet?
         prefix = text[/\A(RT @[a-z0-9_]{1,20}: )/i, 1]
         [prefix, retweeted_status.text].compact.join
       else
@@ -44,69 +37,12 @@ module Twitter
     end
     memoize :full_text
 
-    # @note Must include entities in your request for this method to work
-    # @return [Array<Twitter::Entity::Hashtag>]
-    def hashtags
-      entities(Entity::Hashtag, :hashtags)
-    end
-    memoize :hashtags
-
-    # @note Must include entities in your request for this method to work
-    # @return [Array<Twitter::Media>]
-    def media
-      entities(MediaFactory, :media)
-    end
-    memoize :media
-
-    # @return [Boolean]
-    def reply?
-      !!@attrs[:in_reply_to_status_id]
-    end
-    memoize :reply?
-
-    # @note Must include entities in your request for this method to work
-    # @return [Array<Twitter::Entity::Symbol>]
-    def symbols
-      entities(Entity::Symbol, :symbols)
-    end
-    memoize :symbols
-
     # @return [String] The URL to the tweet.
     def uri
-      Addressable::URI.parse("https://twitter.com/#{user.screen_name}/status/#{id}")
+      Addressable::URI.parse("https://twitter.com/#{user.screen_name}/status/#{id}") unless user.nil?
     end
     memoize :uri
     alias_method :url, :uri
-
-    # @note Must include entities in your request for this method to work
-    # @return [Array<Twitter::Entity::URI>]
-    def uris
-      entities(Entity::URI, :urls)
-    end
-    memoize :uris
-    alias_method :urls, :uris
-
-    # @note Must include entities in your request for this method to work
-    # @return [Array<Twitter::Entity::UserMention>]
-    def user_mentions
-      entities(Entity::UserMention, :user_mentions)
-    end
-    memoize :user_mentions
-
-  private
-
-    # @param klass [Class]
-    # @param key [Symbol]
-    def entities(klass, key)
-      if entities?
-        Array(@attrs[:entities][key.to_sym]).map do |entity|
-          klass.new(entity)
-        end
-      else
-        warn "#{Kernel.caller.first}: To get #{key.to_s.tr('_', ' ')}, you must pass `:include_entities => true` when requesting the #{self.class}."
-        []
-      end
-    end
   end
   Status = Tweet # rubocop:disable ConstantName
 end

data/lib/twitter/user.rb

@@ -1,11 +1,15 @@
+require 'addressable/uri'
+require 'memoizable'
 require 'twitter/basic_user'
 require 'twitter/creatable'
+require 'twitter/entity/uri'
+require 'twitter/profile'
 
 module Twitter
   class User < Twitter::BasicUser
-    PROFILE_IMAGE_SUFFIX_REGEX = /_normal(\.gif|\.jpe?g|\.png)$/i
-    PREDICATE_URI_METHOD_REGEX = /_uri\?$/
     include Twitter::Creatable
+    include Twitter::Profile
+    include Memoizable
     attr_reader :connections, :contributors_enabled, :default_profile,
                 :default_profile_image, :description, :favourites_count,
                 :follow_request_sent, :followers_count, :friends_count,
@@ -28,20 +32,6 @@ module Twitter
     alias_method :tweet?, :status?
     alias_method :tweeted?, :status?
 
-    class << self
-    private
-
-      def alias_predicate_uri_methods(method)
-        %w(_url? _uri_https? _url_https?).each do |replacement|
-          alias_method_sub(method, PREDICATE_URI_METHOD_REGEX, replacement)
-        end
-      end
-
-      def alias_method_sub(method, pattern, replacement)
-        alias_method(method.to_s.sub(pattern, replacement).to_sym, method)
-      end
-    end
-
     # @return [Array<Twitter::Entity::URI>]
     def description_uris
       Array(@attrs[:entities][:description][:urls]).map do |entity|
@@ -51,71 +41,16 @@ module Twitter
     memoize :description_uris
     alias_method :description_urls, :description_uris
 
-    # Return the URL to the user's profile banner image
-    #
-    # @param size [String, Symbol] The size of the image. Must be one of: 'mobile', 'mobile_retina', 'web', 'web_retina', 'ipad', or 'ipad_retina'
-    # @return [String]
-    def profile_banner_uri(size = :web)
-      parse_encoded_uri(insecure_uri([@attrs[:profile_banner_url], size].join('/'))) if @attrs[:profile_banner_url]
-    end
-    alias_method :profile_banner_url, :profile_banner_uri
-
-    # Return the secure URL to the user's profile banner image
-    #
-    # @param size [String, Symbol] The size of the image. Must be one of: 'mobile', 'mobile_retina', 'web', 'web_retina', 'ipad', or 'ipad_retina'
-    # @return [String]
-    def profile_banner_uri_https(size = :web)
-      parse_encoded_uri([@attrs[:profile_banner_url], size].join('/')) if @attrs[:profile_banner_url]
-    end
-    alias_method :profile_banner_url_https, :profile_banner_uri_https
-
-    # @return [Boolean]
-    def profile_banner_uri?
-      !!@attrs[:profile_banner_url]
-    end
-    memoize :profile_banner_uri?
-    alias_predicate_uri_methods :profile_banner_uri?
-
-    # Return the URL to the user's profile image
-    #
-    # @param size [String, Symbol] The size of the image. Must be one of: 'mini', 'normal', 'bigger' or 'original'
-    # @return [String]
-    def profile_image_uri(size = :normal)
-      parse_encoded_uri(insecure_uri(profile_image_uri_https(size))) if @attrs[:profile_image_url_https]
-    end
-    alias_method :profile_image_url, :profile_image_uri
-
-    # Return the secure URL to the user's profile image
-    #
-    # @param size [String, Symbol] The size of the image. Must be one of: 'mini', 'normal', 'bigger' or 'original'
-    # @return [String]
-    def profile_image_uri_https(size = :normal)
-      # The profile image URL comes in looking like like this:
-      # https://a0.twimg.com/profile_images/1759857427/image1326743606_normal.png
-      # It can be converted to any of the following sizes:
-      # https://a0.twimg.com/profile_images/1759857427/image1326743606.png
-      # https://a0.twimg.com/profile_images/1759857427/image1326743606_mini.png
-      # https://a0.twimg.com/profile_images/1759857427/image1326743606_bigger.png
-      parse_encoded_uri(@attrs[:profile_image_url_https].sub(PROFILE_IMAGE_SUFFIX_REGEX, profile_image_suffix(size))) if @attrs[:profile_image_url_https]
-    end
-    alias_method :profile_image_url_https, :profile_image_uri_https
-
-    def profile_image_uri?
-      !!@attrs[:profile_image_url_https]
-    end
-    memoize :profile_image_uri?
-    alias_predicate_uri_methods :profile_image_uri?
-
     # @return [String] The URL to the user.
     def uri
-      Addressable::URI.parse("https://twitter.com/#{screen_name}")
+      Addressable::URI.parse("https://twitter.com/#{screen_name}") unless screen_name.nil?
     end
     memoize :uri
     alias_method :url, :uri
 
     # @return [String] The URL to the user's website.
     def website
-      Addressable::URI.parse(@attrs[:url]) if @attrs[:url]
+      Addressable::URI.parse(@attrs[:url]) unless @attrs[:url].nil?
     end
     memoize :website
 
@@ -123,19 +58,5 @@ module Twitter
       !!@attrs[:url]
     end
     memoize :website?
-
-  private
-
-    def parse_encoded_uri(uri)
-      Addressable::URI.parse(URI.encode(uri))
-    end
-
-    def insecure_uri(uri)
-      uri.to_s.sub(/^https/i, 'http')
-    end
-
-    def profile_image_suffix(size)
-      :original == size.to_sym ? '\\1' : "_#{size}\\1"
-    end
   end
 end

data/lib/twitter/utils.rb

@@ -1,13 +1,12 @@
 module Twitter
   module Utils
-    class << self
-      def parallel_map(enumerable)
-        # Don't bother spawning a new thread if there's only one item
-        if enumerable.count == 1
-          enumerable.map { |object| yield object }
-        else
-          enumerable.map { |object| Thread.new { yield object } }.map(&:value)
-        end
+    module_function
+    def parallel_map(enumerable)
+      # Don't bother spawning a new thread if there's only one item
+      if enumerable.count == 1
+        enumerable.map { |object| yield object }
+      else
+        enumerable.map { |object| Thread.new { yield object } }.map(&:value)
       end
     end
   end

data/lib/twitter/version.rb

@@ -1,8 +1,8 @@
 module Twitter
   class Version
     MAJOR = 5
-    MINOR = 4
-    PATCH = 1
+    MINOR = 5
+    PATCH = 0
     PRE = nil
 
     class << self

data/spec/fixtures/direct_message.json

@@ -1 +1 @@
-{"sender_screen_name":"sferik","recipient_screen_name":"pengwynn","recipient_id":14100886,"recipient":{"profile_background_tile":false,"profile_sidebar_fill_color":"dddddd","description":"Christian husband and father. Dev Experience @ HP Cloud Services. Co-host of the @changelogshow. Mashup of design & development.","friends_count":1877,"follow_request_sent":false,"notifications":false,"profile_sidebar_border_color":"cccccc","verified":false,"time_zone":"Central Time (US & Canada)","favourites_count":32,"url":"http:\/\/wynnnetherland.com","profile_background_color":"efefef","listed_count":184,"lang":"en","created_at":"Sat Mar 08 16:34:22 +0000 2008","location":"Dallas, TX","show_all_inline_media":false,"statuses_count":3928,"profile_use_background_image":true,"profile_text_color":"666666","protected":false,"profile_image_url":"http:\/\/a2.twimg.com\/profile_images\/485575482\/komikazee_normal.png","id_str":"14100886","geo_enabled":true,"name":"Wynn Netherland","contributors_enabled":false,"following":true,"profile_background_image_url":"http:\/\/a1.twimg.com\/profile_background_images\/61741268\/twitter-small.png","profile_link_color":"35abe9","screen_name":"pengwynn","id":14100886,"utc_offset":-21600,"followers_count":2767},"created_at":"Tue Oct 26 21:24:23 +0000 2010","id_str":"1825786345","sender":{"profile_background_tile":false,"profile_sidebar_fill_color":"DDEEF6","description":"Adventures in hunger and foolishness.","friends_count":88,"follow_request_sent":false,"notifications":false,"profile_sidebar_border_color":"C0DEED","verified":false,"time_zone":"Pacific Time (US & Canada)","favourites_count":729,"url":null,"profile_background_color":"000000","listed_count":28,"lang":"en","created_at":"Mon Jul 16 12:59:01 +0000 2007","location":"San Francisco","show_all_inline_media":true,"statuses_count":2970,"profile_use_background_image":true,"profile_text_color":"333333","protected":false,"profile_image_url":"http:\/\/a0.twimg.com\/profile_images\/323331048\/me_normal.jpg","id_str":"7505382","geo_enabled":true,"name":"Erik Michaels-Ober","contributors_enabled":false,"following":false,"profile_background_image_url":"http:\/\/a3.twimg.com\/profile_background_images\/162641967\/we_concept_bg2.png","profile_link_color":"0084B4","screen_name":"sferik","id":7505382,"utc_offset":-28800,"followers_count":898},"sender_id":7505382,"id":1825786345,"text":"Creating a fixture for the Twitter gem"}
+{"id":418030038152642560,"id_str":"418030038152642560","text":"My #newride from @PUBLICBikes. Don't you want one? https:\/\/t.co\/7HIwCl68Y8 https:\/\/t.co\/JSSxDPr4Sf","sender":{"id":14471007,"id_str":"14471007","name":"Diana Kimball","screen_name":"dianakimball","location":"Berlin","description":"Community at @SoundCloud. Every now and then, I write a longer letter that I\u2019d love to send to you: http:\/\/t.co\/AZEzTiBwRS","url":"http:\/\/t.co\/tUTbLPD7Yc","entities":{"url":{"urls":[{"url":"http:\/\/t.co\/tUTbLPD7Yc","expanded_url":"http:\/\/blog.dianakimball.com","display_url":"blog.dianakimball.com","indices":[0,22]}]},"description":{"urls":[{"url":"http:\/\/t.co\/AZEzTiBwRS","expanded_url":"http:\/\/expertnovice.com","display_url":"expertnovice.com","indices":[100,122]}]}},"protected":false,"followers_count":4283,"friends_count":684,"listed_count":176,"created_at":"Tue Apr 22 05:14:47 +0000 2008","favourites_count":6773,"utc_offset":-18000,"time_zone":"Quito","geo_enabled":true,"verified":false,"statuses_count":5527,"lang":"en","contributors_enabled":false,"is_translator":false,"profile_background_color":"F4FFFF","profile_background_image_url":"http:\/\/abs.twimg.com\/images\/themes\/theme15\/bg.png","profile_background_image_url_https":"https:\/\/abs.twimg.com\/images\/themes\/theme15\/bg.png","profile_background_tile":false,"profile_image_url":"http:\/\/pbs.twimg.com\/profile_images\/3333204267\/51006fd104a17604e0398359ff5937ba_normal.jpeg","profile_image_url_https":"https:\/\/pbs.twimg.com\/profile_images\/3333204267\/51006fd104a17604e0398359ff5937ba_normal.jpeg","profile_banner_url":"https:\/\/pbs.twimg.com\/profile_banners\/14471007\/1359310744","profile_link_color":"8F1864","profile_sidebar_border_color":"FFFFFF","profile_sidebar_fill_color":"C0DFEC","profile_text_color":"333333","profile_use_background_image":false,"default_profile":false,"default_profile_image":false,"following":true,"follow_request_sent":false,"notifications":false},"sender_id":14471007,"sender_id_str":"14471007","sender_screen_name":"dianakimball","recipient":{"id":7505382,"id_str":"7505382","name":"Erik Michaels-Ober","screen_name":"sferik","location":"","description":"Prolonging the inevitable.","url":"https:\/\/t.co\/L2xIBaQPRf","entities":{"url":{"urls":[{"url":"https:\/\/t.co\/L2xIBaQPRf","expanded_url":"https:\/\/github.com\/sferik","display_url":"github.com\/sferik","indices":[0,23]}]},"description":{"urls":[]}},"protected":false,"followers_count":3946,"friends_count":345,"listed_count":205,"created_at":"Mon Jul 16 12:59:01 +0000 2007","favourites_count":8018,"utc_offset":3600,"time_zone":"Berlin","geo_enabled":true,"verified":false,"statuses_count":13011,"lang":"en","contributors_enabled":false,"is_translator":false,"profile_background_color":"000000","profile_background_image_url":"http:\/\/a0.twimg.com\/profile_background_images\/677717672\/bb0b3653dcf0644e344823e0a2eb3382.png","profile_background_image_url_https":"https:\/\/si0.twimg.com\/profile_background_images\/677717672\/bb0b3653dcf0644e344823e0a2eb3382.png","profile_background_tile":false,"profile_image_url":"http:\/\/pbs.twimg.com\/profile_images\/378800000757402331\/d8dfba561e2e94112a737f17e7d138ca_normal.jpeg","profile_image_url_https":"https:\/\/pbs.twimg.com\/profile_images\/378800000757402331\/d8dfba561e2e94112a737f17e7d138ca_normal.jpeg","profile_banner_url":"https:\/\/pbs.twimg.com\/profile_banners\/7505382\/1385736840","profile_link_color":"0084B4","profile_sidebar_border_color":"000000","profile_sidebar_fill_color":"DDEEF6","profile_text_color":"333333","profile_use_background_image":true,"default_profile":false,"default_profile_image":false,"following":false,"follow_request_sent":false,"notifications":false},"recipient_id":7505382,"recipient_id_str":"7505382","recipient_screen_name":"sferik","created_at":"Tue Dec 31 14:45:02 +0000 2013","entities":{"hashtags":[{"text":"newride","indices":[3,11]}],"symbols":[],"urls":[{"url":"https:\/\/t.co\/7HIwCl68Y8","expanded_url":"https:\/\/twitter.com\/PUBLICBikes\/status\/350315569708412929","display_url":"twitter.com\/PUBLICBikes\/st\u2026","indices":[51,74]},{"url":"https:\/\/t.co\/JSSxDPr4Sf","expanded_url":"https:\/\/ton.twitter.com\/1.1\/ton\/data\/dm\/418030038152642560\/418030038161047552\/0cnHqrKV.jpg","display_url":"pic.twitter.com\/JSSxDPr4Sf","indices":[75,98]}],"user_mentions":[{"screen_name":"PUBLICBikes","name":"PUBLIC Bikes","id":30035888,"id_str":"30035888","indices":[17,29]}],"media":[{"id":418030038161047552,"id_str":"418030038161047552","indices":[75,98],"media_url":"https:\/\/ton.twitter.com\/1.1\/ton\/data\/dm\/418030038152642560\/418030038161047552\/0cnHqrKV.jpg","media_url_https":"https:\/\/ton.twitter.com\/1.1\/ton\/data\/dm\/418030038152642560\/418030038161047552\/0cnHqrKV.jpg","url":"https:\/\/t.co\/JSSxDPr4Sf","display_url":"pic.twitter.com\/JSSxDPr4Sf","expanded_url":"https:\/\/ton.twitter.com\/1.1\/ton\/data\/dm\/418030038152642560\/418030038161047552\/0cnHqrKV.jpg","type":"photo","sizes":{"medium":{"w":600,"h":600,"resize":"fit"},"large":{"w":640,"h":640,"resize":"fit"},"thumb":{"w":150,"h":150,"resize":"crop"},"small":{"w":340,"h":340,"resize":"fit"}}}]}}

data/spec/twitter/direct_message_spec.rb

@@ -1,7 +1,17 @@
+# coding: utf-8
 require 'helper'
 
 describe Twitter::DirectMessage do
 
+  before do
+    @old_stderr = $stderr
+    $stderr = StringIO.new
+  end
+
+  after do
+    $stderr = @old_stderr
+  end
+
   describe '#==' do
     it 'returns true when objects IDs are the same' do
       direct_message = Twitter::DirectMessage.new(:id => 1, :text => 'foo')
@@ -86,4 +96,136 @@ describe Twitter::DirectMessage do
     end
   end
 
+  describe '#hashtags' do
+    it 'returns an array of Entity::Hashtag when entities are set' do
+      hashtags_array = [
+        {
+          :text => 'twitter',
+          :indices => [10, 33],
+        }
+      ]
+      hashtags = Twitter::DirectMessage.new(:id => 28_669_546_014, :entities => {:hashtags => hashtags_array}).hashtags
+      expect(hashtags).to be_an Array
+      expect(hashtags.first).to be_a Twitter::Entity::Hashtag
+      expect(hashtags.first.indices).to eq([10, 33])
+      expect(hashtags.first.text).to eq('twitter')
+    end
+    it 'is empty when not set' do
+      hashtags = Twitter::DirectMessage.new(:id => 28_669_546_014).hashtags
+      expect(hashtags).to be_empty
+    end
+    it 'warns when not set' do
+      Twitter::DirectMessage.new(:id => 28_669_546_014).hashtags
+      expect($stderr.string).to match(/To get hashtags, you must pass `:include_entities => true` when requesting the Twitter::DirectMessage\./)
+    end
+  end
+
+  describe '#media' do
+    it 'returns media' do
+      media = Twitter::DirectMessage.new(:id => 28_669_546_014, :entities => {:media => [{:id => 1, :type => 'photo'}]}).media
+      expect(media).to be_an Array
+      expect(media.first).to be_a Twitter::Media::Photo
+    end
+    it 'is empty when not set' do
+      media = Twitter::DirectMessage.new(:id => 28_669_546_014).media
+      expect(media).to be_empty
+    end
+    it 'warns when not set' do
+      Twitter::DirectMessage.new(:id => 28_669_546_014).media
+      expect($stderr.string).to match(/To get media, you must pass `:include_entities => true` when requesting the Twitter::DirectMessage\./)
+    end
+  end
+
+  describe '#symbols' do
+    it 'returns an array of Entity::Symbol when symbols are set' do
+      symbols_array = [
+        {:text => 'PEP', :indices => [114, 118]},
+        {:text => 'COKE', :indices => [128, 133]}
+      ]
+      symbols = Twitter::DirectMessage.new(:id => 28_669_546_014, :entities => {:symbols => symbols_array}).symbols
+      expect(symbols).to be_an Array
+      expect(symbols.size).to eq(2)
+      expect(symbols.first).to be_a Twitter::Entity::Symbol
+      expect(symbols.first.indices).to eq([114, 118])
+      expect(symbols.first.text).to eq('PEP')
+    end
+    it 'is empty when not set' do
+      symbols = Twitter::DirectMessage.new(:id => 28_669_546_014).symbols
+      expect(symbols).to be_empty
+    end
+    it 'warns when not set' do
+      Twitter::DirectMessage.new(:id => 28_669_546_014).symbols
+      expect($stderr.string).to match(/To get symbols, you must pass `:include_entities => true` when requesting the Twitter::DirectMessage\./)
+    end
+  end
+
+  describe '#uris' do
+    it 'returns an array of Entity::URIs when entities are set' do
+      urls_array = [
+        {
+          :url => 'http://example.com/t.co',
+          :expanded_url => 'http://example.com/expanded',
+          :display_url => 'example.com/expanded…',
+          :indices => [10, 33],
+        }
+      ]
+      direct_message = Twitter::DirectMessage.new(:id => 28_669_546_014, :entities => {:urls => urls_array})
+      expect(direct_message.uris).to be_an Array
+      expect(direct_message.uris.first).to be_a Twitter::Entity::URI
+      expect(direct_message.uris.first.indices).to eq([10, 33])
+      expect(direct_message.uris.first.display_uri).to be_a String
+      expect(direct_message.uris.first.display_uri).to eq('example.com/expanded…')
+    end
+    it 'is empty when not set' do
+      direct_message = Twitter::DirectMessage.new(:id => 28_669_546_014)
+      expect(direct_message.uris).to be_empty
+    end
+    it 'warns when not set' do
+      Twitter::DirectMessage.new(:id => 28_669_546_014).urls
+      expect($stderr.string).to match(/To get urls, you must pass `:include_entities => true` when requesting the Twitter::DirectMessage\./)
+    end
+    it 'can handle strange urls' do
+      urls_array = [
+        {
+          :url => 'http://with_underscore.example.com/t.co',
+          :expanded_url => 'http://with_underscore.example.com/expanded',
+          :display_url => 'with_underscore.example.com/expanded…',
+          :indices => [10, 33],
+        }
+      ]
+      direct_message = Twitter::DirectMessage.new(:id => 28_669_546_014, :entities => {:urls => urls_array})
+      uri = direct_message.uris.first
+      expect { uri.url }.not_to raise_error
+      expect { uri.expanded_url }.not_to raise_error
+      expect { uri.display_url }.not_to raise_error
+    end
+  end
+
+  describe '#user_mentions' do
+    it 'returns an array of Entity::UserMention when entities are set' do
+      user_mentions_array = [
+        {
+          :screen_name => 'sferik',
+          :name => 'Erik Michaels-Ober',
+          :id_str => '7_505_382',
+          :indices => [0, 6],
+          :id => 7_505_382,
+        }
+      ]
+      user_mentions = Twitter::DirectMessage.new(:id => 28_669_546_014, :entities => {:user_mentions => user_mentions_array}).user_mentions
+      expect(user_mentions).to be_an Array
+      expect(user_mentions.first).to be_a Twitter::Entity::UserMention
+      expect(user_mentions.first.indices).to eq([0, 6])
+      expect(user_mentions.first.id).to eq(7_505_382)
+    end
+    it 'is empty when not set' do
+      user_mentions = Twitter::DirectMessage.new(:id => 28_669_546_014).user_mentions
+      expect(user_mentions).to be_empty
+    end
+    it 'warns when not set' do
+      Twitter::DirectMessage.new(:id => 28_669_546_014).user_mentions
+      expect($stderr.string).to match(/To get user mentions, you must pass `:include_entities => true` when requesting the Twitter::DirectMessage\./)
+    end
+  end
+
 end