nu_plugin_from_beancount

一个将nushell扩展将beancount文件转换为nu结构化数据。

当使用nushell时，可以运行bean-example | from beancount或open my-ledger.beancount以获取一个nushell结构化表格，该表格可以进行进一步转换和处理。

示例

> bean-example | from beancount | where direcive == txn | take 1
╭───┬─────────────┬───────────┬──────┬───────┬──────────────────────────────────────┬────────────────────────────────────────────────────╮
│ # │    date     │ directive │ flag │ payee │              narration               │                      postings                      │
├───┼─────────────┼───────────┼──────┼───────┼──────────────────────────────────────┼────────────────────────────────────────────────────┤
│ 0 │ 2 years ago │ txn       │ *    │       │ Opening Balance for checking account │ ╭───┬─────────────────────────┬──────────────────╮ │
│   │             │           │      │       │                                      │ │ # │         account         │      amount      │ │
│   │             │           │      │       │                                      │ ├───┼─────────────────────────┼──────────────────┤ │
│   │             │           │      │       │                                      │ │ 0 │ Assets:US:BofA:Checking │ ╭───┬─────────╮  │ │
│   │             │           │      │       │                                      │ │   │                         │ │ # │   USD   │  │ │
│   │             │           │      │       │                                      │ │   │                         │ ├───┼─────────┤  │ │
│   │             │           │      │       │                                      │ │   │                         │ │ 0 │ 4560.14 │  │ │
│   │             │           │      │       │                                      │ │   │                         │ ╰───┴─────────╯  │ │
│   │             │           │      │       │                                      │ │ 1 │ Equity:Opening-Balances │ ╭───┬──────────╮ │ │
│   │             │           │      │       │                                      │ │   │                         │ │ # │   USD    │ │ │
│   │             │           │      │       │                                      │ │   │                         │ ├───┼──────────┤ │ │
│   │             │           │      │       │                                      │ │   │                         │ │ 0 │ -4560.14 │ │ │
│   │             │           │      │       │                                      │ │   │                         │ ╰───┴──────────╯ │ │
│   │             │           │      │       │                                      │ ╰───┴─────────────────────────┴──────────────────╯ │
╰───┴─────────────┴───────────┴──────┴───────┴──────────────────────────────────────┴────────────────────────────────────────────────────╯

支持的Beancount语法

• 交易
  • 分录
    • 账户
    • 金额
    • 成本
• 包含指令
• 填充指令
• 余额断言
• 选项
• ...

安装

cargo install nu_plugin_from_beancount
register ~/.cargo/bin/nu_plugin_from_beancount

配套脚本

目前，此插件故意相当简单，它所做的只是输出beancount文件内容，而不进行任何转换或解析。但对于大多数账簿，文件内容不包含进一步分析所需的所有信息。例如，交易通常不是显式平衡的（一个分录没有显式金额），这使得对金额的任何有用汇总都变得困难。

以下是一些可能与from beancount一起使用的“配套”脚本。

# Negate a structured amount (which is a record of currencies to values)
def "bean amount neg" [] {
  transpose currency value | update value { -($in.value) } | transpose -ird
}

# Complete transactions that are not explitly balanced, so that all transactions balance
def "bean resolve txn" [] {
  each {|row|
    if $row.directive != "txn" { $row } else {
      let offset_accounts = ($row.postings | where amount == $nothing | get -i account)
      if ($offset_accounts | is-empty) { $row } else {
        let complete_postings = ($row.postings | where amount != $nothing)
        let offset_account = ($offset_accounts | first)
        let offset_amount = ($complete_postings | get amount | math sum | bean amount neg)
        $row | update postings ($complete_postings | append {account: $offset_account, amount: $offset_amount})
      }
    }
  }
}