croudia4r 0.1.1

data/lib/croudia/rest/favorites.rb

@@ -0,0 +1,47 @@
+require 'croudia/object/status'
+
+module Croudia
+  module Rest
+    module Favorites
+
+      # **This method must throw Exception.**
+      # Returns the 20 most recent Whispers favorited by the authenticating or specified user.
+      #
+      # @see https://developer.croudia.com/docs/51_favorites
+      # @return [NotImplementedError]
+      # @param params [Hash] A customized options.
+      # @option params [Boolean] :trim_user When set to true, each whisper returned in a timeline will include a user object including only the status authors numerical ID.
+      def favorites(params = {})
+        raise NotImplementedError.new()
+      end
+
+      # Favorites the status specified in the ID parameter as the authenticating user. 
+      # Returns the favorited status when successful.
+      #
+      # @see https://developer.croudia.com/docs/52_favorites_create
+      # @return [Croudia::Object::Status] Favorited status.
+      # @param status [Croudia::Object::Status] The favorite whisper.
+      # @param params [Hash] A customized options.
+      # @option params [Boolean] :trim_user When set to true, each whisper returned in a timeline will include a user object including only the status authors numerical ID.
+      # @option params [Boolean] :include_entities The entities node will be omitted when set to false.
+      def favorite(status, params = {})
+        response = post("2/favorites/create/#{status.id}.json", params)
+        Croudia::Object::Status.new(response)
+      end
+
+      # Un-favorites the status specified in the ID parameter as the authenticating user.
+      # Returns the un-favorited status when successful.
+      #
+      # @see https://developer.croudia.com/docs/53_favorites_destroy
+      # @return [Croudia::Object::Status] Un-favorited status.
+      # @param status [Croudia::Object::Status] The un-favorite whisper.
+      # @param params [Hash] A customized options.
+      # @option params [Boolean] :trim_user When set to true, each whisper returned in a timeline will include a user object including only the status authors numerical ID.
+      # @option params [Boolean] :include_entities The entities node will be omitted when set to false.
+      def unfavorite(status, params = {})
+        response = post("2/favorites/destory/#{status.id}.json", params)
+        Croudia::Object::Status.new(response)
+      end
+    end
+  end
+end

data/lib/croudia/rest/followers.rb

@@ -0,0 +1,36 @@
+require 'croudia/object/ids'
+require 'croudia/object/list'
+
+module Croudia
+  module Rest
+    module Followers
+
+      # Returns a collection of user ids that the authenticating user's followers.
+      #
+      # @see https://developer.croudia.com/docs/49_followers_ids
+      # @return [Croudia::Object::IDs] A collection of user ids that authenticating user's followers.
+      # @param params [Hash] A customized options.
+      # @option params [String] :screen_name The screen name of the potentially followers user.
+      # @option params [Integer] :user_id The ID of the potentially followers user.
+      # @option params [Integer] :cursor The page cursor of collection.
+      def follower_ids(params = {})
+        response = get('followers/ids.json', params)
+        Croudia::Object::IDs.new(response)
+      end
+
+      # Returns a collection of user objects the authenticating user's followers.
+      #
+      # @see https://developer.croudia.com/docs/43_followers_list
+      # @return [Croudia::Object::List] A collection of user objects that authenticating user's followers.
+      # @param params [Hash] A customized options.
+      # @option params [String] :screen_name The screen name of the potentially followers user.
+      # @option params [Integer] :user_id The ID of the potentially followers user.
+      # @option params [Integer] :cursor The page cursor of collection.
+      # @option params [Boolean] :trim_user When set to truem each whisper returned in a timeline will include a user object including only the status authors numerical ID.
+      def followers(params = {})
+        response = get('followers/list.json', params)
+        Croudia::Object::List.new(response)
+      end
+    end
+  end
+end

data/lib/croudia/rest/friend_ships.rb

