Saltar al contenido

Cliente de Beancount

Consulta un libro como tablas SQL de solo lectura, o con BQL mediante rledger, y edítalo en tu propio editor de texto.

De un vistazo

Lenguaje de consulta
SQL
Controlador
Se descarga en el primer uso
Conectar mediante
Un archivo
TablePro en un Mac con un libro de Beancount abierto, sus tablas en la barra lateral y el resultado de una consulta BQL.

Abre un libro

Instala rledger o Python Beancount. Si están los dos, se usa rledger, y solo rledger admite BQL y los resultados de validación en diagnostics.

Elige un libro con Browse… o abre un archivo .beancount desde Finder: la ruta es toda la conexión, y puedes importar URL beancount:///path/to/main.beancount. Una app abierta desde Finder no hereda el PATH de tu shell, así que si el backend funciona en Terminal pero no aquí, indícalo con launchctl setenv TABLEPRO_RUSTLEDGER_BINARY o TABLEPRO_BEANCOUNT_PYTHON y vuelve a abrir la app.

El backend de Python ejecuta los plugins incluidos con Beancount y omite cualquier otra directiva plugin, que es código de terceros, hasta que actives Run Ledger Plugins para esa conexión. Los plugins omitidos aparecen en diagnostics.

Consulta el libro

Transacciones, apuntes, cuentas, saldos, precios, directivas, metadatos y archivos fuente son tablas: une apuntes y transacciones por transaction_id, y cuentas por nombre. Los importes llegan contabilizados, con las operaciones, los costes y los precios resueltos, y los costes de los apuntes y los precios en línea en columnas propias.

Las transacciones, los apuntes y varias tablas de directivas incluyen un source_location como main.beancount:42, así que cada fila lleva a su línea. Antepón BQL: a una consulta para enviarla a rledger; la exploración, el recuento de filas y la paginación funcionan sobre el resultado, los parámetros SQL no.

Se siguen las directivas include, tanto rutas literales como patrones glob, y se vigilan todos los archivos del libro y los documentos referenciados, así que la siguiente consulta lee un cambio guardado sin reconectar. La conexión siempre está en Safe Mode Read-Only: se rechazan INSERT, UPDATE, DELETE y los cambios de esquema.

Esta página cubre lo específico de Beancount. Safe Mode, el asistente de IA, el servidor MCP y el resto de TablePro están en las páginas de funciones.

También

  • Mover datos

    Exporta una tabla o el resultado de una consulta como CSV, JSON, SQL, XLSX, Markdown, HTML y XML. Otros archivos que TablePro abre como bases de datos incluyen SQLite, DuckDB y Parquet.

  • Limitaciones

    • Al abrirse, TablePro lee el libro en 23 tablas SQL de solo lectura. No escribe nada en el libro.
    • Requiere rledger o Python beancount instalado en este Mac.
  • ¿Se abre un libro con errores?

    Con rledger, sí. El libro se proyecta incluso si falla la validación, y cada problema es una fila de diagnostics con su archivo, línea, gravedad y mensaje.

  • ¿Puede una conexión abrir varios libros?

    Cada conexión corresponde a un archivo de libro, sin posibilidad de alternar. Un archivo principal que incluya los demás los incorpora todos, también mediante patrones glob.

Obtén TablePro

Todo en esta página es gratis.