Class: HTTY::CLI::Commands::QueryAdd

Inherits:

HTTY::CLI::Command

• Object
• HTTY::CLI::Command
• HTTY::CLI::Commands::QueryAdd

show all

Includes:

Display, UrlEscaping

Defined in:

lib/htty/cli/commands/query_add.rb

Overview

Constant Summary

Constant Summary

Constants included from Display

Display::FORMATS

Instance Attribute Summary

Attributes inherited from HTTY::CLI::Command

#arguments, #session

Class Method Summary (collapse)

• + (Object) category

  Returns the name of a category under which help for the query-add command should appear.

• + (Object) command_line_arguments

  Returns the arguments for the command-line usage of the query-add command.

• + (Object) help

  Returns the help text for the query-add command.

• + (Object) help_extended

  Returns the extended help text for the query-add command.

• + (Object) see_also_commands

  Returns related command classes for the query-add command.

Instance Method Summary (collapse)

• - (Object) perform

  Performs the query-add command.

Methods included from UrlEscaping

#escape_or_warn_of_escape_sequences

Methods included from Display

#format, #indent, #logotype, #normal, #notice, #pluralize, #prompt, #rescuing_from, #say, #say_goodbye, #say_header, #say_hello, #show_headers, #show_request, #show_response, #strong, #word_wrap, #word_wrap_indented

Methods inherited from HTTY::CLI::Command

#add_request_if_new, alias_for, aliases, build_for, command_line, complete_for?, #initialize, notify_if_cookies_cleared, raw_name

23
24
25

# File 'lib/htty/cli/commands/query_add.rb', line 23

def self.category
  'Navigation'
end

28
29
30

# File 'lib/htty/cli/commands/query_add.rb', line 28

def self.command_line_arguments
  'NAME [VALUE [NAME [VALUE ...]]]'
end

33
34
35

# File 'lib/htty/cli/commands/query_add.rb', line 33

def self.help
  "Adds query-string parameters to the request's address"
end

38
39
40
41
42
43
44
45
46
47
48
49
50

# File 'lib/htty/cli/commands/query_add.rb', line 38

def self.help_extended
  'Adds one or more query-string parameters used for the request. Does not ' +
  "communicate with the host.\n"                                             +
  "\n"                                                                       +
  'The difference between this command and '                                 +
  "#{strong HTTY::CLI::Commands::QuerySet.command_line} is that this "       +
  "command adds duplicate parameters instead of replacing any of them.\n"    +
  "\n"                                                                       +
  'The name(s) and value(s) of the query-string parameter(s) will be URL-'   +
  "encoded if necessary.\n"                                                  +
  "\n"                                                                       +
  'The console prompt shows the address for the current request.'
end

53
54
55
56
57
58
59

# File 'lib/htty/cli/commands/query_add.rb', line 53

def self.see_also_commands
  [HTTY::CLI::Commands::QueryRemove,
   HTTY::CLI::Commands::QuerySet,
   HTTY::CLI::Commands::QueryUnset,
   HTTY::CLI::Commands::QueryUnsetAll,
   HTTY::CLI::Commands::Address]
end

62
63
64
65
66
67
68
69
70
71
72

# File 'lib/htty/cli/commands/query_add.rb', line 62

def perform
  add_request_if_new do |request|
    self.class.notify_if_cookies_cleared request do
      escaped_arguments = escape_or_warn_of_escape_sequences(arguments)
      escaped_arguments.each_slice 2 do |name, value|
        request = request.query_add(name, value)
      end
      request
    end
  end
end