Configuration du projet

Un projet est un répertoire qui contient un elide.pkl. Les sorties, les dépendances, les rapports et l’état du build vont dans .dev/. Lancez les commandes depuis le répertoire du projet, ou passez -p PATH.

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

Créer un projet sans questions

elide init ouvre un éditeur dans le terminal. Dans les scripts et en CI, passez --plain --skip-defaults, un modèle et ses paramètres sous la forme 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

Argument	Effet
`NAME=VALUE` ou `NAME VALUE`	Définit un paramètre ; les paramètres omis prennent leur valeur par défaut.
`BLOCK=true`, `BLOCK=false`	Active ou désactive un bloc facultatif : `tests` (sources de test), `mcp` (`.mcp.json`).
`--skip-run`	N’exécute pas Elide après la génération des fichiers.
`--overwrite`	Remplace les fichiers existants.

Entrée	Résultat
Pas de terminal, sans `--plain --skip-defaults`	Code de sortie `2` : `elide init` needs an interactive terminal.
Une valeur qui échoue à la validation	Code de sortie `2` : `Parameter "package" value "1bad" validation failed with error: "Not a valid Java package name."`
Une valeur de bloc autre que `true`/`false`	Code de sortie `2` : `Could not parse block "tests" value "maybe" as boolean, it must be true or false`
Un nom inconnu	Avertissement `No parameter or block "colour" exists, value "red" will be ignored` ; code de sortie `0`

Créer un projet 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 ne nécessite pas de bloc sources ; voir Source sets.

~/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 liste les tâches et leurs options ; voir Tâches de build.

Ajouter un script

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

elide run greet

Les scripts s’exécutent sous /bin/sh. elide run NAME retient la première correspondance : un fichier, puis les scripts de elide.pkl, puis ceux de package.json ou pyproject.toml, puis node_modules/.bin.

Ajouter des dépendances

Déclarez les paquets Maven, npm et PyPI sous dependencies ; elide install résout les paquets Maven et npm, pas PyPI (paquets Python). Voir Dépendances et la référence.

Créer un espace de travail

La racine d’un espace de travail liste les projets membres et les construit comme un seul graphe de tâches. elide init --template workspace en crée un. Voir Espaces de travail.

Inspecter un projet

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>

Les options -f modifient l’export. Formats : Formats d’export du projet. Usages du classpath : Source sets.

Épingler la version d’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 dans elide.pkl liste les versions acceptées ; voir Chaîne d’outils.