Storage and export - Keep books and transactions in SQLite (data/cashbook.db) instead of .ods files; existing .ods books are migrated once at startup - Export a book as the cashbook spreadsheet (.xlsx/.ods, built from the template via LibreOffice) or as CSV - GST rounded per transaction to match the spreadsheet Tax - GST return page with IRD GST101A boxes 5-15 per six-monthly, two-monthly or monthly period, due dates, and a Zero-rated GST type - Income tax page with IR10 (financial statements summary) and IR4 (company return) boxes, from the cashbook plus year-end amounts typed in and saved per book FastAPI and accounts (following led-editor) - Replace the stdlib server with a FastAPI app (src/cashbook_app) run by uvicorn; dependencies in Pipfile - Cookie sessions with bcrypt passwords, first-run admin setup or BOOTSTRAP_ADMIN_*, invites (link or email), sign-in throttling, password change that signs out other sessions - Users page for administrators: rename, reset password, promote or demote, delete, list and revoke invites; last admin is protected - Replaces the shared CASHBOOK_PASSWORD basic auth; AUTH_* settings in .env (see .env.example) - Docker image uses a venv with system site packages for python3-uno - pytest suite for auth, user management, imports, GST and tax figures Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
43 lines
1.3 KiB
Python
43 lines
1.3 KiB
Python
#!/usr/bin/env python3
|
|
"""Create a new cashbook (in the database) for a financial year, April to March.
|
|
|
|
Usage:
|
|
new_book.py NAME [--year 2025] [--opening-balance 1234.56] [--data DIR]
|
|
"""
|
|
import argparse
|
|
import os
|
|
import sys
|
|
from datetime import date
|
|
|
|
import ledger
|
|
|
|
HERE = os.path.dirname(os.path.abspath(__file__))
|
|
ROOT = os.path.dirname(HERE)
|
|
|
|
|
|
def current_fy_start():
|
|
today = date.today()
|
|
return today.year if today.month >= 4 else today.year - 1
|
|
|
|
|
|
def main():
|
|
ap = argparse.ArgumentParser(description=__doc__.split("\n\n")[0])
|
|
ap.add_argument("name", help="name for the book, e.g. cashbook-2025-26")
|
|
ap.add_argument("--year", type=int, default=current_fy_start(),
|
|
help="calendar year the financial year starts in (default: current)")
|
|
ap.add_argument("--opening-balance", type=float, default=0.0,
|
|
help="bank balance at 1 April (default: 0)")
|
|
ap.add_argument("--data", default=os.path.join(ROOT, "data"))
|
|
args = ap.parse_args()
|
|
|
|
conn = ledger.connect(os.path.join(args.data, "cashbook.db"))
|
|
try:
|
|
ledger.create_book(conn, args.name, args.year, args.opening_balance)
|
|
except ValueError as e:
|
|
sys.exit(str(e))
|
|
print(f"Created {args.name} for April {args.year} - March {args.year + 1}")
|
|
|
|
|
|
if __name__ == "__main__":
|
|
main()
|