uses @links: Links[put]
La función puede guardar enlaces mediante la operación declarada. No recibe ninguna autoridad implícita sobre nada más.
Tu agente escribe el código. Una prueba el contrato declarado de cada función para toda entrada, o muestra la entrada que lo rompe; lo que no puede decidir es un error, nunca una aprobación. Lo que una función puede tocar, como archivos, la red o datos sensibles, también está en la cabecera.
curl -fsSL https://raw.githubusercontent.com/una-lang/una/main/install.sh | shFetch https://una-lang.org/llms.txt and follow it to install Una. Then run "una --version" and "una explain U5001".pub kind Availability = SoldOut | Few | Open
--- How much of an item is left to sell.
pub availability(remaining: Int) -> Availability
requires remaining >= 0
ensures remaining == 0 implies result is SoldOut
=
if remaining < 20 then Few else Open if remaining == 0 then SoldOut else if remaining < 20 then Few else Open
Tu agente escribió esta función. Se lee bien, y una prueba con 5 o 50 artículos pasaría.
$ una check stock.una # resumido
[U5001] postcondition of `availability` is refuted
counterexample: remaining = 0, result = Few
repair 1: add a guard or an arm so that the failing
path returns a value for which the clause holds$ una --json check stock.una # resumido
{ "code": "U5001",
"obligation": { "kind": "postcondition", "status": "refuted" },
"counterexample": { "bindings": [
{ "name": "remaining", "value": 0 },
{ "name": "result", "value": "Few" } ] },
"repairs": [ { "rank": 1, "escape_cost": 0,
"description": "add a guard or an arm ..." } ] }El agente aplica la reparación 1: una guarda para la entrada que señala el contraejemplo.
$ una check stock.una
$ Nada impreso, salida 0. La promesa ahora vale para todo remaining >= 0, no solo para las entradas que probó un test.
$ una --json check stock.una
{"schema":"una.diagnostics/1","diagnostics":[],"fixable":0}Nada impreso, salida 0. La promesa ahora vale para todo remaining >= 0, no solo para las entradas que probó un test.
En un ejemplo de enlaces cortos, los efectos y los fallos aparecen en la cabecera. El compilador comprueba los límites declarados a medida que se compone el programa.
--- A slug, checked once where it enters the program.
pub kind Slug = Text where valid_slug(it)
pub kind LinkError = BadSlug | Unknown(slug: Text) | StoreDown
pub kind StoreError = | Offline
--- Where short links are kept.
pub capability Links
op put(slug: Slug, target: Text) -> Unit
fails StoreError
--- Stores a short link and returns its slug.
pub shorten(raw: Text, target: Text) -> Slug
uses @links: Links[put]
fails LinkError
=
let slug = parse_slug(raw)
if error fail BadSlug
@links.put(slug, target)
if error fail StoreDown
sluguses @links: Links[put]La función puede guardar enlaces mediante la operación declarada. No recibe ninguna autoridad implícita sobre nada más.
fails LinkErrorLos fallos que llegan a quien llama tienen nombre. Cada llamada trata su resultado antes de seguir.
Text where valid_slug(it)Slug es un tipo refinado. El texto de entrada se comprueba en parse_slug antes de convertirse en un slug.
checkedchecked comprueba un hecho cuando el programa se ejecuta, donde entra el texto, en lugar de probarlo. Cada módulo tiene un presupuesto para estos usos, para que sean pocos y visibles.
Una comprueba las propiedades que declaras en el código y en el paquete. Su informe también enumera lo que es de confianza, lo que se supone y lo que queda para revisión humana.
requires, ensuresLas precondiciones, las poscondiciones y los tipos refinados se prueban antes de que el programa se ejecute. Una prueba que falla, o que el probador no logra terminar, es un error y nunca un éxito.
uses @Cada función pública declara las capacidades y operaciones que usa, y Una infiere y comprueba las demás. Un programa solo recibe autoridad del host mediante concesiones: las que declara su paquete y las dadas en la línea de comandos para una ejecución.
public < secretLas etiquetas siguen a los datos a través de asignaciones y condiciones. Un valor etiquetado como secreto solo llega a un lugar menos restringido mediante una política declarada, que el informe de compilación lista.
--jsonCada comando, salvo el servidor de lenguaje, devuelve JSON con un esquema: códigos de diagnóstico, posiciones exactas y, cuando existen, reparaciones ordenadas que un agente puede aplicar.
Una prueba que el código corresponde a lo que declaraste. Declarar lo correcto sigue siendo tarea tuya.
Instala Una, escribe un contrato, míralo fallar, arréglalo.
Dale a tu agente el lenguaje en una página y el ciclo que debe ejecutar.
Una by Example: programas pequeños y completos, una idea por página.
O ve directo a Instalación y archivos, Guía del lenguaje, Diagnósticos, Ejemplos, Una para agentes.
Una es una beta de investigación y no está lista para producción. Los comentarios son bienvenidos. Enviar comentarios