btctax-cli 0.13.0

btctax — an offline, single-user US Bitcoin tax ledger (CLI: import, reconcile, and compute).
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

mod fixtures;
use btctax_cli::{cmd, render, Session};
use btctax_core::{DisposeKind, OutflowClass};
use btctax_store::Passphrase;
use time::macros::datetime;

fn pp() -> Passphrase {
    Passphrase::new("pw".into())
}

#[test]
fn full_lifecycle_init_import_verify_reconcile_report() {
    let dir = tempfile::tempdir().unwrap();
    let vault = dir.path().join("vault.pgp");
    let now = datetime!(2026-02-01 12:00:00 UTC);

    // init
    cmd::init::run(&vault, &pp(), &dir.path().join("k.asc")).unwrap();

    // import synthetic Coinbase (Buy + Sell + Send→pending)
    cmd::import::run(
        &vault,
        &pp(),
        &[fixtures::coinbase_buy_sell_send(dir.path())],
    )
    .unwrap();

    // verify: the Send is pending (advisory), conservation balances, no hard blockers
    let v1 = cmd::inspect::verify(&vault, &pp()).unwrap();
    assert!(v1.conservation.balanced);
    assert_eq!(v1.pending, 1);
    assert!(!v1.has_hard_blockers());

    // reconcile: reclassify the pending Send as a Sell (discover its eventref from the projection)
    let out_ref = {
        let s = Session::open(&vault, &pp()).unwrap();
        let (st, _) = s.project().unwrap();
        st.pending_reconciliation[0].event.canonical()
    };
    cmd::reconcile::reclassify_outflow(
        &vault,
        &pp(),
        &out_ref,
        OutflowClass::Dispose {
            kind: DisposeKind::Sell,
        },
        btctax_cli::eventref::parse_usd_arg("2050.00").unwrap(),
        Some(btctax_cli::eventref::parse_usd_arg("2.50").unwrap()),
        None,
        now,
    )
    .unwrap();

    // report: two 2025 disposals now (the original Sell + the reclassified Send)
    let state = cmd::inspect::report(&vault, &pp(), Some(2025)).unwrap();
    assert_eq!(state.disposals.len(), 2);
    let text = render::render_report(&state, Some(2025));
    assert!(text.contains("Disposals (year 2025)"));

    // verify again: nothing pending; still no hard blockers
    let v2 = cmd::inspect::verify(&vault, &pp()).unwrap();
    assert_eq!(v2.pending, 0);
    assert!(!v2.has_hard_blockers());
}