Specs

all(opts :: Keyword.t()) :: [EctoCrux.Schema.Baguette.t()]

[Repo] Fetches all entries from the data store

# Fetch all Baguettes
Baguettes.all()
# Fetch all Baguettes within Repo prefix "francaise"
Baguettes.all(prefix: "francaise")

Options

• order_by - order_by expression, overrides default order_by for the crux usage
• select - select expression, overrides default select for the crux usage
• @see Repo.all/2

call schema_module changeset method

Specs

count() :: integer()

Count number of elements

baguettes_count = Baguettes.count()

Specs

count(query :: Ecto.Query.t()) :: integer()

count(opts :: Keyword.t()) :: integer()

Count number of entries with opts

baguettes_count = Baguettes.count(prefix: "francaise")

Options

• @see Repo.aggregate/3

Specs

count(query :: Ecto.Query.t(), opts :: Keyword.t()) :: integer()

Count number of entries from a query with opts

query = from b in Baguette, where :kind in ["tradition"]
baguettes_count = Baguettes.count(query, prefix: "francaise")

Options

• @see Repo.aggregate/3

Specs

count_by(filters :: Keyword.t() | map(), opts :: Keyword.t()) :: integer()

Count number of entries complying with the filter clauses.

Options

• @see Repo.aggregate/3

Specs

create(attrs :: map(), opts :: Keyword.t()) ::
  {:ok, EctoCrux.Schema.Baguette.t()} | {:error, Ecto.Changeset.t()}

[Repo proxy of insert/2] Create (insert) a new baguette from attrs

# Create a new baguette with `:kind` value set to `:tradition`
{:ok, baguette} = Baguettes.create(%{kind: :tradition})

Options

@see Repo.insert/2

Specs

create_if_not_exist(attrs :: map()) ::
  {:ok, EctoCrux.Schema.Baguette.t()} | {:error, Ecto.Changeset.t()}

Create (insert) a baguette from attrs if it doesn't exist

# Create a new baguette with :kind value set to :tradition baguette = Baguettes.create(%{kind: :tradition}) # Create another one with the same kind {:ok, another_ baguette} = Baguettes.create_if_not_exist(%{kind: :tradition}) # baguette and another_baguette are the same Baguette

Options

@see Repo.insert/2

Specs

create_if_not_exist(attrs :: map(), opts :: Keyword.t()) ::
  {:ok, EctoCrux.Schema.Baguette.t()} | {:error, Ecto.Changeset.t()}

create_if_not_exist(presence_attrs :: map(), creation_attrs :: map()) ::
  {:ok, EctoCrux.Schema.Baguette.t()} | {:error, Ecto.Changeset.t()}

[Repo] Create (insert) a baguette from attrs if it doesn't exist

Behave like create_if_not_exist/1 but you can specify attrs for the presence test, and creation attrs.

Options

@see Repo.insert/2

Specs

create_if_not_exist(
  presence_attrs :: map(),
  creation_attrs :: map(),
  opts :: Keyword.t()
) ::
  {:ok, EctoCrux.Schema.Baguette.t()} | {:error, Ecto.Changeset.t()}

[Repo] Create (insert) a baguette from attrs if it doesn't exist

Behave like create_if_not_exist/1 but you can specify attrs for the presence test, and creation attrs.

Options

@see Repo.insert/2

Specs

delete(blob :: EctoCrux.Schema.Baguette.t(), opts :: Keyword.t()) ::
  {:ok, EctoCrux.Schema.Baguette.t()} | {:error, Ecto.Changeset.t()}

[Repo proxy] Deletes a struct using its primary key.

= Baguettes.delete(baguette)

Options

• @see Repo.delete/2

value of except

Specs

exist?(presence_attrs :: map(), opts :: Keyword.t()) :: boolean()

Test if an entry with <presence_attrs> exists

Specs

find_by(Ecto.Query.t()) :: [EctoCrux.Schema.Baguette.t()]

find_by(filters :: Keyword.t() | map()) :: [EctoCrux.Schema.Baguette.t()]

[Repo] Fetches all results from the filter clauses.

best_baguettes = Baguettes.find_by(kind: "best")

Specs

find_by(Ecto.Query.t(), map()) :: [EctoCrux.Schema.Baguette.t()]

find_by(Ecto.Query.t(), Keyword.t()) :: [EctoCrux.Schema.Baguette.t()]

find_by(Keyword.t(), Keyword.t() | map()) :: [EctoCrux.Schema.Baguette.t()]

