Class: OnyxCord::Interactions::OptionBuilder

Inherits:
Object
  • Object
show all
Defined in:
lib/onyxcord/interactions/internal/option_builder.rb

Overview

A builder for defining slash commands options.

Constant Summary collapse

CHANNEL_TYPES =

Channel types that can be provided to #channel

{
  text: 0,
  dm: 1,
  voice: 2,
  group_dm: 3,
  category: 4,
  news: 5,
  store: 6,
  news_thread: 10,
  public_thread: 11,
  private_thread: 12,
  stage: 13
}.freeze

Instance Attribute Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#options ⇒ Array<Hash> (readonly)

Returns:

  • (Array<Hash>) 


38
39
40
 
# File 'lib/onyxcord/interactions/internal/option_builder.rb', line 38

def options
  @options
end

Instance Method Details

#attachment(name, description, required: nil, name_localizations: nil, description_localizations: nil) ⇒ Object

Returns Hash.

Parameters:

  • name (String, Symbol) —

    The name of the argument.

  • description (String) —

    A description of the argument.

  • required (true, false) (defaults to: nil) —

    Whether this option must be provided.

Returns:

  • Hash



179
180
181
182
 
# File 'lib/onyxcord/interactions/internal/option_builder.rb', line 179

def attachment(name, description, required: nil, name_localizations: nil, description_localizations: nil)
  option(TYPES[:attachment], name, description, required: required,
                                                name_localizations: name_localizations, description_localizations: description_localizations)
end

#boolean(name, description, required: nil, name_localizations: nil, description_localizations: nil) ⇒ Object

Returns Hash.

Parameters:

  • name (String, Symbol) —

    The name of the argument.

  • description (String) —

    A description of the argument.

  • required (true, false) (defaults to: nil) —

    Whether this option must be provided.

Returns:

  • Hash



117
118
119
120
 
# File 'lib/onyxcord/interactions/internal/option_builder.rb', line 117

def boolean(name, description, required: nil, name_localizations: nil, description_localizations: nil)
  option(TYPES[:boolean], name, description, required: required,
                                             name_localizations: name_localizations, description_localizations: description_localizations)
end

#channel(name, description, required: nil, types: nil, name_localizations: nil, description_localizations: nil) ⇒ Object

Returns Hash.

Parameters:

  • name (String, Symbol) —

    The name of the argument.

  • description (String) —

    A description of the argument.

  • required (true, false) (defaults to: nil) —

    Whether this option must be provided.

  • types (Array<Symbol, Integer>) (defaults to: nil) —

    See CHANNEL_TYPES

Returns:

  • Hash



136
137
138
139
140
 
# File 'lib/onyxcord/interactions/internal/option_builder.rb', line 136

def channel(name, description, required: nil, types: nil, name_localizations: nil, description_localizations: nil)
  types = types&.collect { |type| type.is_a?(Numeric) ? type : CHANNEL_TYPES[type] }
  option(TYPES[:channel], name, description, required: required, channel_types: types,
                                             name_localizations: name_localizations, description_localizations: description_localizations)
end

#integer(name, description, required: nil, min_value: nil, max_value: nil, choices: nil, autocomplete: nil, name_localizations: nil, description_localizations: nil, choice_localizations: nil) ⇒ Object

Returns Hash.

Parameters:

  • name (String, Symbol) —

    The name of the argument.

  • description (String) —

    A description of the argument.

  • required (true, false) (defaults to: nil) —

    Whether this option must be provided.

  • min_value (Integer) (defaults to: nil) —

    A minimum value for option.

  • max_value (Integer) (defaults to: nil) —

    A maximum value for option.

  • choices (Hash, nil) (defaults to: nil) —

    Available choices, mapped as Name => Value.

  • autocomplete (true, false) (defaults to: nil) —

    Whether this option can dynamically show choices.

Returns:

  • Hash



105
106
107
108
109
110
111
 
# File 'lib/onyxcord/interactions/internal/option_builder.rb', line 105

def integer(name, description, required: nil, min_value: nil, max_value: nil, choices: nil, autocomplete: nil,
            name_localizations: nil, description_localizations: nil, choice_localizations: nil)
  option(TYPES[:integer], name, description,
         required: required, min_value: min_value, max_value: max_value, choices: choices, autocomplete: autocomplete,
         name_localizations: name_localizations, description_localizations: description_localizations,
         choice_localizations: choice_localizations)
end

#mentionable(name, description, required: nil, name_localizations: nil, description_localizations: nil) ⇒ Object

Returns Hash.

Parameters:

  • name (String, Symbol) —

    The name of the argument.

  • description (String) —

    A description of the argument.

  • required (true, false) (defaults to: nil) —

    Whether this option must be provided.

Returns:

  • Hash



155
156
157
158
 
# File 'lib/onyxcord/interactions/internal/option_builder.rb', line 155

def mentionable(name, description, required: nil, name_localizations: nil, description_localizations: nil)
  option(TYPES[:mentionable], name, description, required: required,
                                                 name_localizations: name_localizations, description_localizations: description_localizations)
end

#number(name, description, required: nil, min_value: nil, max_value: nil, choices: nil, autocomplete: nil, name_localizations: nil, description_localizations: nil, choice_localizations: nil) ⇒ Object

Returns Hash.

