Configurar un proyecto

Un proyecto es un directorio con un elide.pkl. Las salidas, las dependencias, los informes y el estado de compilación van en .dev/. Ejecute los comandos desde el directorio del proyecto o pase -p PATH.

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

Crear un proyecto sin preguntas

elide init abre un editor en la terminal. En scripts y en CI, pase --plain --skip-defaults, una plantilla y sus parámetros como 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

Argumento	Efecto
`NAME=VALUE` o `NAME VALUE`	Define un parámetro; los parámetros omitidos toman su valor predeterminado.
`BLOCK=true`, `BLOCK=false`	Activa o desactiva un bloque opcional: `tests` (fuentes de prueba), `mcp` (`.mcp.json`).
`--skip-run`	No ejecuta Elide después de generar los archivos.
`--overwrite`	Reemplaza los archivos existentes.

Entrada	Resultado
Sin terminal y sin `--plain --skip-defaults`	Sale con `2`: `elide init` needs an interactive terminal.
Un valor que no pasa la validación	Sale con `2`: `Parameter "package" value "1bad" validation failed with error: "Not a valid Java package name."`
Un valor de bloque distinto de `true`/`false`	Sale con `2`: `Could not parse block "tests" value "maybe" as boolean, it must be true or false`
Un nombre desconocido	Advertencia `No parameter or block "colour" exists, value "red" will be ignored`; sale con `0`

Crear un proyecto 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 no necesita un bloque sources; consulte Conjuntos de fuentes.

~/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 muestra las tareas y sus opciones; consulte Tareas de compilación.

Añadir un script

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

elide run greet

Los scripts se ejecutan con /bin/sh. elide run NAME elige la primera coincidencia: un archivo, luego los scripts de elide.pkl, luego los scripts de package.json o pyproject.toml y, por último, node_modules/.bin.

Añadir dependencias

Declare paquetes de Maven, npm y PyPI en dependencies; elide install resuelve los paquetes de Maven y npm, pero no los de PyPI (paquetes de Python). Consulte Dependencias y la referencia.

Crear un espacio de trabajo

La raíz de un espacio de trabajo enumera los proyectos miembros y los compila como un único grafo de tareas. elide init --template workspace crea uno. Consulte Espacios de trabajo.

Inspeccionar un proyecto

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>

Las opciones -f modifican la exportación. Formatos: Formatos de exportación del proyecto. Usos del classpath: Conjuntos de fuentes.

Fijar la versión de 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 en elide.pkl enumera las versiones aceptadas; consulte Cadena de herramientas.