Développement précoceVectrune est en version pré-1.0 et évolue rapidement. La syntaxe et les API peuvent changer entre les versions.Suivez les progrès sur GitHub

Jalon d'adoption massive

Obtenez une application Vectrune utile en quelques minutes.

Vectrune est un langage déclaratif et un runtime pour les données structurées, les API et les petits flux de travail d'application. Cette version du site d'enseignement se concentre sur un objectif clair : vous aider à exécuter une application fonctionnelle, comprendre la structure du fichier et choisir le bon exemple.

Démarrage rapide

Succès en 5 minutes

Installez Vectrune pour votre plateforme, puis exécutez votre première application de bout en bout.

Installer Vectrune

macOS et Linux - Homebrew

brew tap davethomas11/homebrew-vectrune
brew install vectrune

Ensuite, vérifiez l'installation avec :

vectrune --version

Windows - téléchargement de version

Le dépôt documente actuellement un chemin de téléchargement de version pour Windows.

  • Ouvrez la page des versions de GitHub.
  • Téléchargez le dernier exécutable Windows.
  • Placez le dossier exécutable sur votre PATH.
Ouvrir la page des versions

N'importe quelle plateforme - construire à partir de la source

cargo install --path .

Utilisez ce chemin si vous avez déjà une chaîne d'outils Rust et que vous souhaitez l'exécuter à partir d'un clone local.

1

Vérifier l'installation

vectrune --version
2

Exécutez l'application d'exemple

vectrune examples/app.rune

Cela démarre l'application REST minimale définie dans examples/app.rune.

3

Frappez la route de santé

curl http://127.0.0.1:3000/health

Réponse attendue : OK

Ce que vous venez d'apprendre

Les applications Vectrune utilisent des sections lisibles comme @App et @Route, et vous pouvez obtenir un serveur fonctionnant sans beaucoup de code standard.

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.

Visite de la langue

Lisez un fichier Vectrune en un coup d'œil

@App

Définit le nom, le type, la version et le comportement de démarrage optionnel de l'application.

@Schema/Thing

Définit la structure et les règles de validation pour les formes de requête ou de données.

@Route/METHOD /path

Mappe une route HTTP à une séquence d'étapes dans un bloc d'exécution.

@Component/Name et props

Définissez des sections de vue réutilisables avec @Component/Name, puis transmettez des valeurs nommées à chaque site d'invocation : MyComponent title="Bonjour".

Fonctions intégrées en exécution :

Utilisez les fonctions intégrées telles que parse-json, validate, respond et les aides mémoire.

#!RUNE

@App
name = API d'exemple
type = REST
version = 1.0

@Route/GET /health
run:
    log "Vérification de santé"
    respond 200 "OK\

Exemple guidé

Explorez une API sauvegardée par la mémoire

L'exemple examples/memory_api.rune enseigne le démarrage de l'application, la validation du schéma et les routes REST.

1. Initialisez l'état de l'application

@App
name = API d'exemple de mémoire
version = 1.0
type = REST
run:
    skaters = load-rune skateboarders.rune
    set-memory skaters

Chargez les données de démarrage au démarrage et conservez-les en mémoire pour les routes ultérieures.

2. Définir un schéma

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

Utilisez les schémas pour valider la forme des données entrantes avant de modifier l'état.

3. Lire depuis la mémoire

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

Les routes peuvent extraire de la mémoire du runtime et retourner la valeur actuelle directement.

4. Valider avant d'écrire

@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

Analysez la demande, validez-la par rapport au schéma, puis mettez à jour l'état partagé.

Fonctions intégrées clés dans cette procédure

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

Exemples de démarrage

Choisissez le prochain bon exemple

Débutant

examples/app.rune

La plus petite application complète. Le meilleur premier arrêt pour comprendre @App, @Route et run:.

Débutant

examples/skateboarders.rune

Un document de données à faible surcharge cognitive pour apprendre les enregistrements, les entrées répétées et les flux de travail de transformation.

Pratique

examples/user_api.rune

Un exemple REST plus robuste avec schémas, routes de style CRUD, validation et paramètres de route.

Pratique

examples/book_graphql.rune

Apprenez les requêtes et mutations GraphQL avec un état sauvegardé en mémoire et une forme d'application compacte.

Avancé

examples/tic_tac_toe/

Un exemple Rune-Web divisé en parties UI, logique et style. Bon une fois que les bases vous semblent naturelles.

Prochaines étapes

Où va le site d'enseignement

Prochainement

  • Terrain de jeu exécutable soutenu par le CLI Vectrune
  • Pages de visite du langage étape par étape
  • Pages de référence des fonctions intégrées provenant de knowledge/
  • Plus de procédures pas à pas guidées pour REST, GraphQL et Rune-Web

Intention actuelle

Cette première version est intentionnellement légère. Elle existe pour réduire les frictions d'intégration, mettre en évidence les meilleurs exemples de démarrage et créer une base stable pour les futures fonctionnalités d'apprentissage interactif.