A client library for the discordapp bot api

lispcord

# Lispcord -- A wrapper for the [DiscordApp](http://discordapp.com/) WEB-API

Lispcord aims to make it freakishly easy to build bots for Discord.

The [examples](./examples) folder contains some more ideas on how to get started :)


#### NOTE: this is not even an alpha quality software

A lot of the api is changing rapidly, use at own risk!

#### NOTE: recently we axed the Pipe system

Please re-adjust your bots to use the new API going forwards.
As it turned out, the pipes worked well for small bots but had the penchant to
bloat in complexity rather quickly, and weren't particularly fast :D


## Ping bot

This assumes that :lispcord has been loaded in your image. If not, try running

```lisp
(ql:quickload :lispcord)
```

after cloning the repo to your `~/common-lisp` or `~/quicklisp/local-projects` folder.

```lisp
(defpackage :ping-bot
  (:use :cl :lispcord))
(in-package :ping-bot)

(setf (v:repl-level) :info)

(defbot *ping-bot* "<Your Token Here>")
(connect *ping-bot*) ; Yes, you can register handlers after connect

(add-event-handler :on-message-create
  (lambda (msg) (if (string= (lc:content msg) "ping!") (reply msg "pong!"))))
```

Unlike many other libraries, **lispcord** is capable of running an arbitrary amount
of client-instances at the same time.  
Every (non-cache related) function takes an optional "bot" parameter,
either via keyword or as an anonymous optional,
with which you can specify what instance should execute the action.  

For convenience, however, **lispcord** *also* defines a dynamic `*CLIENT*` which
gets automatically bound to the last instance defined via `DEFBOT`. This allows you to:

  - drop having to specifiy the bot for 1-instance scripts
  - use `LET` to override the global, and create local 1-instance spaces


lispcord

Upstream URL

Author

Maintainer

License

example-bot

License:

Authors:

Maintainers:

Dependencies:

lispcord

License:

Authors:

Maintainers:

Dependencies:

Dependencies (8)

Dependents (0)