pledger

一个小型个人支出账本。

pledger 所做的只是跟踪每月的支出。

安装

pledger 是一个单独的命令行程序。您可以使用 cargo 来安装它

cargo install pledger

或者本地构建它

git clone https://github.com/woodruffw/pledger && cd pledger
cargo build

用法

pledger 只接受一个输入：存储月度账本的目录

pledger expenses/

或者，您可以使用 PLEDGER_DIR 来传递目录

PLEDGER_DIR=expenses/ pledger

账本存储为具有 YYYY-MM.ledger 文件名的结构化文本文件。关于 pledger 格式的说明见下文。

例如，以下是包含三个月支出目录的列表

$ ls expenses/
2018-02.ledger
2020-01.ledger
2020-02.ledger

pledger 忽略不符合 YYYY-MM.ledger 格式的文件。

默认情况下，pledger 报告当前月份的支出。

要运行 pledger 在过去的日期上，使用 pledger --d <spec> 或 pledger --l

# do a report on january 2017
pledger -d 2017-01 expenses/

# the month name or single number is also enough for the current year
# do a report on april, then march
pledger -d april expenses/
pledger -d 3 expenses

# -l/--last is a shortcut for last month's ledger
pledger -l expenses/

pledger 还可以使用 pledger ---all 生成所有记录的报告，或者使用 pledger ---year YEAR 生成特定年份的报告。

默认情况下，pledger 输出纯文本报告。您可以使用 --json 标志输出 JSON，供其他工具使用

pledger --json expenses/ > monthly.json

账本格式

pledger 的账本是纯文本文件，每行一个条目。借方以 D 开始，贷方以 C 开始，其余格式大部分是自解释的

C 130.00 #bonus
D 8.00 burger and fries #weekday #lunch
D 27.00 saturday drinks #weekend #alcohol
D 20,000.12 new car #essential

货币金额之后的所有内容都是注释。注释可以包含标签，这些标签以#开头，可以是字母数字+符号。 pledger使用您的标签来提供费用摘要；注释中的重复标签将被删除。

空行或以#开头的行将被忽略。