Desarrollo tempranoVectrune está en una etapa previa a la 1.0 y evoluciona rápidamente. La sintaxis y las API pueden cambiar entre versiones.Sigue el progreso en GitHub

Hito de adopción masiva

Obtén una aplicación Vectrune útil en minutos.

Vectrune es un lenguaje declarativo y runtime para datos estructurados, APIs y pequeños flujos de trabajo de aplicaciones. Esta versión del sitio de enseñanza se enfoca en un objetivo claro: ayudarte a ejecutar una aplicación en funcionamiento, comprender la estructura del archivo y elegir el ejemplo adecuado.

Inicio rápido

Éxito en 5 minutos

Instala Vectrune para tu plataforma, luego ejecuta tu primera aplicación de extremo a extremo.

Instalar Vectrune

macOS y Linux - Homebrew

brew tap davethomas11/homebrew-vectrune
brew install vectrune

Luego verifica la instalación con:

vectrune --version

Windows - descarga de versión

El repositorio documenta actualmente una ruta de descarga de versión para Windows.

  • Abre la página de versiones de GitHub.
  • Descarga el ejecutable de Windows más reciente.
  • Coloca la carpeta ejecutable en tu PATH.
Abrir página de versiones

Cualquier plataforma - compilar desde la fuente

cargo install --path .

Usa esta ruta si ya tienes una cadena de herramientas Rust y quieres ejecutar desde un clon local.

1

Verifica la instalación

vectrune --version
2

Ejecuta la aplicación de ejemplo

vectrune examples/app.rune

Esto inicia la aplicación REST mínima definida en examples/app.rune.

3

Golpea la ruta de salud

curl http://127.0.0.1:3000/health

Respuesta esperada: OK

Lo que acabas de aprender

Las aplicaciones Vectrune usan secciones legibles como @App y @Route, y puedes obtener un servidor en funcionamiento sin mucho código estándar.

Interactive

Try Vectrune in your browser

Type some Rune code below and run it directly in this sandbox.

Code

Output

Click 'Run' to see output here...

Try changing the log message or adding new routes.

Tour del lenguaje

Lee un archivo Vectrune de un vistazo

@App

Define el nombre, tipo, versión y comportamiento de inicio opcional de la aplicación.

@Schema/Thing

Define la estructura y las reglas de validación para formas de solicitud o datos.

@Route/METHOD /path

Asigna una ruta HTTP a una secuencia de pasos en un bloque de ejecución.

@Component/Name y props

Define secciones de vista reutilizables con @Component/Name, luego pasa valores nombrados en cada sitio de invocación: MyComponent title="Hola".

Funciones incorporadas en run:

Usa funciones como parse-json, validate, respond y ayudas de memoria.

#!RUNE

@App
name = API de Ejemplo
type = REST
version = 1.0

@Route/GET /health
run:
    log "Verificación de salud"
    respond 200 "OK\

Ejemplo guiado

Tutorial de una API respaldada por memoria

El ejemplo examples/memory_api.rune enseña inicio de aplicación, validación de esquema y rutas REST.

1. Inicializa el estado de la aplicación

@App
name = API de Ejemplo de Memoria
version = 1.0
type = REST
run:
    skaters = load-rune skateboarders.rune
    set-memory skaters

Carga datos de inicio al iniciar y mantenlos en memoria para rutas posteriores.

2. Define un esquema

@Schema/Skater
fields:
    name: String
    age: Integer
    style: String

Usa esquemas para validar la forma de los datos entrantes antes de mutar el estado.

3. Lee desde la memoria

@Route/GET /Skaters
run:
    skaters = get-memory skaters
    return skaters

Las rutas pueden extraer de la memoria de runtime y devolver el valor actual directamente.

4. Valida antes de escribir

@Route/PUT /Skaters
run:
    skaters = get-memory skaters
    new-skater = parse-json body
    validate new-skater #Skater
    append skaters.Skateboarder.record new-skater
    set-memory skaters
    return skaters

Analiza la solicitud, valídala contra el esquema, luego actualiza el estado compartido.

Funciones incorporadas clave en este tutorial

load-rune, set-memory, get-memory, parse-json, validate, append y return.

Ejemplos iniciales

Elige el próximo ejemplo correcto

Principiante

examples/app.rune

La aplicación más pequeña y completa. La mejor primera parada para comprender @App, @Route y run:.

Principiante

examples/skateboarders.rune

Un documento de datos de baja fricción cognitiva para aprender registros, entradas repetidas y flujos de trabajo de transformación.

Práctico

examples/user_api.rune

Un ejemplo REST más fuerte con esquemas, rutas de estilo CRUD, validación y parámetros de ruta.

Práctico

examples/book_graphql.rune

Aprende consultas y mutaciones de GraphQL con estado respaldado por memoria y una forma de aplicación compacta.

Avanzado

examples/tic_tac_toe/

Un ejemplo de Rune-Web dividido en partes de UI, lógica y estilo. Bueno una vez que lo básico ya se siente natural.

Qué sigue

Hacia dónde va el sitio de enseñanza

Próximamente

  • Playground ejecutable respaldado por el CLI de Vectrune
  • Páginas de tour de lenguaje paso a paso
  • Páginas de referencia de función incorporada originarias de knowledge/
  • Más tutoriales guiados para REST, GraphQL y Rune-Web

Intención actual

Esta primera versión es intencionalmente ligera. Existe para reducir la fricción de integración, destacar los mejores ejemplos iniciales y crear una base estable para futuras características de aprendizaje interactivo.