Kernel.ParallelCompiler

Модуль, отвечающий за компиляцию и загрузку файлов параллельно.

Краткое описание

Функции

async(fun)

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

compile(files, options \\ [])

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

compile_to_path(files, path, options \\ [])

require(files, options \\ [])

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

Функции

async(fun)

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

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

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

compile(files, options \\ [])

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

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

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

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

Параметры

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

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

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

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

• :long_compilation_threshold - время ожидания (в секундах) после вызова обратного вызова :each_long_compilation; по умолчанию 15

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

compile_to_path(files, path, options \\ [])

require(files, options \\ [])

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

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

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

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

Параметры

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

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