El agente escribe.
Una verifica.

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 | sh
O dale esto a tu agenteFetch https://una-lang.org/llms.txt and follow it to install Una. Then run "una --version" and "una explain U5001".

Beta de investigación · código abierto · macOS arm64 · Linux arm64

stock.unaSalida para
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.

Lee la cabecera y sabes lo que la función puede hacer.

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.

shortlinks/links.unaDEL REPOSITORIO
--- 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
  slug

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.

fails LinkError

Los 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.

checked

checked 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.

Lo que Una comprueba, y lo que te dice que no comprobó.

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.

Contratos requires, ensures

Las 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.

Autoridad 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.

Flujo de información public < secret

Las 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.

Interfaz para agentes --json

Cada 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.

¿Está listo?

Una es una beta de investigación y no está lista para producción. Los comentarios son bienvenidos. Enviar comentarios