Knowit
3df80bbc63
append_row.py:
- Switch valueInputOption from USER_ENTERED to RAW.
- coerce() the row per-column: amount / amount_hkd / fx_rate become floats,
everything else stays a string. Combined with RAW, dates ("2026-04-20") no
longer get auto-parsed into Sheets date serials (e.g. 46153), while amounts
still land as proper numeric cells so SUM/AVERAGE keep working.
fx_convert.py:
- Cache frankfurter.app responses in ~/.cache/autoacct/fx_cache.json (atomic
write via .tmp + replace). Keyed by "<currency>_<date>". ECB historical
rates are immutable, so an indefinite TTL is safe. Measured locally:
cache hit 52ms vs cache miss 470ms (~9x).
setup.md: troubleshooting entries for pre-existing serial-date rows and for
the FX cache location.
Auth path also verified end-to-end via pure bash + openssl + curl (JWT
sign → token exchange → Sheets API 404 on bogus ID), proving the wire
format is correct independent of the Python client.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
109 lines
3.3 KiB
Python
Executable File
109 lines
3.3 KiB
Python
Executable File
#!/usr/bin/env python3
|
|
"""
|
|
append_row.py — append one expense row to the configured Google Sheet.
|
|
|
|
Reads config from ../config.json.
|
|
Reads a single JSON object from stdin. Keys (all optional; missing -> ""):
|
|
date, merchant, category, amount, currency,
|
|
amount_hkd, fx_rate, fx_date, payment_method,
|
|
line_items, raw_ocr, note, receipt
|
|
|
|
`logged_at` is set automatically to now (UTC, ISO-8601).
|
|
|
|
Prints the updated range on success; exits non-zero on failure.
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
import json
|
|
import os
|
|
import re
|
|
import sys
|
|
from datetime import datetime, timezone
|
|
from pathlib import Path
|
|
|
|
from google.oauth2.service_account import Credentials
|
|
from googleapiclient.discovery import build
|
|
|
|
|
|
CONFIG_PATH = Path(__file__).resolve().parent.parent / "config.json"
|
|
|
|
|
|
def normalize_sheet_id(value: str) -> str:
|
|
# Accept either a bare sheet ID or a full Google Sheets URL —
|
|
# e.g. https://docs.google.com/spreadsheets/d/<ID>/edit#gid=0.
|
|
m = re.search(r"/d/([a-zA-Z0-9_-]+)", value.strip())
|
|
return m.group(1) if m else value.strip()
|
|
|
|
COLUMNS = [
|
|
"date", "merchant", "category", "amount", "currency",
|
|
"amount_hkd", "fx_rate", "fx_date", "payment_method",
|
|
"line_items", "raw_ocr", "note", "receipt", "logged_at",
|
|
]
|
|
|
|
# Columns stored as numbers in Sheets. Everything else stays as a string —
|
|
# including `date` / `fx_date`, which USER_ENTERED would otherwise auto-parse
|
|
# into a Sheets serial-date integer (e.g. 46153) that displays as a raw number
|
|
# when the column has no date format applied.
|
|
NUMERIC_COLS = {"amount", "amount_hkd", "fx_rate"}
|
|
|
|
|
|
def coerce(col: str, val):
|
|
if val == "" or val is None:
|
|
return ""
|
|
if col in NUMERIC_COLS:
|
|
try:
|
|
return float(val)
|
|
except (TypeError, ValueError):
|
|
return str(val)
|
|
return str(val)
|
|
|
|
|
|
def load_config() -> dict:
|
|
if not CONFIG_PATH.exists():
|
|
sys.exit(
|
|
f"config.json not found at {CONFIG_PATH}. "
|
|
f"Copy config.example.json to config.json and fill it in."
|
|
)
|
|
cfg = json.loads(CONFIG_PATH.read_text())
|
|
cfg["service_account_path"] = os.path.expanduser(cfg["service_account_path"])
|
|
return cfg
|
|
|
|
|
|
def main() -> int:
|
|
cfg = load_config()
|
|
row = json.loads(sys.stdin.read())
|
|
row.setdefault(
|
|
"logged_at",
|
|
datetime.now(timezone.utc).isoformat(timespec="seconds"),
|
|
)
|
|
|
|
values = [coerce(col, row.get(col, "")) for col in COLUMNS]
|
|
|
|
creds = Credentials.from_service_account_file(
|
|
cfg["service_account_path"],
|
|
scopes=["https://www.googleapis.com/auth/spreadsheets"],
|
|
)
|
|
svc = build("sheets", "v4", credentials=creds, cache_discovery=False)
|
|
resp = (
|
|
svc.spreadsheets()
|
|
.values()
|
|
.append(
|
|
spreadsheetId=normalize_sheet_id(cfg["sheet_id"]),
|
|
range=f"{cfg['worksheet']}!A1",
|
|
# RAW (not USER_ENTERED) so Sheets stores values as their JSON
|
|
# types: strings stay strings (no date auto-parsing), floats stay
|
|
# numbers. `coerce()` above puts the right type into each column.
|
|
valueInputOption="RAW",
|
|
insertDataOption="INSERT_ROWS",
|
|
body={"values": [values]},
|
|
)
|
|
.execute()
|
|
)
|
|
updated = resp.get("updates", {}).get("updatedRange", "?")
|
|
print(f"OK {updated}")
|
|
return 0
|
|
|
|
|
|
if __name__ == "__main__":
|
|
sys.exit(main())
|