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.
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 | 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
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.
Num exemplo de links curtos, efeitos e falhas aparecem no cabeçalho. O compilador verifica os limites declarados à medida que o programa é composto.
--- 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]A função pode guardar links pela operação declarada. Ela não recebe nenhuma autoridade implícita sobre mais nada.
fails LinkErrorAs 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.
checkedchecked 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 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.
requires, ensuresPré-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.
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.
public < secretOs 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.
--jsonTodo 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ê.
Instale o Una, escreva um contrato, veja-o falhar, conserte.
Dê ao seu agente a linguagem em uma página e o ciclo a rodar.
Una by Example: programas pequenos e completos, uma ideia por página.
Ou vá direto para Instalação e arquivos, Guia da linguagem, Diagnósticos, Exemplos, Una para agentes.
O Una é um beta de pesquisa e não está pronto para produção. Comentários são bem-vindos. Enviar comentários