askrobots / dbbasic-object-server
Public
Runs live, versioned Python application objects on one VM, with a suite of apps: projects, notes, tasks, files and more.
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
| 1 | import hashlib |
| 2 | |
| 3 | import pytest |
| 4 | |
| 5 | import object_versions |
| 6 | |
| 7 | |
| 8 | def 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 | |
| 32 | def 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 | |
| 52 | def 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 | |
| 62 | def 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 | |
| 74 | def 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 | |
| 93 | def 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 | |
| 101 | def 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 | |
| 112 | def 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 | |
| 122 | def 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 | |
| 145 | def 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 | ) |
| 167 | def 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 | |
| 176 | def 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 | |
| 183 | def 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 | |
| 202 | def 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 |