README.md

# Cloister    [![Kantox ❤ OSS](https://img.shields.io/badge/❤-kantox_oss-informational.svg)](https://kantox.com/)  ![Test](https://github.com/am-kantox/cloister/workflows/Test/badge.svg)  ![Dialyzer](https://github.com/am-kantox/cloister/workflows/Dialyzer/badge.svg)

**The helper application to manage cluster of nodes.**

## Installation

- Add the dependency to your `mix.exs` file:

```elixir
def deps do
  [
    {:cloister, "~> 0.5"},
    ...
  ]
end
```

- Make sure both `:cloister` and `:libring` applications are configured properly in your `config.exs`

```elixir
config :cloister,
  sentry: ~w|node1@127.0.0.1 node2@127.0.0.1|a,
  consensus: 2
```

- Make sure `:cloister` application is started. This does not require any action unless you have the list of applications specified explicitly. If so, add `:cloister` there.

## Changelog

- **`0.18.0`** [BREAK] `sentry` is always properly set up, `Listener.on_state_change/3`
- **`0.17.0`** [TST] shortnames, proper testing with `enfiladex`
- **`0.16.0`** [EXP] experimental `mix` tasks to test/run stuff in a cloister
- **`0.15.0`** [BUG] fixed `Cloister.multicast/multicall`
- **`0.14.0`** named isolated `Finitomata` supervision tree
- **`0.13.0`** [BUG] fixed `Cloister.state/0` adding groups (credits: @anthony-gonzalez-kantox)
- **`0.12.0`** complete rewrite of cluster assembly based on `Finitomata`
- **`0.10.0`** `Cloister.siblings!/0` and `Cloister.consensus/0`, better tests
- **`0.9.0`** `Cloister.multiapply/4` to wrap `:rpc.multicall/4`
- **`0.7.0`** `magic? :: boolean()` and `loopback? :: boolean()` config params to avoid cluster building in tests
- **`0.6.0`** support many hashrings within the same cloister
- **`0.2.0`** use `Application.c:start_phase/3` callback to postpone application start until the consensus is reached

---

## [Documentation](https://hexdocs.pm/cloister).