jsonjsdb 0.7.1__tar.gz → 0.7.3__tar.gz

{jsonjsdb-0.7.1 → jsonjsdb-0.7.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jsonjsdb
-Version: 0.7.1
+Version: 0.7.3
 Summary: Python library for JSONJS database loading
 Project-URL: Homepage, https://github.com/datannur/jsonjsdb
 Project-URL: Repository, https://github.com/datannur/jsonjsdb
@@ -174,6 +174,9 @@ db.save(track_evolution=False)
 
 # Use Excel as source (for easy editing of logs)
 db.save(evolution_xlsx=Path("path/to/evolution.xlsx"))
+
+# Override timestamp for deterministic outputs (useful for testing)
+db.save(timestamp=1741186800)
 ```
 
 When `evolution_xlsx` is provided:

{jsonjsdb-0.7.1 → jsonjsdb-0.7.3}/README.md

@@ -149,6 +149,9 @@ db.save(track_evolution=False)
 
 # Use Excel as source (for easy editing of logs)
 db.save(evolution_xlsx=Path("path/to/evolution.xlsx"))
+
+# Override timestamp for deterministic outputs (useful for testing)
+db.save(timestamp=1741186800)
 ```
 
 When `evolution_xlsx` is provided:

{jsonjsdb-0.7.1 → jsonjsdb-0.7.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "jsonjsdb"
-version = "0.7.1"
+version = "0.7.3"
 description = "Python library for JSONJS database loading"
 authors = [{ name = "datannur" }]
 readme = "README.md"

{jsonjsdb-0.7.1 → jsonjsdb-0.7.3}/src/jsonjsdb/database.py

@@ -106,6 +106,7 @@ class Jsonjsdb:
         *,
         track_evolution: bool = True,
         evolution_xlsx: Path | str | None = None,
+        timestamp: int | None = None,
     ) -> None:
         """Save all tables to disk with optional evolution tracking.
 
@@ -116,6 +117,7 @@ class Jsonjsdb:
             path: Target directory path (optional if already loaded from path)
             track_evolution: Enable change tracking (default: True)
             evolution_xlsx: Optional path for evolution.xlsx output
+            timestamp: Optional timestamp override for deterministic outputs
         """
         save_path = Path(path) if path else self._path
 
@@ -131,7 +133,7 @@ class Jsonjsdb:
             self._path is not None and save_path.resolve() == self._path.resolve()
         )
 
-        timestamp = get_timestamp()
+        ts = timestamp if timestamp is not None else get_timestamp()
         new_entries: list[EvolutionEntry] = []
 
         table_names = []
@@ -143,7 +145,7 @@ class Jsonjsdb:
             # Track evolution if enabled
             if track_evolution:
                 old_df = self._get_old_table(save_path, name, same_path)
-                entries = compare_datasets(old_df, persistable_df, timestamp, name)
+                entries = compare_datasets(old_df, persistable_df, ts, name)
                 new_entries.extend(entries)
 
             write_table_json(persistable_df, save_path / f"{name}.json")
@@ -162,7 +164,7 @@ class Jsonjsdb:
             if "evolution" not in table_names:
                 table_names.append("evolution")
 
-        write_table_index(table_names, save_path / "__table__.json")
+        write_table_index(table_names, save_path / "__table__.json", ts)
 
         self._path = save_path
 

{jsonjsdb-0.7.1 → jsonjsdb-0.7.3}/src/jsonjsdb/evolution.py

@@ -126,9 +126,12 @@ def compare_datasets(
     if entity.startswith("__"):
         return entries
 
-    if old_df.is_empty() and new_df.is_empty():
+    # Skip tracking for initial creation (no previous data)
+    if old_df.is_empty():
         return entries
 
+    # Normalize IDs for consistent comparison
+
     # Normalize id columns to string for consistent comparison
     old_df = _normalize_id_column(old_df)
     new_df = _normalize_id_column(new_df)

{jsonjsdb-0.7.1 → jsonjsdb-0.7.3}/src/jsonjsdb/writer.py

@@ -3,7 +3,7 @@
 import json
 import time
 from pathlib import Path
-from typing import Any
+from typing import Any, Optional
 
 import polars as pl
 
@@ -33,9 +33,17 @@ def write_table_jsonjs(df: pl.DataFrame, table_name: str, path: Path) -> None:
         f.write(content)
 
 
-def write_table_index(tables: list[str], path: Path) -> None:
-    """Write __table__.json with table metadata."""
-    now = int(time.time())
+def write_table_index(
+    tables: list[str], path: Path, timestamp: Optional[int] = None
+) -> None:
+    """Write __table__.json with table metadata.
+
+    Args:
+        tables: List of table names to include
+        path: Path to write __table__.json
+        timestamp: Optional timestamp override (uses current time if None)
+    """
+    now = timestamp if timestamp is not None else int(time.time())
     entries = [{"name": name, "last_modif": now} for name in sorted(tables)]
 
     with open(path, "w") as f: