# SanityEx

A client for interacting with the Sanity API and constructing GROQ queries from Elixir applications.

This is a very primitive implementation, built mostly for practice & my own use, and only supports _some_ of GROQ's syntax. Please feel free to contribute!

## Installation

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

```elixir
def deps do
[
  {:sanity_ex, "~> 0.1.0"}
]
```

and run `$ mix deps.get`.

## Usage

Add the Client to your supervision tree:

```elixir
defmodule MyApp.Application do
  use Application

  def start(_type, _args) do
    children = [
      {
        SanityEx.Client,
        project_id: "your_project_id",
        dataset: "production",
        api_version: "v2021-03-25",
        token: "your_token"
      }
    ]

    opts = [strategy: :one_for_one, name: MyApp.Supervisor]
    Supervisor.start_link(children, opts)
  end
end
```

Then you can use the Client to interact with the Sanity API:

```elixir
SanityEx.Client.query("*[_type == 'movie']{title, releaseYear}")
```

### Options

The following options are required when configuring the client:

- `project_id` - The project ID for your Sanity project.
- `api_version` - The dated version of the Sanity API to use.
- `token` - The API token for making authorized requests.

The following are optional:
- `dataset` - The dataset to query against. Defaults to `production`.
- `asset_url` - The base asset URL to use. Defaults to `cdn.sanity.io/images/{project_id}/{dataset}/`.

## Documentation

Documentation can be found at [https://hexdocs.pm/sanity_ex](https://hexdocs.pm/sanity_ex).