@@ -0,0 +1,60 @@
+require 'croudia/object/relationship'
+require 'croudia/object/relationship_collection'
+require 'croudia/object/user'
+
+module Croudia
+  module Rest
+    module FriendShips
+
+      # Allows the authenticating users to follow the user specified in the ID parameter.
+      #
+      # @see https://developer.croudia.com/docs/41_friendships_create
+      # @return [Croudia::Object::User] The befriended user in the requested format when successful.
+      # @param params [Hash] A customized options.
+      # @option params [String] :screen_name The screen name of the user for whom to befriend.
+      # @option params [Integer] :user_id The ID of the user for whom to befriend.
+      def follow(params = {})
+        response = post('friendships/create.json', params)
+        Croudia::Object::User.new(response)
+      end
+
+      # Allows the authenticating user to unfollow the user specified in the ID parameter.
+      #
+      # @see https://developer.croudia.com/docs/42_friendships_destroy
+      # @return [Croudia::Object::User] The unfollowed user in the requested format when successful.
+      # @param params [Hash] A customized options.
+      # @option params [String] :screen_name The screen name of the user for whom to unfollow.
+      # @option params [Integer] :user_id The ID of the user for whom to unfollow.
+      def unfollow(params = {})
+        response = post('friendships/destroy.json', params)
+        Croudia::Object::User.new(response)
+      end
+
+      # Returns detailed information about the relationship between two arbitrary users.
+      #
+      # @see https://developer.croudia.com/docs/44_friendships_show
+      # @return [Croudia::Object::Relationship] The relationship between two arbitrary users.
+      # @param params [Hash] A customized options.
+      # @option params [Integer] :source_id The user_id of the subject user.
+      # @option params [String] :source_screen_name The screen_name of the subject user.
+      # @option params [Integer] :target_id The user_id of the target user.
+      # @option params [String] :target_screen_name The screen_name of the target user.
+      def relationship(params = {})
+        response = get('friendships/show.json', params)
+        Croudia::Object::Relationship.new(response)
+      end
+
+      # Returns the relationships of the authenticating user to the comma-separated list of up to 100 screen_names or user_ids provided.
+      #
+      # @see https://developer.croudia.com/docs/47_friendships_lookup
+      # @return [Croudia::Object::RelationshipCollection]
+      # @param params [Hash] A customized options.
+      # @option params [Integer] :user_id The comma-separated list of user_ids.
+      # @option params [String] :screen_name The comma-separated list of screen_names.
+      def relationships(params = {})
+        response = get('friendships/lookup.json', params)
+        Croudia::Object::RelationshipCollection.new(response)
+      end
+    end
+  end
+end

data/lib/croudia/rest/friends.rb

@@ -0,0 +1,36 @@
+require 'croudia/object/ids'
+require 'croudia/object/list'
+
+module Croudia
+  module Rest
+    module Friends
+
+      # Returns a collection of user ids that the authenticating user's friends.
+      #
+      # @see https://developer.croudia.com/docs/49_friends_ids
+      # @return [Croudia::Object::IDs] A collection of user ids that authenticating user's friends.
+      # @param params [Hash] A customized options.
+      # @option params [String] :screen_name The screen name of the potentially friends user.
+      # @option params [Integer] :user_id The ID of the potentially friends user.
+      # @option params [Integer] :cursor The page cursor of collection.
+      def friend_ids(params = {})
+        response = get('friends/ids.json', params)
+        Croudia::Object::IDs.new(response)
+      end
+
+      # Returns a collection of user objects the authenticating user's friends.
+      #
+      # @see https://developer.croudia.com/docs/43_friends_list
+      # @return [Croudia::Object::List] A collection of user objects that authenticating user's friends.
+      # @param params [Hash] A customized options.
+      # @option params [String] :screen_name The screen name of the potentially friends user.
+      # @option params [Integer] :user_id The ID of the potentially friends user.
+      # @option params [Integer] :cursor The page cursor of collection.
+      # @option params [Boolean] :trim_user When set to truem each whisper returned in a timeline will include a user object including only the status authors numerical ID.
+      def friends(params = {})
+        response = get('friends/list.json', params)
+        Croudia::Object::List.new(response)
+      end
+    end
+  end
+end

data/lib/croudia/rest/mutes/users.rb

