Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/shuppet/raku-api-discord
Raku module for interacting with the Discord API.
https://github.com/shuppet/raku-api-discord
discord discord-api perl6 perl6-module raku raku-module
Last synced: 2 months ago
JSON representation
Raku module for interacting with the Discord API.
- Host: GitHub
- URL: https://github.com/shuppet/raku-api-discord
- Owner: shuppet
- License: bsd-3-clause
- Created: 2018-06-29T19:26:14.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2022-08-30T14:41:22.000Z (over 2 years ago)
- Last Synced: 2024-09-30T17:37:45.125Z (2 months ago)
- Topics: discord, discord-api, perl6, perl6-module, raku, raku-module
- Language: Raku
- Homepage: https://shuppet.com
- Size: 411 KB
- Stars: 30
- Watchers: 4
- Forks: 3
- Open Issues: 22
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- discord-api-libs - raku-api-discord - Raku module for interacting with the Discord API. (Libraries / Raku)
README
`API::Discord` is a Raku (formerly Perl 6) module for interacting with the Discord API. Built on
top of [`Cro::WebSocket::Client`](https://github.com/croservices/cro-websocket)
and [`Cro::HTTP::Client`](https://github.com/croservices/cro-http), this allows
for fast asynchronous operations between your application and the API.
## Installation
### ... from zef
```
zef install API::Discord
```
### ... from source
```
git clone https://github.com/shuppet/raku-api-discord
cd raku-api-discord/ && zef install ${PWD}
```
## Usage
Full documentation can be found by reading the pod6 directly from the module source.
```
p6doc API::Discord
```
## Example
`API::Discord` is designed to do all the hard work for you. Let us handle the connection, authentication, heartbeats, message parsing and all that other boring stuff - leaving you to focus on writing logic for your applications.
```raku
#!raku
use API::Discord;
use API::Discord::Debug; # remove to disable debug output
sub MAIN($token) {
my $discord = API::Discord.new(:$token);
$discord.connect;
await $discord.ready;
react {
whenever $discord.messages -> $message {
$message.channel.send-message($message.content);
}
}
}
```
More examples can be found within the [`examples/`](https://github.com/shuppet/raku-api-discord/tree/master/examples) directory of this repository.
## Support
### Official
Join our official Discord server where we discuss development, bugs and test changes or new features to our library. Please note that this is a volunteer project and we all have real lives, day jobs and other responsiblities outside of the Internet. Replies may not be immediate and a resolution of your problem is not guaranteed outside of valid bug reports (for which raising an [issue](https://github.com/shuppet/raku-api-discord/issues/new) here on GitHub is far preferable).
[](https://discord.gg/8FqQFCF)
### Community
If you have a more general Raku question, or need help with a programming issue then it might be best to join the Raku Discord community instead. Some of the members there are also familiar with `API::Discord` and it's quite likely they'll be able to help you faster than we can. They're also really nice people. :)
[](https://discord.gg/VzYpdQ6)