quantilica-cli 0.10.0__tar.gz → 0.10.1__tar.gz

{quantilica_cli-0.10.0 → quantilica_cli-0.10.1}/CHANGELOG.md

@@ -5,6 +5,14 @@ Todas as mudanças notáveis deste projeto serão documentadas neste arquivo.
 O formato segue [Keep a Changelog](https://keepachangelog.com/pt-BR/1.1.0/),
 e este projeto adere ao [Semantic Versioning](https://semver.org/lang/pt-BR/).
 
+## [0.10.1] - 2026-10-08
+
+### Corrigido
+
+- `sdk`: `check_entry` considera `local.exists() or sidecar.exists()`, preservando
+  o status de `manifest-fresh` em ambientes de ingestão efêmera sem forçar
+  re-download redundante quando o dado bruto já foi espelhado.
+
 ## [0.10.0] - 2026-10-07
 
 ### Adicionado

{quantilica_cli-0.10.0 → quantilica_cli-0.10.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: quantilica-cli
-Version: 0.10.0
+Version: 0.10.1
 Summary: Unified CLI for Quantilica open data fetchers
 Author-email: "Komesu, D.K." <daniel@dkko.me>
 License-Expression: MIT
@@ -16,7 +16,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Typing :: Typed
 Requires-Python: >=3.12
-Requires-Dist: quantilica-core>=0.10.0
+Requires-Dist: quantilica-core>=0.10.1
 Requires-Dist: rich>=13.0.0
 Requires-Dist: typer>=0.15.0
 Description-Content-Type: text/markdown

{quantilica_cli-0.10.0 → quantilica_cli-0.10.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "quantilica-cli"
-version = "0.10.0"
+version = "0.10.1"
 description = "Unified CLI for Quantilica open data fetchers"
 readme = "README.md"
 authors = [{ name = "Komesu, D.K.", email = "daniel@dkko.me" }]
@@ -20,7 +20,7 @@ classifiers = [
     "Programming Language :: Python :: 3.13",
 ]
 dependencies = [
-    "quantilica-core>=0.10.0",
+    "quantilica-core>=0.10.1",
     "rich>=13.0.0",
     "typer>=0.15.0",
 ]

{quantilica_cli-0.10.0 → quantilica_cli-0.10.1}/src/quantilica/cli/sdk.py

@@ -28,6 +28,7 @@ from quantilica.core.http import (
     resolve_verify_from_env,
 )
 from quantilica.core.logging import get_logger
+from quantilica.core.manifests import manifest_sidecar_path
 from quantilica.core.storage import (
     StampedDataRepository,
     build_stamped_filename,
@@ -166,7 +167,9 @@ class CheckPlanItem:
         remote_etag: Remote ETag header, or None.
         remote_last_modified: Remote Last-Modified header, or None.
         remote_size: Remote Content-Length, or None.
-        local_exists: Whether the local file already exists.
+        local_exists: Whether the artifact already exists locally — this
+            covers either the raw file itself or its ephemeral ``.manifest.json``
+            sidecar marker (file deleted for retention, sidecar still fresh).
         action: ``"download"`` or ``"skip-up-to-date"``.
         reason: Machine-readable reason for the action.
         entry: Original dataset entry (allows ``sync --from-plan`` round-trip).
@@ -983,9 +986,13 @@ class FetcherApp:
             size = None
         last_modified = _parse_head_date(head.headers.get("Last-Modified"))
         local = self.path_builder(output_dir, entry, last_modified)
-        exists = local.exists()
+        sidecar = manifest_sidecar_path(local)
+        exists = local.exists() or sidecar.exists()
         if exists and not is_remote_more_recent(head, local):
-            action, reason = "skip-up-to-date", "local-fresh"
+            if local.exists():
+                action, reason = "skip-up-to-date", "local-fresh"
+            else:
+                action, reason = "skip-up-to-date", "manifest-fresh"
         else:
             action = "download"
             reason = "not-present" if not exists else "remote-newer"

{quantilica_cli-0.10.0 → quantilica_cli-0.10.1}/tests/test_sdk.py

@@ -435,3 +435,65 @@ def test_default_client_attempts_env_override(monkeypatch):
     monkeypatch.delenv("QUANTILICA_CA_BUNDLE", raising=False)
     monkeypatch.setenv("QUANTILICA_HTTP_ATTEMPTS", "9")
     assert default_client().attempts == 9
+
+
+def test_check_entry_ephemeral_manifest_fresh(tmp_path: Path):
+    """Raw file deleted but sidecar manifest survives -> manifest-fresh skip."""
+    from quantilica.core.manifests import (
+        DownloadManifest,
+        SourceMetadata,
+        write_manifest_sidecar,
+    )
+
+    app = make_app(client=_mock_client())
+    entry = sample_list_datasets("exp")[0]
+    local = default_path_builder(tmp_path, entry, dt.date(2024, 1, 1))
+    local.parent.mkdir(parents=True, exist_ok=True)
+    write_manifest_sidecar(
+        local,
+        DownloadManifest(
+            source_id="src",
+            dataset_id="ds",
+            url=entry["url"],
+            fetched_at="2024-01-02T00:00:00+00:00",
+            sha256="0" * 64,
+            size_bytes=10,
+            source_meta=SourceMetadata(
+                etag='"abc123"',
+                last_modified="Mon, 01 Jan 2024 00:00:00 GMT",
+            ),
+        ),
+    )
+    item = app.check_entry(entry, tmp_path)
+    assert item.action == "skip-up-to-date"
+    assert item.reason == "manifest-fresh"
+    assert item.local_exists is True
+
+
+def test_check_entry_ephemeral_stale_downloads(tmp_path: Path):
+    """Sidecar with stale metadata (remote ETag differs) -> download."""
+    from quantilica.core.manifests import (
+        DownloadManifest,
+        SourceMetadata,
+        write_manifest_sidecar,
+    )
+
+    app = make_app(client=_mock_client())
+    entry = sample_list_datasets("exp")[0]
+    local = default_path_builder(tmp_path, entry, dt.date(2024, 1, 1))
+    local.parent.mkdir(parents=True, exist_ok=True)
+    write_manifest_sidecar(
+        local,
+        DownloadManifest(
+            source_id="src",
+            dataset_id="ds",
+            url=entry["url"],
+            fetched_at="2023-12-31T00:00:00+00:00",
+            sha256="0" * 64,
+            size_bytes=10,
+            source_meta=SourceMetadata(etag='"outdated"', last_modified=None),
+        ),
+    )
+    item = app.check_entry(entry, tmp_path)
+    assert item.action == "download"
+    assert item.reason == "remote-newer"