Reglas legibles.
Una referencia práctica.

¿Qué es RuleScript?

RuleScript es el lenguaje de dominio específico propuesto originalmente para expresar transformaciones y validaciones en texto legible. Su idea central separa la declaración de una regla del entorno que la ejecuta.

Los ejemplos usan nombres de campo entre comillas, palabras clave explícitas y mensajes de error opcionales. Sirven de referencia del lenguaje; los casos límite y el soporte real requieren un motor definido.

Sintaxis y ejemplos

1. Transformar un registro

rename "price_usd" to "price";
split "full_name" into "first_name", "last_name" by " ";
map "country_code" [US: "United States", CA: "Canada", MX: "Mexico"];

2. Validar valores

validate "price": number, min 0, max 10000, on error "Price must be valid";
validate "country": required, in ["United States", "Canada", "Mexico"], on error "Invalid country";

3. Combinar pasos explícitos

Aplica el renombrado y el mapeo antes de comprobar los valores resultantes. Conserva los datos originales y explicita el orden de las transformaciones.

rename "price_usd" to "price";
validate "price": number, min 0, max 10000, on error "Price must be valid";

4. Validación condicional

validate "discount": number, on error "Discount must be numeric", if "price" > 100;

Las instrucciones terminan con punto y coma. El orden de las cláusulas opcionales y el comportamiento ante campos ausentes aún deben especificarse para el motor.

Transformaciones

rename "price_usd" to "price";

split "full_name" into "first_name", "last_name" by " ";

merge "first_name", "last_name" into "full_name" with " ";

map "country_code" [US: "United States", CA: "Canada", MX: "Mexico"];

convert "quantity" to integer;

calculate "total" as "price * quantity";

normalize "name" to lowercase;

replace "status" null with "N/A";

round "price" to 2 decimal places;

anonymize "email" with "****@domain.com";

drop "temp_field";

impute "age" missing with average;

reorder columns "id", "name", "email";

filter "age" > 18;

Grupos de validación

validate "name": required, on error "Name is required";

validate "age": number, on error "Age must be numeric";

validate "price": number, min 0, max 10000, on error "Price must be valid";

validate "country": in ["United States", "Canada", "Mexico"], on error "Invalid country";

validate "discount": > 0, on error "Discount must be positive";
validate "price": >= 0, on error "Price must be non-negative";

validate "age": < 18, on error "Age must be below 18";
validate "discount": <= 50, on error "Discount must be 50% or less";

validate "status": equal "Active", on error "Status must be active";
validate "status": not in ["Inactive", "Suspended"], on error "Invalid status";

Flujos de trabajo

CLI

Los archivos de reglas usan la extensión .rules. La CLI lee estos archivos directamente; el ejemplo muestra el comando previsto.

rg-run rules.rules input.csv output.csv

API

El diseño de la API contempla lotes CSV y registros JSON individuales con archivos .rules. Las rutas ilustran la interfaz prevista. Las cargas multipart envían el archivo CSV como una parte de archivo.

Entrada CSV

POST /api/v1/validate/my_rules.rules
Content-Type: multipart/form-data; boundary=example

--example
Content-Disposition: form-data; name="file"; filename="input.csv"
Content-Type: text/csv

price,country
25,US
--example--

Registro JSON individual

POST /api/v1/validate/my_rules.rules
Content-Type: application/json

{"record":{"full_name":"Sample Person","price":-50,"country_code":"US"}}

{"status":"error","errors":[{"field":"price","error":"Price must be between 0 and 10000"}]}

El procesamiento por lotes comprueba una entrega completa; la validación por registro comprueba un evento o envío. Una implementación futura debe definir errores y coherencia entre interfaces.

Procesos encadenados

rg-transform step1.rules input.csv \
  | rg-transform step2.rules \
  | rg-validate rules.rules --output output.csv

Cada paso del proceso lee un archivo .rules. El motor debe definir el formato de los datos entre pasos y los códigos de salida.

Despliegue privado

La ejecución privada es una opción de despliegue en estudio para que los equipos puedan ejecutar reglas en su propia infraestructura. Aún no está disponible.

Prueba dos comprobaciones en tu navegador.

Esta demostración comprueba un precio numérico entre 0 y 10000 y un código US, CA o MX. Es JavaScript escrito para estas dos comprobaciones, no un parser de RuleScript ni el futuro motor. Los datos permanecen en esta página.