Issues from DiscordGo

[switchupcb]

Disgo solves the following issues from https://github.com/bwmarrin/discordgo/issues.

[switchupcb]

bwmarrin/discordgo#513 (by @ErikMcClure) outlines a potential deadlock scenario that involves the calling of multiple Connect() and Disconnect() equivalent-calls while a Opcode 11 Heartbeat ACK is received.

Disgo avoids this issue through multiple mechanisms:

1. Only one connect action can occur at at any given time through the usage the Session's only mutex.
2. A heartbeat will only be sent to a channel (via s.heartbeat.send) when another goroutine is listening to that channel (s.heartbeat.send) due to the manager mechanism (which prevents the heartbeat goroutine from closing BEFORE goroutines that can generate heartbeats).
3. This is not highlighted on the golangci-linter, while this user's alert of this issue occurs from that same linter.
4. We use a test to connect, disconnect, and reconnect to the API with -race.

[switchupcb]

bwmarrin/discordgo#544 outlines the possibility for Discord to send an Opcode 9 Invalid Session (which warrants a re-identify) upon a reconnection attempt. This is handled by Disgo in the session.go initial function.

[switchupcb]

The following (open) issues have occurred due to an incorrect type definition or non-existent type definition in relation to JSON tags:

• Setting ParentID property of a channel bwmarrin/discordgo#571 (by @AZplay)
• Do not omitempty for MessageEdit's embed bwmarrin/discordgo#714 (by @ravener)
• Support for null values bwmarrin/discordgo#734 (by @JurrijnP)
• omitempty on complex edits don't work properly bwmarrin/discordgo#808 (by @aequasi)
• GuildParams missing fields bwmarrin/discordgo#994 (by @Bendodroid)

Disgo avoids these issues through the usage of Dasgo. In short, @bwmarrin and @FedorLap2006 may benefit from using Dasgo to stay up-to-date while reducing maintenance load.

[switchupcb]

The following open issues have occurred due to an incorrect type definition or non-existent type definition:

• Message Components are missing bwmarrin/discordgo#946 (by @Minecodes)
• Webhooks API isn't complete. bwmarrin/discordgo#951 (by @FedorLap2006)

There are 8 open issues and 37 closed issues with the query missing.

Disgo avoids these issues through the usage of Dasgo. In short, @bwmarrin and @FedorLap2006 may benefit from using Dasgo to stay up-to-date while reducing maintenance load.

[switchupcb]

bwmarrin/discordgo#649 (by @UlisseMini) outlines a concern with the New function in discordgo. While this isn't inherently an issue, it abstracts how the client is being initialized. In actuality, New initializes a session which represents a "bot" client. This abstraction can be confusing since a WebSocket Session isn't actually required to send requests, and there is no guarantee that the user needs an initialized "WebSocket Session".

Disgo avoids this confusion by being explicit in its idiomatic initialization, at the cost of a few extra lines.

[switchupcb]

bwmarrin/discordgo#712 (by @riking) outlines an issue with the ratelimiting functionality of DiscordGo. Specifically, a per-resource per-route rate limit issue: This is being addressed by Disgo in #22, and will be possible to implement without a refactor.

[switchupcb]

bwmarrin/discordgo#966 (by @sntran) outlines an issue with a lack of support for the OAuth2 flow Client Credentials Grant. Disgo implements and provides steps for all OAuth2 flows in oauth2.go.

[FedorLap2006]

We're currently working on getting the types up to date, in particular partial and null fields.

[FedorLap2006]

Thank you for outlining some of the older issues though

[switchupcb]

We're currently working on getting the types up to date, in particular partial and null fields.
— @FedorLap2006

Great! If you haven't already, you can consider using Dasgo. We realized that every Go Discord API Wrapper was having trouble with missing fields, or incorrectly defined fields in relation to JSON. In order to solve this issue, we created a Go API Types Library for the Discord API called Dasgo. This library is built with a specification and is not implementation specific to Disgo; meaning that other Go API Wrappers can use it for their types. If Dasgo is used by many API Wrappers, we can unite the entire Discord Go community while still allowing multiple API Wrappers to exist.

Dasgo has more benefits beyond type definitions. As an example, discordgo's wsapi.go L112 features a magic number "10". In actuality, this number refers to an Opcode 10 Hello which is represented in Dasgo by FlagGatewayOpcodeHello. This occurs again at wsapi.go L127` (Dispatch), 140 (Resume), and even for strings such as L179. If Dasgo was used here, the reader of the code would be able to clearly identify the reason for the literal number or string that is used.

Dasgo doesn't have to be used as a dependency, and can be derived from code generation (as shown by Disgo). If you need assistance with that, feel free to let me know! With more people focusing on Dasgo to fix changes like these, maintainers will have less work to do when Discord rolls out an inevitable change.

[switchupcb]

The following pull requests are also related to the issues addressed in #23 (comment).

• Add omitempty to channel_id in MessageReference struct bwmarrin/discordgo#1002 (@corbmr)
• Added SelectMenu Values slice bwmarrin/discordgo#1192 (@JABirchall)
• Allow setting bool fields of ChannelEdit to false bwmarrin/discordgo#1199 (@iokill)
• feat: add UserGuildMember bwmarrin/discordgo#1210 (@drlau)
• fix typo in InviteTargetEmbeddedApplication bwmarrin/discordgo#1211 (@plally)

[switchupcb]

The following issues are solved by using Dasgo.

• BeforeUpdate is missing for GuildMemberUpdate bwmarrin/discordgo#1200 (@fafafwawe)

[switchupcb]

The following issues are avoided by using Automatic Intent Calculation.

• Message content is always empty bwmarrin/discordgo#1270
• Message content is empty bwmarrin/discordgo#1264

[switchupcb]

@FedorLap2006, join the Disgo side. We have cookies... Strictly necessary of course.

[switchupcb]

@Strum355 So predictable.

[Strum355]

thanks for the content, looks great in a github platform abuse report 🙂