Tipos de Entrada Lua

Tipos de Entrada Lua

Configuración para entradas basadas en Lua: funciones, procesos, flujos de trabajo y bibliotecas.

Tipos de Entrada

Tipo	Descripción
function.lua	Función sin estado, se ejecuta bajo demanda
process.lua	Actor de larga duración con estado
workflow.lua	Flujo de trabajo durable (Temporal)
library.lua	Código compartido importado por otras entradas
module.lua	Superficie de módulo (biblioteca con múltiples métodos)

Cada tipo tiene una contraparte de bytecode precompilado (function.lua.bc, library.lua.bc, process.lua.bc, workflow.lua.bc) producida por wippy pack --bytecode. Los autores escriben entradas .lua; los tipos de bytecode se emiten automáticamente al empaquetar.

Campos Comunes

Todas las entradas Lua comparten estos campos:

Campo	Requerido	Descripción
name	sí	Nombre único dentro del namespace
kind	sí	Uno de los tipos Lua anteriores
source	sí	Ruta del archivo Lua (file://path.lua)
method	function/process/workflow	Función a exportar (las bibliotecas no la usan)
modules	no	Módulos permitidos para require()
imports	no	Otras entradas como módulos locales
meta	no	Metadatos buscables

function.lua

Función sin estado llamada bajo demanda. Cada invocación es independiente.

- name: handler
  kind: function.lua
  source: file://handler.lua
  method: main
  modules:
    - http
    - json

Usar para: Manejadores HTTP, transformaciones de datos, utilidades.

process.lua

Actor de larga duración que mantiene estado entre mensajes. Se comunica mediante paso de mensajes.

- name: worker
  kind: process.lua
  source: file://worker.lua
  method: main
  modules:
    - process
    - sql

Usar para: Trabajadores en segundo plano, demonios de servicio, actores con estado.

Para ejecutar como servicio supervisado:

- name: worker_service
  kind: process.service
  process: app:worker
  host: app:processes
  lifecycle:
    auto_start: true
    restart:
      max_attempts: 10

workflow.lua

Flujo de trabajo durable que sobrevive a reinicios. El estado se persiste en Temporal.

- name: order_processor
  kind: workflow.lua
  source: file://order_workflow.lua
  method: main
  modules:
    - workflow
    - time

Usar para: Procesos de negocio de múltiples pasos, orquestaciones de larga duración.

library.lua

Código compartido que puede ser importado por otras entradas.

- name: helpers
  kind: library.lua
  source: file://helpers.lua
  modules:
    - json
    - base64

Otras entradas lo referencian vía imports:

- name: handler
  kind: function.lua
  source: file://handler.lua
  method: main
  imports:
    helpers: app.lib:helpers

En código Lua:

local helpers = require("helpers")
helpers.format_date(timestamp)

Módulos

El campo modules controla qué módulos pueden cargarse con require():

modules:
  - http
  - json
  - sql
  - process

channel, print, subscribe y unsubscribe se cargan como globales de Lua y no necesitan aparecer en modules:.

Solo los módulos listados están disponibles. Esto proporciona:

• Seguridad: Prevenir acceso a módulos del sistema
• Dependencias explícitas: Claro qué necesita el código
• Determinismo: Los flujos de trabajo solo obtienen módulos determinísticos

Consulte Runtime de Lua para módulos disponibles.

Imports

Importe otras entradas como módulos locales:

imports:
  utils: app.lib:utils       # require("utils")
  auth: app.auth:helpers     # require("auth")

La clave se convierte en el nombre del módulo en código Lua. El valor es el ID de entrada (namespace:name).

Configuración de Pool

Configure el pool de ejecución para funciones:

- name: handler
  kind: function.lua
  source: file://handler.lua
  method: main
  pool:
    type: adaptive    # por defecto
    size: 4           # workers iniciales
    max_size: 16      # tope para pools elásticos

Campo	Pools	Descripción
type	todos	Implementación del scheduler (ver tabla abajo)
size	static, lazy, adaptive	Cantidad inicial de workers
workers	engine v2	Cantidad de hilos worker
buffer	static, adaptive	Capacidad de la cola de tareas (por defecto workers * 64)
warm_start	adaptive	Precompilar entradas al inicio
max_size	lazy, adaptive	Tope superior para crecimiento elástico (por defecto 16)

Tipo	Comportamiento
inline	Ejecución síncrona en la goroutine del llamador. Mínima latencia, sin aislamiento entre llamadas.
lazy	Cero workers en reposo, se crean bajo demanda y se eliminan cuando están inactivos.
static	Pool de tamaño fijo basado en canales. Predecible bajo carga estable.
adaptive	Pool auto-escalable — crece bajo carga, se reduce cuando está inactivo. Predeterminado.

Metadatos

Use meta para enrutamiento y descubrimiento:

- name: api_handler
  kind: function.lua
  meta:
    type: handler
    version: "2.0"
    tags: [api, users]
  source: file://api.lua
  method: handle
  modules:
    - http
    - json

Los metadatos son buscables vía el registro:

local registry = require("registry")
local handlers = registry.find({type = "handler"})

Vea También

• Tipos de Entrada - Referencia de todos los tipos de entrada
• Unidades de Cómputo - Funciones vs procesos vs flujos de trabajo
• Runtime de Lua - Módulos disponibles