Vai al contenuto

Client Beancount

Interroga un registro come tabelle SQL in sola lettura, o con BQL tramite rledger, e modificalo nel tuo editor di testo.

A colpo d’occhio

Linguaggio di query
SQL
Driver
Scaricato al primo utilizzo
Connetti tramite
Un file
TablePro su Mac con un registro Beancount aperto, le sue tabelle nella barra laterale e il risultato di una query BQL.

Apri un registro

Installa rledger o Python Beancount. rledger ha la precedenza se ci sono entrambi, e solo rledger supporta BQL e l’output di validazione in diagnostics.

Scegli un registro con Browse… o apri un file .beancount dal Finder: il percorso è l’intera connessione, e si possono importare URL beancount:///path/to/main.beancount. Un’app aperta dal Finder non eredita il PATH della shell, quindi se il backend funziona in Terminal ma non qui, indicalo con launchctl setenv TABLEPRO_RUSTLEDGER_BINARY o TABLEPRO_BEANCOUNT_PYTHON e riavvia l’app.

Il backend Python esegue i plugin inclusi in Beancount e ignora tutte le altre direttive plugin, che contengono codice di terze parti, finché non attivi Run Ledger Plugins per quella connessione. I plugin ignorati sono elencati in diagnostics.

Interroga il registro

Transazioni, registrazioni, conti, saldi, prezzi, direttive, metadati e file di origine sono tabelle: unisci le registrazioni alle transazioni su transaction_id, e i conti per nome. Gli importi arrivano contabilizzati, con operazioni aritmetiche, costi e prezzi risolti, e con i costi delle registrazioni e i prezzi inline in colonne dedicate.

Transazioni, registrazioni e varie tabelle delle direttive hanno una source_location come main.beancount:42, così una riga rimanda alla sua riga nel file. Aggiungi il prefisso BQL: a una query per inviarla a rledger; navigazione, conteggio delle righe e paginazione funzionano sul risultato, i parametri SQL no.

Le direttive include vengono seguite, sia con percorsi letterali sia con glob, e ogni file del registro e ogni documento citato viene monitorato, così la query successiva legge una modifica salvata senza riconnettersi. La connessione è sempre al livello Read-Only di Safe Mode: INSERT, UPDATE, DELETE e le modifiche allo schema vengono rifiutati.

Questa pagina tratta ciò che è specifico di Beancount. Safe Mode, l’assistente AI, il server MCP e il resto di TablePro sono nelle pagine delle funzionalità.

Inoltre

  • Sposta i dati

    Esporta una tabella o il risultato di una query in CSV, JSON, SQL, XLSX, Markdown, HTML e XML. Gli altri file che TablePro apre come database includono SQLite, DuckDB e Parquet.

  • Limiti

    • All’apertura, TablePro legge il registro in 23 tabelle SQL in sola lettura. Non viene scritto nulla nel registro.
    • Richiede rledger o Python beancount installato su questo Mac.
  • Un registro con errori si apre comunque?

    Tramite rledger, sì. Il registro viene proiettato in tabelle anche se la validazione fallisce e ogni problema è una riga in diagnostics con file, riga, gravità e messaggio.

  • Una connessione può aprire più registri?

    Una connessione corrisponde a un file di registro, senza possibilità di passare a un altro. Un file principale che include gli altri li carica tutti, anche tramite glob.

Scarica TablePro

Tutto in questa pagina è gratuito.