Parameters:

  • name (String, Symbol) —

    The name of the argument.

  • description (String) —

    A description of the argument.

  • required (true, false) (defaults to: nil) —

    Whether this option must be provided.

  • min_value (Float) (defaults to: nil) —

    A minimum value for option.

  • max_value (Float) (defaults to: nil) —

    A maximum value for option.

  • autocomplete (true, false) (defaults to: nil) —

    Whether this option can dynamically show choices.

Returns:

  • Hash



167
168
169
170
171
172
173
 
# File 'lib/onyxcord/interactions/internal/option_builder.rb', line 167

def number(name, description, required: nil, min_value: nil, max_value: nil, choices: nil, autocomplete: nil,
           name_localizations: nil, description_localizations: nil, choice_localizations: nil)
  option(TYPES[:number], name, description,
         required: required, min_value: min_value, max_value: max_value, choices: choices, autocomplete: autocomplete,
         name_localizations: name_localizations, description_localizations: description_localizations,
         choice_localizations: choice_localizations)
end

#role(name, description, required: nil, name_localizations: nil, description_localizations: nil) ⇒ Object

Returns Hash.

Parameters:

  • name (String, Symbol) —

    The name of the argument.

  • description (String) —

    A description of the argument.

  • required (true, false) (defaults to: nil) —

    Whether this option must be provided.

Returns:

  • Hash



146
147
148
149
 
# File 'lib/onyxcord/interactions/internal/option_builder.rb', line 146

def role(name, description, required: nil, name_localizations: nil, description_localizations: nil)
  option(TYPES[:role], name, description, required: required,
                                          name_localizations: name_localizations, description_localizations: description_localizations)
end

#string(name, description, required: nil, min_length: nil, max_length: nil, choices: nil, autocomplete: nil, name_localizations: nil, description_localizations: nil, choice_localizations: nil) ⇒ Object

Returns Hash.

Parameters:

  • name (String, Symbol) —

    The name of the argument.

  • description (String) —

    A description of the argument.

  • required (true, false) (defaults to: nil) —

    Whether this option must be provided.

  • min_length (Integer) (defaults to: nil) —

    A minimum length for option value.

  • max_length (Integer) (defaults to: nil) —

    A maximum length for option value.

  • choices (Hash, nil) (defaults to: nil) —

    Available choices, mapped as Name => Value.

  • autocomplete (true, false) (defaults to: nil) —

    Whether this option can dynamically show choices.

Returns:

  • Hash



89
90
91
92
93
94
95
 
# File 'lib/onyxcord/interactions/internal/option_builder.rb', line 89

def string(name, description, required: nil, min_length: nil, max_length: nil, choices: nil, autocomplete: nil,
           name_localizations: nil, description_localizations: nil, choice_localizations: nil)
  option(TYPES[:string], name, description,
         required: required, min_length: min_length, max_length: max_length, choices: choices, autocomplete: autocomplete,
         name_localizations: name_localizations, description_localizations: description_localizations,
         choice_localizations: choice_localizations)
end

#subcommand(name, description) {|| ... } ⇒ Object

Returns Hash.

Examples:

bot.register_application_command(:test, 'Test command') do |cmd|
  cmd.subcommand(:echo) do |sub|
    sub.string('message', 'What to echo back', required: true)
  end
end

Parameters:

  • name (String, Symbol) —

    The name of the subcommand.

  • description (String) —

    A description of the subcommand.

Yield Parameters:

Returns:

  • Hash



55
56
57
58
59
60
 
# File 'lib/onyxcord/interactions/internal/option_builder.rb', line 55

def subcommand(name, description)
  builder = OptionBuilder.new
  yield builder if block_given?

  option(TYPES[:subcommand], name, description, options: builder.to_a)
end

#subcommand_group(name, description) {|| ... } ⇒ Object

Returns Hash.

Examples:

bot.register_application_command(:test, 'Test command') do |cmd|
  cmd.subcommand_group(:fun) do |group|
    group.subcommand(:8ball) do |sub|
      sub.string(:question, 'What do you ask the mighty 8ball?')
    end
  end
end

Parameters:

  • name (String, Symbol) —

    The name of the subcommand group.

  • description (String) —

    A description of the subcommand group.

Yield Parameters:

Returns:

  • Hash



74
75
76
77
78
79
 
# File 'lib/onyxcord/interactions/internal/option_builder.rb', line 74

def subcommand_group(name, description)
  builder = OptionBuilder.new
  yield builder

  option(TYPES[:subcommand_group], name, description, options: builder.to_a)
end

#to_a ⇒ Array<Hash>

Returns:

  • (Array<Hash>) 


212
213
214
 
# File 'lib/onyxcord/interactions/internal/option_builder.rb', line 212

def to_a
  @options
end

#user(name, description, required: nil, name_localizations: nil, description_localizations: nil) ⇒ Object

Returns Hash.

Parameters:

  • name (String, Symbol) —

    The name of the argument.

  • description (String) —

    A description of the argument.

  • required (true, false) (defaults to: nil) —

    Whether this option must be provided.

Returns:

  • Hash



126
127
128
129
 
# File 'lib/onyxcord/interactions/internal/option_builder.rb', line 126

def user(name, description, required: nil, name_localizations: nil, description_localizations: nil)
  option(TYPES[:user], name, description, required: required,
                                          name_localizations: name_localizations, description_localizations: description_localizations)
end