O agente escreve.
O Una verifica.

Seu agente escreve o código. O Una prova o contrato declarado de cada função para toda entrada, ou mostra a entrada que o quebra; o que ele não consegue decidir é erro, nunca aprovação. O que uma função pode tocar, como arquivos, a rede ou dados sensíveis, também está no cabeçalho.

curl -fsSL https://raw.githubusercontent.com/una-lang/una/main/install.sh | sh
Ou entregue isto ao seu agenteFetch https://una-lang.org/llms.txt and follow it to install Una. Then run "una --version" and "una explain U5001".

Beta de pesquisa · código aberto · macOS arm64 · Linux arm64

stock.unaSaída 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

Seu agente escreveu esta função. Ela parece certa, e um teste com 5 ou 50 itens passaria.

$ 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 ..." } ] }

O agente aplica o reparo 1: uma guarda para a entrada que o contraexemplo aponta.

$ una check stock.una
$ 

Nada impresso, saída 0. A promessa agora vale para todo remaining >= 0, não só para as entradas que um teste tentou.

$ una --json check stock.una
{"schema":"una.diagnostics/1","diagnostics":[],"fixable":0}

Nada impresso, saída 0. A promessa agora vale para todo remaining >= 0, não só para as entradas que um teste tentou.

Leia o cabeçalho e você sabe o que a função pode fazer.

Num exemplo de links curtos, efeitos e falhas aparecem no cabeçalho. O compilador verifica os limites declarados à medida que o programa é composto.

shortlinks/links.unaDO REPOSITÓRIO
--- 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]

A função pode guardar links pela operação declarada. Ela não recebe nenhuma autoridade implícita sobre mais nada.

fails LinkError

As falhas que chegam a quem chama têm nome. Cada chamada trata seu resultado antes de seguir.

Text where valid_slug(it)

Slug é um tipo refinado. O texto de entrada é verificado em parse_slug antes de virar um slug.

checked

checked testa um fato quando o programa roda, onde o texto entra, em vez de prová-lo. Cada módulo tem um orçamento para esses usos, para que fiquem poucos e visíveis.

O que o Una verifica, e o que ele avisa que não verificou.

O Una verifica as propriedades que você declara no código e no pacote. Seu relatório também lista o que é confiado, assumido ou deixado para revisão humana.

Contratos requires, ensures

Pré-condições, pós-condições e tipos refinados são provados antes de o programa rodar. Uma prova que falha, ou que o provador não consegue concluir, é um erro e nunca um sucesso.

Autoridade uses @

Cada função pública declara as capacidades e operações que usa, e o Una infere e verifica as demais. Um programa só recebe autoridade do host por concessões: as que seu pacote declara e as dadas na linha de comando para uma execução.

Fluxo de informação public < secret

Os rótulos acompanham os dados por atribuições e condições. Um valor rotulado como secreto só chega a um lugar menos restrito por uma política declarada, que o relatório de build lista.

Interface para agentes --json

Todo comando, exceto o servidor de linguagem, devolve JSON com esquema: códigos de diagnóstico, posições exatas e, quando existem, reparos ordenados que um agente pode aplicar.

O Una prova que o código corresponde ao que você declarou. Declarar a coisa certa continua sendo com você.

Está pronto?

O Una é um beta de pesquisa e não está pronto para produção. Comentários são bem-vindos. Enviar comentários