@@ -0,0 +1,58 @@
+require 'croudia/object/user'
+require 'croudia/object/ids'
+require 'croudia/object/list'
+
+module Croudia
+  module Rest
+    module Mutes
+      module Users
+        
+        # Mutes the user specified in the ID parameter for the authenticating user.
+        #
+        # @see https://developer.croudia.com/docs/71_mutes_users_create
+        # @return [Croudia::Object::User] Muted user.
+        # @param params [Hash] A customized options.
+        # @option params [String] :screen_name The screen name of the potentially muted user.
+        # @option params [Integer] :user_id The ID of the potentially muted user.
+        def mute(params = {})
+          response = post('mutes/users/create.json', params)
+          Croudia::Object::User.new(response)
+        end
+
+        # Un-mutes the user specified in the ID parameter for the authenticating user.
+        #
+        # @see https://developer.croudia.com/docs/72_mutes_users_destroy
+        # @return [Croudia::Object::User] Un-muted user.
+        # @param params [Hash] A customized options.
+        # @option params [String] :screen_name The screen name of the potentially unmuted user.
+        # @option params [Integer] :user_id The ID of the potentially unmuted user.
+        def umnute(params = {})
+          response = post('mutes/users/destroy.json', params)
+          Croudia::Object::User.new(response)
+        end
+
+        # Returns a collection of users the authenticating user has muted.
+        #
+        # @see https://developer.croudia.com/docs/74_mutes_users_list
+        # @param params [Hash] A customized options.
+        # @option params [Integer] :cursor The page cursor.
+        # @option params [Boolean] :trim_user When set to true, objects returned will include a user object including only the status authors numerical ID.
+        def mutes(params = {})
+          response = get('mutes/users/list.json', params)
+          Croudia::Object::List.new(response)
+        end
+
+        # Returns an array of numeric user ids the authenticating user has muted.
+        #
+        # @see https://developer.croudia.com/docs/75_mutes_users_ids
+        # @return [Croudia::Object::IDs] Numeric user ids the authenticating user has muted.
+        # @param params [Hash] A customized options.
+        # @option params [Integer] :cursor The page cursor.
+        def mute_ids(params = {})
+          response = get('mutes/users/ids.json', params)
+          Croudia::Object::IDs.new(response)
+        end
+      end
+    end
+  end
+end

data/lib/croudia/rest/mutes.rb

@@ -0,0 +1,9 @@
+require 'croudia/rest/mutes/users'
+
+module Croudia
+  module Rest
+    module Mutes
+      include Croudia::Rest::Mutes::Users
+    end
+  end
+end

data/lib/croudia/rest/oauth.rb

@@ -0,0 +1,48 @@
+require 'croudia/object/tokens'
+
+module Croudia
+  module Rest
+    module OAuth
+
+      # Returns an authorization url.
+      #
+      # @return [String] Authorization url.
+      # @param params [Hash] A customized options.
+      # @option params [String] :state OAuth 2 Authorization State Code.
+      def authorize_url(params = {})
+        unless (params[:state].nil?)
+          "https://api.croudia.com/oauth/authorize?response_type=code&client_id=#{@client_id}&state=#{params[:state]}"
+        else
+          "https://api.croudia.com/oauth/authorize?response_type=code&client_id=#{@client_id}"
+        end
+      end
+
+      # Allows a registered application to obtain an OAuth 2 Bearer Token.
+      #
+      # @see https://developer.croudia.com/docs/oauth
+      # @return [Croudia::Object::Tokens] Token pair.
+      # @param params [Hash] A customized options.
+      # @option params [String] :code Authorization code of application.
+      def token(params = {})
+        default_params = {grant_type: 'authorization_code', client_id: @client_id, client_secret: @client_secret}
+        params.merge!(default_params)
+        response = post('oauth/token', params)
+        puts response
+        Croudia::Object::Tokens.new(response)
+      end
+
+      # Refresh an OAuth 2 Bearer Token.
+      #
+      # @see https://developer.croudia.com/docs/oauth
+      # @return [Croudia::Object::Tokens] Token pair.
+      # @param params [Hash] A customized options.
+      # @option params [String] :refresh_token OAuth 2 refresh token.
+      def refresh(params = {})
+        default_params = {grant_type: 'refresh_token', client_id: @client_id, client_secret: @client_secret }
+        params.merge!(default_params)
+        response = post('oauth/token', params)
+        Croudia::Object::Tokens.new(response)
+      end
+    end
+  end
+end

data/lib/croudia/rest/search.rb

