A dart library to connect with the hledger plain text accounting system.

License

This work is provided under the terms of the MIT license. Please take a look at the LICENSE file for the full text.

Features

These are the problems my library solves:

Current features

• Generate journal entries and write it to a journal file with
  • a date and an optional description,
  • sub transactions between two or more accounts,
  • prefixed or suffixed units,
  • simple conversion transactions.
• Conversion transactions.
• Creates a new journal files if necessary.
• Returns a Success record when everything works correctly or an Error record which contains an error message.

Planned features

• Read and filter journal information.
• Add comments to journal entries.

If you need any feature please contact me.

Usage

The following Dart record structure

import 'package:hledger_connector/hledger_connector.dart';

var transaction = Transaction(
  description: 'Example transaction',
  date: DateTime(2026,1,1),
  subTransactions: [
    SubTransaction(
      account: 'assets:cash',
      amount: Amount(value: -5, unit: '\$')
    ),
    SubTransaction(
      account: 'expenses:food',
      amount: Amount(value: 5, unit: '\$')
    )
]);

final result = await addTransaction(transaction, 'test.journal');

adds the following transaction to the journal:

2026-01-01 Example transaction
    assets:cash    $-5.0
    expenses:food   $5.0

For more usage examples, see the example/ directory.

Contact

If you have any questions just drop a message at mail@centaurus22.de.