ledger-autosync 使用教程
项目介绍
ledger-autosync
是一个用于自动同步银行交易数据到 ledger
或 hledger
的程序。它能够从银行下载交易记录,并生成相应的 ledger
交易条目,确保不会重复创建已存在的交易记录。该项目支持多种银行和账户,并提供了交互式的银行设置界面。
项目快速启动
安装
你可以通过 pip
安装最新版本的 ledger-autosync
:
pip install ledger-autosync
或者从源码安装:
git clone https://github.com/egh/ledger-autosync.git
cd ledger-autosync
python setup.py install
运行
安装完成后,你可以从银行下载一个 OFX 文件,并使用 ledger-autosync
处理它:
ledger-autosync download ofx
这将会输出一系列的交易记录到标准输出。将这些交易记录添加到你的默认 ledger
文件中(即运行 ledger
命令时不带参数的文件),再次运行 ledger-autosync
时,应该不会输出任何交易记录,这是因为 ledger-autosync
具有去重功能,只会输出新的交易记录。
应用案例和最佳实践
案例一:多账户同步
假设你有两个银行账户,分别在不同的银行。你可以为每个账户设置一个独立的配置文件,然后分别运行 ledger-autosync
来同步这两个账户的交易记录。
ledger-autosync -c config_account1.yaml download ofx
ledger-autosync -c config_account2.yaml download ofx
案例二:自动导入和处理
你可以设置一个定时任务,每天自动运行 ledger-autosync
来同步最新的交易记录,并自动导入到你的 ledger
文件中。
# 在 crontab 中添加以下条目
0 1 * * * /path/to/ledger-autosync download ofx >> /path/to/ledger_file.ledger
典型生态项目
ledger-cli
ledger-cli
是一个命令行会计工具,用于管理个人财务。ledger-autosync
生成的交易记录可以直接导入到 ledger-cli
中进行进一步的处理和分析。
hledger
hledger
是一个类似 ledger-cli
的工具,但提供了更多的功能和更好的用户体验。ledger-autosync
也支持生成 hledger
格式的交易记录。
ofxclient
ofxclient
是一个用于与银行进行 OFX 协议通信的工具,ledger-autosync
使用 ofxclient
来下载银行交易记录。
通过这些生态项目的配合使用,可以构建一个完整的个人财务管理系统。