@@ -0,0 +1,33 @@
+require 'croudia/object/search_result'
+require 'croudia/object/user'
+
+module Croudia
+  module Rest
+    module Search
+
+      def search_statuses(params = {})
+        response = get('search/voices.json', params)
+        Croudia::Object::SearchResult.new(response)
+      end
+
+      def search_users(params = {})
+        response = get('users/search.json', params)
+        response.map do |user|
+          Croudia::Object::User.new(user)
+        end
+      end
+
+      def search_users_by_profile(params = {})
+        response = get('profile/search.json', params)
+        response.map do |user|
+          Croudia::Object::User.new(user)
+        end
+      end
+
+      def search_favorites(params = {})
+        response = get('search/favorites.json', params)
+        Croudia::Object::SearchResult.new(response)
+      end
+    end
+  end
+end

data/lib/croudia/rest/secret_mails.rb

@@ -0,0 +1,96 @@
+require 'croudia/object/secret_mail'
+
+module Croudia
+  module Rest
+    module SecretMails
+    
+      # Returns the 20 most recent direct messages sent to the authenticating user.
+      #
+      # @see https://developer.croudia.com/docs/21_secret_mails
+      # @return [Array<Croudia::Object::SecretMail>] Secret mails that authenticating user is received.
+      # @param params [Hash] A customized options.
+      # @option params [Boolean] :trim_user When set to true, each message returned in a timeline will include a user object including only the status authors numerical ID.
+      # @option params [Integer] :since_id Returns results with an ID greater than (that is, more recent than) the specified ID. 
+      # @option params [Integer] :max_id Returns results with an ID less than (that is, older than) or equal to the specified ID.
+      # @option params [Integer] :count Specifies the number of statuses to retrieve.
+      def received(params = {})
+        response = get('secret_mails.json', params)
+        response.map do |sm|
+          Croudia::Object::SecretMail.new(sm)
+        end
+      end
+
+      # Returns the 20 most recent direct messages sent by the authenticating user.
+      #
+      # @see https://developer.croudia.com/docs/22_secret_mails_sent
+      # @return [Array<Croudia::Object::SecretMail>] Secret mails that authenticating user is sent.
+      # @param params [Hash] A customized options.
+      # @option params [Boolean] :trim_user When set to true, each message returned in a timeline will include a user object including only the status authors numerical ID.
+      # @option params [Integer] :since_id Returns results with an ID greater than (that is, more recent than) the specified ID. 
+      # @option params [Integer] :max_id Returns results with an ID less than (that is, older than) or equal to the specified ID.
+      # @option params [Integer] :count Specifies the number of statuses to retrieve.    
+      def sent(params = {})
+        response = get('secret_mails/sent.json', params)
+        response.map do |sm|
+          Croudia::Object::SecretMail.new(sm)
+        end
+      end
+
+      # Sends a new message to the specified user from the authenticating user. 
+      # 
+      # @see https://developer.croudia.com/docs/23_secret_mails_new
+      # @return [Croudia::Object::SecretMail] Sent message.
+      # @param params [Hash] A customized options.
+      # @option params [String] :text The text of your status update, typically up to 372 characters.
+      # @option params [String] :screen_name The screen name of the user for whom to send message.
+      # @option params [Integer] :user_id The ID of the user for whom to send message.
+      def new_message(params = {})
+        response = post('secret_mails/new.json', params)
+        Croudia::Object::SecretMail.new(response)
+      end
+
+      # Sends a new message with image to the specified user from the authenticating user.
+      #
+      # @see https://developer.croudia.com/docs/26_secret_mails_new_with_media
+      # @return [Croudia::Object::SecretMail] Sent message.
+      # @param params [Hash] A customized options.
+      # @option params [String] :text The text of your status update, typically up to 372 characters.
+      # @option params [File] :media Attachment image as PNG, JPEG or GIF format.
+      # @option params [String] :screen_name The screen name of the user for whom to send message.
+      # @option params [Integer] :user_id The ID of the user for whom to send message.
+      def new_message_with_media(params = {})
+        response = post('secret_mails/new_with_media.json', params)
+        Croudia::Object::SecretMail.new(response)
+      end
+
+      # Deletes the authenticating user's sent message.
+      #
+      # @see https://developer.croudia.com/docs/24_secret_mails_destroy
+      # @return [Croudia::Object::SecretMail] Deleted message.
+      # @param status [Croudia::Object::SecretMail] Delete status.
+      def delete_message(status)
+        response = post("secret_mails/destroy/#{status.id}.json")
+        Croudia::Object::SecretMail.new(response)
+      end
+
+      # Returns a single message, specified by the id parameter.
+      #
+      # @see https://developer.croudia.com/docs/25_secret_mails_show
+      # @return [Croudia::Object::SecretMail] Message specified by id. 
+      # @param status [Croudia::Object::SecretMail] Message.
+      def message(status)
+        response = get("secret_mails/show/#{status.id}.json")
+        Croudia::Object::SecretMail.new(response)
+      end
+
+      # Returns the URI of the image that attached to message.
+      # 
+      # @see https://developer.croudia.com/docs/27_secret_mails_get_secret_photo
+      # @return [String] URL of attaching message.
+      # @param status [Croudia::Object::SecretMail] Status.
+      def message_photo(status)
+        "https://api.croudia.com/secret_mails/get_secret_photo/#{status.id}.json"
+      end
+    end
+  end
+end

