Referência da API

curl -s https://dataforge-lang.vercel.app/api/index.json

{
  "nome": "DataForge",
  "versao": "1.0.0",
  "descricao": "API pública da linguagem: sintaxe, biblioteca, comandos e conteúdos.",
  "documentacao": "https://dataforge-lang.vercel.app/docs",
  "rotas": {
    "sintaxe":    "/api/sintaxe.json",
    "embutidas":  "/api/embutidas.json",
    "modulos":    "/api/modulos.json",
    "comandos":   "/api/comandos.json",
    "erros":      "/api/erros.json",
    "conteudos":  "/api/conteudos.json"
  }
}

{
  "versao": "1.0.0",
  "extensao": ".df",
  "reservadas": [
    { "palavra": "action", "descricao": "declara uma função",
      "equivalente": "def / function" }
  ],
  "contextuais": [
    { "palavra": "abstract", "descricao": "sem implementação; obriga o herdeiro",
      "equivalente": "abstract", "onde": "corpo de blueprint" }
  ],
  "operadores": [
    { "simbolo": ":=", "descricao": "atribuição", "equivalente": "=" }
  ],
  "verbos_http": ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS", "ANY"],
  "regras": ["A indentação é de 4 espaços. Tab é erro de sintaxe.", "…"]
}

{
  "versao": "1.0.0",
  "total_modulos": 39,
  "total_simbolos": 1490,
  "modulos": [
    {
      "nome": "Arcane.Vitrine",
      "apelidos": ["Painel", "Vitrine"],
      "total": 113,
      "simbolos": [
        { "nome": "abas", "assinatura": "(rotulos)",
          "resumo": "Abas. Devolve um cluster de áreas, uma por rótulo." }
      ]
    }
  ]
}

{
  "codigo": "DF0101",
  "titulo": "Indentacao inconsistente",
  "explicacao": "DataForge usa indentação para delimitar blocos, e aceita apenas espaços…",
  "exemplo": "given x bigger 0:\n    out \"com espacos\"\n\tout \"com tab\"",
  "solucao": "Configure o editor para inserir espaços no lugar de tab…",
  "doc": "primeiros-passos"
}

{
  "grupo": "Projeto",
  "comandos": [
    {
      "nome": "init",
      "uso": "dataforge init [pasta]",
      "resumo": "Cria forge.toml e o esqueleto do projeto",
      "detalhe": "Escreve o manifesto, a pasta src/ com um main.df e a tests/…",
      "opcoes": [],
      "exemplos": [
        { "comando": "dataforge init", "nota": "aqui mesmo" },
        { "comando": "dataforge init meu-app", "nota": "numa pasta nova" }
      ],
      "apelidos": [],
      "veja": ["new", "info"]
    }
  ]
}

adopt Arcane.Web as Web
adopt Arcane.Serialization as Serde

// 'Arcane.Web' e o CLIENTE; 'Arcane.Http' e o servidor.
r := Web.get("https://dataforge-lang.vercel.app/api/sintaxe.json")
dados := Serde.from_json(r["body"])

out $"{len(dados["reservadas"])} palavras reservadas"

// Cada uma traz o equivalente na linguagem de onde a pessoa vem
cycle p in dados["reservadas"]:
    given p["equivalente"] is not "":
        out $"  {p["palavra"]} ← {p["equivalente"]}"

# quantos símbolos tem cada módulo, do maior para o menor
curl -s https://dataforge-lang.vercel.app/api/modulos.json \
  | jq -r '.modulos | sort_by(-.total) | .[] | "\(.total)\t\(.nome)"' \
  | head

# o que fazer com um erro específico
curl -s https://dataforge-lang.vercel.app/api/erros.json \
  | jq -r '.codigos[] | select(.codigo == "DF0401") | .solucao'

# toda opção de um comando
curl -s https://dataforge-lang.vercel.app/api/comandos.json \
  | jq -r '.grupos[].comandos[] | select(.nome == "check") | .opcoes[]'

const base = 'https://dataforge-lang.vercel.app/api';

// O CORS é aberto: dá para chamar de qualquer origem.
const { reservadas, operadores } = await fetch(`${base}/sintaxe.json`)
  .then((r) => r.json());

// Um realce de sintaxe mínimo, com a lista sempre em dia.
const palavras = new RegExp(`\\b(${reservadas.map((p) => p.palavra).join('|')})\\b`, 'g');
const colorido = codigo.replace(palavras, '<b>$1</b>');

curl -s https://dataforge-lang.vercel.app/registry/index.json | jq '.pacotes | keys'

adopt Arcane.API as API

doc := API.openapi(minha_api, {"titulo": "Loja", "versao": "2.0"})