| @@ -18,9 +18,6 @@ The name and description help users find your command among many others, and the | |||||
| Message and User commands are only a name, to the user. So try to make the name descriptive. | Message and User commands are only a name, to the user. So try to make the name descriptive. | ||||
| They're accessed by right clicking (or long press, on mobile) a user or a message, respectively. | They're accessed by right clicking (or long press, on mobile) a user or a message, respectively. | ||||
| > [!IMPORTANT] | |||||
| > Context menu commands are currently not supported on mobile. | |||||
| All three varieties of application commands have both Global and Guild variants. | All three varieties of application commands have both Global and Guild variants. | ||||
| Your global commands are available in every guild that adds your application. | Your global commands are available in every guild that adds your application. | ||||
| You can also make commands for a specific guild; they're only available in that guild. | You can also make commands for a specific guild; they're only available in that guild. | ||||
| @@ -172,13 +172,14 @@ namespace Discord | |||||
| ServerRequiresMonetization = 50097, | ServerRequiresMonetization = 50097, | ||||
| ServerRequiresBoosts = 50101, | ServerRequiresBoosts = 50101, | ||||
| RequestBodyContainsInvalidJSON = 50109, | RequestBodyContainsInvalidJSON = 50109, | ||||
| #endregion | |||||
| #region 2FA (60XXX) | |||||
| FailedToResizeAssetBelowTheMaximumSize = 50138, | |||||
| OwnershipCannotBeTransferredToABotUser = 50132, | OwnershipCannotBeTransferredToABotUser = 50132, | ||||
| AssetResizeBelowTheMaximumSize= 50138, | AssetResizeBelowTheMaximumSize= 50138, | ||||
| UploadedFileNotFound = 50146, | UploadedFileNotFound = 50146, | ||||
| MissingPermissionToSendThisSticker = 50600, | MissingPermissionToSendThisSticker = 50600, | ||||
| #endregion | |||||
| #region 2FA (60XXX) | |||||
| Requires2FA = 60003, | Requires2FA = 60003, | ||||
| #endregion | #endregion | ||||
| @@ -106,13 +106,17 @@ namespace Discord | |||||
| get => _nameLocalizations; | get => _nameLocalizations; | ||||
| set | set | ||||
| { | { | ||||
| foreach (var (locale, name) in value) | |||||
| if (value != null) | |||||
| { | { | ||||
| if(!Regex.IsMatch(locale, @"^\w{2}(?:-\w{2})?$")) | |||||
| throw new ArgumentException($"Invalid locale: {locale}", nameof(locale)); | |||||
| foreach (var (locale, name) in value) | |||||
| { | |||||
| if(!Regex.IsMatch(locale, @"^\w{2}(?:-\w{2})?$")) | |||||
| throw new ArgumentException($"Invalid locale: {locale}", nameof(locale)); | |||||
| EnsureValidOptionName(name); | |||||
| EnsureValidOptionName(name); | |||||
| } | |||||
| } | } | ||||
| _nameLocalizations = value; | _nameLocalizations = value; | ||||
| } | } | ||||
| } | } | ||||
| @@ -126,13 +130,17 @@ namespace Discord | |||||
| get => _descriptionLocalizations; | get => _descriptionLocalizations; | ||||
| set | set | ||||
| { | { | ||||
| foreach (var (locale, description) in value) | |||||
| if (value != null) | |||||
| { | { | ||||
| if(!Regex.IsMatch(locale, @"^\w{2}(?:-\w{2})?$")) | |||||
| throw new ArgumentException($"Invalid locale: {locale}", nameof(locale)); | |||||
| foreach (var (locale, description) in value) | |||||
| { | |||||
| if(!Regex.IsMatch(locale, @"^\w{2}(?:-\w{2})?$")) | |||||
| throw new ArgumentException($"Invalid locale: {locale}", nameof(locale)); | |||||
| EnsureValidOptionDescription(description); | |||||
| EnsureValidOptionDescription(description); | |||||
| } | |||||
| } | } | ||||
| _descriptionLocalizations = value; | _descriptionLocalizations = value; | ||||
| } | } | ||||
| } | } | ||||
| @@ -55,18 +55,21 @@ namespace Discord | |||||
| get => _nameLocalizations; | get => _nameLocalizations; | ||||
| set | set | ||||
| { | { | ||||
| foreach (var (locale, name) in value) | |||||
| if (value != null) | |||||
| { | { | ||||
| if (!Regex.IsMatch(locale, @"^\w{2}(?:-\w{2})?$")) | |||||
| throw new ArgumentException("Key values of the dictionary must be valid language codes."); | |||||
| switch (name.Length) | |||||
| foreach (var (locale, name) in value) | |||||
| { | { | ||||
| case > 100: | |||||
| throw new ArgumentOutOfRangeException(nameof(value), | |||||
| "Name length must be less than or equal to 100."); | |||||
| case 0: | |||||
| throw new ArgumentOutOfRangeException(nameof(value), "Name length must at least 1."); | |||||
| if (!Regex.IsMatch(locale, @"^\w{2}(?:-\w{2})?$")) | |||||
| throw new ArgumentException("Key values of the dictionary must be valid language codes."); | |||||
| switch (name.Length) | |||||
| { | |||||
| case > 100: | |||||
| throw new ArgumentOutOfRangeException(nameof(value), | |||||
| "Name length must be less than or equal to 100."); | |||||
| case 0: | |||||
| throw new ArgumentOutOfRangeException(nameof(value), "Name length must at least 1."); | |||||
| } | |||||
| } | } | ||||
| } | } | ||||
| @@ -35,17 +35,21 @@ namespace Discord | |||||
| get => _nameLocalizations; | get => _nameLocalizations; | ||||
| set | set | ||||
| { | { | ||||
| foreach (var (locale, name) in value) | |||||
| if (value != null) | |||||
| { | { | ||||
| if(!Regex.IsMatch(locale, @"^\w{2}(?:-\w{2})?$")) | |||||
| throw new ArgumentException($"Invalid locale: {locale}", nameof(locale)); | |||||
| foreach (var (locale, name) in value) | |||||
| { | |||||
| if (!Regex.IsMatch(locale, @"^\w{2}(?:-\w{2})?$")) | |||||
| throw new ArgumentException($"Invalid locale: {locale}", nameof(locale)); | |||||
| Preconditions.AtLeast(name.Length, 1, nameof(name)); | |||||
| Preconditions.AtMost(name.Length, SlashCommandBuilder.MaxNameLength, nameof(name)); | |||||
| Preconditions.AtLeast(name.Length, 1, nameof(name)); | |||||
| Preconditions.AtMost(name.Length, SlashCommandBuilder.MaxNameLength, nameof(name)); | |||||
| if (Type == ApplicationCommandType.Slash && !Regex.IsMatch(name, @"^[-_\p{L}\p{N}\p{IsDevanagari}\p{IsThai}]{1,32}$")) | |||||
| throw new ArgumentException(@"Name must match the regex ^[-_\p{L}\p{N}\p{IsDevanagari}\p{IsThai}]{1,32}$", nameof(name)); | |||||
| if (Type == ApplicationCommandType.Slash && !Regex.IsMatch(name, @"^[-_\p{L}\p{N}\p{IsDevanagari}\p{IsThai}]{1,32}$")) | |||||
| throw new ArgumentException(@"Name must match the regex ^[-_\p{L}\p{N}\p{IsDevanagari}\p{IsThai}]{1,32}$", nameof(name)); | |||||
| } | |||||
| } | } | ||||
| _nameLocalizations = value; | _nameLocalizations = value; | ||||
| } | } | ||||
| } | } | ||||
| @@ -58,14 +62,18 @@ namespace Discord | |||||
| get => _descriptionLocalizations; | get => _descriptionLocalizations; | ||||
| set | set | ||||
| { | { | ||||
| foreach (var (locale, description) in value) | |||||
| if (value != null) | |||||
| { | { | ||||
| if(!Regex.IsMatch(locale, @"^\w{2}(?:-\w{2})?$")) | |||||
| throw new ArgumentException($"Invalid locale: {locale}", nameof(locale)); | |||||
| foreach (var (locale, description) in value) | |||||
| { | |||||
| if (!Regex.IsMatch(locale, @"^\w{2}(?:-\w{2})?$")) | |||||
| throw new ArgumentException($"Invalid locale: {locale}", nameof(locale)); | |||||
| Preconditions.AtLeast(description.Length, 1, nameof(description)); | |||||
| Preconditions.AtMost(description.Length, SlashCommandBuilder.MaxDescriptionLength, nameof(description)); | |||||
| Preconditions.AtLeast(description.Length, 1, nameof(description)); | |||||
| Preconditions.AtMost(description.Length, SlashCommandBuilder.MaxDescriptionLength, nameof(description)); | |||||
| } | |||||
| } | } | ||||
| _descriptionLocalizations = value; | _descriptionLocalizations = value; | ||||
| } | } | ||||
| } | } | ||||
| @@ -0,0 +1,37 @@ | |||||
| using System; | |||||
| using Discord; | |||||
| using Xunit; | |||||
| namespace Discord; | |||||
| public class CommandBuilderTests | |||||
| { | |||||
| [Fact] | |||||
| public void BuildSimpleSlashCommand() | |||||
| { | |||||
| var command = new SlashCommandBuilder() | |||||
| .WithName("command") | |||||
| .WithDescription("description") | |||||
| .AddOption( | |||||
| "option1", | |||||
| ApplicationCommandOptionType.String, | |||||
| "option1 description", | |||||
| isRequired: true, | |||||
| choices: new [] | |||||
| { | |||||
| new ApplicationCommandOptionChoiceProperties() | |||||
| { | |||||
| Name = "choice1", Value = "1" | |||||
| } | |||||
| }) | |||||
| .AddOptions(new SlashCommandOptionBuilder() | |||||
| .WithName("option2") | |||||
| .WithDescription("option2 description") | |||||
| .WithType(ApplicationCommandOptionType.String) | |||||
| .WithRequired(true) | |||||
| .AddChannelType(ChannelType.Text) | |||||
| .AddChoice("choice1", "1") | |||||
| .AddChoice("choice2", "2")); | |||||
| command.Build(); | |||||
| } | |||||
| } | |||||