Skip to content
Quetzal Language

Project Organization

Section titled “Recommended Structure”
  • Directorymy-project/
    • quetzal.json (project configuration)
    • principal.qz (entry point)
    • Directorymodulos/
      • usuarios.qz
      • utilidades.qz
    • Directorydatos/
      • config.json

The quetzal.json File

Section titled “The quetzal.json File”

This optional configuration file defines metadata, dependencies, and permissions.

Basic Structure

Section titled “Basic Structure”
{
  "version": "0.2.0",
  "aplicacion": "my-project",
  "dependencias": {
    "libreria_ejemplo": "1.0.0"
  }
}

Permission System

Section titled “Permission System”

Controls access to system resources.

{
  "version": "0.2.0",
  "aplicacion": "my-project",
  "permisos": [
    {
      "tipo": "sistema-archivos",
      "habilitado": true,
      "alcance": ["lectura", "escritura"],
      "directorios": ["./", "./modulos"]
    }
  ]
}

File Naming

Section titled “File Naming”
  • Use .qz extension for code files
  • Use lowercase with underscores (usuarios.qz, validaciones_datos.qz)
  • Avoid spaces and special characters

Best Practices

Section titled “Best Practices”
  1. Keep related functions together for easy discovery
  2. Separate domain logic and infrastructure in different modules
  3. Document dependencies with comments
  4. Limit permissions to minimum necessary in quetzal.json