Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/andreoliwa/bank-csv-rs
Handle CSV files from a few German banks and PayPal
https://github.com/andreoliwa/bank-csv-rs
banking csv dkb finance n26 paypal rust
Last synced: about 22 hours ago
JSON representation
Handle CSV files from a few German banks and PayPal
- Host: GitHub
- URL: https://github.com/andreoliwa/bank-csv-rs
- Owner: andreoliwa
- Created: 2024-01-19T23:48:46.000Z (9 months ago)
- Default Branch: master
- Last Pushed: 2024-09-16T10:49:23.000Z (17 days ago)
- Last Synced: 2024-09-16T12:25:16.130Z (17 days ago)
- Topics: banking, csv, dkb, finance, n26, paypal, rust
- Language: Rust
- Homepage:
- Size: 59.6 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: docs/README.md
Awesome Lists containing this project
README
# bank-csv
Handle CSV files from a few German banks and PayPal.
## Supported CSV files
| Bank | Where to get the CSV |
| --------------------------------- | ----------------------------------------------------------------------------------------- |
| [N26](https://n26.com/) | [Downloads](https://app.n26.com/downloads) |
| [PayPal](https://www.paypal.com/) | [Activity report](https://www.paypal.com/reports/dlog) |
| [DKB](https://www.dkb.de/) | [DKB Konto Umsätze](https://www.ib.dkb.de/banking/finanzstatus/kontoumsaetze?$event=init) |
PayPal CSV columns can be configured on download and the default columns can change.
This project uses [polars](https://github.com/pola-rs/polars) to read CSV files directly by column names.
It's a heavier dependency, but it's easier to support different CSV formats without being super strict about column order and presence.
## Installation
| From | Command |
| ---------------------------------------------- | --------------------------------------------------------------- |
| [crates.io](https://crates.io/crates/bank-csv) | `cargo install bank-csv` |
| GitHub | `cargo install --git https://github.com/andreoliwa/bank-csv-rs` |
## Usage
Merge CSV files from a few German banks and PayPal into a single CSV file.
```bash
bank-csv merge /path/to/import-*.csv
```
`EUR` transactions are filtered by default. You can choose a different currency with the `--currency` option.
```bash
bank-csv merge -c USD /path/to/import-*.csv
```
This will generate `bank-csv-transactions*.csv` files in the download directory of the computer, with transactions sorted by date and grouped by month.
Type `bank-csv --help` for more details.
```bash
❯ bank-csv --help
Handle CSV files from a few German banks and PayPal
Usage: bank-csv
Commands:
merge Merge one or more bank CSV files and split them into multiple files, one for each month
help Print this message or the help of the given subcommand(s)
Options:
-h, --help Print help
-V, --version Print version
```
## Roadmap (TODO)
- [ ] Generate OFX (or QIF) files to be imported into [GnuCash](https://www.gnucash.org/)