# `Selecto.Livebook`

Convenience helpers for interactive notebooks and demos.

# `run_result`

```elixir
@type run_result() :: {:ok, term()} | {:error, term()}
```

# `explain`

```elixir
@spec explain(String.t(), Selecto.t(), keyword()) :: {String.t(), list()}
```

Print generated SQL and parameters.

# `run`

```elixir
@spec run(String.t(), Selecto.t(), keyword()) :: run_result()
```

Print SQL and execute query with preview information.

# `run_shape`

```elixir
@spec run_shape(String.t(), Selecto.t(), keyword()) :: run_result()
```

Print SQL and execute shaped query with preview information.

---

*Consult [api-reference.md](api-reference.md) for complete listing*