From 2ce2a5158816fb5b903e55ffd7bade2a28c2ef9d Mon Sep 17 00:00:00 2001 From: Lynnesbian Date: Sat, 26 Sep 2020 23:25:52 +1000 Subject: [PATCH] a readme file yahoo --- README.md | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..13af792 --- /dev/null +++ b/README.md @@ -0,0 +1,35 @@ +BunyMuny +=== + +BunyMuny parses the CSV output of various bank statement listings and converts it to something more human readable with nice visualisations. + +## Building +```bash +git clone https://git.bune.city/lynnesbian/BunyMuny +cd BunyMuny +dotnet build +``` + +## The rules file +By default, BunyMuny checks for rules in `rules.json` in the current directory. An example rules file might look like this: +```json +[ + { + "Match":"Start", + "Value": "Purchase Cash Converters", + "Category":"Personal", + "Description":"Cashies" + } +] +``` +This means that any statement that starts with "Purchase Cash Converters" will be assigned the category "Personal", and the description "Cashies". + +- `"Match"` specifies the type of matching to perform. It can be any of the following: + - "Start": Match the start of the description. + - "End": Match the end of the description. + - "Contains": Match anywhere in the description. + - "Exact": Only match if the bank statement's description is exactly equal to the provided value. + - "Regex": Match with [regular expressions](https://en.wikipedia.org/wiki/Regular_expression). +- `"Value"` specifies the value to match against. +- `"Category"` is the category that the statement should be filed under. +- `"Description"` is a short description to distinguish the particular merchant.