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 2 months 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 (over 6 years ago)
Default Branch: master
Last Pushed: 2023-05-20T03:42:13.000Z (about 1 year ago)
Last Synced: 2023-08-18T09:45:01.117Z (11 months ago)
Topics: discord, discord-api, discord-lib, lisp, racket, racket-cord, scheme
Language: Racket
Homepage:
Size: 483 KB
Stars: 27
Watchers: 4
Forks: 5
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Lists

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 endpoints

Thus, 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