NeonRAW 0.1.1

data/lib/NeonRAW/objects/subreddit/moderation.rb

@@ -0,0 +1,200 @@
+require_relative '../thing'
+require_relative '../modloguser'
+require_relative '../listing'
+
+module NeonRAW
+  module Objects
+    class Subreddit < Thing
+      # Methods for moderators.
+      module Moderation
+        # @!group Listing
+        # Fetches the modlog for the subreddit.
+        # @!method modlog(params = { limit: 25 })
+        # @param params [Hash] The parameters.
+        # @option params :after [String] Fullname of the next data block.
+        # @option params :before [String] Fullname of the previous data block.
+        # @option params :count [Integer] The number of items already in the
+        #   listing.
+        # @option params :limit [1..500] The number of listing items to fetch.
+        # @option params :mod [String] The moderator to filter actions by. Also
+        #   'a' can be given to filter by admin actions.
+        # @option params :show [String] Literally the string 'all'.
+        # @option params :type [String] The type of mod action to filter by
+        #   [banuser, unbanuser, removelink, approvelink, removecomment,
+        #   approvecomment, addmoderator, invitemoderator, uninvitemoderator,
+        #   acceptmoderatorinvite, removemoderator, addcontributor,
+        #   removecontributor, editsettings, editflair, distinguish, marknsfw,
+        #   wikibanned, wikicontributor, wikiunbanned, wikipagelisted,
+        #   removewikicontributor, wikirevise, wikipermlevel, ignorereports,
+        #   unignorereports, setpermissions, setsuggestedsort, sticky, unsticky,
+        #   setcontestmode, unsetcontestmode, lock, unlock, muteuser,
+        #   unmuteuser, createrule, editrule, deleterule]
+        # @return [NeonRAW::Objects::Listing] Returns a listing of the modlog
+        #   actions.
+        def modlog(params = { limit: 25 })
+          path = "/r/#{display_name}/about/log.json"
+          @client.send(:build_listing, path, params)
+        end
+
+        # Fetches the subreddit's modmail.
+        # @!method modmail(params = { limit: 25 })
+        # @param params [Hash] The parameters.
+        # @option params :after [String] Fullname of the next data block.
+        # @option params :before [String] Fullname of the previous data block.
+        # @option params :count [Integer] The number of things already in the
+        #   listing.
+        # @option params :limit [1..1000] The number of listing items to fetch.
+        # @option params :only [Symbol] Only fetch either [links, comments].
+        # @option params :show [String] Literally the string 'all'.
+        # @return [NeonRAW::Objects::Listing] Returns a listing with all the
+        #   things.
+        def modmail(params = { limit: 25 })
+          path = "/r/#{display_name}/about/message/inbox"
+          @client.send(:build_listing, path, params)
+        end
+
+        # Fetches things for review by moderators.
+        # @!method reported(params = { limit: 25 })
+        # @!method spam(params = { limit: 25 })
+        # @!method modqueue(params = { limit: 25 })
+        # @!method unmoderated(params = { limit: 25 })
+        # @!method edited(params = { limit: 25 })
+        # @param params [Hash] The parameters.
+        # @option params :after [String] Fullname of the next data block.
+        # @option params :before [String] Fullname of the previous data block.
+        # @option params :count [Integer] The number of things already in the
+        #   listing.
+        # @option params :limit [1..1000] The number of listing items to fetch.
+        # @option params :only [Symbol] Only fetch either [links, comments].
+        # @option params :show [String] Literally the string 'all'.
+        # @return [NeonRAW::Objects::Listing] Returns a listing with all the
+        #   things.
+        %w(reported spam modqueue unmoderated edited).each do |type|
+          define_method :"#{type}" do |params = { limit: 25 }|
+            type = 'reports' if type == 'reported'
+            path = "/r/#{display_name}/about/#{type}.json"
+            @client.send(:build_listing, path, params)
+          end
+        end
+
+        # Fetches users with altered privileges.
+        # @!method banned(params = { limit: 25 })
+        # @!method muted(params = { limit: 25 })
+        # @!method wikibanned(params = { limit: 25 })
+        # @!method contributors(params = { limit: 25 })
+        # @!method wikicontributors(params = { limit: 25 })
+        # @!method moderators(params = { limit: 25 })
+        # @param params [Hash] The parameters.
+        # @option params :after [String] Fullname of the next data block.
+        # @option params :before [String] Fullname of the previous data block.
+        # @option params :count [Integer] Number of items already in the
+        #   listing.
+        # @option params :limit [1..1000] The number of listing items to fetch.
+        # @option params :show [String] Literally the string 'all'.
+        # @option params :user [String] The name of the user to fetch.
+        # @return [NeonRAW::Objects::Listing] Returns a listing of the users.
+        %w(banned muted wikibanned
+           contributors wikicontributors moderators).each do |type|
+             define_method :"#{type}" do |params = { limit: 25 }|
+               data_arr = []
+               path = "/r/#{display_name}/about/#{type}"
+               until data_arr.length == params[:limit]
+                 data = @client.request_data(path, :get, params)
+                 params[:after] = data[:data][:after]
+                 params[:before] = data[:data][:before]
+                 data[:data][:children].each do |item|
+                   data_arr << ModLogUser.new(@client, item)
+                   break if data_arr.length == params[:limit]
+                 end
+                 break if params[:after].nil?
+               end
+               listing = Listing.new(params[:after], params[:before])
+               data_arr.each { |user| listing << user }
+               listing
+             end
+           end
+        # @!endgroup
+
+        # Accept a pending mod invite to the subreddit.
+        # @!method accept_mod_invite!
+        def accept_mod_invite!
+          params = { api_type: 'json' }
+          path = "/r/#{display_name}/api/accept_moderator_invite"
+          @client.request_data(path, :post, params)
+          refresh!
+        end
+
+        # Ditch your privileged status in the subreddit.
+        # @!method leave_contributor!
+        # @!method leave_moderator!
+        %w(contributor moderator).each do |type|
+          define_method :"leave_#{type}!" do
+            params = { id: name }
+            @client.request_data("/api/leave#{type}", :post, params)
+            refresh!
+          end
+        end
+
+        # Upload a subreddit image.
+        # @!method upload_image!(file_path, file_type, image_name, upload_type)
+        # @param file_path [String] The path to the file (500 KiB maximum).
+        # @param file_type [String] The file extension [png, jpg].
+        # @param image_name [String] The name of the image.
+        # @param upload_type [String] The type of upload [img, header, icon,
+        #   banner].
+        def upload_image!(file_path, file_type, image_name, upload_type)
+          params = { img_type: file_type, name: image_name,
+                     upload_type: upload_type }
+          path = "/r/#{display_name}/api/upload_sr_img"
+          file = File.open(file_path, 'r')
+          @client.request_data(path, :post, params, file: file)
+          refresh!
+        end
+
+        # Remove a subreddit image.
+        # @!method remove_banner!
+        # @!method remove_header!
+        # @!method remove_icon!
+        %w(banner header icon).each do |type|
+          define_method :"remove_#{type}!" do
+            params = { api_type: 'json' }
+            path = "/r/#{display_name}/api/delete_sr_#{type}"
+            @client.request_data(path, :post, params)
+            refresh!
+          end
+        end
+
+        # Remove a subreddit image.
+        # @!method remove_image!(image)
+        # @param image [String] The name of the image.
+        def remove_image!(image)
+          params = { api_type: 'json', img_name: image }
+          path = "/r/#{display_name}/api/delete_sr_img"
+          @client.request_data(path, :post, params)
+          refresh!
+        end
+
+        # Edit the subreddit's stylesheet.
+        # @!method edit_stylesheet(data, opts = {})
+        # @param data [String] The CSS for the stylesheet.
+        # @param opts [Hash] Optional parameters.
+        # @option opts :reason [String] The reason for the edit (256 characters
+        #   maximum).
+        def edit_stylesheet(data, opts = {})
+          params = { api_type: 'json', op: 'save',
+                     reason: opts[:reason], stylesheet_contents: data }
+          path = "/r/#{display_name}/api/subreddit_stylesheet"
+          @client.request_data(path, :post, params)
+        end
+
+        # Fetches the settings for the subreddit.
+        # @!method settings
+        # @return [Hash] Returns the subreddit's settings.
+        def settings
+          path = "/r/#{display_name}/about/edit.json"
+          @client.request_data(path, :get)[:data]
+        end
+      end
+    end
+  end
+end

