https://github.com/brokenprogrammer/brokendiscord
Discord Library written in F#
https://github.com/brokenprogrammer/brokendiscord
discord discord-api fsharp
Last synced: 7 months ago
JSON representation
Discord Library written in F#
- Host: GitHub
- URL: https://github.com/brokenprogrammer/brokendiscord
- Owner: brokenprogrammer
- License: mit
- Created: 2018-08-04T12:02:01.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-09-23T14:32:53.000Z (over 7 years ago)
- Last Synced: 2025-06-14T09:42:19.333Z (7 months ago)
- Topics: discord, discord-api, fsharp
- Language: F#
- Homepage:
- Size: 203 KB
- Stars: 7
- Watchers: 3
- Forks: 0
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# BrokenDiscord [](https://travis-ci.org/brokenprogrammer/BrokenDiscord) [](https://www.nuget.org/packages/BrokenDiscord/)
BrokenDiscord is a [Discord](https://discordapp.com) API Library written in [F#](https://fsharp.org/). The main purpose is to provide a functional alternative that is both clean and easy to use.
## Installation
The library is available through [NuGet](https://www.nuget.org/packages/BrokenDiscord/).
## Usage
The classic ping pong example can be found [here](https://github.com/brokenprogrammer/BrokenDiscord/blob/master/BrokenDiscord.Examples/Ping/Ping.fs). More examples will be added in the future.
First you want to import the following modules
```fsharp
open BrokenDiscord.Client
open BrokenDiscord.Types
open BrokenDiscord.Events
open Hopac
```
You can then construct a new Discord client which can be used to access both the Discord web API and set callbacks for Discord events.
```fsharp
let client = new Client("DISCORD_BOT_TOKEN_HERE")
```
In the main function of the program you can add event handlers to the client and then call the start function to start the client which will then connect to the Discord gateway using a websocket.
```fsharp
// Add functionality for reacting to events here
let handleEvents = function
| Ready args -> ()
| MessageCreate args -> ()
| TypingStart args -> ()
| _ -> ()
[]
let main argv =
client.Events |> Event.add handleEvents
client.start()
Console.ReadLine() |> ignore
0
```
## Contributors
- [Oskar Mendel](https://github.com/brokenprogrammer) - Creator, maintainer
- [iseurie](https://github.com/iseurie) - Maintainer
- [Elliott Brown](https://github.com/EBrown8534) - Structure, bug fixes
- Michael Garnett - Structure, bug fixes