Скрипт обслуживания Nim

«Великий шеф — это художник, которого я по-настоящему уважаю» — Роберт Стек.

Введение

Программа koch является скриптом обслуживания Nim. Она заменяет make и shell-скрипты, обладая преимуществами большей переносимости. Слово koch означает повар по-немецки. koch используется в основном для сборки компилятора Nim, но также может быть использована для других задач. В этом документе описаны поддерживаемые команды и их параметры.

Команды

Команда boot

Команда boot выполняет загрузку компилятора и принимает различные параметры:

-d:release

По умолчанию создаётся версия для отладки. Передача этого параметра заставит создать релизную сборку, которая намного быстрее и предпочтительна, если вы не отлаживаете компилятор.

-d:nimUseLinenoise

Использовать библиотеку linenoise для интерактивного режима (не нужно на Windows).

После завершения компиляции вы, надеюсь, получите компилятор Nim в каталоге bin. Вы можете добавить каталог bin Nim в ваш $PATH или использовать команду install, чтобы разместить его там, где он будет найден.

Команда csource

Команда csource собирает исходные C-файлы для установки. Она принимает те же параметры, что и команда boot.

Команда temp

Команда temp собирает компилятор Nim, но с другим конечным именем (nim_temp), чтобы не перезаписывать ваш обычный компилятор. Вы можете использовать эту команду для тестирования различных параметров, которые вы бы использовали для команды boot.

Команда test

Команда test также может быть вызвана с псевдонимом tests. Эта команда скомпилирует и запустит testament/tester.nim, который является основным драйвером набора тестов Nim. Вы можете передать параметры команде test, они будут переданы тестировщику. См. исходный код для доступных параметров.

Команда web

Команда web преобразует документацию в каталоге doc из rst в HTML. Она также повторяет ту же операцию, но помещает результат в web/upload, что можно использовать для обновления сайта по адресу https://nim-lang.org.

По умолчанию документация будет собираться параллельно с использованием количества доступных ядер процессора. Если какие-либо подкоманды сборки документации завершаются сбоем, они будут перевыполнены последовательно, чтобы можно было собрать информативные ошибки для проверки. Переключатель --parallelBuild:n или параметр конфигурации могут быть использованы для принудительного задания определённого количества параллельных задач или выполнения всего последовательно с самого начала (n == 1).