Ir para o conteúdo

Cliente Beancount

Consulte um livro-razão como tabelas SQL somente leitura, ou com BQL pelo rledger, e edite-o no seu próprio editor de texto.

Visão geral

Linguagem de consulta
SQL
Driver
Baixado no primeiro uso
Conectar por
Um arquivo
O TablePro no Mac com um livro-razão Beancount aberto, as tabelas na barra lateral e o resultado de uma consulta BQL.

Abra um livro-razão

Instale rledger ou Python Beancount. O rledger tem prioridade quando os dois estão instalados, e só o rledger aceita BQL e resultados de validação em diagnostics.

Escolha um livro-razão com Browse… ou abra um arquivo .beancount no Finder: o caminho é a conexão inteira, e URLs beancount:///path/to/main.beancount podem ser importados. Um app aberto pelo Finder não herda o PATH do seu shell; se o backend funciona no Terminal, mas não aqui, indique-o com launchctl setenv TABLEPRO_RUSTLEDGER_BINARY ou TABLEPRO_BEANCOUNT_PYTHON e reabra o app.

O backend Python executa os plugins que acompanham Beancount e ignora qualquer outra diretiva plugin, que contém código de terceiros, até você ativar Run Ledger Plugins para essa conexão. Os plugins ignorados são listados em diagnostics.

Consulte o livro-razão

Transações, lançamentos, contas, saldos, preços, diretivas, metadados e arquivos de origem são tabelas: junte lançamentos a transações em transaction_id, e contas pelo nome. Os valores chegam contabilizados, com aritmética, custos e preços resolvidos, e os custos dos lançamentos e preços inline ficam em colunas próprias.

Transações, lançamentos e várias tabelas de diretivas trazem uma source_location, como main.beancount:42, então cada linha leva de volta à sua linha no arquivo. Comece uma consulta com BQL: para enviá-la ao rledger; navegação, contagem de linhas e paginação funcionam no resultado, parâmetros SQL não.

As diretivas include são seguidas, tanto caminhos literais quanto globs, e todos os arquivos do livro-razão e documentos referenciados são monitorados, então a próxima consulta lê uma alteração salva sem reconectar. A conexão fica sempre no nível Read-Only do Safe Mode: INSERT, UPDATE, DELETE e alterações de esquema são recusados.

Esta página trata do que é específico de Beancount. Safe Mode, o assistente de IA, o servidor MCP e o resto do TablePro estão nas páginas de recursos.

Também

  • Mover dados

    Exporte uma tabela ou o resultado de uma consulta como CSV, JSON, SQL, XLSX, Markdown, HTML e XML. Outros arquivos que o TablePro abre como bancos de dados incluem SQLite, DuckDB e Parquet.

  • Limitações

    • TablePro lê o livro-razão em 23 tabelas SQL somente leitura ao abrir. Nada é gravado de volta no livro-razão.
    • Exige rledger ou Python beancount instalado neste Mac.
  • Um livro-razão com erros ainda abre?

    Pelo rledger, sim. O livro-razão é projetado em tabelas mesmo quando a validação falha, e cada problema aparece como uma linha em diagnostics, com arquivo, linha, gravidade e mensagem.

  • Uma conexão pode abrir vários livros-razão?

    Uma conexão corresponde a um arquivo de livro-razão, sem alternância. Um arquivo principal que inclui os outros traz todos eles, inclusive por globs.

Baixe o TablePro

Tudo nesta página é gratuito.