Налаштування проєкту

Проєкт — це каталог із файлом 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 перелічує допустимі версії; див. Інструментарій.