rotom_bot/app/embeds/help.rb

HELP_BLUE = '#4976ca'.freeze

def command_list_embed(commands, restriction = nil)
  fields = []
  desc = 'To learn more about any of the listed commands,' +
         ' use `pkmn-help [command]`'

  commands.each do |cmd|
    fields.push({name: "pkmn-#{cmd.name}", value: cmd.cmd.description})
  end

  case restriction
  when :pm
    title = 'PM Commands'
    desc = "Can only be used in a PM with <@639191920786276378> \n" +
           'To learn more about any of the listed commands, use `pkmn-help [command]`'

  end

  Embed.new(
    title: title || 'Commands',
    description: desc,
    color: HELP_BLUE,
    fields: fields
  )
end

def command_help(command, event)
  embed = Embed.new(
    title: command.to_s.gsub('Command', ' Command'),
    description: command.cmd.description,
    color: HELP_BLUE,
    footer: { text: 'For more help, ask a Guild Master!' }
  )

  # Apply options, if there are any
  fields = command_usage(command, event) unless command.cmd.options.empty?
  # If in the admin channel, show additional admin options
  fields = admin_options(command, fields) if event.channel.id == ENV['ADMIN_CH'].to_i

  # Apply fields and return
  embed.fields = fields
  embed
end

def command_usage(command, event)
  # save the options, to shorten the logic later
  opts = command.cmd.options
  example = command.example_command(event)
  fields = []

  # Add navigation information, if there is any
  if opts[:nav]
    fields.push({
                  name: 'Reaction Navigation',
                  value: opts[:nav].map { |k, v| "#{v[0]} - `#{k}` - #{v[1]}" }.join("\n")
                })
  end

  # Save the command with its options, and the option instructions
  structure = "```pkmn-#{command.name} #{opts[:usage].map { |k, _v| k }.join(' | ')}```"
  instructions = opts[:usage].map { |k, v| "- `#{k}` -- #{v}" }.join("\n")

  # Add usage information
  fields.push({
                name: 'Command Usage',
                value: "#{structure}\n#{instructions}"
              })

  # Add an example command
  fields.push({
                name: 'Example',
                value: "```pkmn-#{command.name} #{example.join(' | ')}```"
              })
end

def admin_options(command, fields)
  # Find the admin options, and return if there are none
  r_opts = command.admin_opts
  return fields unless r_opts

  # Save the command with its options, and the option instructions
  structure = "```pkmn-#{command.name} #{r_opts[:usage].map { |k, _v| k }.join(' | ')}```"
  instructions = r_opts[:usage].map { |k, v| "- `#{k}` -- #{v}" }.join("\n")

  # Add usage information
  fields.push({
                name: 'Administrator Options',
                value: "#{structure}\n#{instructions}"
              })

  fields
end

def command_error(title, command, event=nil)
  embed = Embed.new(
    title: title,
    description: command.cmd.description,
    color: ERROR_RED,
    footer: { text: 'For more help, ask a Guild Master!' }
  )

  # Apply options, if there are any
  fields = command_usage(command, event) unless command.cmd.options.empty?
  # If in the admin channel, show additional admin options
  fields = admin_options(command, fields) if event&.channel&.id == ENV['ADMIN_CH'].to_i

  # Apply fields and return
  embed.fields = fields
  embed
end