module Totter
  class Client
    # Client methods for working with users
    module Users
      # Get the current user
      #
      # Requires authenticatied client.
      #
      # @return [Hashie::Mash]
      # @see Totter::Client
      # @example
      #   client.me
      def me
        get 'me'
      end

      # Get a single user
      #
      # @param user [String] A Seeaw username or ID.
      # @return [Hashie::Mash]
      # @example
      #   Seesaw.user('soffes')
      def user(user)
        get "users/#{user}"
      end

      # Follow a user.
      #
      # Requires authenticatied client.
      #
      # @param user [String] Username or ID of the user to follow.
      # @return [Boolean] True if follow was successful, false otherwise.
      # @see Totter::Client
      # @example
      #   client.follow('gotwalt')
      def follow(user)
        boolean_from_response :post, "users/#{user}/follow"
      end

      # Unfollow a user.
      #
      # Requires authenticatied client.
      #
      # @param user [String] Username or ID of the user to unfollow.
      # @return [Boolean] True if unfollow was successful, false otherwise.
      # @see Totter::Client
      # @example
      #   client.unfollow('kyle')
      def unfollow(user)
        boolean_from_response :post, "users/#{user}/unfollow"
      end
    end
  end
end