'Add transaction' tool (#40)

Author: mxr

README.md

@@ -10,13 +10,15 @@ This repo is a single CLI for YNAB-focused tools.
 
 - `reconciler`: find and automatically reconciles unreconciled transactions
 - `auto-approve`: approve matched transactions automatically
+- `add-transaction`: create a transaction and optionally fund a category
 - `pending-income`: move pending income transactions to today
 - `zero-out`: set a category's planned amount to zero across a month range
 
 Tool-specific docs:
 
 - [Reconciler](manager_for_ynab/reconciler/README.md)
 - [Auto Approve](manager_for_ynab/auto_approve/README.md)
+- [Add Transaction](manager_for_ynab/add_transaction/README.md)
 - [Pending Income](manager_for_ynab/pending_income/README.md)
 - [Zero Out](manager_for_ynab/zero_out/README.md)
 
@@ -32,6 +34,7 @@ $ pip install manager-for-ynab
 $ manager-for-ynab --help
 $ manager-for-ynab reconciler --help
 $ manager-for-ynab auto-approve --help
+$ manager-for-ynab add-transaction --help
 $ manager-for-ynab pending-income --help
 $ manager-for-ynab zero-out --help
 ```

manager_for_ynab/_main.py

@@ -4,6 +4,7 @@
 from typing import TYPE_CHECKING
 
 from manager_for_ynab._version import get_version
+from manager_for_ynab.add_transaction import run as run_add_transaction
 from manager_for_ynab.auto_approve import run as run_auto_approve
 from manager_for_ynab.pending_income import run as run_pending_income
 from manager_for_ynab.reconciler import run as run_reconciler
@@ -15,6 +16,7 @@
 
 _RECONCILER_HELP = "Find and automatically reconciles unreconciled transactions."
 _AUTO_APPROVE_HELP = "Approve matched transactions automatically."
+_ADD_TRANSACTION_HELP = "Create a transaction and optionally fund a category."
 
 
 def build_parser() -> argparse.ArgumentParser:
@@ -43,6 +45,13 @@ def build_parser() -> argparse.ArgumentParser:
     )
     auto_approve_parser.set_defaults(func=run_auto_approve)
 
+    add_transaction_parser = subparsers.add_parser(
+        "add-transaction",
+        help=_ADD_TRANSACTION_HELP,
+        description=_ADD_TRANSACTION_HELP,
+    )
+    add_transaction_parser.set_defaults(func=run_add_transaction)
+
     zero_out_parser = subparsers.add_parser(
         "zero-out",
         help="Set a category's budgeted amount to zero across a month range.",
@@ -67,6 +76,8 @@ async def async_main(argv: Sequence[str] = ()) -> int:
             return await run_pending_income(argv[1:])
         case "auto-approve":
             return await run_auto_approve(argv[1:])
+        case "add-transaction":
+            return await run_add_transaction(argv[1:])
         case "zero-out":
             return await run_zero_out(argv[1:])
 

manager_for_ynab/add_transaction/README.md

@@ -0,0 +1,7 @@
+# Add Transaction
+
+`manager-for-ynab add-transaction` creates a new YNAB transaction from the local sqlite-export database and can optionally fund the category from Ready to Assign.
+
+It works interactively by autocompleting payees, categories etc already in your plan.
+
+Use `--for-real` to create the transaction. Without it, the command only previews the transaction that would be sent.