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

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

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

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

Возвращает {:ok, modules, warnings} или {:error, errors, warnings} по умолчанию, но рекомендуется использовать return_diagnostics: true, чтобы получить диагностику в виде словарей, а также словарь информации о компиляции. Словарь имеет структуру:

%{
  runtime_warnings: [warning],
  compile_warnings: [warning]
}

Параметры

• :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

• :return_diagnostics (с версии v1.15.0) - возвращает словари с информацией вместо списка предупреждений и возвращает диагностику как словари вместо кортежей

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

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

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

Выполняет параллельную компиляцию collection с помощью fun.

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

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

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

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

Возвращает {:ok, modules, warnings} или {:error, errors, warnings} по умолчанию, но рекомендуется использовать return_diagnostics: true, чтобы получить диагностику в виде словарей, а также словарь информации о компиляции. Словарь имеет структуру:

%{
  runtime_warnings: [warning],
  compile_warnings: [warning]
}

Параметры

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

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