data/lib/NeonRAW/objects/subreddit/utilities.rb

@@ -0,0 +1,73 @@
+module NeonRAW
+  module Objects
+    class Subreddit
+      # Utilities for subreddits.
+      module Utilities
+        # Get info on a link/comment/subreddit.
+        # @!method info(params = {})
+        # @param params [Hash] The parameters.
+        # @option params :id [String] The fullname of the thing.
+        # @option params :url [String] The URL of the thing.
+        # @return [NeonRAW::Objects::Comment/Submission/Subreddit] Returns the
+        #   object.
+        def info(params = {})
+          path = "/r/#{display_name}/api/info"
+          data = @client.request_data(path, :get, params)
+          case data[:data][:children][0][:kind]
+          when 't1'
+            Comment.new(@client, data[:data][:children][0][:data])
+          when 't3'
+            Submission.new(@client, data[:data][:children][0][:data])
+          when 't5'
+            Subreddit.new(@client, data[:data][:children][0][:data])
+          end
+        end
+
+        # Submit a thread to the subreddit.
+        # @!method submit(title, params = {})
+        # @param title [String] The title of the submission (300
+        #   characters maximum).
+        # @param params [Hash] The parameters.
+        # @option params :text [String] The text of the submission (selfpost).
+        # @option params :url [String] The URL of the submission (link post).
+        # @return [NeonRAW::Objects::Submission] Returns the submission object.
+        def submit(title, params = {})
+          params[:kind] = 'self' if params[:text]
+          params[:kind] = 'link' if params[:url]
+          params[:sr] = display_name
+          params[:title] = title
+          response = @client.request_data('/api/submit', :post, params)
+          # Seriously though, fucking convoluted data structures.
+          submission_id = response[:jquery].last[3].first.split('/')[6]
+          info(id: 't3_' + submission_id)
+        end
+
+        # Gets recommended subreddits for the subreddit.
+        # @!method recommended_subreddits(opts = {})
+        # @param opts [Hash] Optional parameters.
+        # @option opts :omit [String] A comma-separated list of subreddits to
+        #   omit from the results.
+        # @return [Array<String>] Returns a list of the recommended subreddits.
+        def recommended_subreddits(opts = {})
+          params = { omit: opts[:omit], srnames: display_name }
+          path = "/api/recommend/sr/#{display_name}"
+          data = @client.request_data(path, :get, params)
+          data.map { |subreddit| subreddit[:sr_name] }
+        end
+
+        # Toggle your subscription to the subreddit.
+        # @!method subscribe!
+        # @!method unsubscribe!
+        %w(subscribe unsubscribe).each do |type|
+          define_method :"#{type}!" do
+            params = { sr: name }
+            params[:action] = 'sub' if type == 'subscribe'
+            params[:action] = 'unsub' if type == 'unsubscribe'
+            @client.request_data('/api/subscribe', :post, params)
+            refresh!
+          end
+        end
+      end
+    end
+  end
+end

