/clj-slack

Use Slack REST API from Clojure

Primary LanguageClojureEclipse Public License 1.0EPL-1.0

clj-slack

clj-slack is a Clojure library to talk to the Slack REST API. It supports almost the entire Slack API.

Clojars Project

Slack API methods are described here.

Usage

This is on clojars, of course. Just add [clj-slack "0.2.2"] to your :dependencies in your project.clj file.

Get your access token here.

Your need to create a connection map like {:api-url "https://slack.com/api" :token "YOUR TOKEN"} and pass it as the first argument of every functions in clj-slack. Of course you can change api-url for debugging or testing purposes.

Example in a REPL:

(require 'clj-slack.users)
(def connection {:api-url "https://slack.com/api" :token "YOUR TOKEN"})
(clj-slack.users/list connection)

will give you the list of your team users for example.

clj-slack will throw an Exception if the map you're trying to use is not valid.

To Do

  • Proper documentation
  • Add tests
  • Update docstrings with params
  • Handle optional params
  • File upload

License

Copyright (C) 2014-2015 Julien Blanchard

Distributed under the Eclipse Public License, the same as Clojure.