Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/simmsb/racket-cord
A discord library for racket
https://github.com/simmsb/racket-cord
discord discord-api discord-lib lisp racket racket-cord scheme
Last synced: about 1 month ago
JSON representation
A discord library for racket
- Host: GitHub
- URL: https://github.com/simmsb/racket-cord
- Owner: simmsb
- License: mit
- Created: 2017-10-16T22:55:59.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2023-05-20T03:42:13.000Z (over 1 year ago)
- Last Synced: 2024-06-18T18:52:31.875Z (3 months ago)
- Topics: discord, discord-api, discord-lib, lisp, racket, racket-cord, scheme
- Language: Racket
- Homepage:
- Size: 483 KB
- Stars: 28
- Watchers: 4
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- discord-api-libs - racket-cord - A discord library for racket (Libraries / Racket)
README
# racket-cord
A low-level library for interfacing with Discord using Racket.
[![Build Status](https://github.com/nitros12/racket-cord/actions/workflows/ci.yml/badge.svg)](https://github.com/nitros12/racket-cord/actions/workflows/ci.yml)
[Racket package](https://pkgd.racket-lang.org/pkgn/package/racket-cord)
[Docs](https://docs.racket-lang.org/racket-cord/index.html)
# Design Notes
The library is focused on only a couple things and doing those things properly:
1. Providing the network plumbing for receiving and sending gateway events
2. Providing convenience bindings for the HTTP endpointsThus, this library is quite low level. In general, data is exposed directly as returned by the Discord API,
without extra conversions into other types. There is nearly no caching of state in the client.The rationale can be found in this [commit message](https://github.com/simmsb/racket-cord/commit/64b8f1de97fccb01487571362e2b4bac749c3691)
Essentially, I don't have the time nor energy to maintain typed wrappers when Discord's API
is so unstable, the documentation so bad, and no machine-readable specs exist.Typed wrappers or cached client-side state should not be difficult to implement on top of
this library via the gateway events, if someone is interested in subjecting themselves to that pain.
If you make one, let us know and we will feature it here. :)# Sample Projects
* R16: A Racket trick bot for Discord - https://sr.ht/~williewillus/r16