data/lib/NeonRAW/objects/subreddit/wiki.rb

@@ -0,0 +1,31 @@
+require_relative '../thing'
+require_relative '../wikipage'
+
+module NeonRAW
+  module Objects
+    class Subreddit < Thing
+      # Methods for wiki pages.
+      module WikiPages
+        # Fetches the wiki page.
+        # @!method wikipage(page)
+        # @param page [String] The name of the page.
+        # @return [NeonRAW::Objects::WikiPage] Returns the wiki page object.
+        def wikipage(page)
+          params = { page: page }
+          path = "/r/#{display_name}/wiki/#{page}"
+          data = @client.request_data(path, :get, params)
+          data[:data][:name] = page
+          data[:data][:subreddit] = display_name
+          WikiPage.new(@client, data[:data])
+        end
+
+        # Fetches a list of wiki pages for the subreddit.
+        # @!method wikipages
+        # @return [Array<String>] Returns a list of wiki pages.
+        def wikipages
+          @client.request_data("/r/#{display_name}/wiki/pages", :get)[:data]
+        end
+      end
+    end
+  end
+end

data/lib/NeonRAW/objects/subreddit.rb

@@ -0,0 +1,223 @@
+require_relative '../objects/submission'
+require_relative '../objects/listing'
+require_relative '../objects/comment'
+require_relative '../objects/thing'
+require_relative '../objects/rule'
+require_relative 'subreddit/flair'
+require_relative 'subreddit/moderation'
+require_relative 'subreddit/utilities'
+require_relative 'subreddit/wiki'
+# rubocop:disable Metrics/MethodLength
+
+module NeonRAW
+  module Objects
+    # The subreddit object.
+    # @!attribute [r] subscribed?
+    #   @return [Boolean] Returns whether or not you're subscribed
+    #     to the subreddit.
+    # @!attribute [r] approved_submitter?
+    #   @return [Boolean] Returns whether or not you're an approved
+    #     submitter to the subreddit.
+    # @!attribute [r] moderator?
+    #   @return [Boolean] Returns whether or not you're a moderator
+    #     of the subreddit.
+    # @!attribute [r] im_banned?
+    #   @return [Boolean] Returns whether or not you're banned from
+    #     the subreddit.
+    # @!attribute [r] collapse_deleted_comments?
+    #   @return [Boolean] Returns whether or not the subreddit
+    #     collapses deleted comments.
+    # @!attribute [r] nsfw?
+    #   @return [Boolean] Returns whether or not the subreddit is
+    #     marked for adult content.
+    # @!attribute [r] muted?
+    #   @return [Boolean] Returns whether or not you're muted from
+    #     the subreddit's modmail.
+    # @!attribute [r] quarantined?
+    #   @return [Boolean] Returns whether or not the subreddit is
+    #     quarantined.
+    # @!attribute [r] public_traffic?
+    #   @return [Boolean] Returns whether or not the subreddit made
+    #     their traffic stats public.
+    # @!attribute [r] theme_enabled?
+    #   @return [Boolean] Returns whether or not you have the
+    #     subreddit theme enabled.
+    # @!attribute [r] wiki_enabled?
+    #   @return [Boolean] Returns whether or not the subreddit has
+    #     its wiki enabled.
+    # @!attribute [r] hide_ads?
+    #   @return [Boolean] Returns whether or not the subreddit hides
+    #     ads.
+    # @!attribute [r] banner_img
+    #   @return [String, nil] Returns a string container a link to the
+    #     banner image or nil if there is none.
+    # @!attribute [r] submit_text_html
+    #   @return [String, nil] Returns the text with HTML included in the
+    #     thread submission page or nil if there is none..
+    # @!attribute [r] submit_text
+    #   @return [String, nil] Returns the text included in the thread
+    #     submission page or nil if there is none.
+    # @!attribute [r] display_name
+    #   @return [String] Returns the display name of the subreddit.
+    # @!attribute [r] header_img
+    #   @return [String, nil] Returns the link to the header image
+    #     or nil if there is none.
+    # @!attribute [r] sidebar_html
+    #   @return [String, nil] Returns the subreddit's sidebar text
+    #     with HTML or nil if there is none..
+    # @!attribute [r] title
+    #   @return [String] Returns the subreddit's title.
+    # @!attribute [r] public_description
+    #   @return [String, nil] Returns the subreddit's public description or nil
+    #     if there is none..
+    # @!attribute [r] public_description_html
+    #   @return [String, nil] Returns the subreddit's public description
+    #     with HTML included or nil if there is none.
+    # @!attribute [r] suggested_comment_sort
+    #   @return [String, nil] Returns the subreddit's suggested
+    #     comment sort or nil if there isn't one [hot, top, new,
+    #     old, controversial, random]
+    # @!attribute [r] submit_link_label
+    #   @return [String, nil] Returns the subreddit's custom label
+    #     for the submit link button or nil if there is none.
+    # @!attribute [r] submit_text_label
+    #   @return [String, nil] Returns the subreddit's custom label
+    #     for the submit text button or nil if there is none.
+    # @!attribute [r] header_title
+    #   @return [String, nil] Returns the header title or nil if
+    #     there is none.
+    # @!attribute [r] sidebar
+    #   @return [String] Returns the subreddit's sidebar text.
+    # @!attribute [r] accounts_active
+    #   @return [Integer] Returns the number of users online browsing
+    #     the subreddit.
+    # @!attribute [r] header_size
+    #   @return [Array<Integer, Integer>, nil] Returns an array containing the
+    #     header's dimensions or nil if there isn't one.
+    # @!attribute [r] subscribers
+    #   @return [Integer] Returns the number of subscribers the
+    #     subreddit has.
+    # @!attribute [r] lang
+    #   @return [String] Returns the subreddit's primary language.
+    # @!attribute [r] url
+    #   @return [String] Returns the subreddit's URL.
+    # @!attribute [r] comment_score_hide_mins
+    #   @return [Integer] Returns the number of minutes that comment
+    #     scores are hidden.
+    # @!attribute [r] subreddit_type
+    #   @return [String] Returns the type of subreddit [public,
+    #     restricted, private, gold_restricted, archived].
+    # @!attribute [r] submission_type
+    #   @return [String] Returns the type of submissions allowed
+    #     to be posted [any, link, self].
+    class Subreddit < Thing
+      include Thing::Createable
+      include Thing::Refreshable
+      include Subreddit::Flair
+      include Subreddit::Moderation
+      include Subreddit::Utilities
+      include Subreddit::WikiPages
+
+      # @!method initialize(client, data)
+      # @param client [NeonRAW::Clients::Web/Installed/Script] The client.
+      # @param data [Hash] The object data.
+      def initialize(client, data)
+        @client = client
+        data.each do |key, value|
+          value = nil if ['', [], {}].include?(value)
+          instance_variable_set(:"@#{key}", value)
+          next if key == :created || key == :created_utc
+          self.class.send(:attr_reader, key)
+        end
+        class << self
+          alias_method :subscribed?, :user_is_subscriber
+          alias_method :approved_submitter?, :user_is_contributor
+          alias_method :moderator?, :user_is_moderator
+          alias_method :im_banned?, :user_is_banned
+          alias_method :collapses_deleted_comments?, :collapse_deleted_comments
+          alias_method :nsfw?, :over18
+          alias_method :muted?, :user_is_muted
+          alias_method :quarantined?, :quarantine
+          alias_method :public_traffic?, :public_traffic
+          alias_method :theme_enabled?, :user_sr_theme_enabled
+          alias_method :wiki_enabled?, :wiki_enabled
+          alias_method :hide_ads?, :hide_ads
+          alias_method :sidebar, :description
+          alias_method :sidebar_html, :description_html
+        end
+      end
+
+      # Fetches the subreddit's rules.
+      # @!method rules
+      # @return [Array<NeonRAW::Objects::Rule>] Returns a list of the rules.
+      def rules
+        data_arr = []
+        data = @client.request_data("/r/#{display_name}/about/rules.json", :get)
+        data[:rules].each do |rule|
+          data_arr << Rule.new(@client, rule)
+        end
+        data_arr
+      end
+
+      # Fetches the subreddit's stylesheet.
+      # @!method stylesheet
+      # @return [Hash<Array, String, String>] Returns the stylesheet data.
+      def stylesheet
+        path = "/r/#{display_name}/about/stylesheet.json"
+        @client.request_data(path, :get)[:data]
+      end
+
+      # @!group Listings
+      # Fetches a listing from the subreddit.
+      # @!method hot(params = { limit: 25 })
+      # @!method rising(params = { limit: 25 })
+      # @!method top(params = { limit: 25 })
+      # @!method old(params = { limit: 25 })
+      # @!method new(params = { limit: 25 })
+      # @!method controversial(params = { limit: 25 })
+      # @!method comments(param = { limit: 25 })
+      # @param params [Hash] The parameters for the request.
+      # @option params :t [String] Time for relevant sorting [hour, day, week,
+      #   month, year, all]
+      # @option params :after [String] The name of the next data block.
+      # @option params :before [String] The name of the previous data block.
+      # @option params :count [Integer] The number of items already in the
+      #   listing.
+      # @option params :limit [1..1000] The number of items to fetch.
+      # @option params :show [String] Literally the string 'all'.
+      # @return [NeonRAW::Objects::Listing] Returns the listing object.
+      %w(hot rising top old new controversial comments).each do |type|
+        define_method :"#{type}" do |params = { limit: 25 }|
+          path = "/r/#{display_name}/#{type}/.json"
+          @client.send(:build_listing, path, params)
+        end
+      end
+
+      # Search for links in the subreddit.
+      # @!method search(query, opts = { limit: 25 })
+      # @param query [String] The text to search for (512 characters maximum).
+      # @param opts [Hash] Optional parameters.
+      # @option opts :after [String] Fullname of the next data block.
+      # @option opts :before [String] Fullname of the previous data block.
+      # @option opts :count [Integer] Number of items already in the listing.
+      # @option opts :include_facets [Boolean] Whether or not to include facets.
+      # @option opts :limit [1..1000] The number of listing items to fetch.
+      # @option opts :show [String] Literally the string 'all'.
+      # @option opts :sort [String] The sort of the data [relevance, hot, top,
+      #   new, comments].
+      # @option opts :syntax [String] The type of search you want [cloudsearch,
+      #   lucene, plain]
+      # @option opts :t [String] Time for relevant sorting [hour, day, week,
+      #   month, year, all]
+      def search(query, opts = { limit: 25 })
+        params = opts
+        params[:q] = query
+        params[:restrict_sr] = true
+        params[:sr_detail] = false
+        params[:type] = 'link'
+        @client.send(:build_listing, "/r/#{display_name}/search", params)
+      end
+      # @!endgroup
+    end
+  end
+end

