linklater: The fast and fun way to write Slack.com bots
A library for writing https://slack.com/ Slack chat bots.
Tutorial: https://github.com/hlian/linklater/wiki/Tutorial
Features you could take advantage of right now, should you choose:
Uses
Textfor state-of-the-art Unicode support;Lovely documentation with no misspelllllings to be found;
Supports Slack's formatting syntax
Comes with a fast mode (
slashSimple) and a power mode (slash)A warm, receptive maintainer with beautiful brown eyes;
Fully Haddock'd methods and module;
Open source (BSD3).
For example, maybe you want this little guy to show up in your channel:
Find out how by clicking on Network.Linklater!
[Skip to Readme]
Flags
Manual Flags
| Name | Description | Default |
|---|---|---|
| developer | Disabled |
Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info
Downloads
- linklater-2.0.0.2.tar.gz [browse] (Cabal source package)
- Package description (revised from the package)
Note: This package has metadata revisions in the cabal description newer than included in the tarball. To unpack the package including the revisions, use 'cabal get'.
Maintainer's Corner
For package maintainers and hackage trustees
Candidates
| Versions [RSS] | 1.0.0.0, 1.0.0.1, 1.0.0.2, 1.0.0.3, 2.0.0.0, 2.0.0.1, 2.0.0.2, 2.0.0.3, 3.1.0.0, 3.2.0.0, 4.0.0.0, 4.0.0.1, 4.0.0.2 |
|---|---|
| Change log | changelog |
| Dependencies | aeson (>=0.7.0.6 && <0.8), base (>=4.6 && <4.8), bytestring (>=0.10.4.0 && <0.11), containers (>=0.5 && <0.6), http-types (>=0.8.5 && <0.9), lens (>=4.3 && <4.4), text (>=1.1.1.3 && <1.2), wai (>=3.0.0.2 && <3.1), wreq (>=0.1.0.1 && <0.2) [details] |
| License | BSD-3-Clause |
| Author | Hao Lian <me@haolian.org> |
| Maintainer | me@haolian.org |
| Revised | Revision 1 made by hao at 2014-07-27T08:22:27Z |
| Category | Network |
| Home page | https://github.com/hlian/linklater |
| Bug tracker | https://github.com/hlian/linklater/issues |
| Source repo | head: git clone https://github.com/hlian/linklater |
| Uploaded | by hao at 2014-07-27T08:15:30Z |
| Distributions | |
| Reverse Dependencies | 2 direct, 0 indirect [details] |
| Downloads | 9824 total (0 in the last 30 days) |
| Rating | (no votes yet) [estimated by Bayesian average] |
| Your Rating | |
| Status | Docs available [build log] Successful builds reported [all 1 reports] |
Readme for linklater-2.0.0.2
[back to package description]Who let you in here?
Relax! I'm here to make your life easier. Has your company ever switched to using Slack, and then you wanted to write silly Slack bots in Haskell as a way to learn Haskell?
Really?WowThat was a pretty specific question.
Uh, do you want to be friends? Well let's talk about it later, because right now I have an example for you. But you'll have to grab me first: If you don't have Haskell, it's quite easy: Windows, Mac, and Linux. Here's a For the full example (since this one is missing a ton of imports), see
the Now! So easy. Much fast.
cabal sandbox init
cabal install linklater
Show me an example!
/jpgto bot. If you run this program and then tell Slack
about your server (incoming hook and custom slash command) and then
type /jpgto diplomatico in one of your channels, you'll get the
image from http://diplomatico.jpg.to. How, you say? Screen scraping.-- Remaining imports left as an exercise to the reader.
import Network.Linklater (say, slashSimple, Command(..), Config(..), Message(..), Icon(..), Format(..))
findUrl :: Text -> Maybe Text
findUrl = fmap fromStrict . maybeResult . parse (manyTill (notChar '\n') (string "src=\"") *> takeTill (== '"'))
jpgto :: Maybe Command -> IO Text
jpgto (Just (Command user channel (Just text))) = do
message <- (fmap messageOf . findUrl . decodeUtf8 . flip (^.) responseBody) <$> get ("http://" <> (unpack subdomain) <> ".jpg.to/")
case (debug, message) of
(True, _) -> putStrLn ("+ Pretending to post " <> (unpack . decodeUtf8 . encode) message) >> return ""
(False, Just m) -> config' >>= say m >> return ""
(False, Nothing) -> return "Something went wrong!"
where config' = (Config "trello.slack.com" . filter (/= '\n') . pack) <$> readFile "token"
subdomain = (intercalate "." . fmap (filter isLetter . filter isAscii) . words) text
messageOf url = FormattedMessage (EmojiIcon "gift") "jpgtobot" channel [FormatAt user, FormatLink url (subdomain <> ".jpg.to>")]
debug = True
jpgto _ = return "Type more! (Did you know? jpgtobot is only 26 lines of Haskell. <https://github.com/hlian/jpgtobot/blob/master/Main.hs>)"
main :: IO ()
main = let port = 3000 in putStrLn ("+ Listening on port " <> show port) >> run port (slashSimple jpgto)
examples/ directory on GitHub./jpgto corgi:
Features
Text everywhere so you can send your slash commands crazy Unicode characters all day long.
Contributors
