Add tests/test_ledger.py for the lot ledger of spec section 5
This commit is contained in:
1 parent
83ed331018
commit
88b60de2bd
1 file changed
+246
@@ -0,0 +1,246 @@
|
||||
"""Unit tests for the lot ledger of docs/spec.md section 5.
|
||||
|
||||
Run with: python3 -m unittest discover -s tests -v
|
||||
Every test makes its own database in a temporary directory, so the tests never
|
||||
touch the development database.
|
||||
"""
|
||||
|
||||
import os
|
||||
import tempfile
|
||||
import unittest
|
||||
|
||||
import database
|
||||
import ledger
|
||||
|
||||
TRANSACTION_DEFAULTS = {
|
||||
"market_id": None,
|
||||
"date": "2024-01-01",
|
||||
"type": "trade",
|
||||
"taxable": 1,
|
||||
"note": "",
|
||||
"leg_in_sats": None,
|
||||
"leg_in_ore": None,
|
||||
"leg_out_sats": None,
|
||||
"leg_out_ore": None,
|
||||
"value_ore": None,
|
||||
"fee_sats": 0,
|
||||
"fee_ore": 0,
|
||||
"to_market_id": None,
|
||||
"transfer_group": None,
|
||||
"generated": 0,
|
||||
}
|
||||
|
||||
|
||||
def create_market(name, kind="exchange", taxable=1, custody_market_id=None):
|
||||
conn = database.connect()
|
||||
try:
|
||||
with conn:
|
||||
cursor = conn.execute(
|
||||
"INSERT INTO markets (name, kind, taxable, custody_market_id)"
|
||||
" VALUES (?, ?, ?, ?)",
|
||||
(name, kind, taxable, custody_market_id),
|
||||
)
|
||||
return cursor.lastrowid
|
||||
finally:
|
||||
conn.close()
|
||||
|
||||
|
||||
def create_transaction(**fields):
|
||||
"""Insert one transaction row. Columns not given keep their default."""
|
||||
values = dict(TRANSACTION_DEFAULTS)
|
||||
unknown = set(fields) - set(values)
|
||||
if unknown:
|
||||
raise AssertionError("unknown transaction field(s): %s" % sorted(unknown))
|
||||
values.update(fields)
|
||||
columns = ", ".join(values)
|
||||
placeholders = ", ".join("?" for _ in values)
|
||||
conn = database.connect()
|
||||
try:
|
||||
with conn:
|
||||
cursor = conn.execute(
|
||||
"INSERT INTO transactions (%s, created_at, updated_at)"
|
||||
" VALUES (%s, '2024-01-01T00:00:00+00:00', '2024-01-01T00:00:00+00:00')"
|
||||
% (columns, placeholders),
|
||||
tuple(values.values()),
|
||||
)
|
||||
return cursor.lastrowid
|
||||
finally:
|
||||
conn.close()
|
||||
|
||||
|
||||
def golden_market():
|
||||
"""The four transactions of docs/spec.md section 6.4 on one account."""
|
||||
market_id = create_market("Børs_01")
|
||||
create_transaction(market_id=market_id, date="2024-01-10",
|
||||
leg_in_sats=100000000, leg_in_ore=20000000)
|
||||
create_transaction(market_id=market_id, date="2024-04-10",
|
||||
leg_in_sats=100000000, leg_in_ore=50000000)
|
||||
create_transaction(market_id=market_id, date="2024-08-10",
|
||||
leg_in_sats=50000000, leg_in_ore=20000000)
|
||||
create_transaction(market_id=market_id, date="2024-11-10",
|
||||
leg_in_ore=50000000, leg_out_sats=100000000, fee_ore=500000)
|
||||
return market_id
|
||||
|
||||
|
||||
def lots_of(market_id):
|
||||
conn = database.connect()
|
||||
try:
|
||||
return [dict(row) for row in conn.execute(
|
||||
"SELECT * FROM lots WHERE market_id = ? ORDER BY id", (market_id,)
|
||||
).fetchall()]
|
||||
finally:
|
||||
conn.close()
|
||||
|
||||
|
||||
def consumptions(tx_id):
|
||||
conn = database.connect()
|
||||
try:
|
||||
return [dict(row) for row in conn.execute(
|
||||
"SELECT * FROM lot_consumptions WHERE tx_id = ? ORDER BY id", (tx_id,)
|
||||
).fetchall()]
|
||||
finally:
|
||||
conn.close()
|
||||
|
||||
|
||||
def snapshot():
|
||||
conn = database.connect()
|
||||
try:
|
||||
lots = [tuple(row) for row in conn.execute(
|
||||
"SELECT * FROM lots ORDER BY id").fetchall()]
|
||||
consumed = [tuple(row) for row in conn.execute(
|
||||
"SELECT * FROM lot_consumptions ORDER BY id").fetchall()]
|
||||
finally:
|
||||
conn.close()
|
||||
return lots, consumed
|
||||
|
||||
|
||||
class LedgerTestCase(unittest.TestCase):
|
||||
def setUp(self):
|
||||
self._directory = tempfile.TemporaryDirectory()
|
||||
os.environ["DATABASE_PATH"] = os.path.join(self._directory.name, "test.sqlite3")
|
||||
|
||||
def tearDown(self):
|
||||
os.environ.pop("DATABASE_PATH", None)
|
||||
self._directory.cleanup()
|
||||
|
||||
def test_golden_example_consumes_by_method(self):
|
||||
market_id = golden_market()
|
||||
expected = {"FIFO": 20000000, "LIFO": 45000000, "HIFO": 50000000}
|
||||
for method, cost_ore in expected.items():
|
||||
database.set_setting("lot_method", method)
|
||||
ledger.rebuild()
|
||||
rows = consumptions(4)
|
||||
self.assertEqual(sum(row["sats"] for row in rows), 100000000, method)
|
||||
self.assertEqual(sum(row["cost_ore"] for row in rows), cost_ore, method)
|
||||
self.assertEqual(
|
||||
sum(lot["sats_remaining"] for lot in lots_of(market_id)), 150000000, method
|
||||
)
|
||||
|
||||
def test_partial_consumption_rounds_and_keeps_every_ore(self):
|
||||
market_id = create_market("Lommebok", kind="wallet")
|
||||
create_transaction(market_id=market_id, date="2024-01-01",
|
||||
leg_in_sats=3, leg_in_ore=100)
|
||||
first = create_transaction(market_id=market_id, date="2024-02-01",
|
||||
leg_in_ore=50, leg_out_sats=1)
|
||||
second = create_transaction(market_id=market_id, date="2024-03-01",
|
||||
leg_in_ore=50, leg_out_sats=1)
|
||||
third = create_transaction(market_id=market_id, date="2024-04-01",
|
||||
leg_in_ore=50, leg_out_sats=1)
|
||||
ledger.rebuild()
|
||||
self.assertEqual([row["cost_ore"] for row in consumptions(first)], [33])
|
||||
self.assertEqual([row["cost_ore"] for row in consumptions(second)], [34])
|
||||
self.assertEqual([row["cost_ore"] for row in consumptions(third)], [33])
|
||||
lot = lots_of(market_id)[0]
|
||||
self.assertEqual((lot["sats_remaining"], lot["cost_ore_remaining"]), (0, 0))
|
||||
|
||||
def test_consuming_across_three_lots(self):
|
||||
market_id = create_market("Børs_01")
|
||||
for day, ore in (("2024-01-01", 100), ("2024-02-01", 200), ("2024-03-01", 300)):
|
||||
create_transaction(market_id=market_id, date=day, leg_in_sats=1, leg_in_ore=ore)
|
||||
sale = create_transaction(market_id=market_id, date="2024-04-01",
|
||||
leg_in_ore=1000, leg_out_sats=3)
|
||||
ledger.rebuild()
|
||||
rows = consumptions(sale)
|
||||
self.assertEqual([row["sats"] for row in rows], [1, 1, 1])
|
||||
self.assertEqual([row["cost_ore"] for row in rows], [100, 200, 300])
|
||||
self.assertEqual([row["auto"] for row in rows], [1, 1, 1])
|
||||
|
||||
def test_hand_picked_lot_overrides_the_method(self):
|
||||
market_id = create_market("Børs_01")
|
||||
bought = [
|
||||
create_transaction(market_id=market_id, date=day, leg_in_sats=1, leg_in_ore=ore)
|
||||
for day, ore in (("2024-01-01", 100), ("2024-02-01", 200), ("2024-03-01", 300))
|
||||
]
|
||||
sale = create_transaction(market_id=market_id, date="2024-04-01",
|
||||
leg_in_ore=1000, leg_out_sats=2)
|
||||
conn = database.connect()
|
||||
try:
|
||||
with conn:
|
||||
conn.execute(
|
||||
"INSERT INTO lot_picks (tx_id, origin_tx_id, origin_seq, sats)"
|
||||
" VALUES (?, ?, 0, 1)",
|
||||
(sale, bought[1]),
|
||||
)
|
||||
finally:
|
||||
conn.close()
|
||||
ledger.rebuild()
|
||||
rows = consumptions(sale)
|
||||
self.assertEqual([row["auto"] for row in rows], [0, 1])
|
||||
self.assertEqual([row["cost_ore"] for row in rows], [200, 100])
|
||||
|
||||
def test_shortfall_names_the_missing_sats(self):
|
||||
market_id = create_market("Lommebok", kind="wallet")
|
||||
create_transaction(market_id=market_id, date="2024-01-01",
|
||||
leg_in_sats=1, leg_in_ore=100)
|
||||
create_transaction(market_id=market_id, date="2024-02-01",
|
||||
leg_in_ore=100, leg_out_sats=2)
|
||||
with self.assertRaises(ledger.LedgerError) as caught:
|
||||
ledger.rebuild()
|
||||
self.assertIn("1 sats", str(caught.exception))
|
||||
|
||||
def test_transfer_mirrors_date_and_cost(self):
|
||||
source = create_market("Børs_01")
|
||||
destination = create_market("Lommebok", kind="wallet")
|
||||
create_transaction(market_id=source, date="2024-01-10",
|
||||
leg_in_sats=100000000, leg_in_ore=20000000)
|
||||
transfer = create_transaction(market_id=source, date="2024-06-01",
|
||||
type="transfer_out", leg_out_sats=100000000,
|
||||
fee_sats=1000, fee_ore=50000,
|
||||
to_market_id=destination, transfer_group="group-1")
|
||||
# The API writes the generated transfer_in row together with the transfer_out.
|
||||
create_transaction(market_id=destination, date="2024-06-01", type="transfer_in",
|
||||
leg_in_sats=99999000, fee_sats=1000, fee_ore=50000,
|
||||
to_market_id=source, transfer_group="group-1", generated=1)
|
||||
ledger.rebuild()
|
||||
self.assertEqual(
|
||||
sum(row["sats"] for row in consumptions(transfer)), 100000000
|
||||
)
|
||||
self.assertEqual(
|
||||
sum(row["cost_ore"] for row in consumptions(transfer)), 20000000
|
||||
)
|
||||
source_lot = lots_of(source)[0]
|
||||
mirror = lots_of(destination)[0]
|
||||
self.assertEqual(source_lot["sats_remaining"], 0)
|
||||
self.assertEqual(mirror["acquired_date"], "2024-01-10")
|
||||
self.assertEqual(mirror["source_lot_id"], source_lot["id"])
|
||||
self.assertEqual(mirror["sats_original"], 99999000)
|
||||
self.assertEqual(mirror["cost_ore_original"], 20050000)
|
||||
|
||||
def test_rebuild_twice_gives_the_same_ledger(self):
|
||||
golden_market()
|
||||
ledger.rebuild()
|
||||
first = snapshot()
|
||||
ledger.rebuild()
|
||||
self.assertEqual(snapshot(), first)
|
||||
|
||||
def test_holdings_before_and_after_the_sale(self):
|
||||
market_id = golden_market()
|
||||
ledger.rebuild()
|
||||
self.assertEqual(ledger.sats_in_market(market_id, "2024-11-09"), 250000000)
|
||||
self.assertEqual(ledger.sats_in_market(market_id, "2024-11-10"), 150000000)
|
||||
self.assertEqual(ledger.holdings_at("2024-12-31"), {market_id: 150000000})
|
||||
self.assertEqual(ledger.sats_on_hand(), {market_id: 150000000})
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
unittest.main()
|
||||
Reference in new issue
Block a user