data/lib/NeonRAW/objects/thing/createable.rb

@@ -0,0 +1,22 @@
+module NeonRAW
+  module Objects
+    class Thing
+      # Methods for things that can be created.
+      module Createable
+        # Fetch when the thing was created.
+        # @!method created
+        # @return [Time] Returns a Time object containing the time/date.
+        def created
+          Time.at(@created)
+        end
+
+        # Fetch when the thing was created UTC.
+        # @!method created_utc
+        # @return [Time] Returns a Time object containing the time/date.
+        def created_utc
+          Time.at(@created_utc)
+        end
+      end
+    end
+  end
+end

data/lib/NeonRAW/objects/thing/editable.rb

@@ -0,0 +1,46 @@
+module NeonRAW
+  module Objects
+    class Thing
+      # Methods for editing.
+      module Editable
+        # Checks whether or not the thing was edited.
+        # @!method edited?
+        # @return [Boolean] Returns whether or not the comment was edited.
+        def edited?
+          if @edited != false
+            true
+          else
+            false
+          end
+        end
+
+        # Gets the timestamp of the thing's lastest edit.
+        # @!method last_edit
+        # @return [Float, nil] Returns the UNIX timestamp of the edit or nil if
+        #   the comment hasn't been edited.
+        # @note If you crawl some old comments on /r/reddit.com this may return
+        #   true instead of the timestamp.
+        def last_edit
+          nil || @edited if @edited != false
+        end
+
+        # Edit a thing.
+        # @!method edit!(text)
+        # @param text [String] The text to replace the current text with.
+        def edit!(text)
+          params = { api_type: 'json', text: text, thing_id: name }
+          @client.request_data('/api/editusertext', :post, params)
+          refresh!
+        end
+
+        # Deletes the thing.
+        # @!method delete!
+        def delete!
+          params = { id: name }
+          @client.request_data('/api/del', :post, params)
+          refresh!
+        end
+      end
+    end
+  end
+end

