From 6a5cf07e0a619ab3aa7f457bf48e3f31fc271719 Mon Sep 17 00:00:00 2001 From: Hsu Still <341464@gmail.com> Date: Mon, 19 Mar 2018 14:09:50 +0800 Subject: [PATCH] Comply with CONTRIBUTING.md - As well as making minor adjustments here and there --- docs/faq/0-GettingStarted.md | 37 ------- docs/faq/1-Basics.md | 18 ---- docs/faq/2-BasicOperations.md | 75 -------------- docs/faq/4-Commands.md | 81 --------------- docs/faq/5-Legacy.md | 11 -- ...AdvancedOperations.md => AdvancedOperations.md} | 0 docs/faq/BasicOperations.md | 74 +++++++++++++ docs/faq/ClientBasics.md | 47 +++++++++ docs/faq/Commands.md | 114 +++++++++++++++++++++ docs/faq/GettingStarted.md | 71 +++++++++++++ docs/faq/Glossary.md | 18 ++++ docs/faq/Legacy.md | 19 ++++ docs/faq/images/snowflake.png | Bin 0 -> 73062 bytes docs/faq/samples/basics/cast.cs | 15 +++ docs/faq/samples/basics/emoji.cs | 18 ++++ docs/faq/samples/commands/DI.cs | 27 +++++ docs/faq/samples/commands/Remainder.cs | 19 ++++ docs/faq/toc.yml | 14 +-- 18 files changed, 430 insertions(+), 228 deletions(-) delete mode 100644 docs/faq/0-GettingStarted.md delete mode 100644 docs/faq/1-Basics.md delete mode 100644 docs/faq/2-BasicOperations.md delete mode 100644 docs/faq/4-Commands.md delete mode 100644 docs/faq/5-Legacy.md rename docs/faq/{3-AdvancedOperations.md => AdvancedOperations.md} (100%) create mode 100644 docs/faq/BasicOperations.md create mode 100644 docs/faq/ClientBasics.md create mode 100644 docs/faq/Commands.md create mode 100644 docs/faq/GettingStarted.md create mode 100644 docs/faq/Glossary.md create mode 100644 docs/faq/Legacy.md create mode 100644 docs/faq/images/snowflake.png create mode 100644 docs/faq/samples/basics/cast.cs create mode 100644 docs/faq/samples/basics/emoji.cs create mode 100644 docs/faq/samples/commands/DI.cs create mode 100644 docs/faq/samples/commands/Remainder.cs diff --git a/docs/faq/0-GettingStarted.md b/docs/faq/0-GettingStarted.md deleted file mode 100644 index 4b0c5cc36..000000000 --- a/docs/faq/0-GettingStarted.md +++ /dev/null @@ -1,37 +0,0 @@ -# Basic Concepts / Getting Started - -## How do I get started? -First of all, welcome! Before you delve into using the library, however, you should have some decent understanding of the language you are about to use. This library touches on TAP (Task-based Asynchronous Pattern), polymorphism, interface and many more advanced topics extensively. Please make sure that you understand these topics to some extent before proceeding. - - Here are some examples: - 1. [Official quick start guide](https://github.com/RogueException/Discord.Net/blob/dev/docs/guides/getting_started/samples/intro/structure.cs) - 2. [Official template](https://github.com/foxbot/DiscordBotBase/tree/csharp/src/DiscordBot) - -Please note that you should *not* try to blindly copy paste the code. It is meant to be a template or a guide. It is not meant to be something that will work out of the box. - -## How do I add my bot to my server/guild? - -The [OAuth2 URL](https://discordapp.com/developers/tools/oauth2-url-generator) can be generated via the Discord developer page. This allows you to set the permissions that the bot will be added with. With this method, bots will also be assigned their own special roles that normal users cannot use, which is what we call a `Managed` role. - -## What is a Client/User/Object ID? Is it the token? - -Each user and object on Discord has its own snowflake ID generated based on various conditions, see [here](https://this.is-a-professional-domain.com/7da0e4.png). The ID can be seen by anyone; it is public. It is merely used to identify an object in the Discord ecosystem. Many things in the library require an ID to retrieve the said object. - - There are 2 ways to obtain the said ID. - 1. Enable Discord's developer mode. With developer mode enabled, you can - as an example - right click on a guild and copy the guild id (please note that this does not apply to Role IDs, see below). - ![Developer Mode](images/dev-mode.png) - 2. Escape the object using `\` in front the object. For example, when you do `\@Example#1234`, it will return the user ID of the aforementioned user. - -A token is a credential used to log into an account. This information should be kept **private** and for your eyes only. Anyone with your token can log into your account. This applies to both user and bot accounts. That also means that you should never ever hardcode your token or add it into source control, as your identity may be stolen by scrape bots on the internet that scours through constantly to obtain a token. - -## How do I get the role ID? - -Several common ways to do this: - 1. Make the role mentionable and mention the role, and escape it using the `\` character in front. - 2. Inspect the roles collection within the guild via your debugger. - -Please note that right-clicking on the role and copying the ID will **not** work. It will only copy the message ID. - -## I have more questions! - -Please visit us at #dotnet_discord-net at the Discord API server. Describe the problem in details to us, and preferably with the problematic code uploaded onto [Hastebin](https://hastebin.com). diff --git a/docs/faq/1-Basics.md b/docs/faq/1-Basics.md deleted file mode 100644 index a30e1c252..000000000 --- a/docs/faq/1-Basics.md +++ /dev/null @@ -1,18 +0,0 @@ -# Client Basics Questions - -## My client keeps returning 401 upon logging in! - - There are few possible reasons why this may occur. - 1. You are not using the appropriate `TokenType`. If you are using a bot account created from the Discord Developer portal, you should be using `TokenType.Bot`. - 2. You are not using the correct login credentials. Please keep in mind that tokens start with `Mj*`. If it starts with any other characters, chances are, you are using the *client secret*, which has nothing to do with the login token. - -## How do I do X, Y, Z when my bot connects/logs on? Why do I get a `NullReferenceException` upon calling any client methods after connect? - - Your bot should not attempt to interact in any way with guilds/servers until the `Ready` event fires. When the bot connects, it first has to download guild information from Discord in order for you to get access to any server information; the client is not ready at this point. Technically, the `GuildAvailable` event fires once the data for a particular guild has downloaded; however, it's best to wait for all guilds to be downloaded. Once all downloads are complete, the `Ready` event is triggered, then you can proceed to do whatever you like. - -## How do I get a message's previous content when that message is edited? - - If you need to do anything with messages (e.g. checking Reactions, checking the content of edited/deleted messages), you must set the `MessageCacheSize` in your `DiscordSocketConfig` settings in order to use the cached message entity. Read more about it [here](https://discord.foxbot.me/docs/guides/concepts/events.html#cacheable). - 1. Message Cache must be enabled. - 2. Hook the `MessageUpdated` event. This event provides a *before* and *after* object. - 3. Only messages received *AFTER* the bot comes online will be available in the cache. \ No newline at end of file diff --git a/docs/faq/2-BasicOperations.md b/docs/faq/2-BasicOperations.md deleted file mode 100644 index e8424448d..000000000 --- a/docs/faq/2-BasicOperations.md +++ /dev/null @@ -1,75 +0,0 @@ -# Basic Operations Questions - -## How should I safely check a type? -In Discord.NET, the idea of polymorphism is used throughout. You may need to cast the object as a certain type before you can perform any action. There are several ways to cast, with direct casting `(Type)type` being the the least recommended, as it *can* throw an `InvalidCastException` when the object isn't the desired type. Please refer to [this post](https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/types/how-to-safely-cast-by-using-as-and-is-operators) for more details. - -A good and safe casting example: -```cs -public async Task MessageReceivedHandler(SocketMessage msg) -{ - // Option 1: - // Using the `as` keyword, which will return `null` if the object isn't the desired type. - var usermsg = msg as SocketUserMessage; - // We bail when the message isn't the desired type. - if (msg == null) return; - - // Option 2: - // Using the `is` keyword to cast (C#7 or above only) - if (msg is SocketUserMessage usermsg) - { - // Do things - } -} -``` - -## How do I send a message? - - Any implementation of **IMessageChannel** has a **SendMessageAsync** method. Using the client, you can get an appropriate channel (**GetChannel(id)**) to send a message to. Remember, when using Discord.NET, polymorphism is a common recurring theme. This means an object may take in many shapes or form, which means casting is your friend. You should attempt to cast the channel as an `IMessageChannel` or any other entity that implements it to be able to message. - -## How can I tell if a message is from X, Y, Z? - - You may check message channel type. - - * A **Text channel** (`ITextChannel`) is a message channel from a Guild. - * A **DM channel** (`IDMChannel`) is a message channel from a DM. - * A **Group channel** (`IGroupChannel`) is a message channel from a Group (this is rarely used, due to the bot's inability to join a group). - * A **Private channel** (`IPrivateChannel`) is a DM or a Group. - * A **Message channel** (`IMessageChannel`) is all of the above. - -## How do I add hyperlink text to an embed? - - Embeds can use standard [markdown](https://support.discordapp.com/hc/en-us/articles/210298617-Markdown-Text-101-Chat-Formatting-Bold-Italic-Underline-) in the Description as well as in field values. With that in mind, links can be added using the following format \[text](link). - - -## How do I add reactions to a message? - - Any entities that implement `IUserMessage` has an **AddReactionAsync** method. This method expects an `IEmote` as a parameter. In Discord.Net, an Emote represents a server custom emote, while an Emoji is a Unicode emoji (standard emoji). Both `Emoji` and `Emote` implement `IEmote` and are valid options. - ```cs - // bail if the message is not a user one (system messages cannot have reactions) - var usermsg = msg as IUserMessage; - if (usermsg == null) return; - - // standard Unicode emojis - Emoji emoji = new Emoji("👍"); - // or - // Emoji emoji = new Emoji("\u23F8"); - - // custom guild emotes - Emote emote = Emote.Parse("<:dotnet:232902710280716288>"); - // using Emote.TryParse may be safer in regards to errors being thrown; - // please note that the method does not verify if the emote exists, - // it simply creates the Emote object for you. - - // add the reaction to the message - await usermsg.AddReactionAsync(emoji); - await usermsg.AddReactionAsync(emote); - ``` - -## Why am I getting so many preemptive rate limits when I try to add more than one reactions? - - This is due to how .NET parses the HTML header, mistreating 0.25sec/action to 1sec. This casues the lib to throw preemptive rate limit more frequently than it should for methods such as adding reactions. - - -## Can I opt-out of preemptive rate limits? - - Unfortunately, not at the moment. See [#401](https://github.com/RogueException/Discord.Net/issues/401). \ No newline at end of file diff --git a/docs/faq/4-Commands.md b/docs/faq/4-Commands.md deleted file mode 100644 index 96d6cb053..000000000 --- a/docs/faq/4-Commands.md +++ /dev/null @@ -1,81 +0,0 @@ -# Command-related Questions - -## How can I restrict some of my commands so only certain users can execute them? - - Based on how you want to implement the restrictions, you can use the built-in `RequireUserPermission` precondition, which allows you to restrict the command based on the user's current permissions in the guild or channel (*e.g. `GuildPermission.Administrator`, `ChannelPermission.ManageMessages` etc.*). - If, however, you wish to restrict the commands based on the user's role, you can eithe create your own custom precondition or use Joe4evr's [Preconditions Addons](https://github.com/Joe4evr/Discord.Addons/tree/master/src/Discord.Addons.Preconditions) that provides a few custom preconditions that aren't provided in the stock library. Its source can also be used as an example for creating your own custom preconditions. - - -## I'm getting an error about `Assembly#GetEntryAssembly`. What now? - - You may be confusing `CommandService#AddModulesAsync` with `CommandService#AddModuleAsync`. The former is used to add modules via the assembly, while the latter is used to add a single module. - - -## What does [Remainder] do in the command signature? - - The `RemainderAttribute` leaves the string unparsed, meaning you don't have to add quotes around the text for the text to be recognized as a single object. Please note that if your method has multiple parameters, the remainder attribute can only be applied to the last parameter. - ```cs - // !echo repeat this message in chat - [Command("echo")] - [Summary("Replies whatever the user adds")] - [Remarks("The entire message is considered one String")] - public Task EchoAsync([Remainder]String text) => ReplyAsync(text); - - // !echo repeat this message in chat - [Command("echo")] - [Summary("Replies whatever the user adds")] - [Remarks("This command will error for having too many arguments. - The message would be seen as having 5 parameters while the method only accepts one. - Wrapping the message in quotes solves this - '!echo repeat this message in chat' - - this way, the system knows the entire message is to be parsed as a single String")] - public Task EchoAsync(String text) => ReplyAsync(text); - ``` - -## What is a service? Why does my module not hold any data after execution? - - In Discord.NET, modules are created similarly to ASP.NET, meaning that they have a transient nature. This means that they are spawned every time when a request is received, and are killed from memory when the execution finishes. This is why you cannot store persistent data inside a module. To workaround this, consider using a service. Service is often used to hold data externally, so that they will persist throughout execution. Think of it like a chest that holds whatever you throw at it that won't be affected by anything unless you want it to. Note that you should also learn Microsoft's implementation of Dependency Injection before proceeding. You can learn more about it [here](https://docs.microsoft.com/en-us/aspnet/core/fundamentals/dependency-injection), and how it works in Discord.NET [here](https://discord.foxbot.me/latest/guides/commands/commands.html#usage-in-modules). A brief example of service and dependency injection can be seen below, - -```cs -public class MyService -{ - public string MyCoolString {get; set;} -} -public class SetupOrWhatever -{ - public IServiceProvider BuildProvider() => new ServiceCollection().AddSingleton().BuildServiceProvider(); -} -public class MyModule : ModuleBase -{ - // Inject via public settable prop - public MyService MyService {get; set;} - // or via ctor - private readonly MyService _myService; - public MyModule (MyService myService) => _myService = myService; - [Command("setorprintstring")] - public Task GetOrSetStringAsync() - { - if (_myService.MyCoolString == null) _myService.MyCoolString = "ya boi"; - return ReplyAsync(_myService.MyCoolString); - } -} -``` - -## I have a long-running Task in my command, and Discord.NET keeps saying that a `MessageReceived` handler is blocking the gateway. What gives? - - By default, all commands are executed on the same thread as the gateway task, which is responsible for keeping the connection from your client to Discord alive. When you execute a long-running task, this blocks the gateway from communicating for as long as the command task is being executed. The library will warn you about any long running event handler (in this case, the command handler) that persists for more than 3 seconds. - - To resolve this, the library has designed a flag called `RunMode`. There are 2 main `RunMode`s. One being `RunMode.Sync`, which is the default; another being `RunMode.Async`. `RunMode.Async` essentially calls an unawaited Task and continues with the execution without waiting for the command task to finish. You should use `RunMode.Async` in either the `CommandAttribute` or the `DefaultRunMode` flag in `CommandServiceConfig`. Further details regarding `RunMode.Async` can be found below. - -## Okay, that's great and all, but how does `RunMode.Async` work, and if it's so great, why is the lib *not* using it by default? - - As with any async operation, `RunMode.Async` also comes at a cost. The following are the caveats with RunMode.Async, - 1) You introduce race condition. - 2) Unnecessary overhead caused by async state machine (learn more about it [here](https://www.red-gate.com/simple-talk/dotnet/net-tools/c-async-what-is-it-and-how-does-it-work/)). - 3) `CommandService#ExecuteAsync` will immediately return `ExecuteResult` instead of other result types (this is particularly important for those who wish to utilize `RuntimeResult` in 2.0). - 4) Exceptions are swallowed. - - However, there are ways to remedy #3 and #4. - - For #3, in Discord.NET 2.0, the library introduces a new event called `CommandExecuted`, which is raised whenever the command is finished. This event will be called regardless of the `RunMode` type and will return the appropriate execution result - - For #4, exceptions are caught in `CommandService#Log` under `(CommandException)LogMessage.Exception`. \ No newline at end of file diff --git a/docs/faq/5-Legacy.md b/docs/faq/5-Legacy.md deleted file mode 100644 index 9f10fd400..000000000 --- a/docs/faq/5-Legacy.md +++ /dev/null @@ -1,11 +0,0 @@ -# Legacy Questions - -## X, Y, Z does not work! It doesn't return a valid value anymore. - If you're currently using 1.0.0, please upgrade to the latest 2.0 beta to ensure maximum compatibility. Several methods or props may be broken in 1.0.x and will not be fixed in the 1.0 branch due to their breaking nature. - Notable breaking changes are as follows, - * `IChannel#IsNsfw` has been replaced with `ITextChannel#IsNsfw` and now returns valid value in 2.0. - * Bulk message removal (`DeletedMessagesAsync`) has been moved from `IMessageChannel` to `ITextChannel`. - * `IAsyncEnumerable#Flatten` has been renamed to `FlattenAsync`. - -## I came from an earlier version of Discord.NET 1.0, and DependencyMap doesn't seem to exist anymore in the later revision? What happened to it? - The `DependencyMap` has been replaced with Microsoft's [DependencyInjection](https://docs.microsoft.com/en-us/aspnet/core/fundamentals/dependency-injection) Abstractions. An example usage can be seen [here](https://github.com/foxbot/DiscordBotBase/blob/csharp/src/DiscordBot/Program.cs#L36). \ No newline at end of file diff --git a/docs/faq/3-AdvancedOperations.md b/docs/faq/AdvancedOperations.md similarity index 100% rename from docs/faq/3-AdvancedOperations.md rename to docs/faq/AdvancedOperations.md diff --git a/docs/faq/BasicOperations.md b/docs/faq/BasicOperations.md new file mode 100644 index 000000000..c9e1d7d6b --- /dev/null +++ b/docs/faq/BasicOperations.md @@ -0,0 +1,74 @@ +# Basic Operations Questions + +## How should I safely check a type? +In Discord.NET, the idea of polymorphism is used throughout. You may +need to cast the object as a certain type before you can perform any +action. There are several ways to cast, with direct casting +`(Type)type` being the the least recommended, as it *can* throw an +[InvalidCastException] when the object isn't the desired type. +Please refer to [this post] for more details. + +A good and safe casting example: + +[!code-csharp[Casting](samples/basics/cast.cs)] + +[InvalidCastException]: https://docs.microsoft.com/en-us/dotnet/api/system.invalidcastexception +[this post]: https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/types/how-to-safely-cast-by-using-as-and-is-operators + +## How do I send a message? + +Any implementation of [IMessageChannel] has a [SendMessageAsync] +method. You can get the channel via [GetChannel] under the client. +Remember, when using Discord.NET, polymorphism is a common recurring +theme. This means an object may take in many shapes or form, which +means casting is your friend. You should attempt to cast the channel +as an [IMessageChannel] or any other entity that implements it to be +able to message. + +[SendMessageAsync]: xref:Discord.IMessageChannel#Discord_IMessageChannel_SendMessageAsync_System_String_System_Boolean_Discord_Embed_Discord_RequestOptions_ +[GetChannel]: xref:Discord.WebSocket.DiscordSocketClient#Discord_WebSocket_DiscordSocketClient_GetChannel_System_UInt64_ + +## How can I tell if a message is from X, Y, Z? + +You may check the message channel type. Visit [Glossary] to see the +various types of channels. + +[Glossary]: Glossary.md + +## How do I add hyperlink text to an embed? + +Embeds can use standard [markdown] in the description field as well as + in field values. With that in mind, links can be added using the + following format \[text](link). + +[markdown]: https://support.discordapp.com/hc/en-us/articles/210298617-Markdown-Text-101-Chat-Formatting-Bold-Italic-Underline- + +## How do I add reactions to a message? + +Any entities that implement [IUserMessage] has an [AddReactionAsync] +method. This method expects an [IEmote] as a parameter. +In Discord.Net, an Emote represents a server custom emote, while an +Emoji is a Unicode emoji (standard emoji). Both [Emoji] and [Emote] +implement [IEmote] and are valid options. + +[!code-csharp[Emoji](samples/basics/emoji.cs)] + +[AddReactionAsync]: xref:Discord.IUserMessage#Discord_IUserMessage_AddReactionAsync_Discord_IEmote_Discord_RequestOptions_ + +## Why am I getting so many preemptive rate limits when I try to add more than one reactions? + +This is due to how .NET parses the HTML header, mistreating +0.25sec/action to 1sec. This casues the lib to throw preemptive rate +limit more frequently than it should for methods such as adding +reactions. + +## Can I opt-out of preemptive rate limits? + +Unfortunately, not at the moment. See [#401](https://github.com/RogueException/Discord.Net/issues/401). + + +[IMessageChannel]: xref:Discord.IMessageChannel +[IUserMessage]: xref:Discord.IUserMessage +[IEmote]: xref:Discord.IEmote +[Emote]: xref:Discord.Emote +[Emoji]: xref:Discord.Emoji \ No newline at end of file diff --git a/docs/faq/ClientBasics.md b/docs/faq/ClientBasics.md new file mode 100644 index 000000000..8ea5394b4 --- /dev/null +++ b/docs/faq/ClientBasics.md @@ -0,0 +1,47 @@ +# Client Basics Questions + +## My client keeps returning 401 upon logging in! + +There are few possible reasons why this may occur. + 1. You are not using the appropriate [TokenType]. + If you are using a bot account created from the Discord Developer + portal, you should be using `TokenType.Bot`. + 2. You are not using the correct login credentials. + Please keep in mind that tokens start with `Mj*`. + If it starts with any other characters, chances are, you might be + using the *client secret*, which has nothing to do with the login + token. + +[TokenType]: xref:Discord.TokenType + +## How do I do X, Y, Z when my bot connects/logs on? Why do I get a `NullReferenceException` upon calling any client methods after connect? + +Your bot should not attempt to interact in any way with guilds/servers +until the [Ready] event fires. When the bot connects, it first has to +download guild information from Discord in order for you to get +access to any server information; the client is not ready at this +point. + +Technically, the [GuildAvailable] event fires once the data for a +particular guild has downloaded; however, it's best to wait for all +guilds to be downloaded. Once all downloads are complete, the [Ready] +event is triggered, then you can proceed to do whatever you like. + +[Ready]: xref:Discord.WebSocket.DiscordSocketClient#Discord_WebSocket_DiscordSocketClient_Ready +[GuildAvailable]: xref:Discord.WebSocket.BaseSocketClient#Discord_WebSocket_BaseSocketClient_GuildAvailable + +## How do I get a message's previous content when that message is edited? + +If you need to do anything with messages (e.g. checking Reactions, +checking the content of edited/deleted messages), you must set the +[MessageCacheSize] in your [DiscordSocketConfig] settings in order to +use the cached message entity. Read more about it [here](../guides/concepts/events.md#cacheable). +1. Message Cache must be enabled. +2. Hook the MessageUpdated event. This event provides a *before* and +*after* object. +3. Only messages received *after* the bot comes online will be +available in the cache. + +[MessageCacheSize]: xref:Discord.WebSocket.DiscordSocketConfig#Discord_WebSocket_DiscordSocketConfig_MessageCacheSize +[DiscordSocketConfig]: xref:Discord.WebSocket.DiscordSocketConfig +[MessageUpdated]: xref:Discord.WebSocket.BaseSocketClient#Discord_WebSocket_BaseSocketClient_MessageUpdated \ No newline at end of file diff --git a/docs/faq/Commands.md b/docs/faq/Commands.md new file mode 100644 index 000000000..948b7639d --- /dev/null +++ b/docs/faq/Commands.md @@ -0,0 +1,114 @@ +# Command-related Questions + +## How can I restrict some of my commands so only certain users can execute them? + +Based on how you want to implement the restrictions, you can use the +built-in [RequireUserPermission] precondition, which allows you to +restrict the command based on the user's current permissions in the +guild or channel (*e.g. `GuildPermission.Administrator`, +`ChannelPermission.ManageMessages` etc.*). + +If, however, you wish to restrict the commands based on the user's +role, you can either create your own custom precondition or use +Joe4evr's [Preconditions Addons] that provides a few custom +preconditions that aren't provided in the stock library. +Its source can also be used as an example for creating your own +custom preconditions. + +[RequireUserPermission]: xref:Discord.Commands.RequireUserPermissionAttribute +[Preconditions Addons]: https://github.com/Joe4evr/Discord.Addons/tree/master/src/Discord.Addons.Preconditions + +## I'm getting an error about `Assembly#GetEntryAssembly`. What now? + +You may be confusing [CommandService#AddModulesAsync] with +[CommandService#AddModuleAsync]. The former is used to add modules +via the assembly, while the latter is used to add a single module. + +[CommandService#AddModulesAsync]: xref:Discord.Commands.CommandService#Discord_Commands_CommandService_AddModulesAsync_Assembly_System_IServiceProvider_ +[CommandService#AddModuleAsync]: xref:Discord.Commands.CommandService#Discord_Commands_CommandService_AddModuleAsync__1_System_IServiceProvider_ + +## What does [Remainder] do in the command signature? + +The [RemainderAttribute] leaves the string unparsed, meaning you +don't have to add quotes around the text for the text to be +recognized as a single object. Please note that if your method has +multiple parameters, the remainder attribute can only be applied to +the last parameter. + +[!code-csharp[Remainder](samples/commands/Remainder.cs)] + +[RemainderAttribute]: xref:Discord.Commands.RemainderAttribute + +## What is a service? Why does my module not hold any data after execution? + +In Discord.NET, modules are created similarly to ASP.NET, meaning +that they have a transient nature. This means that they are spawned +every time when a request is received, and are killed from memory +when the execution finishes. This is why you cannot store persistent +data inside a module. To workaround this, consider using a service. + +Service is often used to hold data externally, so that they will +persist throughout execution. Think of it like a chest that holds +whatever you throw at it that won't be affected by anything unless +you want it to. Note that you should also learn Microsoft's +implementation of [Dependency Injection] before proceeding, as well +as how it works in [Discord.NET](../guides/commands/commands.md#usage-in-modules). + +A brief example of service and dependency injection can be seen below. + +[!code-csharp[DI](samples/commands/DI.cs)] + +[Dependency Injection]: https://docs.microsoft.com/en-us/aspnet/core/fundamentals/dependency-injection + +## I have a long-running Task in my command, and Discord.NET keeps saying that a `MessageReceived` handler is blocking the gateway. What gives? + +By default, all commands are executed on the same thread as the +gateway task, which is responsible for keeping the connection from +your client to Discord alive. When you execute a long-running task, +this blocks the gateway from communicating for as long as the command +task is being executed. The library will warn you about any long +running event handler (in this case, the command handler) that +persists for more than 3 seconds. + +To resolve this, the library has designed a flag called [RunMode]. +There are 2 main `RunMode`s. One being `RunMode.Sync`, which is the +default; another being `RunMode.Async`. `RunMode.Async` essentially +calls an unawaited Task and continues with the execution without +waiting for the command task to finish. You should use +`RunMode.Async` in either the [CommandAttribute] or the +[DefaultRunMode] flag in `CommandServiceConfig`. +Further details regarding `RunMode.Async` can be found below. + +[RunMode]: xref:Discord.Commands.RunMode +[CommandAttribute]: xref:Discord.Commands.CommandAttribute +[DefaultRunMode]: xref:Discord.Commands.CommandServiceConfig#Discord_Commands_CommandServiceConfig_DefaultRunMode + +## Okay, that's great and all, but how does `RunMode.Async` work, and if it's so great, why is the lib *not* using it by default? + +As with any async operation, `RunMode.Async` also comes at a cost. +The following are the caveats with RunMode.Async, +1) You introduce race condition. +2) Unnecessary overhead caused by [async state machine]. +3) [ExecuteAsync] will immediately return [ExecuteResult] instead of +other result types (this is particularly important for those who wish +to utilize [RuntimeResult] in 2.0). +4) Exceptions are swallowed. + +However, there are ways to remedy #3 and #4. + +For #3, in Discord.NET 2.0, the library introduces a new event called +[CommandExecuted], which is raised whenever the command is +**successfully executed**. This event will be raised regardless of +the `RunMode` type and will return the appropriate execution result. + +For #4, exceptions are caught in [CommandService#Log] event under +[LogMessage.Exception] as [CommandException]. + +[async state machine]: https://www.red-gate.com/simple-talk/dotnet/net-tools/c-async-what-is-it-and-how-does-it-work/)) +[ExecuteAsync]: xref:Discord.Commands.CommandService#Discord_Commands_CommandService_ExecuteAsync_Discord_Commands_ICommandContext_System_Int32_System_IServiceProvider_Discord_Commands_MultiMatchHandling_ +[ExecuteResult]: xref:Discord.Commands.ExecuteResult +[RuntimeResult]: xref:Discord.Commands.RuntimeResult +[CommandExecuted]: xref:Discord.Commands.CommandService#Discord_Commands_CommandService_CommandExecuted +[CommandService#Log]: xref:Discord.Commands.CommandService#Discord_Commands_CommandService_Log +[LogMessage.Exception]: xref:Discord.LogMessage#Discord_LogMessage_Exception +[CommandException]: xref:Discord.Commands.CommandException \ No newline at end of file diff --git a/docs/faq/GettingStarted.md b/docs/faq/GettingStarted.md new file mode 100644 index 000000000..1e4276b80 --- /dev/null +++ b/docs/faq/GettingStarted.md @@ -0,0 +1,71 @@ +# Basic Concepts / Getting Started + +## How do I get started? +First of all, welcome! Before you delve into using the library; +however, you should have some decent understanding of the language +you are about to use. This library touches on +[Task-based Asynchronous Pattern], [polymorphism], [interface] and +many more advanced topics extensively. Please make sure that you +understand these topics to some extent before proceeding. + + Here are some examples: + 1. [Official quick start guide](https://github.com/RogueException/Discord.Net/blob/dev/docs/guides/getting_started/samples/intro/structure.cs) + 2. [Official template](https://github.com/foxbot/DiscordBotBase/tree/csharp/src/DiscordBot) + +Please note that you should *not* try to blindly copy paste the code. It is meant to be a template or a guide. It is not meant to be something that will work out of the box. + +[Task-based Asynchronous Pattern]: https://docs.microsoft.com/en-us/dotnet/standard/asynchronous-programming-patterns/task-based-asynchronous-pattern-tap +[polymorphism]: https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/classes-and-structs/polymorphism +[interface]: https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/interfaces/ + +## How do I add my bot to my server/guild? + +The [OAuth2 URL](https://discordapp.com/developers/tools/oauth2-url-generator) +can be generated via the Discord developer page. This allows you to +set the permissions that the bot will be added with. With this method, + bots will also be assigned their own special roles that normal users + cannot use, which is what we call a `Managed` role. + +## What is a Client/User/Object ID? Is it the token? + +Each user and object on Discord has its own snowflake ID generated +based on various conditions. +![Snowflake Generation](images/snowflake.png) +The ID can be seen by anyone; it is public. It is merely used to +identify an object in the Discord ecosystem. Many things in the +library require an ID to retrieve the said object. + +There are 2 ways to obtain the said ID. + 1. Enable Discord's developer mode. With developer mode enabled, + you can - as an example - right click on a guild and copy the guild + id (please note that this does not apply to Role IDs, see below). + ![Developer Mode](images/dev-mode.png) + 2. Escape the object using `\` in front the object. For example, + when you do `\@Example#1234` in chat, it will return the user ID of + the aforementioned user. + +A token is a credential used to log into an account. This information +should be kept **private** and for your eyes only. Anyone with your +token can log into your account. This applies to both user and bot +accounts. That also means that you should never ever hardcode your +token or add it into source control, as your identity may be stolen +by scrape bots on the internet that scours through constantly to +obtain a token. + +## How do I get the role ID? + +Several common ways to do this: + 1. Make the role mentionable and mention the role, and escape it + using the `\` character in front. + 2. Inspect the roles collection within the guild via your debugger. + +Please note that right-clicking on the role and copying the ID will +**not** work. It will only copy the message ID. + +## I have more questions! + +Please visit us at #dotnet_discord-net at [Discord API]. +Describe the problem in details to us, and preferably with the +problematic code uploaded onto [Hastebin](https://hastebin.com). + +[Discord API]: https://discord.gg/jkrBmQR \ No newline at end of file diff --git a/docs/faq/Glossary.md b/docs/faq/Glossary.md new file mode 100644 index 000000000..84e95d251 --- /dev/null +++ b/docs/faq/Glossary.md @@ -0,0 +1,18 @@ +# Glossary + +## Channel types + +* A **Text channel** ([ITextChannel]) is a message channel from a +Guild. +* A **DM channel** ([IDMChannel]) is a message channel from a DM. +* A **Group channel** ([IGroupChannel]) is a message channel from a +Group (this is rarely used due to the bot's inability to join groups). +* A **Private channel** ([IPrivateChannel]) is a DM or a Group. +* A **Message channel** ([IMessageChannel]) is all of the above. + + +[IMessageChannel]: xref:Discord.IMessageChannel +[ITextChannel]: xref:Discord.ITextChannel +[IGroupChannel]: xref:Discord.IGroupChannel +[IDMChannel]: xref:Discord.IDMChannel +[IPrivateChannel]: xref:Discord.IPrivateChannel \ No newline at end of file diff --git a/docs/faq/Legacy.md b/docs/faq/Legacy.md new file mode 100644 index 000000000..83495ef79 --- /dev/null +++ b/docs/faq/Legacy.md @@ -0,0 +1,19 @@ +# Legacy Questions + +## X, Y, Z does not work! It doesn't return a valid value anymore. +If you're currently using an older version in stable branch, please +upgrade to the latest pre-release version to ensure maximum +compatibility. Several methods or props may be broken in older +versions and will likely not be fixed in the version branch due to +their breaking nature. + +Visit the repo's [release tag] to see the latest public pre-release. + +[release tag]: https://github.com/RogueException/Discord.Net/releases + +## I came from an earlier version of Discord.NET 1.0, and DependencyMap doesn't seem to exist anymore in the later revision? What happened to it? +The `DependencyMap` has been replaced with Microsoft's +[DependencyInjection] Abstractions. An example usage can be seen +[here](https://github.com/foxbot/DiscordBotBase/blob/csharp/src/DiscordBot/Program.cs#L36). + +[DependencyInjection]: https://docs.microsoft.com/en-us/aspnet/core/fundamentals/dependency-injection \ No newline at end of file diff --git a/docs/faq/images/snowflake.png b/docs/faq/images/snowflake.png new file mode 100644 index 0000000000000000000000000000000000000000..816a10eee07e156ec4e27ee90a000512b1f12463 GIT binary patch literal 73062 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 RN4x+4002ovPDHLkV1mSX+zS8z literal 0 KcmV+b0RR6000031 diff --git a/docs/faq/samples/basics/cast.cs b/docs/faq/samples/basics/cast.cs new file mode 100644 index 000000000..73ef5237f --- /dev/null +++ b/docs/faq/samples/basics/cast.cs @@ -0,0 +1,15 @@ +public async Task MessageReceivedHandler(SocketMessage msg) +{ + // Option 1: + // Using the `as` keyword, which will return `null` if the object isn't the desired type. + var usermsg = msg as SocketUserMessage; + // We bail when the message isn't the desired type. + if (msg == null) return; + + // Option 2: + // Using the `is` keyword to cast (C#7 or above only) + if (msg is SocketUserMessage usermsg) + { + // Do things + } +} \ No newline at end of file diff --git a/docs/faq/samples/basics/emoji.cs b/docs/faq/samples/basics/emoji.cs new file mode 100644 index 000000000..dd3e6317f --- /dev/null +++ b/docs/faq/samples/basics/emoji.cs @@ -0,0 +1,18 @@ +// bail if the message is not a user one (system messages cannot have reactions) +var usermsg = msg as IUserMessage; +if (usermsg == null) return; + +// standard Unicode emojis +Emoji emoji = new Emoji("👍"); +// or +// Emoji emoji = new Emoji("\uD83D\uDC4D"); + +// custom guild emotes +Emote emote = Emote.Parse("<:dotnet:232902710280716288>"); +// using Emote.TryParse may be safer in regards to errors being thrown; +// please note that the method does not verify if the emote exists, +// it simply creates the Emote object for you. + +// add the reaction to the message +await usermsg.AddReactionAsync(emoji); +await usermsg.AddReactionAsync(emote); \ No newline at end of file diff --git a/docs/faq/samples/commands/DI.cs b/docs/faq/samples/commands/DI.cs new file mode 100644 index 000000000..59f098ff9 --- /dev/null +++ b/docs/faq/samples/commands/DI.cs @@ -0,0 +1,27 @@ +public class MyService +{ + public string MyCoolString {get; set;} +} +public class Setup +{ + public IServiceProvider BuildProvider() => + new ServiceCollection() + .AddSingleton() + .BuildServiceProvider(); +} +public class MyModule : ModuleBase +{ + // Inject via public settable prop + public MyService MyService {get; set;} + + // or via ctor + private readonly MyService _myService; + public MyModule (MyService myService) => _myService = myService; + + [Command("string")] + public Task GetOrSetStringAsync(string input) + { + if (_myService.MyCoolString == null) _myService.MyCoolString = input; + return ReplyAsync(_myService.MyCoolString); + } +} \ No newline at end of file diff --git a/docs/faq/samples/commands/Remainder.cs b/docs/faq/samples/commands/Remainder.cs new file mode 100644 index 000000000..9a4ac4d78 --- /dev/null +++ b/docs/faq/samples/commands/Remainder.cs @@ -0,0 +1,19 @@ +// Input: +// !echo Coffee Cake + +// Output: +// Coffee Cake +[Command("echo")] +public Task EchoRemainderAsync([Remainder]string text) => ReplyAsync(text); + +// Output: +// CommandError.BadArgCount +[Command("echo-hassle")] +public Task EchoAsync(string text) => ReplyAsync(text); + +// The message would be seen as having 5 parameters, while the method +// only accepts one. Wrapping the message in quotes solves this. +// This way, the system knows the entire message is to be parsed as a +// single String. +// e.g. +// !echo "Coffee Cake" \ No newline at end of file diff --git a/docs/faq/toc.yml b/docs/faq/toc.yml index 446ddbf54..08ba404c1 100644 --- a/docs/faq/toc.yml +++ b/docs/faq/toc.yml @@ -1,10 +1,12 @@ - name: Getting Started - href: 0-GettingStarted.md -- name: Basics - href: 1-Basics.md + href: GettingStarted.md +- name: Client Basics + href: ClientBasics.md - name: Basic Operations - href: 2-BasicOperations.md + href: BasicOperations.md - name: Commands - href: 4-Commands.md + href: Commands.md +- name: Glossary + href: Glossary.md - name: Legacy or Upgrade - href: 5-Legacy.md + href: Legacy.md \ No newline at end of file