lib/rescuetime/query_buildable.rb
def where(name: nil, document: nil)
      # Stand-in for required keyword arguments
      name || raise(ArgumentError, 'missing keyword: name')

      add_to_query restrict_thing:  name,
                   restrict_thingy: document
    end
def where(name: nil, document: nil)
      # Stand-in for required keyword arguments
      name || raise(ArgumentError, 'missing keyword: name')

      add_to_query restrict_thing:  name,
                   restrict_thingy: document
    end
Limits the Rescuetime report to specific activities and documents.
 The name option limits the results to those where name is an exact match;
 this can be used on the overview, activity, and category report. The
 document option limits the specific document title; this is only available
 on the activity report.

 If a value is passed for an unsupported report, it will be ignored.

 To see the category and document names for your account, please look at
 your rescuetime dashboard or generated rescuetime report.

 :name can be used on:
 - Overview report
 - Category report
 - Activity report

 :document can be used on:
 - Activity report when :name is set

 @example Basic Use
   client = Rescuetime::Client.new
   client.activities.where name: 'github.com',
                           document: 'leesharma/rescuetime'
   #=> #<Rescuetime::Collection:0x007f93841681a8>

 @example Valid reports
   client.overview.where name: 'Utilities'
   client.categories.where name: 'Intelligence'
   client.activities.where name: 'github.com'
   client.activities.where name: 'github.com', document: 'rails/rails'

 @example Invalid reports
   client.productivity.where name: 'Intelligence'  # Invalid!
   client.efficiency.where name: 'Intelligence'    # Invalid!
   client.activities.where document: 'rails/rails' # Invalid!

 @param  [String] name      Rescuetime category name, valid on overview,
                            category, and activity reports
 @param  [String] document  Specific document name, valid on activity
                            reports when :name is set

 @return [Rescuetime::Collection]  a Rescuetime Collection specifying
                                   category name and (optionally) document
 @raise [ArgumentError] if name is not set

 @see #overview
 @see #activities
 @see #categories
 @see https://www.rescuetime.com/apidoc#paramlist  Rescuetime API docs
                                                   (see: restrict_thing,
                                                   restrict_thingy)
 @since v0.3.0