data/lib/NeonRAW/objects/thing/gildable.rb

@@ -0,0 +1,29 @@
+module NeonRAW
+  module Objects
+    class Thing
+      # Methods for things that can be gilded.
+      module Gildable
+        # Checks whether a comment was gilded or not.
+        # @!method gilded?
+        # @return [Boolean] Returns whether or not the comment was gilded.
+        def gilded?
+          if @gilded > 0
+            true
+          else
+            false
+          end
+        end
+
+        # Give a thing gold.
+        # @!method gild(quantity)
+        # @param quantity [Integer] The amount of gold to give.
+        def gild(quantity)
+          quantity.times do
+            @client.request_data("/api/v1/gold/gild/#{name}", :post)
+          end
+          refresh!
+        end
+      end
+    end
+  end
+end

data/lib/NeonRAW/objects/thing/inboxable.rb

@@ -0,0 +1,26 @@
+module NeonRAW
+  module Objects
+    class Thing
+      # Methods for things that appear in your inbox.
+      module Inboxable
+        # Changes the read status of a PM.
+        # @!method mark_as_read
+        # @!method mark_as_unread
+        %w(read unread).each do |type|
+          define_method :"mark_as_#{type}" do
+            params = { id: name }
+            @client.request_data("/api/#{type}_message", :post, params)
+          end
+        end
+
+        # Add a text reply to a comment/private message.
+        # @!method reply(text)
+        # @param text [String] The text you want to reply with.
+        def reply(text)
+          params = { api_type: 'json', text: text, thing_id: name }
+          @client.request_data('/api/comment', :post, params)
+        end
+      end
+    end
+  end
+end