chore: release v0.2.1

Author: Romamo

.github/workflows/ci.yml

@@ -12,12 +12,12 @@ jobs:
     strategy:
       matrix:
         python-version:
-          - "3.9"
           - "3.10"
           - "3.11"
           - "3.12"
           - "3.13"
           - "3.14"
+          - "3.15"
       fail-fast: false
     steps:
       - name: Checkout
@@ -35,3 +35,6 @@ jobs:
 
       - name: Run tests
         run: uv run pytest
+
+      - name: Smoke test
+        run: uv run python tests/smoke_test.py

CHANGELOG.md

@@ -5,6 +5,18 @@ 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.1] - 2026-02-27
+
+### Added
+- Added `--version` flag to the CLI for easier version tracking.
+- Implemented a comprehensive smoke test suite in `tests/smoke_test.py`.
+
+### Changed
+- Bumped minimum Python version to 3.10 to support PEP 604 union types (`|` syntax).
+- Updated CI workflow to test against Python 3.10 through 3.15.
+- Fixed import sorting in `cli.py` to comply with Ruff rules.
+- Dropped support for Python 3.9.
+
 ## [0.2.0] - 2026-02-27
 
 ### Changed

pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "beancount-cli"
-version = "0.2.0"
+version = "0.2.1"
 description = "A CLI tool to manage Beancount ledgers"
 readme = "README.md"
 authors = [
     { name = "Roman Medvedev", email = "pypi@romavm.dev" }
 ]
 license = { text = "MIT" }
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 dependencies = [
     "beancount>=3.0.0",
     "beanquery>=0.1.0",

src/beancount_cli/__init__.py

@@ -1 +1 @@
-__version__ = "0.2.0"
+__version__ = "0.2.1"

src/beancount_cli/cli.py

@@ -6,6 +6,7 @@
 from decimal import Decimal
 from pathlib import Path
 
+from beancount_cli import __version__
 from beancount_cli.config import CliConfig
 from beancount_cli.formatting import Console, Table, Tree, render_output
 from beancount_cli.models import AccountModel, TransactionModel
@@ -598,6 +599,9 @@ def main(args=None):
     parser.add_argument(
         "--file", "-f", dest="ledger_file", type=Path, help="Path to main.beancount file"
     )
+    parser.add_argument(
+        "--version", action="version", version=f"beancount-cli {__version__}", help="Show version"
+    )
     parser.add_argument(
         "--format", choices=["table", "json", "csv"], default="table", help="Global output format"
     )

tests/smoke_test.py

@@ -1,14 +1,76 @@
-# EDIT: Import your main class or module here
-# from your_package import YourMainClass
+import subprocess
+import sys
+import tempfile
+from pathlib import Path
 
 
 def test_smoke():
-    print("Smoke test starting...")
-    # EDIT: Add real functionality verification
-    # e.g., result = YourMainClass.method()
-    # assert result is not None
+    """
+    Basic smoke test to ensure the CLI is functional and can be imported.
+    """
+    print("Running smoke test...")
+
+    # 1. Check help command
+    # Using sys.executable -m to ensure we test the current environment
+    result = subprocess.run(
+        [sys.executable, "-m", "beancount_cli.cli", "--help"],
+        capture_output=True,
+        text=True,
+        check=False,
+    )
+    assert result.returncode == 0
+    assert "Beancount CLI tool" in result.stdout
+
+    # 2. Check version command
+    result = subprocess.run(
+        [sys.executable, "-m", "beancount_cli.cli", "--version"],
+        capture_output=True,
+        text=True,
+        check=False,
+    )
+    assert result.returncode == 0
+    assert "beancount-cli" in result.stdout
+
+    # 3. Check transaction schema command
+    result = subprocess.run(
+        [sys.executable, "-m", "beancount_cli.cli", "transaction", "schema"],
+        capture_output=True,
+        text=True,
+        check=False,
+    )
+    assert result.returncode == 0
+    assert "TransactionModel" in result.stdout
+
+    # 4. Check with a minimal ledger file
+    with tempfile.NamedTemporaryFile(mode="w", suffix=".beancount", delete=False) as f:
+        f.write('2023-01-01 open Assets:Cash USD\n')
+        temp_path = Path(f.name)
+
+    try:
+        result = subprocess.run(
+            [sys.executable, "-m", "beancount_cli.cli", "check", str(temp_path)],
+            capture_output=True,
+            text=True,
+            check=False,
+        )
+        assert result.returncode == 0
+        assert "No errors found" in result.stdout
+    finally:
+        if temp_path.exists():
+            temp_path.unlink()
+
     print("Smoke test passed.")
 
 
 if __name__ == "__main__":
-    test_smoke()
+    try:
+        test_smoke()
+    except AssertionError as e:
+        print(f"Smoke test failed: {e}")
+        sys.exit(1)
+    except Exception as e:
+        print(f"An error occurred: {e}")
+        import traceback
+
+        traceback.print_exc()
+        sys.exit(1)