Настройка проекта

Проект — это каталог с файлом elide.pkl. Результаты сборки, зависимости, отчёты и состояние сборки хранятся в .dev/. Запускайте команды из каталога проекта или передайте -p PATH.

elide init --templates   # java, ktjvm, web-simple, web-demo, workspace

Создание проекта без вопросов

elide init открывает редактор в терминале. В скриптах и CI передайте --plain --skip-defaults, шаблон и его параметры в виде name=value:

elide init --template java --parameters          # list parameters and blocks
elide init --template java --parameters --json   # the same, as JSON
elide init --plain --skip-defaults --skip-run --template java \
  project_name=greeter package=dev.acme greeting="Hi there" tests=false

elide.pkl
src/main/dev/acme/Hello.java

Аргумент	Действие
`NAME=VALUE` или `NAME VALUE`	Задаёт параметр; пропущенные параметры получают значения по умолчанию.
`BLOCK=true`, `BLOCK=false`	Включает или выключает необязательный блок: `tests` (исходники тестов), `mcp` (`.mcp.json`).
`--skip-run`	Не запускает Elide после создания файлов.
`--overwrite`	Заменяет существующие файлы.

Ввод	Результат
Нет терминала, без `--plain --skip-defaults`	Код выхода `2`: `elide init` needs an interactive terminal.
Значение, не прошедшее проверку	Код выхода `2`: `Parameter "package" value "1bad" validation failed with error: "Not a valid Java package name."`
Значение блока, отличное от `true`/`false`	Код выхода `2`: `Could not parse block "tests" value "maybe" as boolean, it must be true or false`
Неизвестное имя	Предупреждение `No parameter or block "colour" exists, value "red" will be ignored`; код выхода `0`

Создание проекта JVM

amends "elide:project.pkl"

name = "hello"

jvm {
  main = "sample.HelloKt"
}

src/main/kotlin/sample/Hello.kt:

package sample

fun main() {
  println("Hello from Kotlin")
}

elide install
elide build
elide run

Для src/main/kotlin блок sources не нужен; см. Наборы исходников.

~/demo  elide build

[10.5s] ✓ Resolved 7 Maven dependencies (10.4s)

[10.6s] ✓ Compiled 1 main Kotlin source file (128ms)

[10.6s] ⇥ Java main compilation skipped (No sources)

[10.6s] ✓ Build successful in 10.6s

~/demo  elide run

[ 11ms] ⇥ Dependencies ready (Up to date)

[ 12ms] ⇥ Kotlin main compilation skipped (Up to date)

[ 12ms] ⇥ Java main compilation skipped (Up to date)

Hello from Kotlin!

[ 69ms] ✓ JVM main application completed successfully (57ms)

[ 74ms] ✓ Build successful in 64ms

~/demo  elide build

[ 12ms] ⇥ Dependencies ready (Up to date)

[ 12ms] ⇥ Kotlin main compilation skipped (Up to date)

[ 12ms] ⇥ Java main compilation skipped (Up to date)

[ 29ms] ✓ Build successful in 19ms

0:23 / 0:23

elide build --inspect выводит список задач и их параметров; см. Задачи сборки.

Добавление скрипта

scripts {
  ["greet"] = "echo hello"
}

elide run greet

Скрипты выполняются в /bin/sh. elide run NAME выбирает первое совпадение: файл, затем скрипты из elide.pkl, затем скрипты из package.json или pyproject.toml, затем node_modules/.bin.

Добавление зависимостей

Объявите пакеты Maven, npm и PyPI в dependencies; elide install разрешает пакеты Maven и npm, но не PyPI (пакеты Python). См. Зависимости и справочник.

Создание рабочего пространства

Корень рабочего пространства перечисляет проекты-участники и собирает их как единый граф задач. elide init --template workspace создаёт такой корень. См. Рабочие пространства.

Просмотр проекта

elide project info                 # resolved source sets, dependencies, artifacts
elide project advice               # usage advice for coding agents
elide project export               # the resolved manifest as JSON
elide project export --format=pom  # or intellij
elide classpath                    # the main compile classpath, `:`-separated
elide classpath test:runtime       # [<source-set>:]<usage>

Флаги -f меняют экспорт. Форматы: Форматы экспорта проекта. Варианты classpath: Наборы исходников.

Закрепление версии Elide

elide use 1.6.0               # write .elideversion and install that version
elide use 1.6.0 --no-install  # only write the file

toolchain.engines в elide.pkl перечисляет допустимые версии; см. Инструментарий.