ledger-autosync 使用教程

ledger-autosync 使用教程

ledger-autosyncSynchronize your ledger-cli files with your bank.项目地址:https://gitcode.com/gh_mirrors/le/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 来下载银行交易记录。

通过这些生态项目的配合使用，可以构建一个完整的个人财务管理系统。

ledger-autosyncSynchronize your ledger-cli files with your bank.项目地址:https://gitcode.com/gh_mirrors/le/ledger-autosync