data/lib/croudia/rest/statuses.rb

@@ -0,0 +1,170 @@
+require 'croudia/object/status'
+
+module Croudia
+  module Rest
+    module Statuses
+
+      # Returns a collection of the most recent Whispers, spreads and comments posted by the authenticating user and the users they non-protected.
+      #
+      # @see https://developer.croudia.com/docs/01_statuses_public_timeline
+      # @return [Array<Croudia::Object::Status>] Collection of the most recent statuses.
+      # @param params [Hash] A customized options.
+      # @option params [Boolean] :trim_user When set to true, each whisper returned in a timeline will include a user object including only the status authors numerical ID.
+      # @option params [Boolean] :include_entities The entities node will be omitted when set to false.
+      # @option params [Integer] :since_id Returns results with an ID greater than (that is, more recent than) the specified ID. 
+      # @option params [Integer] :max_id Returns results with an ID less than (that is, older than) or equal to the specified ID.
+      # @option params [Integer] :count Specifies the number of statuses to retrieve.
+      def public_timeline(params = {})
+        response = get('2/statuses/public_timeline.json', params)
+        response.map{ |status| Croudia::Object::Status.new(status) }
+      end
+
+      # Returns a collection of the most recent Whispers, spreads and comments posted by the authenticating user and the users they following.
+      #
+      # @see https://developer.croudia.com/docs/02_statuses_home_timeline
+      # @return [Array<Croudia::Object::Status>] Collection of the most recent statuses.
+	    # @param params [Hash] A customized options.
+      # @option params [Boolean] :trim_user When set to true, each whisper returned in a timeline will include a user object including only the status authors numerical ID.
+      # @option params [Boolean] :include_entities The entities node will be omitted when set to false.
+      # @option params [Integer] :since_id Returns results with an ID greater than (that is, more recent than) the specified ID. 
+      # @option params [Integer] :max_id Returns results with an ID less than (that is, older than) or equal to the specified ID.
+      # @option params [Integer] :count Specifies the number of statuses to retrieve.
+      def home_timeline(params = {})
+        response = get('2/statuses/home_timeline.json', params)
+        response.map{ |status| Croudia::Object::Status.new(status) }
+      end
+      
+      # Returns a collection of the most recent Whispers, spreads and comments posted by specified user.
+      #
+      # @see https://developer.croudia.com/docs/03_statuses_user_timeline
+      # @return [Array<Croudia::Object::Status>] Collection of the most recent statuses.
+      # @param params [Hash] A customized options.
+      # @option params [String] :screen_name The screen name of the user for whom to return results for.
+      # @option params [Integer] :user_id The ID of the user for whom to return results for.
+      # @option params [Boolean] :trim_user When set to true, each whisper returned in a timeline will include a user object including only the status authors numerical ID.
+      # @option params [Boolean] :include_entities The entities node will be omitted when set to false.
+      # @option params [Integer] :since_id Returns results with an ID greater than (that is, more recent than) the specified ID. 
+      # @option params [Integer] :max_id Returns results with an ID less than (that is, older than) or equal to the specified ID.
+      # @option params [Integer] :count Specifies the number of statuses to retrieve.
+      def user_timeline(params = {})
+        response = get('2/statuses/user_timeline.json', params)
+        response.map{ |status| Croudia::Object::Status.new(status) }
+      end
+
+      # Returns the 20 most recent mentions (Whispers containing a users’s @screen_name) for the authenticating user. 
+      #
+      # @see https://developer.croudia.com/docs/04_statuses_mentions
+      # @return [Array<Croudia::Object::Status>] Collection of the most recent statuses.
+      # @param params [Hash] A customized options.
+      # @option params [Boolean] :trim_user When set to true, each whisper returned in a timeline will include a user object including only the status authors numerical ID.
+      # @option params [Boolean] :include_entities The entities node will be omitted when set to false.
+      # @option params [Integer] :since_id Returns results with an ID greater than (that is, more recent than) the specified ID. 
+      # @option params [Integer] :max_id Returns results with an ID less than (that is, older than) or equal to the specified ID.
+      # @option params [Integer] :count Specifies the number of statuses to retrieve. 
+      def mentions_timeline(params = {})
+        response = get('2/statuses/mentions.json', params)
+        response.map{ |status| Croudia::Object::Status.new(status) }
+      end
+
+      # Updates the authenticating user’s current status.
+      #
+      # @see https://developer.croudia.com/docs/11_statuses_update
+      # @return [Croudia::Object::Status] Updated status.
+      # @param params [Hash] A customized options.
+      # @option params [String] :status The text of your status update, typically up to 372 characters.
+      # @option params [Integer] :in_reply_to_status_id The ID of an existing status that the update is in reply to.
+      # @option params [Integer] :timer Whispers timer's seconds.
+      # @option params [Boolean] :trim_user When set to true, the whisper returned will include a user object including only the status authors numerical ID.
+      # @option params [Boolean] :include_entities The entities node will be omitted when set to false.
+      def update_status(params = {})
+        response = post('2/statuses/update.json', params)
+        Croudia::Object::Status.new(response)
+      end
+
+      # Updates the authenticating user's current status with media as photos.
+      #
+      # @see https://developer.croudia.com/docs/14_statuses_update_with_media
+      # @return [Croudia::Object::Status] Updated status.
+      # @param params [Hash] A customized options.
+      # @option params [String] :status The text of your status update, typically up to 372 characters.
+      # @option params [File] :media Attachment image that PNG, JPEG or GIF format.
+      # @option params [Integer] :in_reply_to_status_id The ID of an existing status that the update is in reply to.
+      # @option params [Integer] :timer Whispers timer's seconds.
+      # @option params [Boolean] :trim_user When set to true, the whisper returned will include a user object including only the status authors numerical ID.
+      # @option params [Boolean] :include_entities The entities node will be omitted when set to false.      
+      def update_status_with_media(params = {})
+        response = post('2/statuses/update_with_media.json', params)
+        Croudia::Object::Status.new(response)
+      end
+
+      # Deletes the authenticating user's status.
+      #
+      # @see https://developer.croudia.com/docs/12_statuses_destroy
+      # @return [Croudia::Object::Status] Deleted status.
+      # @param status [Croudia::Object::Status] Delete status.
+      # @param params [Hash] A customized options.
+      # @option params [Boolean] :trim_user When set to true, whisper returned will include a user object including only the status authors numerical ID.
+      # @option params [Boolean] :include_entities The entities node will be omitted when set to false.
+      def delete_status(status, params = {})
+        response = post("2/statuses/destory/#{status.id}.json", params)
+        Croudia::Object::Status.new(response)
+      end
+      alias_method :delete_spread, :delete_status
+
+      # Returns a single Whisper, specified by the id parameter.
+      #
+      # @see https://developer.croudia.com/docs/13_statuses_show
+      # @return [Croudia::Object::Status] Status specified by id.
+      # @param status [Croudia::Object::Status] Status.
+      # @param params [Hash] A customized options.
+      # @option params [Boolean] :trim_user When set to true, whisper returned will include a user object including only the status authors numerical ID.
+      # @option params [Boolean] :include_entities The entities node will be omitted when set to false.
+      def status(status, params = {})
+        response = get("2/statuses/show/#{status.id}.json", params)
+        Croudia::Object::Status.new(response)
+      end
+
+      # Shares the status by authenticating user.
+      #
+      # @see https://developer.croudia.com/docs/61_statuses_spread
+      # @return [Croudia::Object::Status] Status shread by id.
+      # @param status [Croudia::Object::Status] Status.
+      # @param params [Hash] A customized options.
+      # @option params [Boolean] :trim_user When set to true, whisper returned will include a user object including only the status authors numerical ID.
+      # @option params [Boolean] :include_entities The entities node will be omitted when set to false.
+      def spread(status, params = {})
+        response = post("2/statuses/spread/#{status.id}.json", params)
+        Croudia::Object::Status.new(response)
+      end
+
+      #
+      # 
+      # @see https://developer.croudia.com/docs/112_statuses_comment
+      # @return [Croudia::Object::Status] Commented status.
+      # @param params [Hash] A customized options.
+      # @option params [Integer] :id Comment status id.
+      # @option params [String] :status Comment body.
+      # @option params [Boolean] :trim_user When set to true, whisper returned will include a user object including only the status authors numerical ID.
+      # @option params [Boolean] :include_entities The entities node will be omitted when set to false.
+      def comment(params = {})
+        response = post('2/statuses/comment.json', params)
+        Croudia::Object::Status.new(response)
+      end
+
+      # 
+      #
+      # @see https://developer.croudia.com/docs/113_statuses_comment_with_media
+      # @return [Croudia::Object::Status] Commented status.
+      # @param params [Hash] A customized options.
+      # @option params [Integer] :id Comment status id.
+      # @option params [String] :status Comment body.
+      # @option params [File] :media Attachment media.
+      # @option params [Boolean] :trim_user When set to true, whisper returned will include a user object including only the status authors numerical ID.
+      # @option params [Boolean] :include_entities The entities node will be omitted when set to false.
+      def comment_with_media(params = {})
+        response = post('2/statuses/comment_with_media.json', params)
+        Croudia::Object::Status.new(response)
+      end
+    end
+  end
+end