find_by(filters :: Keyword.t() | map(), opts :: map()) :: [
  EctoCrux.Schema.Baguette.t()
]

[Repo] Fetches all results from the filter clauses, with opts

best_baguettes = Baguettes.find_by(kind: "best", prefix: "francaise")

Options

• order_by - order_by expression, overrides default order_by for the crux usage
• select - select expression, overrides default select for the crux usage
• @see Repo.all/2

Specs

get(id :: term(), opts :: Keyword.t()) :: EctoCrux.Schema.Baguette.t() | nil

[Repo] Fetches a single struct from the data store where the primary key matches the given id.

# Get the baguette with id primary key `01DACBCR6REMDH6446VCQEZ5EC`
Baguettes.get("01DACBCR6REMDH6446VCQEZ5EC")
# Get the baguette with id primary key `01DACBCR6REMDH6446VCQEZ5EC` and preload it's bakery and flavor
Baguettes.get("01DACBCR6REMDH6446VCQEZ5EC", preloads: [:bakery, :flavor])

Options

• preloads - list of atom to preload
• select - select expression, overrides default select for the crux usage
• @see Repo.get/3

Specs

get!(id :: term(), opts :: Keyword.t()) :: EctoCrux.Schema.Baguette.t()

[Repo] Similar to get/2 but raises Ecto.NoResultsError if no record was found.

Options

• preloads - list of atom to preload
• select - select expression, overrides default select for the crux usage
• @see Repo.get!/3

Specs

get_by(clauses :: Keyword.t() | map(), opts :: Keyword.t()) ::
  EctoCrux.Schema.Baguette.t() | nil

[Repo] Fetches a single result from the clauses.

best_baguette = Baguettes.get_by(kind: "best")

Options

• preloads - list of atom to preload
• select - select expression, overrides default select for the crux usage
• @see Repo.get_by/3

Specs

get_by!(clauses :: Keyword.t() | map(), opts :: Keyword.t()) ::
  EctoCrux.Schema.Baguette.t()

[Repo] Similar to get_by/2 but raises Ecto.NoResultsError if no record was found.

Options

• preloads - list of atom to preload
• select - select expression, overrides default select for the crux usage
• @see Repo.get_by!/2

create a new query using schema module

value of default order by

default page size if using pagination

Specs

preload(structs_or_struct_or_nil, preloads :: term(), opts :: Keyword.t()) ::
  structs_or_struct_or_nil
when structs_or_struct_or_nil:
       [EctoCrux.Schema.Baguette.t()] | EctoCrux.Schema.Baguette.t() | nil

[Repo proxy] Preloads all associations on the given struct or structs.

my_baguette = Baguettes.preload(baguette, [:floor, :boulanger])

Options

• @see Repo.preload/2

value of read_only mode

configured repo to use

schema module is it associated to

value of default select

Specs

stream(filters :: Keyword.t(), opts :: Keyword.t()) :: Enum.t()

Like find_by/1 by returns a stream to handle large requests

Repo.transaction(fn ->
  Baguettes.stream(kind: "best")
  |> Stream.chunk_every(@chunk_size)
  |> Stream.each(fn baguettes_chunk ->
    # eat them
  end)
  |> Stream.run()
end)

Options

• @see Repo.stream/2

Create an atom-keyed map from the given map. If both a string and an atom keys are provided in the original map, atom key gets priority.

Baguettes.to_schema_atom_params(%{"kind" => "baguepi", :kind => "tradition", "half?" => true})
%{kind: "tradition"}

Options

• with_assoc [optional] - add associations fields to the list of allowed fields, defaults to true.

Specs

update(
  blob :: EctoCrux.Schema.Baguette.t(),
  attrs :: map(),
  opts :: Keyword.t()
) ::
  {:ok, EctoCrux.Schema.Baguette.t()} | {:error, Ecto.Changeset.t()}

[Repo proxy] Updates a changeset using its primary key.

{:ok, updated_baguette} = Baguettes.update(baguette, %{kind: "best"})

Options

• @see Repo.update/2

Specs

update!(
  blob :: EctoCrux.Schema.Baguette.t(),
  attrs :: map(),
  opts :: Keyword.t()
) ::
  EctoCrux.Schema.Baguette.t()

[Repo proxy] Same as update/2 but return the struct or raises if the changeset is invalid

updated_baguette = Baguettes.update!(baguette, %{kind: "best"})

Options

• @see Repo.update!/2