vsTerminus / Mojo-Discord

Perl Modules that implement parts of the Discord API. Intended for Text Chat Bots.
MIT License
33 stars 10 forks source link

Socialization #38

Open Disinterpreter opened 3 years ago

Disinterpreter commented 3 years ago

I suggest to send a request to official Discord API server for adding text chat with this bot. https://discord.gg/discord-api

Yes, Perl is dead, but we have a right to discuss and maintain the thing that we love.

vsTerminus commented 3 years ago

So I agree with this as a goal for the library. It's something I've always wanted to do but can never seem to focus my time on reaching that goal.

Basically, this library does not meet the requirements for an API channel. Nor does it even meet the requirements for a CPAN release. Primary because of three things: Missing functionality, missing documentation, and missing test cases.

The Discord API server has an FAQ where they list the requirements for a library getting its own channel. You can find it here: https://gist.github.com/meew0/bbbbd5348967dee5f7e84c0cd58983fd

And for CPAN, it must have a decent suite of unit tests. As far as I can tell we meet the rest of the requirements.

So if we want this on Discord-API it needs to have those items addressed. Maybe we should identify the missing functionality. I'm missing everything related to sharding, file uploading, and probably a bunch of other things that my own bot doesn't leverage.

Documentation isn't hard it's just time consuming. The hardest part will be the unit tests (particularly for the gateway) and getting it out on CPAN so it's not so hard to install anymore (To me this is more important than getting a channel in Discord-API).

Disinterpreter commented 3 years ago

Well... We can start to write documentation. How should it look? Would it CPAN? Or readthedocs?

vsTerminus commented 3 years ago

I have a discord server that I set up for my other project (Goose bot) but honestly it mostly gets used to discuss Mojo::Discord, so if you want to come chat in an easier way, https://discord.gg/FuKTcHF