Runs live, versioned Python application objects on one VM, with a suite of apps: projects, notes, tasks, files and more.

0 downloads

dbbasic-object-server/tests/test_object_versions.py
Download zip
Clone
Clone with git
git clone https://gitstable.com/git/askrobots/dbbasic-object-server.git
HTTPS
https://gitstable.com/git/askrobots/dbbasic-object-server.git
SSH
ssh://git@gitstable.com:2222/askrobots/dbbasic-object-server.git

Cloning needs no sign-in. Pushing over HTTPS asks for your username and an access token. SSH needs your key under SSH keys.

danq9 signup: the person chooses the password and name on the confirm page 83c7aa6 2 weeks, 5 days ago History
test_object_versions.py · 7.7 KB · 226 lines
1import hashlib
2
3import pytest
4
5import object_versions
6
7
8def test_save_first_version_creates_metadata_and_content_file(tmp_path):
9 manager = object_versions.VersionManager(tmp_path / "data")
10
11 version_id = manager.save_version(
12 object_id="basics_counter",
13 content="content v1",
14 author="system",
15 message="Initial version",
16 )
17
18 assert version_id == 1
19 version_dir = tmp_path / "data" / "versions" / "basics_counter"
20 metadata = version_dir / "metadata.tsv"
21 content = version_dir / "v1.txt"
22
23 assert metadata.exists()
24 assert content.read_text() == "content v1"
25
26 lines = metadata.read_text().strip().split("\n")
27 assert lines[0] == "version_id\ttimestamp\tauthor\tmessage\thash\tcorrelation_id"
28 assert lines[1].startswith("1\t")
29 assert "\tsystem\tInitial version\t" in lines[1]
30
31
32def test_save_version_records_correlation_id(tmp_path):
33 manager = object_versions.VersionManager(tmp_path / "data")
34 correlation_id = "123e4567-e89b-42d3-a456-426614174000"
35
36 manager.save_version(
37 "basics_counter",
38 "content v1",
39 "system",
40 "Initial version",
41 correlation_id=correlation_id,
42 )
43
44 version = manager.get_version("basics_counter", version_id=1)
45 history = manager.get_history("basics_counter")
46
47 assert version is not None
48 assert version["correlation_id"] == correlation_id
49 assert history[0]["correlation_id"] == correlation_id
50
51
52def test_save_multiple_versions_increment_ids(tmp_path):
53 manager = object_versions.VersionManager(tmp_path / "data")
54
55 v1 = manager.save_version("basics_counter", "content v1", "user", "v1")
56 v2 = manager.save_version("basics_counter", "content v2", "user", "v2")
57 v3 = manager.save_version("basics_counter", "content v3", "user", "v3")
58
59 assert [v1, v2, v3] == [1, 2, 3]
60
61
62def test_versions_are_independent_per_object(tmp_path):
63 manager = object_versions.VersionManager(tmp_path / "data")
64
65 obj1_v1 = manager.save_version("object_one", "one v1", "user", "one")
66 obj2_v1 = manager.save_version("object_two", "two v1", "user", "two")
67 obj1_v2 = manager.save_version("object_one", "one v2", "user", "one again")
68
69 assert obj1_v1 == 1
70 assert obj2_v1 == 1
71 assert obj1_v2 == 2
72
73
74def test_get_specific_and_latest_version(tmp_path):
75 manager = object_versions.VersionManager(tmp_path / "data")
76
77 manager.save_version("basics_counter", "content v1", "alice", "first")
78 version_id = manager.save_version("basics_counter", "content v2", "bob", "second")
79
80 latest = manager.get_version("basics_counter")
81 specific = manager.get_version("basics_counter", version_id=1)
82
83 assert latest is not None
84 assert latest["version_id"] == version_id
85 assert latest["content"] == "content v2"
86 assert latest["author"] == "bob"
87 assert specific is not None
88 assert specific["version_id"] == 1
89 assert specific["content"] == "content v1"
90 assert specific["author"] == "alice"
91
92
93def test_get_version_returns_none_for_missing_object_or_version(tmp_path):
94 manager = object_versions.VersionManager(tmp_path / "data")
95 manager.save_version("basics_counter", "content", "user", "message")
96
97 assert manager.get_version("missing_object") is None
98 assert manager.get_version("basics_counter", version_id=999) is None
99
100
101def test_history_is_newest_first_and_excludes_content(tmp_path):
102 manager = object_versions.VersionManager(tmp_path / "data")
103 for i in range(1, 6):
104 manager.save_version("basics_counter", f"content v{i}", f"user{i}", f"Version {i}")
105
106 history = manager.get_history("basics_counter", limit=2, offset=1)
107
108 assert [row["version_id"] for row in history] == [4, 3]
109 assert all("content" not in row for row in history)
110
111
112def test_hash_matches_saved_content(tmp_path):
113 manager = object_versions.VersionManager(tmp_path / "data")
114 manager.save_version("basics_counter", "content v1", "user", "message")
115
116 version = manager.get_version("basics_counter", version_id=1)
117
118 assert version is not None
119 assert version["hash"] == hashlib.sha256("content v1".encode()).hexdigest()
120
121
122def test_rollback_creates_new_version_with_old_content(tmp_path):
123 manager = object_versions.VersionManager(tmp_path / "data")
124 manager.save_version("basics_counter", "content v1", "user", "v1")
125 manager.save_version("basics_counter", "content v2", "user", "v2")
126 manager.save_version("basics_counter", "content v3", "user", "v3")
127
128 new_version = manager.rollback(
129 "basics_counter",
130 to_version=1,
131 author="rollback_user",
132 message="Rollback to v1",
133 )
134
135 assert new_version == 4
136 latest = manager.get_version("basics_counter")
137 assert latest is not None
138 assert latest["version_id"] == 4
139 assert latest["content"] == "content v1"
140 assert latest["author"] == "rollback_user"
141 assert latest["message"] == "Rollback to v1"
142 assert [row["version_id"] for row in manager.get_history("basics_counter")] == [4, 3, 2, 1]
143
144
145def test_rollback_missing_version_raises(tmp_path):
146 manager = object_versions.VersionManager(tmp_path / "data")
147 manager.save_version("basics_counter", "content", "user", "message")
148
149 with pytest.raises(object_versions.VersionNotFoundError):
150 manager.rollback("basics_counter", to_version=99, author="user", message="bad rollback")
151
152
153@pytest.mark.parametrize(
154 "object_id",
155 [
156 "",
157 "../outside",
158 "basics/counter",
159 "basics.counter",
160 "object id",
161 "object@station",
162 "object;drop",
163 "object\x00id",
164 "a" * 65,
165 ],
166)
167def test_invalid_object_ids_are_rejected(tmp_path, object_id):
168 manager = object_versions.VersionManager(tmp_path / "data")
169
170 with pytest.raises(object_versions.InvalidObjectIdError):
171 manager.save_version(object_id, "content", "user", "message")
172
173 assert not (tmp_path / "data" / "outside").exists()
174
175
176def test_missing_metadata_returns_empty_history(tmp_path):
177 manager = object_versions.VersionManager(tmp_path / "data")
178
179 assert manager.get_history("basics_counter") == []
180 assert manager.get_version("basics_counter") is None
181
182
183def test_malformed_metadata_rows_are_ignored(tmp_path):
184 manager = object_versions.VersionManager(tmp_path / "data")
185 version_dir = tmp_path / "data" / "versions" / "basics_counter"
186 version_dir.mkdir(parents=True)
187 (version_dir / "metadata.tsv").write_text(
188 "version_id\ttimestamp\tauthor\tmessage\thash\n"
189 "bad\t2026-01-01T00:00:00\tuser\tbad row\tbad-hash\n"
190 "1\t2026-01-01T00:00:01\tuser\tgood row\tgood-hash\n"
191 )
192 (version_dir / "v1.txt").write_text("good content")
193
194 history = manager.get_history("basics_counter")
195 version = manager.get_version("basics_counter", version_id=1)
196
197 assert [row["version_id"] for row in history] == [1]
198 assert version is not None
199 assert version["content"] == "good content"
200
201
202def test_legacy_metadata_without_correlation_id_still_reads(tmp_path):
203 manager = object_versions.VersionManager(tmp_path / "data")
204 version_dir = tmp_path / "data" / "versions" / "basics_counter"
205 version_dir.mkdir(parents=True)
206 (version_dir / "metadata.tsv").write_text(
207 "version_id\ttimestamp\tauthor\tmessage\thash\n"
208 "1\t2026-01-01T00:00:01\tuser\tlegacy row\tlegacy-hash\n"
209 )
210 (version_dir / "v1.txt").write_text("legacy content")
211
212 history = manager.get_history("basics_counter")
213 version = manager.get_version("basics_counter", version_id=1)
214
215 assert history == [
216 {
217 "version_id": 1,
218 "timestamp": "2026-01-01T00:00:01",
219 "author": "user",
220 "message": "legacy row",
221 "hash": "legacy-hash",
222 }
223 ]
224 assert version is not None
225 assert version["content"] == "legacy content"
226 assert "correlation_id" not in version