bepp Download - bepp Source code download

bepp

AI Source Code

ve graph plotting ?

Download

? Bepp ?

A tiny tool to manage, clean, and merge transaction exports from Banca Etica and PayPal.

About

I wrote this script to learn and practice with Python and pandas, while also getting something I really needed out of it.

⏬ Install

Install uv
Start a virtual environment: uv venv
Install the package: uv pip install bepp
- append -U to install at the user level
- append --system to install system-wide

Usage

argument	type	default	description
`input/path/`	string	Required	Input directory, containing the source CSV and Excel files.
`-b`, `--backup`	boolean	False	Save one CSV backup per kind containing all the original transactions, with no modification.
`-c`, `--convert_to_eur`	boolean	False	Convert transactions in other currencies to €. Note: This heavily slows down the process!
`-d`, `--dry_run`	boolean	False	Run the script without changing or printing anything.
`-m`, `--merge`	boolean	False	Merge the PayPal’s and Banca Etica’s transaction summaries in one unique CSV.
`-n`, `--note`	boolean	False	Only print the note/description (useful for debugging description regexs).
`-o`, `--output_dir`	string	`input/path/` + `bepp_export/`	Specify an output directory.
`-p`, `--keep_pp_dupes`	boolean	False	Prevent from removing PayPal transactions in Banca Etica’s logs.
`-t`, `--timeline`	boolean	False	Plot a timeline graph of the spendings.

Note: Bepp assumes that inside the specified directory all Excel files are Banca Etica’s “estratto conto” files, and all CSV files are PayPal transaction summaries.