data/lib/croudia/rest/trends.rb

@@ -0,0 +1,19 @@
+require 'croudia/object/trend'
+
+module Croudia
+  module Rest
+    module Trends
+
+      # Returns the top 10 trending topics for a specific WOEID.
+      #
+      # @see https://developer.croudia.com/docs/100_trends_place
+      # @return [Croudia::Object::Trend] Trends
+      # @param params [Hash] A customized options.
+      # @option params [Integer] :woeid Please set 1.
+      def place(params = {})
+        response = get('trends/place.json', params)
+        Croudia::Object::Trend.new(response)
+      end
+    end
+  end
+end

data/lib/croudia/rest/users.rb

@@ -0,0 +1,33 @@
+require 'croudia/object/user'
+
+module Croudia
+  module Rest
+    module Users
+      
+      # Returns a variety of information about the user.
+      #
+      # @see https://developer.croudia.com/docs/31_users_show
+      # @return [Croudia::Object::User] Variety of information about the user.
+      # @param params [Hash] A customized options.
+      # @option params [String] :screen_name The screen name of the user for whom to return results for.
+      # @option params [Integer] :user_id The ID of the user for whom to return results for.
+      def user(params = {})
+        response = get('users/show.json', params)
+        Croudia::Object::User.new(response)
+      end
+
+
+      # Returns a information about the up to 100 users.
+      #
+      # @see https://developer.croudia.com/docs/32_users_lookup
+      # @return [Array<Croudia::Object::User>] Information about the users.
+      # @param params [Hash] A customized options.
+      # @option params [String] :screen_name The camma-separated screen name of the user for whom to return results for.
+      # @option params [Integer] :user_id The camma-separated IDs of the user for whom to return results for.
+      def users(params = {})
+        response = get('users/lookup.json', params)
+        response.map {|user| Croudia::Object::User.new(user) }
+      end
+    end
+  end
+end

data/lib/croudia/version.rb

@@ -0,0 +1,3 @@
+module Croudia
+  VERSION = "0.1.1"
+end

data/lib/croudia.rb

@@ -0,0 +1,2 @@
+require "croudia/version"
+require "croudia/client"