Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/supernullset/hedwig_flowdock
A Flowdock Adapter for the Hedwig ChatBot Framework
https://github.com/supernullset/hedwig_flowdock
Last synced: 6 days ago
JSON representation
A Flowdock Adapter for the Hedwig ChatBot Framework
- Host: GitHub
- URL: https://github.com/supernullset/hedwig_flowdock
- Owner: supernullset
- License: mit
- Created: 2016-06-01T21:01:36.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-07-30T04:28:36.000Z (over 7 years ago)
- Last Synced: 2024-10-13T01:48:37.894Z (about 1 month ago)
- Language: Elixir
- Size: 38.1 KB
- Stars: 5
- Watchers: 1
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG
- License: LICENSE.md
Awesome Lists containing this project
README
# Hedwig Flowdock Adapter
> A Flowdock Adapter for [Hedwig](https://github.com/hedwig-im/hedwig)
## Getting started
Let's generate a new Elixir application with a supervision tree:
```
λ mix new alfred --sup
* creating README.md
* creating .gitignore
* creating mix.exs
* creating config
* creating config/config.exs
* creating lib
* creating lib/alfred.ex
* creating test
* creating test/test_helper.exs
* creating test/alfred_test.exs
Your Mix project was created successfully.
You can use "mix" to compile it, test it, and more:
cd alfred
mix test
Run "mix help" for more commands.
```
Change into our new application directory:
```
λ cd alfred
```
Add `hedwig_flowdock` to your list of dependencies in `mix.exs`:
```elixir
def deps do
[
{:hedwig, github: "hedwig-im/hedwig"},
{:hedwig_flowdock, "0.1"}
]
end
```
Ensure `hedwig_flowdock` is started before your application:
```elixir
def application do
[applications: [:hedwig, :hedwig_flowdock]]
end
```
### Generate our robot
```
λ mix hedwig.gen.robot
Welcome to the Hedwig Robot Generator!
Let's get started.
What would you like to name your bot?: alfred
Available adapters
1. Hedwig.Adapters.Slack
2. Hedwig.Adapters.Console
3. Hedwig.Adapters.Test
Please select an adapter: 1
* creating lib/alfred
* creating lib/alfred/robot.ex
* updating config/config.exs
Don't forget to add your new robot to your supervision tree
(typically in lib/alfred.ex):
worker(Alfred.Robot, [])
```
### Supervise our robot
We'll want Alfred to be supervised and started when we start our application.
Let's add it to our supervision tree. Open up `lib/alfred.ex` and add the
following to the `children` list:
```elixir
worker(Alfred.Robot, [])
```
### Configuration
The next thing we need to do is configure our bot for our XMPP server. Open up
`config/config.exs` and let's take a look at what was generated for us:
```elixir
use Mix.Config
config :alfred, Alfred.Robot,
adapter: Hedwig.Adapters.Flowdock,
name: "alfred",
aka: "/",
responders: [
{Hedwig.Responders.Help, []},
{Hedwig.Responders.GreatSuccess, []},
{Hedwig.Responders.ShipIt, []}
]
```
So we have the `adapter`, `name`, `aka`, and `responders` set. The `adapter` is
the module responsible for handling all of the Flowdock details like connecting and
sending and receiving messages over the network. The `name` is the name that our
bot will respond to. The `aka` (also known as) field is optional, but it allows
us to address our bot with an alias. By default, this alias is set to `/`.
Finally we have `responders`. Responders are modules that provide functions that
match on the messages that get sent to our bot. We'll discuss this further in
a bit.
We'll need to provide a few more things in order for us to connect to our Flowdock
server. We'll need to provide our bot's API key as well as a list of rooms we
want our bot to join once connected. Let's see what that looks like:
```elixir
use Mix.Config
config :alfred, Alfred.Robot,
adapter: Hedwig.Adapters.Flowdock,
name: "alfred",
aka: "/",
# fill in the appropriate API token for your bot
token: "some api token",
# for now, you can invite your bot to a channel in Flowdock and it will join
# automatically
rooms: [],
responders: [
{Hedwig.Responders.Help, []},
{Hedwig.Responders.GreatSuccess, []},
{Hedwig.Responders.ShipIt, []}
]
```
Great! We're ready to start our bot. From the root of our application, let's run
the following:
```
λ mix run --no-halt
```
This will start our application along with our bot. Our bot should connect to
Flowdock and join the rooms it's in based on its Flowdock integration. From there, we
can chat with our bot in any Flowdock client.
Since we have the `Help` responder installed, we can say `alfred help` and we
should see a list of usage for all of the installed responders.
## What's next?
Well, that's it for now. Make sure to read the [Hedwig Documentation](http://hexdocs.pm/hedwig) for more
details on writing responders and other exciting things!
## LICENSE
Copyright (c) 2016, Sean Williamson.
Hedwig Flowdock source code is licensed under the [MIT License](https://github.com/hedwig-im/hedwig_flowdock/blob/master/LICENSE.md).