beancount-cli 0.2.12__tar.gz → 0.2.14__tar.gz

{beancount_cli-0.2.12 → beancount_cli-0.2.14}/.gitignore

@@ -25,3 +25,4 @@ build/
 .vscode/
 *.swp
 .DS_Store
+/Ledger/

{beancount_cli-0.2.12 → beancount_cli-0.2.14}/CHANGELOG.md

@@ -5,6 +5,27 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.14] - 2026-06-02
+
+### Added
+- `account pad-balance`: insert a `pad` + `balance` directive pair directly into the ledger.
+
+### Changed
+- `--stdin` flag renamed to `--input` across all commands that read from standard input.
+
+## [0.2.13] - 2026-04-17
+
+### Added
+- `price check`: detect anomalous pricing situations in addition to missing price gaps.
+- `transaction list --fields`: limit JSON output to a selected comma-separated subset of fields.
+
+### Changed
+- Upgraded `agentyper` to `0.1.12`.
+
+### Fixed
+- `report audit`: sort entries chronologically from oldest to newest.
+- `price fetch`: remove the non-functional `--held` behavior.
+
 ## [0.2.12] - 2026-04-08
 
 ### Fixed

{beancount_cli-0.2.12 → beancount_cli-0.2.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: beancount-cli
-Version: 0.2.12
+Version: 0.2.14
 Summary: A CLI tool to manage Beancount ledgers
 Project-URL: Homepage, https://github.com/romamo/beancount-cli
 Project-URL: Repository, https://github.com/romamo/beancount-cli
@@ -20,12 +20,12 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Office/Business :: Financial :: Accounting
 Requires-Python: >=3.10
-Requires-Dist: agentyper==0.1.8
-Requires-Dist: beancount>=3.0.0
-Requires-Dist: beanprice>=2.1.0
+Requires-Dist: agentyper==0.1.13
+Requires-Dist: beancount==3.2.3
+Requires-Dist: beanprice2>=2.1.0
 Requires-Dist: beanquery>=0.1.0
-Requires-Dist: pydantic-settings>=2.0.0
-Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pydantic-settings==2.14.1
+Requires-Dist: pydantic==2.13.4
 Requires-Dist: python-dateutil>=2.8.2
 Description-Content-Type: text/markdown
 

{beancount_cli-0.2.12 → beancount_cli-0.2.14}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "beancount-cli"
-version = "0.2.12"
+version = "0.2.14"
 description = "A CLI tool to manage Beancount ledgers"
 readme = "README.md"
 authors = [
@@ -9,13 +9,13 @@ authors = [
 license = { text = "MIT" }
 requires-python = ">=3.10"
 dependencies = [
-    "beancount>=3.0.0",
+    "beancount==3.2.3",
     "beanquery>=0.1.0",
-    "pydantic>=2.0.0",
+    "pydantic==2.13.4",
     "python-dateutil>=2.8.2",
-    "beanprice>=2.1.0",
-    "pydantic-settings>=2.0.0",
-    "agentyper==0.1.8",
+    "beanprice2>=2.1.0",
+    "pydantic-settings==2.14.1",
+    "agentyper==0.1.13",
 ]
 keywords = ["beancount", "cli", "accounting", "automation", "agent"]
 classifiers = [
@@ -62,8 +62,6 @@ packages = ["src/beancount_cli"]
 requires = ["hatchling"]
 build-backend = "hatchling.build"
 
-[tool.uv.sources]
-beanprice = { git = "https://github.com/romamo/beanprice" }
 
 [dependency-groups]
 dev = [
@@ -88,4 +86,3 @@ extend-immutable-calls = ["agentyper.Argument", "agentyper.Option", "typer.Argum
 [tool.ruff.lint.per-file-ignores]
 "tests/*" = ["E501"]
 
-

beancount_cli-0.2.14/src/beancount_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.2.14"

{beancount_cli-0.2.12 → beancount_cli-0.2.14}/src/beancount_cli/adapters.py

@@ -8,6 +8,7 @@ from beancount_cli.models import (
     BalanceModel,
     CostModel,
     CurrencyCode,
+    PadBalanceModel,
     PostingModel,
     TransactionModel,
 )
@@ -110,3 +111,30 @@ def to_core_balance(model: BalanceModel) -> data.Balance:
         diff_amount=None,
         tolerance=None,
     )
+
+
+def to_core_pad(model: PadBalanceModel) -> tuple[data.Pad, data.Balance]:
+    """Convert a PadBalanceModel into a (Pad, Balance) directive pair.
+
+    The Pad directive is dated one day before the Balance assertion by default,
+    which is the standard Beancount pattern to avoid the 'Unused Pad entry' error.
+    """
+    import datetime
+
+    pad_date = model.pad_date or (model.balance_date - datetime.timedelta(days=1))
+
+    pad = data.Pad(
+        meta=model.meta or {},
+        date=pad_date,
+        account=str(model.account),
+        source_account=str(model.pad_account),
+    )
+    balance = data.Balance(
+        meta={},
+        date=model.balance_date,
+        account=str(model.account),
+        amount=to_core_amount(model.amount),
+        diff_amount=None,
+        tolerance=None,
+    )
+    return pad, balance

beancount_cli-0.2.14/src/beancount_cli/commands/account.py

@@ -0,0 +1,202 @@
+import json
+import sys
+from datetime import date
+from pathlib import Path
+
+import agentyper as typer
+from pydantic import TypeAdapter
+
+from beancount_cli.commands.common import (
+    _is_table_format,
+    console,
+    get_ledger_file,
+    read_json_input,
+)
+from beancount_cli.models import AccountModel, BalanceModel, PadBalanceModel
+from beancount_cli.services import AccountService
+
+app = typer.Agentyper(help="Manage accounts.")
+
+
+@app.command(name="list")
+def account_list(
+    file: Path | None = typer.Option(
+        None, "--file", "-f", envvar="BEANCOUNT_FILE", help="Main beancount file"
+    ),
+):
+    """List all accounts."""
+    actual_file = get_ledger_file(file)
+    service = AccountService(actual_file)
+    accounts = service.list_accounts()
+
+    if _is_table_format():
+        data = [
+            {
+                "Account": acc.name,
+                "Open Date": str(acc.open_date),
+                "Currencies": ", ".join(acc.currencies),
+            }
+            for acc in accounts
+        ]
+        typer.output(data, title=f"Accounts ({len(accounts)})")
+    else:
+        typer.output(accounts, title=f"Accounts ({len(accounts)})")
+
+
+@app.command(name="create")
+def account_create(
+    file: Path | None = typer.Option(
+        None, "--file", "-f", envvar="BEANCOUNT_FILE", help="Main beancount file"
+    ),
+    name: str | None = typer.Option(None, "--name", "-n", help="Account name (e.g. Assets:Bank)"),
+    currency_opt: str | None = typer.Option(
+        None, "--currency", "-c", help="Currencies (comma-separated)"
+    ),
+    open_date: str | None = typer.Option(None, "--date", "-d", help="Open date (YYYY-MM-DD)"),
+    json_data: str | None = typer.Option(
+        None, "--input", "-i", help="JSON string data (or '-' to read from STDIN)"
+    ),
+    target: Path | None = typer.Option(None, "--target", help="Override target file to write to"),
+):
+    """Create a new account."""
+    actual_file = get_ledger_file(file)
+    service = AccountService(actual_file)
+
+    if json_data:
+        data_input = json.loads(read_json_input(json_data))
+        if isinstance(data_input, list):
+            ta = TypeAdapter(list[AccountModel])
+            models = ta.validate_python(data_input)
+            for m in models:
+                service.create_account(m, target_file=target)
+                console.print(f"[green]Account {m.name} created.[/green]")
+        else:
+            model = AccountModel(**data_input)
+            service.create_account(model, target_file=target)
+            console.print(f"[green]Account {model.name} created.[/green]")
+    else:
+        if not name:
+            console.print("[red]Error: --name is required if not using --input.[/red]")
+            sys.exit(typer.EXIT_VALIDATION)
+
+        d = date.today()
+        if open_date:
+            d = date.fromisoformat(open_date)
+
+        currencies = [c.strip() for c in currency_opt.split(",")] if currency_opt else []
+        model = AccountModel(name=name, open_date=d, currencies=currencies)
+        service.create_account(model, target_file=target)
+        console.print(f"[green]Account {name} created.[/green]")
+
+
+@app.command(name="balance")
+def account_balance(
+    file: Path | None = typer.Option(
+        None, "--file", "-f", envvar="BEANCOUNT_FILE", help="Main beancount file"
+    ),
+    json_data: str = typer.Option(
+        ..., "--input", "-i", help="JSON string data (or '-' to read from STDIN)"
+    ),
+    target: Path | None = typer.Option(None, "--target", help="Override target file to write to"),
+):
+    """Add a balance directive for an account."""
+    actual_file = get_ledger_file(file)
+    service = AccountService(actual_file)
+
+    data_input = json.loads(read_json_input(json_data))
+    model = BalanceModel(**data_input)
+    service.add_balance(model, target_file=target)
+    console.print(f"[green]Balance check for {model.account} added.[/green]")
+
+
+@app.command(name="pad-balance")
+def account_pad_balance(
+    file: Path | None = typer.Option(
+        None, "--file", "-f", envvar="BEANCOUNT_FILE", help="Main beancount file"
+    ),
+    account: str | None = typer.Option(
+        None, "--account", help="Account to adjust (e.g. Assets:BE:Wise:EUR)"
+    ),
+    amount: str | None = typer.Option(
+        None, "--amount", help="Target balance amount (e.g. 1777.00)"
+    ),
+    currency: str | None = typer.Option(
+        None, "--currency", "-c", help="Currency of the target balance (e.g. EUR)"
+    ),
+    pad_account: str | None = typer.Option(
+        None,
+        "--pad-account",
+        "-p",
+        help="Account to absorb the difference (e.g. Expenses:Other)",
+    ),
+    balance_date: str | None = typer.Option(
+        None,
+        "--date",
+        "-d",
+        help="Date of the balance assertion (YYYY-MM-DD). Defaults to today.",
+    ),
+    pad_date: str | None = typer.Option(
+        None,
+        "--pad-date",
+        help="Date of the pad directive (YYYY-MM-DD). Defaults to balance-date minus 1 day.",
+    ),
+    json_data: str | None = typer.Option(
+        None, "--input", "-i", help="JSON string data (or '-' to read from STDIN)"
+    ),
+    target: Path | None = typer.Option(None, "--target", help="Override target file to write to"),
+):
+    """Adjust an account balance using a Pad + Balance directive pair.
+
+    Beancount inserts a synthetic transaction to bring ACCOUNT to AMOUNT
+    on BALANCE-DATE.  The adjustment is automatically booked to PAD-ACCOUNT.
+
+    Example:
+      uv run bean account pad-balance \\
+        --account Assets:BE:Wise:EUR \\
+        --amount 1777 --currency EUR \\
+        --pad-account Expenses:Other
+
+    JSON example (for agent pipelines):
+      echo '{"account": "Assets:BE:Wise:EUR", "amount": {"number": 1777, "currency": "EUR"}, \\
+             "pad_account": "Expenses:Other", "balance_date": "2026-06-02"}' \\
+        | uv run bean account pad-balance --input -
+    """
+    actual_file = get_ledger_file(file)
+    service = AccountService(actual_file)
+
+    if json_data:
+        data_input = json.loads(read_json_input(json_data))
+        model = PadBalanceModel(**data_input)
+    else:
+        missing = [
+            f
+            for f, v in [
+                ("--account", account),
+                ("--amount", amount),
+                ("--currency", currency),
+                ("--pad-account", pad_account),
+            ]
+            if not v
+        ]
+        if missing:
+            console.print(
+                f"[red]Error: {', '.join(missing)} required when not using --input.[/red]"
+            )
+            sys.exit(typer.EXIT_VALIDATION)
+
+        b_date = date.fromisoformat(balance_date) if balance_date else date.today()
+        p_date = date.fromisoformat(pad_date) if pad_date else None
+
+        model = PadBalanceModel(
+            balance_date=b_date,
+            account=account,  # type: ignore[arg-type]
+            amount={"number": amount, "currency": currency},
+            pad_account=pad_account,  # type: ignore[arg-type]
+            pad_date=p_date,
+        )
+
+    service.add_pad_balance(model, target_file=target)
+    console.print(
+        f"[green]Pad + Balance for {model.account} → {model.amount.number} "
+        f"{model.amount.currency} added.[/green]"
+    )

beancount_cli-0.2.14/src/beancount_cli/commands/commodity.py

@@ -0,0 +1,193 @@
+import json
+import logging
+import sys
+from pathlib import Path
+
+import agentyper as typer
+from beancount.core import data
+from beancount.parser import parser as bp_parser
+
+from beancount_cli.commands.common import (
+    _is_table_format,
+    console,
+    error_console,
+    get_ledger_file,
+    read_json_input,
+    read_stdin,
+)
+from beancount_cli.models import CommodityModel
+from beancount_cli.services import CommodityService
+
+app = typer.Agentyper(help="Manage commodities.")
+
+
+@app.command(name="list")
+def commodity_list(
+    file: Path | None = typer.Option(
+        None, "--file", "-f", envvar="BEANCOUNT_FILE", help="Main beancount file"
+    ),
+    asset_class: str | None = typer.Option(
+        None, "--asset-class", "-c", help="Filter by asset-class meta (e.g. stock, Cash)"
+    ),
+):
+    """List all commodities."""
+    actual_file = get_ledger_file(file)
+    service = CommodityService(actual_file)
+    commodities = service.list_commodities(asset_class=asset_class)
+
+    if _is_table_format():
+        data = [
+            {
+                "Currency": c.currency,
+                "Date": str(c.date) if c.date else "",
+                "Name": c.meta.get("name", "") if c.meta else "",
+            }
+            for c in commodities
+        ]
+        typer.output(data, title=f"Commodities ({len(commodities)})")
+    else:
+        typer.output(commodities, title=f"Commodities ({len(commodities)})")
+
+
+@app.command(name="check")
+def commodity_check(
+    file: Path | None = typer.Option(
+        None, "--file", "-f", envvar="BEANCOUNT_FILE", help="Main beancount file"
+    ),
+):
+    """Check for currencies used in transactions but missing a commodity directive."""
+    actual_file = get_ledger_file(file)
+    service = CommodityService(actual_file)
+    undeclared = service.get_undeclared_commodities()
+
+    if _is_table_format():
+        if not undeclared:
+            console.print("[green]All used currencies are declared.[/green]")
+        else:
+            typer.output(undeclared, title=f"Undeclared Commodities ({len(undeclared)})")
+    else:
+        typer.output(undeclared, title="Undeclared Commodities")
+
+
+@app.command(name="export")
+def commodity_export(
+    file: Path | None = typer.Option(
+        None, "--file", "-f", envvar="BEANCOUNT_FILE", help="Main beancount file"
+    ),
+    asset_class: str | None = typer.Option(
+        None, "--asset-class", "-c", help="Filter by asset-class meta (e.g. stock, Cash)"
+    ),
+    output_file: Path | None = typer.Option(
+        None, "--output-file", help="Write output to file (default: commodities_file or stdout)"
+    ),
+):
+    """Export commodities as beancount directives."""
+    actual_file = get_ledger_file(file)
+    service = CommodityService(actual_file)
+    commodities = service.list_commodities(asset_class=asset_class)
+
+    content = "\n".join(service._format_commodity_block(c) for c in commodities)
+
+    dest = output_file or service.ledger_service.get_commodities_file()
+    if dest:
+        dest.write_text(content)
+        console.print(f"[green]Exported {len(commodities)} commodities →[/green] {dest}")
+    else:
+        sys.stdout.write(content)
+
+
+@app.command(name="import", mutating=True)
+def commodity_import(
+    file: Path | None = typer.Option(
+        None, "--file", "-f", envvar="BEANCOUNT_FILE", help="Main beancount file"
+    ),
+    input_file: Path | None = typer.Option(
+        None, "--input-file", help="Read beancount directives from file instead of stdin"
+    ),
+    output_file: Path | None = typer.Option(
+        None, "--output-file", help="Write to file (default: commodities_file from ledger config)"
+    ),
+    overwrite: bool = typer.Option(False, "--overwrite", help="Overwrite existing commodities"),
+    dry_run: bool = False,
+):
+    """Import commodity directives from stdin (or --input-file) into the commodities_file."""
+    stdin_text = Path(input_file).read_text() if input_file else read_stdin()
+    entries, errors, _ = bp_parser.parse_string(stdin_text)
+    if errors:
+        for e in errors:
+            console.print(f"[red]Parse error: {e.message}[/red]")
+        sys.exit(typer.EXIT_VALIDATION)
+
+    commodities = [
+        CommodityModel(currency=e.currency, date=e.date, meta=e.meta)
+        for e in entries
+        if isinstance(e, data.Commodity)
+    ]
+    if not commodities:
+        console.print("[yellow]No commodity directives found in stdin.[/yellow]")
+        return
+
+    actual_file = get_ledger_file(file)
+    service = CommodityService(actual_file)
+    dest = output_file or service.ledger_service.get_commodities_file()
+
+    results, commodities_file = service.import_commodities(
+        commodities, output_file=dest, overwrite=overwrite, dry_run=dry_run
+    )
+
+    stdout_mode = not dry_run and commodities_file is None
+    status_console = error_console if stdout_mode else console
+    verbose = logging.getLogger().isEnabledFor(logging.INFO)
+    prefix = "[dim](dry-run)[/dim] " if dry_run else ""
+    for r in results:
+        if not verbose and not dry_run and r.action == "skipped":
+            continue
+        color = {"added": "green", "overwritten": "yellow", "skipped": "dim"}.get(r.action, "white")
+        status_console.print(f"{prefix}[{color}]{r.action:12}[/{color}] {r.currency}")
+
+    if dry_run:
+        return
+
+    if commodities_file:
+        console.print(f"\n[green]Done →[/green] {commodities_file}")
+    else:
+        # No destination configured — stream added/overwritten entries to stdout
+        written = {r.currency for r in results if r.action != "skipped"}
+        for c in commodities:
+            if str(c.currency) in written:
+                sys.stdout.write(service._format_commodity_block(c))
+
+
+@app.command(name="create")
+def commodity_create(
+    currency: str | None = typer.Argument(None, help="Currency code (e.g. USD)"),
+    file: Path | None = typer.Option(
+        None, "--file", "-f", envvar="BEANCOUNT_FILE", help="Main beancount file"
+    ),
+    name: str | None = typer.Option(None, "--name", "-n", help="Full name"),
+    json_data: str | None = typer.Option(
+        None, "--input", "-i", help="JSON string data (or '-' to read from STDIN)"
+    ),
+):
+    """Create a new commodity."""
+    actual_file = get_ledger_file(file)
+    service = CommodityService(actual_file)
+
+    if json_data:
+        data_input = json.loads(read_json_input(json_data))
+        items = data_input if isinstance(data_input, list) else [data_input]
+        for item in items:
+            curr = item.get("currency")
+            comm_name = item.get("name")
+            if not curr:
+                console.print(f"[yellow]Skipping invalid commodity entry: {item}[/yellow]")
+                continue
+            meta = {k: v for k, v in item.items() if k not in ("currency", "name")}
+            service.create_commodity(curr, name=comm_name, meta=meta)
+            console.print(f"[green]Commodity {curr} created.[/green]")
+    else:
+        if not currency:
+            console.print("[red]Error: currency argument is required if not using --input.[/red]")
+            sys.exit(typer.EXIT_VALIDATION)
+        service.create_commodity(currency, name=name)
+        console.print(f"[green]Commodity {currency} created.[/green]")

{beancount_cli-0.2.12 → beancount_cli-0.2.14}/src/beancount_cli/commands/common.py

@@ -15,6 +15,30 @@ console = Console(width=_width)
 error_console = Console(stderr=True, width=_width)
 
 
+_STDIN_MAX_BYTES = 65_536
+
+
+def read_stdin() -> str:
+    """Read text from stdin, guarding against TTY deadlock and pipe-buffer overflow (§50, §61)."""
+    import agentyper as typer
+
+    if sys.stdin.isatty():
+        error_console.print(
+            "[red]Error: stdin is a TTY — pipe input or use --input-file PATH.[/red]"
+        )
+        sys.exit(typer.EXIT_VALIDATION)
+
+    chunk = sys.stdin.buffer.read(_STDIN_MAX_BYTES + 1)
+    if len(chunk) > _STDIN_MAX_BYTES:
+        error_console.print(
+            f"[red]Error: stdin exceeds {_STDIN_MAX_BYTES // 1024} KB limit."
+            " Use --input-file PATH for large payloads.[/red]"
+        )
+        sys.exit(typer.EXIT_VALIDATION)
+
+    return chunk.decode()
+
+
 def read_json_input(json_data: str) -> str:
     """Read JSON from a string or from STDIN when json_data is '-'."""
     if json_data == "-":