mix compile.mojoler (mojoler v0.1.0)

Copy Markdown View Source

Builds the Mojo NIFs into priv/native.

This is the Mix.Task.Compiler callback Mix.Task.Compiler.run/1. Mix calls it because mix.exs appends :mojoler to the compiler list. A second run with the same sources, headers, and compiler returns {:noop, []}.

The callback receives the compiler argv and ignores it. It returns one of:

  • {:ok, []} after a build
  • {:noop, []} when the fingerprint and the libraries are unchanged
  • {:error, [diagnostic]} when the VM has already loaded a library that would be replaced, or when mojo build fails

diagnostic is a Mix.Task.Compiler.Diagnostic. The fields this task sets are:

  • :file — priv/native or scripts/build-native.sh
  • :severity — :error
  • :message — the build or load failure
  • :position — 0
  • :compiler_name — "mojoler"

Examples

iex> Mix.Tasks.Compile.Mojoler.run([])
{:noop, []}

Summary

Functions

run(args)

Runs the native build.

Functions

run(args)

@spec run([String.t()]) ::
  {:ok, []} | {:noop, []} | {:error, [Mix.Task.Compiler.Diagnostic.t()]}

Runs the native build.

args is the compiler argv. It is ignored. There is no optional argument beyond that ignored list.

See the module docs for the return values and the diagnostic fields.

Examples

iex> Mix.Tasks.Compile.Mojoler.run(["--force"])
{:noop, []}