Reglas legibles.
Una base que conservamos.

¿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;

El ejemplo histórico omitía el punto y coma final; aquí se normaliza. El orden de las cláusulas opcionales y el comportamiento ante campos ausentes siguen necesitando una especificación del 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;

Funciones 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 históricos

CLI

El diseño original usaba archivos fuente .rs y artefactos compilados .rsx. Son comandos históricos; no se ofrece un instalador.

rg-compile rules.rs
rg-run rules.rsx input.csv output.csv

API

La documentación proponía lotes CSV y registros JSON individuales. Las rutas siguientes son bocetos históricos, no endpoints operativos. Una carga multipart debe enviar una parte de archivo real, no el nombre dentro de JSON que mostraba la web anterior.

Entrada CSV

POST /api/v1/validate/my_rules.rsx
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.rsx
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.rsx input.csv \
  | rg-transform step2.rsx \
  | rg-validate rules.rsx --output output.csv

Conservamos el concepto del proceso original. Un motor debe definir el formato entre pasos y los códigos de salida antes de que pueda usarse de forma fiable.

Despliegue privado

La ejecución local era una dirección de despliegue en la web anterior. Aquí no se anuncia una oferta empresarial disponible y el despliegue por sí solo no acredita cumplimiento normativo.

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.

¿Qué cambia en la migración?

• RuleScript conserva su nombre. Los ejemplos .rs y .rsx se mantienen como documentación; la migración de la web no cambia su semántica de ejecución.
• Las comillas se normalizan para copiar los ejemplos. El ejemplo condicional incluye punto y coma final.
• Se conservan las 14 transformaciones y los 7 grupos de validación. Los ejemplos de CLI y API indican su estado.
• El enmascaramiento se describe como tal; no como garantía de anonimización.