Class: Discordrb::ApplicationCommand

Inherits:
Object
  • Object
show all
Defined in:
lib/discordrb/data/interaction.rb

Overview

An ApplicationCommand for slash commands.

Defined Under Namespace

Classes: Permission

Constant Summary collapse

TYPES =

Command types. chat_input is a command that appears in the text input field. user and message types appear as context menus for the respective resource.

{
  chat_input: 1,
  user: 2,
  message: 3
}.freeze

Instance Attribute Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#application_id ⇒ Integer (readonly)

Returns:



423
424
425
 
# File 'lib/discordrb/data/interaction.rb', line 423

def application_id
  @application_id
end

#contexts ⇒ Array<Integer> (readonly)

Returns:



447
448
449
 
# File 'lib/discordrb/data/interaction.rb', line 447

def contexts
  @contexts
end

#default_permission ⇒ true, false (readonly)

Returns:

  • (true, false) 


435
436
437
 
# File 'lib/discordrb/data/interaction.rb', line 435

def default_permission
  @default_permission
end

#description ⇒ String (readonly)

Returns:



432
433
434
 
# File 'lib/discordrb/data/interaction.rb', line 432

def description
  @description
end

#id ⇒ Integer (readonly)

Returns:



441
442
443
 
# File 'lib/discordrb/data/interaction.rb', line 441

def id
  @id
end

#integration_types ⇒ Array<Integer> (readonly)

Returns:



450
451
452
 
# File 'lib/discordrb/data/interaction.rb', line 450

def integration_types
  @integration_types
end

#name ⇒ String (readonly)

Returns:



429
430
431
 
# File 'lib/discordrb/data/interaction.rb', line 429

def name
  @name
end

#nsfw ⇒ true, false (readonly)

Returns:

  • (true, false) 


444
445
446
 
# File 'lib/discordrb/data/interaction.rb', line 444

def nsfw
  @nsfw
end

#options ⇒ Hash (readonly)

Returns:

  • (Hash) 


438
439
440
 
# File 'lib/discordrb/data/interaction.rb', line 438

def options
  @options
end

#server_id ⇒ Integer? (readonly)

Returns:



426
427
428
 
# File 'lib/discordrb/data/interaction.rb', line 426

def server_id
  @server_id
end

Instance Method Details

#delete ⇒ Object

Delete this application command.



497
498
499
 
# File 'lib/discordrb/data/interaction.rb', line 497

def delete
  @bot.delete_application_command(@id, server_id: @server_id)
end

#edit(name: nil, description: nil, default_permission: nil, nsfw: nil) {|, | ... } ⇒ Object

Parameters:

  • name (String) (defaults to: nil) —

    The name to use for this command.

  • description (String) (defaults to: nil) —

    The description of this command.

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

    Whether this command is available with default permissions.

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

    Whether this command should be marked as age-restricted.

Yield Parameters:

  • (OptionBuilder)
  • (PermissionBuilder) 


491
492
493
 
# File 'lib/discordrb/data/interaction.rb', line 491

def edit(name: nil, description: nil, default_permission: nil, nsfw: nil, &block)
  @bot.edit_application_command(@id, server_id: @server_id, name: name, description: description, default_permission: default_permission, nsfw: nsfw, &block)
end

#mention(subcommand_group: nil, subcommand: nil) ⇒ String Also known as: to_s

Returns the layout to mention it in a message.

Parameters:

  • subcommand (String, nil) (defaults to: nil) —

    The subcommand to mention.

  • subcommand_group (String, nil) (defaults to: nil) —

    The subcommand group to mention.

Returns:

  • (String) —

    the layout to mention it in a message



471
472
473
474
475
476
477
478
479
480
481
 
# File 'lib/discordrb/data/interaction.rb', line 471

def mention(subcommand_group: nil, subcommand: nil)
  if subcommand_group && subcommand
    "</#{name} #{subcommand_group} #{subcommand}:#{id}>"
  elsif subcommand_group
    "</#{name} #{subcommand_group}:#{id}>"
  elsif subcommand
    "</#{name} #{subcommand}:#{id}>"
  else
    "</#{name}:#{id}>"
  end
end

#permissions(server_id: nil) ⇒ Array<Permission>

Get the permission configuration for this application command in a specific server.

Parameters:

  • server_id (Integer, String, nil) (defaults to: nil) —

    The ID of the server to fetch command permissions for.

Returns:

  • (Array<Permission>) —

    the permissions for this application command in the given server.



504
505
506
507
508
509
510
511
512
 
# File 'lib/discordrb/data/interaction.rb', line 504

def permissions(server_id: nil)
  raise ArgumentError, 'A server ID must be provided for global application commands' if @server_id.nil? && server_id.nil?

  response = JSON.parse(API::Application.get_application_command_permissions(@bot.token, @bot.profile.id, @server_id || server_id&.resolve_id, @id))
  response['permissions'].map { |permission| Permission.new(permission, response, @bot) }
rescue Discordrb::Errors::UnknownError
  # If there aren't any explicit overwrites configured for the command, the response is a 400.
  []
end