sawshadev/wharf

A minimal discord api wrapper

Deprecation Notice

Wharf is now deprecated. I no longer will be working on this library and it might be going fully out of date soon because of the pomelo (username changes) updates with discord.
As of 5/13/2023, this library does still work as to my knowledge but i'd say use another api wrapper such a Hikari or Discord.py.
You may create a fork of this if you want just as people did with discord.py when it was deprecated back in 2021.

Wharf

An minimal discord api wrapper that allows you to do what you want to do
If you need any support or want to give us suggestions, please do so by joining out Support Server

Aint this just another discord.py or hikari clone?

I see how you can think that but no. wharf was made entirely from scratch but the libraries do share stylistic choices. wharf is meant to be as minimal as possible whilst are being beginner-friendly. basically a mix of hikari and discord.py into one brand new made from scratch library!

What events are there/Whats their names?

You can find a list of all gateway events at The discord docs!
we use the gateway event names discord gives us in the docs such as message_create, guild_create, or interaction_create. We support all events but some of the events use the raw json from the gateway instead of proper models for now.

wharf's Issues

Incorrect handling of reconnect opcode.

I saw this and matched it against the docs, and when you receive it, you should attempt to reconnect and resume immediately.

Unable to have multiple events

Hey, I saw this repo in TCR and it was interesting, it took a nice approach to wrapping the Discord API and gateway. I was skimming through the code out of curiosity (and so I could see what I could help with), and I found this line. From what I can see without any testing is that this function is called in the subscribe function, and it blindly resets the events to a list. If I've understood that correctly, what you should do is use a defaultdict, with list as the argument. This means you don't need to do none of the if not self.events.get(event_name), and can go straight to the self.events[event_name].append. I hope this helps you. Keep up the solid work 👍