bankfiletool-statement-check 0.1.0__tar.gz

bankfiletool_statement_check-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 bankfiletool-statement-check contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

bankfiletool_statement_check-0.1.0/PKG-INFO

@@ -0,0 +1,27 @@
+Metadata-Version: 2.4
+Name: bankfiletool-statement-check
+Version: 0.1.0
+Summary: Local balance reconciliation for exported statement CSV files
+License-Expression: MIT
+Project-URL: Homepage, https://bankfiletool.com/
+Classifier: Programming Language :: Python :: 3
+Classifier: Environment :: Console
+Classifier: Topic :: Office/Business :: Financial :: Accounting
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# BankFileTool Statement Check
+
+Reconcile statement totals using exact decimal arithmetic, or inspect the first row of a CSV export for reviewable columns. This tool works locally and does not upload financial files.
+
+```bash
+pip install bankfiletool-statement-check
+bankfiletool-check totals 100.00 55.25 20.10 135.15
+bankfiletool-check headers transactions.csv
+```
+
+When preparing statement data for an import, keep the original statement beside the CSV and verify dates, signs, and several transaction rows. A [Bank Statement Converter](https://bankfiletool.com/) can create the export, while this small companion checks arithmetic and column readiness. A matching balance does not prove that every transaction was extracted correctly.
+
+Review private files under your own retention rules.

bankfiletool_statement_check-0.1.0/README.md

@@ -0,0 +1,13 @@
+# BankFileTool Statement Check
+
+Reconcile statement totals using exact decimal arithmetic, or inspect the first row of a CSV export for reviewable columns. This tool works locally and does not upload financial files.
+
+```bash
+pip install bankfiletool-statement-check
+bankfiletool-check totals 100.00 55.25 20.10 135.15
+bankfiletool-check headers transactions.csv
+```
+
+When preparing statement data for an import, keep the original statement beside the CSV and verify dates, signs, and several transaction rows. A [Bank Statement Converter](https://bankfiletool.com/) can create the export, while this small companion checks arithmetic and column readiness. A matching balance does not prove that every transaction was extracted correctly.
+
+Review private files under your own retention rules.

bankfiletool_statement_check-0.1.0/bankfiletool_statement_check.egg-info/PKG-INFO

@@ -0,0 +1,27 @@
+Metadata-Version: 2.4
+Name: bankfiletool-statement-check
+Version: 0.1.0
+Summary: Local balance reconciliation for exported statement CSV files
+License-Expression: MIT
+Project-URL: Homepage, https://bankfiletool.com/
+Classifier: Programming Language :: Python :: 3
+Classifier: Environment :: Console
+Classifier: Topic :: Office/Business :: Financial :: Accounting
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# BankFileTool Statement Check
+
+Reconcile statement totals using exact decimal arithmetic, or inspect the first row of a CSV export for reviewable columns. This tool works locally and does not upload financial files.
+
+```bash
+pip install bankfiletool-statement-check
+bankfiletool-check totals 100.00 55.25 20.10 135.15
+bankfiletool-check headers transactions.csv
+```
+
+When preparing statement data for an import, keep the original statement beside the CSV and verify dates, signs, and several transaction rows. A [Bank Statement Converter](https://bankfiletool.com/) can create the export, while this small companion checks arithmetic and column readiness. A matching balance does not prove that every transaction was extracted correctly.
+
+Review private files under your own retention rules.

bankfiletool_statement_check-0.1.0/bankfiletool_statement_check.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+bankfiletool_statement_check.py
+pyproject.toml
+bankfiletool_statement_check.egg-info/PKG-INFO
+bankfiletool_statement_check.egg-info/SOURCES.txt
+bankfiletool_statement_check.egg-info/dependency_links.txt
+bankfiletool_statement_check.egg-info/entry_points.txt
+bankfiletool_statement_check.egg-info/top_level.txt

bankfiletool_statement_check-0.1.0/bankfiletool_statement_check.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

bankfiletool_statement_check-0.1.0/bankfiletool_statement_check.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+bankfiletool-check = bankfiletool_statement_check:main

bankfiletool_statement_check-0.1.0/bankfiletool_statement_check.egg-info/top_level.txt

@@ -0,0 +1 @@
+bankfiletool_statement_check

bankfiletool_statement_check-0.1.0/bankfiletool_statement_check.py

@@ -0,0 +1,71 @@
+"""Reconcile statement totals locally using exact decimal arithmetic."""
+
+import argparse
+import csv
+import json
+import re
+from decimal import Decimal
+
+
+MONEY = re.compile(r"^-?(?:0|[1-9]\d*)(?:\.\d{1,2})?$")
+
+
+def parse_money(raw: str, *, allow_negative: bool = True) -> Decimal:
+    text = raw.strip()
+    if not MONEY.fullmatch(text) or (not allow_negative and text.startswith("-")):
+        raise ValueError("Amounts must be plain decimal strings with at most two places")
+    return Decimal(text)
+
+
+def reconcile(opening: str, credits: str, debits: str, closing: str) -> dict:
+    start = parse_money(opening)
+    incoming = parse_money(credits, allow_negative=False)
+    outgoing = parse_money(debits, allow_negative=False)
+    printed = parse_money(closing)
+    calculated = start + incoming - outgoing
+    difference = calculated - printed
+    return {
+        "calculated_closing": f"{calculated:.2f}",
+        "printed_closing": f"{printed:.2f}",
+        "difference": f"{difference:.2f}",
+        "matches": difference == 0,
+    }
+
+
+def review_csv_headers(path: str) -> dict:
+    with open(path, newline="", encoding="utf-8-sig") as stream:
+        headers = next(csv.reader(stream), [])
+    normalized = [item.strip().lower() for item in headers]
+    has_date = any("date" in item for item in normalized)
+    has_description = any(any(term in item for term in ("description", "memo", "payee", "details")) for item in normalized)
+    has_amount = any("amount" in item for item in normalized)
+    has_split = any("debit" in item for item in normalized) and any("credit" in item for item in normalized)
+    missing = []
+    if not has_date:
+        missing.append("date")
+    if not has_description:
+        missing.append("description or payee")
+    if not (has_amount or has_split):
+        missing.append("amount or debit+credit")
+    return {"headers": headers, "missing": missing, "ready_for_manual_review": not missing}
+
+
+def main(argv=None) -> int:
+    parser = argparse.ArgumentParser(description=__doc__)
+    sub = parser.add_subparsers(dest="command", required=True)
+    totals = sub.add_parser("totals", help="Compare opening + credits - debits with closing")
+    for name in ("opening", "credits", "debits", "closing"):
+        totals.add_argument(name)
+    headers = sub.add_parser("headers", help="Check whether a CSV has reviewable columns")
+    headers.add_argument("csv_file")
+    args = parser.parse_args(argv)
+    try:
+        result = reconcile(args.opening, args.credits, args.debits, args.closing) if args.command == "totals" else review_csv_headers(args.csv_file)
+    except (ValueError, OSError) as exc:
+        parser.error(str(exc))
+    print(json.dumps(result, indent=2))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

bankfiletool_statement_check-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "bankfiletool-statement-check"
+version = "0.1.0"
+description = "Local balance reconciliation for exported statement CSV files"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+classifiers = ["Programming Language :: Python :: 3", "Environment :: Console", "Topic :: Office/Business :: Financial :: Accounting"]
+
+[project.urls]
+Homepage = "https://bankfiletool.com/"
+
+[project.scripts]
+bankfiletool-check = "bankfiletool_statement_check:main"
+
+[tool.setuptools]
+py-modules = ["bankfiletool_statement_check"]

bankfiletool_statement_check-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+