Persistord.Adapters.DiscordNet 1.0.0-beta2

This is a prerelease version of Persistord.Adapters.DiscordNet.

dotnet add package Persistord.Adapters.DiscordNet --version 1.0.0-beta2

NuGet\Install-Package Persistord.Adapters.DiscordNet -Version 1.0.0-beta2

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="Persistord.Adapters.DiscordNet" Version="1.0.0-beta2" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="Persistord.Adapters.DiscordNet" Version="1.0.0-beta2" />
                    

                            Directory.Packages.props

<PackageReference Include="Persistord.Adapters.DiscordNet" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add Persistord.Adapters.DiscordNet --version 1.0.0-beta2

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Persistord.Adapters.DiscordNet, 1.0.0-beta2"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#:package Persistord.Adapters.DiscordNet@1.0.0-beta2

#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.

#addin nuget:?package=Persistord.Adapters.DiscordNet&version=1.0.0-beta2&prerelease
                    

                            Install as a Cake Addin

#tool nuget:?package=Persistord.Adapters.DiscordNet&version=1.0.0-beta2&prerelease
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Persistord.Adapters.DiscordNet

← Persistord docs · Documentation site

</div>

Opt-in adapter that maps Discord.Net interface types to Persistord entities.

Install only if you use Discord.Net — the core Persistord packages never reference a Discord client library.

dotnet add package Persistord.Adapters.DiscordNet

Usage

The adapter adds .To*Entity() extension methods on Discord.Net interfaces:

using Persistord.Adapters.DiscordNet;
using Persistord.History.Entities;

await using var db = await factory.CreateDbContextAsync();

db.Messages.Add(socketMessage.ToMessageEntity());        // embeds, attachments, reactions included
db.MessageHistory.Add(socketMessage.ToHistoryEntity(HistoryChangeType.Created));
await db.SaveChangesAsync();

All mappers:

Method	Source	Target
`ToGuildEntity()`	`IGuild`	`GuildEntity`
`ToChannelEntity()`	`IGuildChannel`	`ChannelEntity`
`ToUserEntity()`	`IUser`	`UserEntity`
`ToMemberEntity()`	`IGuildUser`	`MemberEntity`
`ToRoleEntity()`	`IRole`	`RoleEntity`
`ToMessageEntity()`	`IMessage`	`MessageEntity`
`ToHistoryEntity(changeType)`	`IMessage`	`MessageHistoryEntity`

Mappers copy data fields only. Persistence-managed fields (MessageEntity.IsDeleted, DeletedAt) and EF-generated surrogate keys are left at their defaults; child foreign keys are filled by EF from the navigation collections on SaveChanges. Mappers tolerate partial gateway data (null optional fields) and throw only on a null source argument.

Because they bind to Discord.Net interfaces, the mappers work for both gateway (Socket*) and REST (Rest*) entities.

Versioning

This package declares a Discord.Net version range of [3.20.0, 4.0.0), so you may upgrade Discord.Net freely within its current major version while a breaking 4.0 is held back. A new adapter release follows each Discord.Net breaking major.

Product	Compatible and additional computed target framework versions.
.NET	net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net10.0
- Discord.Net (>= 3.20.1 && < 4.0.0)
- Persistord.Core (>= 1.0.0-beta2)
- Persistord.History (>= 1.0.0-beta2)
- Persistord.Messages (>= 1.0.0-beta2)

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.