jsonjsdb 0.7.2__tar.gz → 0.7.4__tar.gz

{jsonjsdb-0.7.2 → jsonjsdb-0.7.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jsonjsdb
-Version: 0.7.2
+Version: 0.7.4
 Summary: Python library for JSONJS database loading
 Project-URL: Homepage, https://github.com/datannur/jsonjsdb
 Project-URL: Repository, https://github.com/datannur/jsonjsdb
@@ -172,8 +172,14 @@ db.save()
 # Disable tracking
 db.save(track_evolution=False)
 
+# Skip .json.js files (faster, smaller output)
+db.save(write_js=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.2 → jsonjsdb-0.7.4}/README.md

@@ -147,8 +147,14 @@ db.save()
 # Disable tracking
 db.save(track_evolution=False)
 
+# Skip .json.js files (faster, smaller output)
+db.save(write_js=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.2 → jsonjsdb-0.7.4}/pyproject.toml

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

{jsonjsdb-0.7.2 → jsonjsdb-0.7.4}/src/jsonjsdb/database.py

@@ -106,6 +106,8 @@ class Jsonjsdb:
         *,
         track_evolution: bool = True,
         evolution_xlsx: Path | str | None = None,
+        timestamp: int | None = None,
+        write_js: bool = True,
     ) -> None:
         """Save all tables to disk with optional evolution tracking.
 
@@ -116,6 +118,8 @@ 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
+            write_js: If True, write both .json and .json.js (default: True)
         """
         save_path = Path(path) if path else self._path
 
@@ -131,7 +135,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,11 +147,12 @@ 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")
-            write_table_jsonjs(persistable_df, name, save_path / f"{name}.json.js")
+            if write_js:
+                write_table_jsonjs(persistable_df, name, save_path / f"{name}.json.js")
             table_names.append(name)
 
             # Update snapshot for next comparison
@@ -159,10 +164,12 @@ class Jsonjsdb:
             existing_entries = load_evolution(save_path, xlsx_path)
             all_entries = existing_entries + new_entries
             save_evolution(all_entries, save_path, xlsx_path)
-            if "evolution" not in table_names:
+            if "evolution" not in table_names:  # pragma: no branch
                 table_names.append("evolution")
 
-        write_table_index(table_names, save_path / "__table__.json")
+        write_table_index(
+            table_names, save_path / "__table__.json", ts, write_js=write_js
+        )
 
         self._path = save_path
 

{jsonjsdb-0.7.2 → jsonjsdb-0.7.4}/src/jsonjsdb/evolution.py

@@ -144,9 +144,7 @@ def compare_datasets(
     map_new = _df_to_dict_by_id(new_df)
 
     # Determine all variables to compare
-    if old_df.is_empty():
-        variables = new_df.columns
-    elif new_df.is_empty():
+    if new_df.is_empty():
         variables = old_df.columns
     else:
         variables = list(set(old_df.columns) | set(new_df.columns))

{jsonjsdb-0.7.2 → jsonjsdb-0.7.4}/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,14 +33,27 @@ 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())
-    entries = [{"name": name, "last_modif": now} for name in sorted(tables)]
-
-    with open(path, "w") as f:
-        json.dump(entries, f, indent=2, ensure_ascii=False)
-        f.write("\n")
+def write_table_index(
+    tables: list[str],
+    path: Path,
+    timestamp: Optional[int] = None,
+    *,
+    write_js: bool = True,
+) -> None:
+    """Write __table__.json and optionally __table__.json.js 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)
+        write_js: If True, also write __table__.json.js (default: True)
+    """
+    now = timestamp if timestamp is not None else int(time.time())
+    df = pl.DataFrame([{"name": name, "last_modif": now} for name in sorted(tables)])
+
+    write_table_json(df, path)
+    if write_js:
+        write_table_jsonjs(df, "__table__", path.with_suffix(".json.js"))
 
 
 def _prepare_df_for_write(df: pl.DataFrame) -> pl.DataFrame: