Are you sure you want to delete this task? Once this task is deleted, it cannot be recovered.
You can not select more than 25 topics
Topics must start with a chinese character,a letter or number, can include dashes ('-') and can be up to 35 characters long.
FiniteReality
01e9ae8679
|
5 years ago | |
|---|---|---|
| .github | 5 years ago | |
| docs | 5 years ago | |
| src | 5 years ago | |
| test | 5 years ago | |
| .editorconfig | 5 years ago | |
| .gitattributes | 5 years ago | |
| .gitignore | 5 years ago | |
| Directory.Build.props | 5 years ago | |
| Directory.Build.targets | 5 years ago | |
| Discord.Net.sln | 5 years ago | |
| LICENSE | 5 years ago | |
docs/README.md
Discord.Net
An unofficial .NET library for the Discord API.
Installation
Our stable builds available from NuGet through the Discord.Net metapackage:
Discord.Net
Unstable "nightly" builds are available through our MyGet feed:
https://www.myget.org/F/discord-net/api/v3/index.json
Building
At minimum, .NET Core 2.1 is required to successfully build Discord.Net,
but .NET Core 3.1 is recommended. You should install the appropriate tools and
components for your editor to open the Discord.Net solution file:
- The .NET Core workload for Visual Studio
- The C# build tools for Visual Studio Code
- The .NET Core SDK for command line
Versioning
As a rule, Discord.Net attempts to follow
Semantic Versioning. This means MAJOR.MINOR.PATCH
versioning.
However, as Discord evolves and adds or changes existing endpoints, we may need
to add code to support these changes. To do this, we increment the minor version
when adding new API surfaces to the library. To counter any inevitable breaking
changes, we have decided that our public interfaces should be for
consumption only - bot developers should not need to implement these
interfaces for normal code.
Additionally, as the Discord API changes, we may need to add, remove, or change
parameters to certain methods. To ensure this breaks as little code as
possible, we use the following approach to deprecate old APIs and redirect
users to new APIs, while retaining binary compatibility:
// OLD API
[Obsolete("This API has been superseded by GetUserAsync.", false)]
[EditorBrowsable(EditorBrowsableState.Never)]
public ValueTask<IUser> GetUserAsync(ulong userId)
=> GetUserAsync(userId, "default");
// NEW API
public ValueTask<IUser> GetUserAsync(ulong userId,
string additionalParameter = "default");
These obsolete methods will be removed in the next major version, and will be
clearly documented in our change logs.
No Description
C#