Lua Academy · Lezione

Creazione di una DSL di configurazione

Crei un linguaggio di configurazione dichiarativo, caricato tramite dofile() in una sandbox.

Creazione di una DSL di configurazione è una lezione Lua Academy gratuita su CoddyKit. Questa è la lezione 3 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Lua Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Lua Academy include 4 lezioni in totale.

Obiettivo: configurazione dichiarativa

Un DSL di configurazione consente agli utenti di esprimere la configurazione in uno stile leggibile e dichiarativo, sfruttando al contempo tutta la potenza di Lua (condizionali, cicli e funzioni) dietro le quinte.

Schema della funzione di configurazione

Esponga una funzione config(tbl) che convalidi e memorizzi la configurazione. La richiami con un literal di tabella per ottenere una sintassi pulita.

local function config(tbl)
  -- validate and store
  return tbl
end
-- config.lua:
return config {
  host = "localhost",
  port = 8080,
  debug = os.getenv("DEBUG") == "1",
}

Configurazione annidata con sezioni

Supporti sezioni annidate per organizzare la configurazione.

return config {
  database = { host="db.local", port=5432 },
  cache    = { host="cache.local", ttl=300 },
  logging  = { level="INFO", file="/var/log/app.log" },
}

Funzioni di supporto nella configurazione

Consenta di chiamare funzioni di supporto all'interno della configurazione per calcolare i valori.

local function env(name, default)
  return os.getenv(name) or default
end
return config {
  host  = env("DB_HOST", "localhost"),
  port  = tonumber(env("DB_PORT", "5432")),
}

Caricamento della configurazione in sandbox

Per motivi di sicurezza, carichi la configurazione in un ambiente limitato che consenta solo funzioni di supporto sicure.

local function loadConfig(path)
  local safeEnv = {
    config = config,
    env    = env,
    math   = math,
    table  = table,
  }
  local fn, err = loadfile(path, "t", safeEnv)
  if not fn then error(err) end
  return fn()
end

Convalida dello schema

Convalidi i campi obbligatori e i relativi tipi dopo il caricamento.

local function validate(cfg)
  assert(type(cfg.host) == "string", "host must be string")
  assert(type(cfg.port) == "number", "port must be number")
  assert(cfg.port > 0 and cfg.port < 65536, "port out of range")
end
validate(loadConfig("config.lua"))

Valori predefiniti

Unisca la configurazione caricata ai valori predefiniti per garantire che tutte le chiavi obbligatorie abbiano un valore.

local defaults = {host="localhost", port=8080, debug=false}
local function loadWithDefaults(path)
  local cfg = loadConfig(path)
  for k, v in pairs(defaults) do
    if cfg[k] == nil then cfg[k] = v end
  end
  return cfg
end

Sovrascrittura tramite l'ambiente

Consenta alle variabili d'ambiente di sovrascrivere i valori del file di configurazione: è essenziale per la progettazione di app 12-factor.

Ereditarietà della configurazione

Carichi una configurazione di base, quindi applichi sopra di essa la configurazione specifica per l'ambiente (sviluppo, staging, produzione).

Configurazione immutabile

Dopo il caricamento, renda non modificabile la tabella di configurazione con un __newindex che generi un errore, impedendo modifiche accidentali durante l'esecuzione.

Documentazione nella configurazione

Utilizzi commenti e nomi strutturati delle chiavi come documentazione incorporata. Un DSL di configurazione ben progettato è autoesplicativo per i team DevOps.

Domanda sul DSL di configurazione

Perché caricare un file di configurazione con un _ENV in sandbox?

Riepilogo: creazione di un DSL di configurazione

Esponga una funzione config(tbl). Supporti sezioni annidate e funzioni di supporto. Carichi la configurazione in un ambiente in sandbox. Convalidi i campi obbligatori e i relativi tipi. Fornisca valori predefiniti e consenta sovrascritture tramite variabili d'ambiente per la conformità al modello 12-factor.

Domande Frequenti

La lezione «Creazione di una DSL di configurazione» è gratuita?

Sì — il testo completo di «Creazione di una DSL di configurazione» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Lua Academy, passa a CoddyKit PRO. Il corso Lua Academy include 4 lezioni in totale.

Cosa imparerò in «Creazione di una DSL di configurazione»?

Crei un linguaggio di configurazione dichiarativo, caricato tramite dofile() in una sandbox. Eserciti Lua Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Lua Academy?

Non è richiesta alcuna esperienza precedente. Lua Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 3 di 4.

Quanto tempo richiede la lezione «Creazione di una DSL di configurazione»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Lua Academy?

Sì. Ogni lezione Lua Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

Principi di progettazione delle DSL in Lua
Overloading degli operatori per una DSL fluida
Creazione di una DSL di configurazione
Semplice parser di espressioni

← Torna a Lua Academy