Aller au contenu

Client Beancount

Interrogez un ledger comme des tables SQL en lecture seule, ou avec BQL via rledger, et modifiez-le dans votre propre éditeur de texte.

En bref

Langage de requête
SQL
Pilote
Téléchargé à la première utilisation
Connexion via
Un fichier
TablePro sur Mac avec un ledger Beancount ouvert, ses tables dans la barre latérale et le résultat d’une requête BQL.

Ouvrez un livre

Installez rledger ou Python Beancount. Si les deux sont présents, rledger est prioritaire, et seul rledger prend en charge BQL et les résultats de validation dans diagnostics.

Choisissez un ledger avec Parcourir… (Browse…) ou ouvrez un fichier .beancount depuis le Finder : le chemin constitue toute la connexion, et les URL beancount:///path/to/main.beancount peuvent être importées. Une app ouverte depuis le Finder n’hérite pas du PATH de votre shell ; si le moteur fonctionne dans Terminal mais pas ici, indiquez-le avec launchctl setenv TABLEPRO_RUSTLEDGER_BINARY ou TABLEPRO_BEANCOUNT_PYTHON, puis relancez l’app.

Le moteur Python exécute les plugins fournis avec Beancount et ignore toute autre directive plugin, qui représente du code tiers, jusqu’à ce que vous activiez Exécuter les plugins Ledger (Run Ledger Plugins) pour cette connexion. Les plugins ignorés figurent dans diagnostics.

Interrogez le livre

Transactions, écritures, comptes, soldes, prix, directives, métadonnées et fichiers source sont des tables : reliez écritures et transactions par transaction_id, et les comptes par leur nom. Les montants arrivent comptabilisés, avec calculs, coûts et prix résolus, et les coûts des écritures et les prix en ligne occupent leurs propres colonnes.

Les transactions, les écritures et plusieurs tables de directives comportent une source_location telle que main.beancount:42, qui ramène une ligne de résultat à sa ligne source. Préfixez une requête par BQL: pour l’envoyer à rledger ; la navigation, le comptage des lignes et la pagination fonctionnent sur le résultat, les paramètres SQL non.

Les directives include sont suivies, chemins explicites comme motifs glob, et tous les fichiers du livre et documents référencés sont surveillés ; la requête suivante lit donc une modification enregistrée sans reconnexion. La connexion reste toujours au niveau Read-Only de Safe Mode : INSERT, UPDATE, DELETE et les modifications de schéma sont refusés.

Cette page présente ce qui est propre à Beancount. Safe Mode, l’assistant IA, le serveur MCP et le reste de TablePro sont décrits dans les pages des fonctionnalités.

Et aussi

  • Déplacer les données

    Exportez une table ou un résultat de requête en CSV, JSON, SQL, XLSX, Markdown, HTML et XML. Les autres fichiers que TablePro ouvre comme bases de données incluent SQLite, DuckDB et Parquet.

  • Limites

    • TablePro lit le registre à l’ouverture dans 23 tables SQL en lecture seule. Rien n’est réécrit dans le registre.
    • Nécessite rledger ou Python beancount installé sur ce Mac.
  • Un livre contenant des erreurs s’ouvre-t-il ?

    Avec rledger, oui. Le livre est projeté même si la validation échoue, et chaque problème devient une ligne de diagnostics avec fichier, ligne, gravité et message.

  • Une connexion peut-elle ouvrir plusieurs livres ?

    Une connexion correspond à un seul fichier de livre, sans bascule possible. Un fichier principal qui inclut les autres les rassemble tous, y compris via des motifs glob.

Obtenez TablePro

Tout ce qui figure sur cette page est gratuit.