Adapter to get basic query functionality into Ecto with CouchDB.

Configuration

It uses the same as Ecto pattern to config the Dbs with this format:

config :my_app, MyRepo,
  username: "username",
  password: "password",
  database: "db_name",
  hostname: "localhost",
  protocol: "http",
  port: 5984

Usage

Couchx supports 1 main repo and many dynamic supervised repos. A dynamic repo will allow you to have multiple db connections in your application. To achieve this, you will need to setup a DynamicSupervisor and a Registry in the application like:

  def start(_type, _args) do
    children = [
      {DynamicSupervisor, strategy: :one_for_one, name: CouchxSupervisor}
      {Registry, keys: :unique, name: CouchxRegistry},
      ...
    ]
    ...
  end

The Restry name is tied up to the code so it must be called CouchxRegistry.

The main Repo is configured as any other Ecto Repo, so you can start it in the application just adding it to the children list.

  def start(_type, _args) do
    children = [
      MyDb.Repo
    ]
    ...
  end

Dynamic Repo queries

The dynamic repos are implemente with a Macro that you can get into your repo as:

  use CouchxDyncamicTepo, otp_app: :my_app, name: :my_repo

This is used to setup a run function, with a callback as argument. To execute actions in a dynamic repo we follow this pattern:

  MyDynamicRepo.run( ->
    MyDynamicRepo.get(MyStruct, doc_id)
  end)

Any Repo call inside the callback function will be run in a dynamically supervised connection.