Запускает задачу для параллельной компиляции.

Если у вас есть файл, который нужно скомпилировать параллельно с другими модулями, запущенные процессы должны понимать среду компиляции. Эта функция позволяет разработчику создать задачу, которая учитывает эти среды.

См. Task.async/1 для получения дополнительной информации. Запущенная задача должна всегда ожидать завершения, вызвав Task.await/1.

@spec compile([Path.t()], keyword()) ::
  {:ok, [atom()], [warning()]} | {:error, [error()], [warning()]}

Компилирует заданные файлы.

Эти файлы компилируются параллельно и могут автоматически определять зависимости между ними. Как только зависимость найдена, текущий файл останавливает компиляцию, пока зависимость не будет разрешена.

Возвращает {:ok, modules, warnings} или {:error, errors, warnings}.

Ошибки и предупреждения представлены в виде списка троек, содержащих файл, строку и отформатированную ошибку/предупреждение.

Опции

• :each_file - для каждого скомпилированного файла вызывает обратный вызов, передавая файл

• :each_long_compilation - для каждого файла, который занимает более заданного времени ожидания (см. опцию :long_compilation_threshold), вызывает обратный вызов, передавая файл в качестве аргумента

• :each_module - для каждого скомпилированного модуля вызывает обратный вызов, передавая файл, модуль и байт-код модуля

• :each_cycle - после компиляции заданных файлов вызывает эту функцию, которая должна возвращать следующие значения:

  • {:compile, modules, warnings} - продолжить компиляцию со списком дополнительных модулей для компиляции
  • {:runtime, modules, warnings} - остановить компиляцию и проверить список модулей, потому что зависимые модули изменились

• :long_compilation_threshold - время ожидания (в секундах) для проверки модулей, которые занимают слишком много времени для компиляции. Для каждого файла, превысившего порог, вызывается обратный вызов :each_long_compilation. С Elixir v1.11 учитывается только время, затраченное на компиляцию модуля, время ожидания не учитывается. По умолчанию 10 секунд.

• :profile - если установлено в :time, измеряет время компиляции каждого цикла компиляции и группирует проверку прохода

• :dest - целевая директория для BEAM-файлов. При использовании compile/2, эта информация используется только для правильной аннотации BEAM-файлов перед их загрузкой в память. Если вы хотите, чтобы файл был фактически записан в dest, используйте compile_to_path/3 вместо этого.

• :beam_timestamp - отметка времени изменения для всех BEAM-файлов

@spec compile_to_path(
  [Path.t()],
  Path.t(),
  keyword()
) :: {:ok, [atom()], [warning()]} | {:error, [error()], [warning()]}

Компилирует заданные файлы и записывает полученные BEAM-файлы в указанный путь.

См. compile/2 для получения дополнительной информации.

@spec print_warning(warning()) :: :ok

Выводит предупреждение, возвращенное компилятором.

@spec require([Path.t()], keyword()) ::
  {:ok, [atom()], [warning()]} | {:error, [error()], [warning()]}

Подгружает заданные файлы параллельно.

В отличие от компиляции, зависимости между файлами не пытаются быть автоматически решены.

Возвращает {:ok, modules, warnings} или {:error, errors, warnings}.

Ошибки и предупреждения представлены в виде списка троек, содержащих файл, строку и отформатированную ошибку/предупреждение.

Опции

• :each_file - для каждого скомпилированного файла вызывает обратный вызов, передавая файл

• :each_module - для каждого скомпилированного модуля вызывает обратный вызов, передавая файл, модуль и байт-код модуля