trainlog/tests/test_equipment_associations_exchange.py

312 lines
17 KiB
Python

"""Exercise the real desktop companion exporter/importer on temporary DBs."""
import importlib.util
import json
import sqlite3
import subprocess
import sys
import tempfile
from pathlib import Path
ROOT = Path(__file__).resolve().parents[1]
sys.path.insert(0, str(ROOT / "tools"))
SPEC = importlib.util.spec_from_file_location(
"import_equipment_associations",
ROOT / "tools/import_equipment_associations.py",
)
ASSOCIATIONS = importlib.util.module_from_spec(SPEC)
SPEC.loader.exec_module(ASSOCIATIONS)
SOURCE_ID = "ex_43c7375f-934c-4650-930c-45807d2f2929"
CANONICAL_ID = "ex_2d488c08-194c-4051-a3c9-34471646c1d3"
def make_db(path, equipment):
db = sqlite3.connect(path)
db.executescript("""
CREATE TABLE exercises(id INTEGER PRIMARY KEY, exercise_id TEXT UNIQUE);
CREATE TABLE sessions(id INTEGER PRIMARY KEY, session_id TEXT UNIQUE, started_at TEXT);
CREATE TABLE session_exercises(id INTEGER PRIMARY KEY, entry_id TEXT UNIQUE, session_row_id INTEGER, exercise_row_id INTEGER, position INTEGER, equipment_id TEXT);
CREATE TABLE custom_equipment(equipment_id TEXT PRIMARY KEY, display_name TEXT NOT NULL, label_name TEXT NOT NULL, equipment_type TEXT NOT NULL, load_semantics TEXT NOT NULL);
""")
db.execute("INSERT INTO exercises VALUES(1,'ex_fixture')")
db.execute("INSERT INTO sessions VALUES(1,'se_fixture','2026-01-01T00:00:00+00:00')")
db.execute("INSERT INTO session_exercises VALUES(1,'sxe_fixture',1,1,0,?)", (equipment,))
db.execute("PRAGMA user_version=8")
db.commit(); db.close()
def main():
with tempfile.TemporaryDirectory() as directory:
directory = Path(directory)
source, target, artifact = directory / 'source.db', directory / 'target.db', directory / 'equipment.json'
make_db(source, 'leg_press'); make_db(target, 'leg_press')
subprocess.run([sys.executable, ROOT / 'tools/export_equipment_associations.py', artifact, '--database', source], check=True)
subprocess.run([sys.executable, ROOT / 'tools/import_equipment_associations.py', artifact, '--database', target], check=True)
assert sqlite3.connect(target).execute('SELECT equipment_id FROM session_exercises').fetchone()[0] == 'leg_press'
payload = json.loads(artifact.read_text()); payload['associations'][0] = {'session_id':'se_fixture','entry_id':'sxe_fixture','exercise_id':'ex_fixture','state':'cleared'}
artifact.write_text(json.dumps(payload))
conflict = subprocess.run([sys.executable, ROOT / 'tools/import_equipment_associations.py', artifact, '--database', target], text=True, capture_output=True)
assert conflict.returncode != 0 and 'conflit association' in conflict.stdout
assert sqlite3.connect(target).execute('SELECT equipment_id FROM session_exercises').fetchone()[0] == 'leg_press'
# A V2 entry ID is not sufficient identity: its exercise ID must also
# agree before an otherwise equal association is treated as a replay.
payload['associations'][0] = {'session_id':'se_fixture','entry_id':'sxe_fixture','exercise_id':'ex_other','state':'set','equipment_id':'leg_press'}
artifact.write_text(json.dumps(payload))
exercise_conflict = subprocess.run([sys.executable, ROOT / 'tools/import_equipment_associations.py', artifact, '--database', target], text=True, capture_output=True)
assert exercise_conflict.returncode != 0 and 'conflit exercice association' in exercise_conflict.stdout
assert sqlite3.connect(target).execute('SELECT equipment_id FROM session_exercises').fetchone()[0] == 'leg_press'
# A durable flattened alias is identity evidence before raw-ID
# comparison. The retired source must corroborate the canonical
# occurrence without requiring an optional V2 proof snapshot.
alias_target = directory / 'alias-target.db'
make_db(alias_target, 'leg_press')
alias_db = sqlite3.connect(alias_target)
alias_db.execute("UPDATE exercises SET exercise_id=?", (CANONICAL_ID,))
alias_db.execute(
"CREATE TABLE exercise_aliases(source_exercise_id TEXT PRIMARY KEY, "
"canonical_exercise_id TEXT NOT NULL REFERENCES exercises(exercise_id))"
)
alias_db.execute("INSERT INTO exercise_aliases VALUES(?,?)", (SOURCE_ID, CANONICAL_ID))
alias_db.execute("PRAGMA user_version=12")
alias_db.commit(); alias_db.close()
payload['associations'][0] = {
'session_id': 'se_fixture', 'entry_id': 'sxe_fixture',
'exercise_id': SOURCE_ID, 'state': 'set', 'equipment_id': 'leg_press',
}
artifact.write_text(json.dumps(payload))
alias_replay = subprocess.run(
[sys.executable, ROOT / 'tools/import_equipment_associations.py', artifact,
'--database', alias_target],
text=True, capture_output=True,
)
assert alias_replay.returncode == 0, alias_replay.stdout + alias_replay.stderr
with sqlite3.connect(alias_target) as alias_db:
assert alias_db.execute(
'SELECT exercise_id FROM exercises'
).fetchall() == [(CANONICAL_ID,)]
assert alias_db.execute(
'SELECT source_exercise_id,canonical_exercise_id FROM exercise_aliases'
).fetchall() == [(SOURCE_ID, CANONICAL_ID)]
# A different live canonical exercise remains a genuine conflict even
# when some unrelated alias is present.
with sqlite3.connect(alias_target) as alias_db:
alias_db.execute("INSERT INTO exercises VALUES(2,'ex_other')")
payload['associations'][0]['exercise_id'] = 'ex_other'
artifact.write_text(json.dumps(payload))
canonical_conflict = subprocess.run(
[sys.executable, ROOT / 'tools/import_equipment_associations.py', artifact,
'--database', alias_target],
text=True, capture_output=True,
)
assert canonical_conflict.returncode != 0
assert 'conflit exercice association' in canonical_conflict.stdout
# MACHINE_EXERCISE_MODEL_V1: a stale pre-split companion is accepted
# only for the closed set of completed stable entries and only when the
# current V3 snapshot proves the exact machine-specific target.
split_db = directory / 'machine-splits.db'
db = sqlite3.connect(split_db)
db.executescript("""
CREATE TABLE exercises(id INTEGER PRIMARY KEY, exercise_id TEXT UNIQUE);
CREATE TABLE sessions(id INTEGER PRIMARY KEY, session_id TEXT UNIQUE, started_at TEXT);
CREATE TABLE session_exercises(id INTEGER PRIMARY KEY, entry_id TEXT UNIQUE,
session_row_id INTEGER, exercise_row_id INTEGER, position INTEGER, equipment_id TEXT);
CREATE TABLE custom_equipment(equipment_id TEXT PRIMARY KEY, display_name TEXT NOT NULL,
label_name TEXT NOT NULL, equipment_type TEXT NOT NULL, load_semantics TEXT NOT NULL);
CREATE TABLE draft_session_exercises(entry_id TEXT PRIMARY KEY, exercise_id TEXT, equipment_id TEXT);
PRAGMA user_version=13;
""")
plate_old = 'ex_b432623f-bfe9-4daf-a653-60ec7fdffbde'
plate_new = 'ex_0e26c06f-a458-40a4-be20-4ed219ede30d'
walk_old = 'ex_b1e6ffc6-75b5-45ff-a3c0-e7433c58013d'
treadmill_new = 'ex_f01d2a46-6984-4dec-8934-4d82fca6dfc2'
seated_leg = 'ex_617007f9-7420-4408-91b9-8ffb77900f13'
rear_delt = 'ex_4cd2433e-80b1-478a-b8df-487bf6014ce6'
ids = [plate_new, walk_old, treadmill_new, seated_leg, rear_delt, 'ex_unrelated']
db.executemany('INSERT INTO exercises VALUES(?,?)', enumerate(ids, 1))
sessions = [
('se_c0d07454-b58b-403e-8b79-744619815fc5', '2026-09-07T19:27:35+02:00'),
('se_ac3908d6-8e3e-4ac6-81a6-62dc2c39075a', '2026-09-08T11:25:30+02:00'),
]
db.executemany('INSERT INTO sessions(id,session_id,started_at) VALUES(?,?,?)',
[(i, *row) for i, row in enumerate(sessions, 1)])
row_by_id = {value: index for index, value in enumerate(ids, 1)}
occurrences = [
('sxe_draft_legacy_7', 1, plate_new, 0, 'plate_loaded_leg_press'),
('sxe_093c1331-beaa-4b69-91b3-240292709be6', 1, treadmill_new, 1, 'treadmill'),
('sxe_draft_legacy_1', 1, walk_old, 2, None),
('sxe_draft_legacy_3', 1, seated_leg, 3, 'seated_leg_curl'),
('sxe_8b0b1722-7c32-4364-aefa-b4825fe681d7', 2, rear_delt, 0, None),
]
db.executemany(
'INSERT INTO session_exercises(entry_id,session_row_id,exercise_row_id,position,equipment_id) VALUES(?,?,?,?,?)',
[(entry, session, row_by_id[exercise], position, equipment)
for entry, session, exercise, position, equipment in occurrences])
db.execute("INSERT INTO draft_session_exercises VALUES('sxe_draft_current',?,?)",
(walk_old, 'treadmill'))
db.commit(); db.close()
split_artifact = directory / 'stale-machine-associations.json'
split_payload = {
'format': 'trainlog-equipment-associations', 'version': 2,
'generated_at': '2026-09-12T08:05:57+02:00',
'associations': [
{'session_id': sessions[0][0], 'entry_id': 'sxe_draft_legacy_7',
'exercise_id': plate_old, 'state': 'set', 'equipment_id': 'plate_loaded_leg_press'},
{'session_id': sessions[0][0], 'entry_id': 'sxe_093c1331-beaa-4b69-91b3-240292709be6',
'exercise_id': walk_old, 'state': 'set', 'equipment_id': 'treadmill'},
{'session_id': sessions[0][0], 'entry_id': 'sxe_draft_legacy_1',
'exercise_id': walk_old, 'state': 'cleared'},
{'session_id': sessions[0][0], 'entry_id': 'sxe_draft_legacy_3',
'exercise_id': seated_leg, 'state': 'set', 'equipment_id': 'seated_leg_curl'},
{'session_id': sessions[1][0], 'entry_id': 'sxe_8b0b1722-7c32-4364-aefa-b4825fe681d7',
'exercise_id': rear_delt, 'state': 'cleared'},
],
}
split_artifact.write_text(json.dumps(split_payload))
proof = directory / 'current-machine-v3.json'
proof.write_text(json.dumps({
'format': 'trainlog-mobile-export', 'version': 3,
'generated_at': '2026-09-12T09:26:00+02:00', 'exercises': [],
'body_observations': [], 'sessions': [
{'session_id': session_id, 'exercises': [
{'entry_id': entry, 'exercise_id': exercise}
for entry, session, exercise, _position, _equipment in occurrences
if session == session_index
]}
for session_index, (session_id, _started) in enumerate(sessions, 1)
],
}))
for _ in range(2):
accepted = subprocess.run(
[sys.executable, ROOT / 'tools/import_equipment_associations.py', split_artifact,
'--database', split_db, '--mobile-export', proof],
text=True, capture_output=True,
)
assert accepted.returncode == 0, accepted.stdout + accepted.stderr
with sqlite3.connect(split_db) as db:
assert db.execute('SELECT exercise_id,equipment_id FROM draft_session_exercises').fetchone() == (walk_old, 'treadmill')
assert db.execute('SELECT exercise_id FROM exercises WHERE exercise_id=?', (seated_leg,)).fetchone() == (seated_leg,)
assert db.execute('SELECT equipment_id FROM session_exercises WHERE entry_id=?',
('sxe_8b0b1722-7c32-4364-aefa-b4825fe681d7',)).fetchone() == (None,)
conflict_payload = json.loads(split_artifact.read_text())
conflict_payload['associations'][0]['exercise_id'] = 'ex_unrelated'
split_artifact.write_text(json.dumps(conflict_payload))
true_conflict = subprocess.run(
[sys.executable, ROOT / 'tools/import_equipment_associations.py', split_artifact,
'--database', split_db, '--mobile-export', proof],
text=True, capture_output=True,
)
assert true_conflict.returncode != 0
assert 'conflit exercice association' in true_conflict.stdout
# The importer must validate the entire artifact before applying its
# first otherwise-valid association. v2 cannot transport custom IDs.
prevalidation_artifact = directory / 'prevalidation-rejected.json'
prevalidation_payload = {
'format': 'trainlog-equipment-associations',
'version': 2,
'generated_at': '2026-01-01T00:00:00+00:00',
'associations': [
{'session_id': 'se_fixture', 'entry_id': 'sxe_fixture',
'exercise_id': 'ex_fixture', 'state': 'set', 'equipment_id': 'leg_press'},
{'session_id': 'se_later', 'entry_id': 'sxe_later',
'exercise_id': 'ex_later', 'state': 'set', 'equipment_id': 'custom_rack'},
],
}
prevalidation_artifact.write_text(json.dumps(prevalidation_payload))
rejected = subprocess.run(
[sys.executable, ROOT / 'tools/import_equipment_associations.py', prevalidation_artifact, '--database', target],
text=True,
capture_output=True,
)
assert rejected.returncode != 0
assert 'session_id=se_later' in rejected.stdout
assert 'entry_id=sxe_later' in rejected.stdout
assert 'equipment_id=custom_rack' in rejected.stdout
assert sqlite3.connect(target).execute('SELECT equipment_id FROM session_exercises').fetchone()[0] == 'leg_press'
# Definition-v1 is ordered before unchanged association-v2, so the
# exporter admits a locally-defined custom stable ID.
custom_source, custom_target = directory / 'custom-source.db', directory / 'custom-target.db'
make_db(custom_source, 'custom_rack'); make_db(custom_target, None)
custom_db = sqlite3.connect(custom_source)
custom_db.execute("INSERT INTO custom_equipment VALUES('custom_rack','Rack','Rack','rack','none')")
custom_db.commit(); custom_db.close()
custom_artifact = directory / 'custom-equipment.json'
exported = subprocess.run(
[sys.executable, ROOT / 'tools/export_equipment_associations.py', custom_artifact, '--database', custom_source],
text=True,
capture_output=True,
)
assert exported.returncode == 0, exported.stdout + exported.stderr
assert json.loads(custom_artifact.read_text())['associations'][0]['equipment_id'] == 'custom_rack'
# A complete causal envelope may contain an older association snapshot
# for a session whose tombstone was applied earlier in the transaction.
# The same companion remains invalid as a standalone import.
deleted_session = 'se_deleted'
deleted_entry = 'sxe_deleted'
dominated_payload = {
'format': 'trainlog-equipment-associations',
'version': 2,
'generated_at': '2026-01-01T00:00:00+00:00',
'associations': [{
'session_id': deleted_session,
'entry_id': deleted_entry,
'exercise_id': 'ex_fixture',
'state': 'set',
'equipment_id': 'leg_press',
}],
}
causal_db = sqlite3.connect(':memory:')
causal_db.executescript("""
CREATE TABLE exercises(id INTEGER PRIMARY KEY, exercise_id TEXT UNIQUE);
CREATE TABLE sessions(id INTEGER PRIMARY KEY, session_id TEXT UNIQUE);
CREATE TABLE session_exercises(
id INTEGER PRIMARY KEY,
entry_id TEXT UNIQUE,
session_row_id INTEGER,
exercise_row_id INTEGER,
equipment_id TEXT
);
CREATE TABLE custom_equipment(equipment_id TEXT PRIMARY KEY);
CREATE TABLE sync_causal_state(
target_kind TEXT,
target_id TEXT,
current_revision_id TEXT,
deleted INTEGER,
operation_id TEXT,
PRIMARY KEY(target_kind, target_id)
);
""")
causal_db.execute(
"INSERT INTO sync_causal_state VALUES('session',?,'del_fixture',1,'del_fixture')",
(deleted_session,),
)
try:
ASSOCIATIONS.apply_associations(
causal_db,
dominated_payload,
{'leg_press'},
{(deleted_session, deleted_entry): 'ex_fixture'},
)
raise AssertionError('standalone missing association was accepted')
except ValueError as error:
assert 'entrée séance inconnue' in str(error)
assert ASSOCIATIONS.apply_associations(
causal_db,
dominated_payload,
{'leg_press'},
{(deleted_session, deleted_entry): 'ex_fixture'},
complete_causal_envelope=True,
) == 1
causal_db.close()
print('PASS equipment association exchange')
if __name__ == '__main__': main()