README.md

# Marvin

Slack bots using Elixir.


## Installation

If [available in Hex](https://hex.pm/docs/publish), the package can be installed as:

1. Add Marvin to your list of dependencies in `mix.exs`:

```elixir
def deps do
  [
    {:marvin, "~> 0.3.0"},
    {:websocket_client, git: "https://github.com/jeremyong/websocket_client"}
  ]
end
```

You'll need to add `websocket_client` manually.

2. Ensure marvin is started before your application:

```elixir
def application do
  [applications: [:marvin]]
end
```

You'll need to set your bots Slack token in your applications config file.

```elixir
config :marvin, slack_token: "secret"
```

## Creating Bots

Bots are simple to create and can respond to mentions, direct messages and ambient conversation.

```elixir
defmodule EchoBot do
  use Marvin.Bot

  # Here you can set a specific type of message and a regex pattern to match against
  # Direct includes mentions and direct discussions with the bot. Patterns are case
  # sensitive by default.

  match {:direct, ~r/hello/}

  def handle_message(message, slack) do
    send_message("Hi!", message.channel, slack)
  end
end
```

Next you'll need to tell Marvin to start your bots by adding them to your config file.

```elixir
config :marvin, bots: [EchoBot]
```

You can also capture reactions being applied to a message.

```elixir
defmodule EchoBot do
  use Marvin.Bot

  match :reaction

  def handle_message(message, slack) do
    case message.reaction do
      "coin" ->
        IO.puts "A coin was given"
      _ -> nil
    end
  end
end