defmodule Herd do
  @moduledoc """
  A herd consists of three modules, a Cluster, a Pool, and a Supervisor.  The cluster manages an
  ets table of all the current nodes to balance across, the pool supervises connection pools to each node, and a Supervisor supervises the cluster and the pool.  They can be created more or less like so:

  ```elixir
  defmodule Herd.MockCluster do
    use Herd.Cluster, otp_app: :herd,
                      pool: Herd.MockPool,
                      discovery: MyDiscovery,
                      router: MyRouter # defaults to Herd.Router.HashRing
  end

  defmodule Herd.MockPool do
    use Herd.Pool, otp_app: :herd
  end

  defmodule Herd.MockSupervisor do
    use Herd.Supervisor, otp_app: :herd
                        pool: Herd.MockPool,
                        cluster: Herd.MockCluster
  end
  ```

  You would then need to add Herd.MockSupervisor to your application's supervision tree.

  If you want to bring your own router you can implement the `Herd.Router` behaviour,
  and if you want to implement a service discovery mechanism, simply implement the `Herd.Discovery`
  behaviour.  The library comes built with a hash ring based router and a config based discovery
  mechanism
  """
end