Kernel.ParallelCompiler
Модуль, отвечающий за компиляцию и загрузку файлов в параллельном режиме.
Краткое описание
Функции
- async(fun)
Запускает задачу для параллельной компиляции.
- compile(files, options \\ [])
Компилирует заданные файлы.
- compile_to_path(files, path, options \\ [])
- require(files, options \\ [])
Загружает заданные файлы в параллельном режиме.
Функции
async(fun)
(с версии 1.6.0) Запускает задачу для параллельной компиляции.
Если у вас файл, который должен компилировать другие модули в параллельном режиме, запущенные процессы должны быть осведомлены об окружении компилятора. Эта функция позволяет разработчику создавать задачу, которая учитывает эти среды.
См. Task.async/1 для получения дополнительной информации. Запущенная задача всегда должна быть ожидаема, вызывая Task.await/1
compile(files, options \\ [])
(с версии 1.6.0) Компилирует заданные файлы.
Эти файлы компилируются параллельно и могут автоматически определять зависимости между ними. После обнаружения зависимости текущий файл останавливает компиляцию до разрешения зависимости.
Возвращает {: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 \\ [])
(с версии 1.6.0) require(files, options \\ [])
(с версии 1.6.0) Загружает заданные файлы в параллельном режиме.
В отличие от компиляции, попытки автоматического решения зависимостей между файлами не предпринимаются.
Возвращает {:ok, modules, warnings} или {:error, errors, warnings}.
Ошибки и предупреждения представлены в виде списка кортежей из трех элементов: файла, строки и отформатированной ошибки/предупреждения.
Параметры
-
:each_file- для каждого скомпилированного файла вызывает обратный вызов, передавая файл -
:each_module- для каждого скомпилированного модуля вызывает обратный вызов, передавая файл, модуль и байткод модуля
© 2012 Plataformatec
Licensed under the Apache License, Version 2.0.
https://hexdocs.pm/elixir/1.8.2/Kernel.ParallelCompiler.html