eolas-data 1.3.19__tar.gz → 1.3.20__tar.gz

{eolas_data-1.3.19 → eolas_data-1.3.20}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: eolas-data
-Version: 1.3.19
+Version: 1.3.20
 Summary: Python client for the eolas.fyi statistical data API (NZ + OECD; Australia on roadmap)
 Project-URL: Homepage, https://eolas.fyi
 Project-URL: Documentation, https://docs.eolas.fyi/

{eolas_data-1.3.19 → eolas_data-1.3.20}/eolas_data/__init__.py

@@ -15,7 +15,7 @@ from .exceptions import (
     WatermarkExpired,
 )
 
-__version__ = "1.3.19"
+__version__ = "1.3.20"
 
 __all__ = [
     "Client",

{eolas_data-1.3.19 → eolas_data-1.3.20}/eolas_data/cli.py

@@ -401,6 +401,10 @@ def download_cmd(
         False, "--no-progress",
         help="Disable the download progress bar (useful when output is captured by a log collector).",
     ),
+    show_progress: bool        = typer.Option(
+        False, "--progress",
+        help="Always show the download progress bar (even when stdout/stderr are not a TTY).",
+    ),
     api_key:     Optional[str]  = typer.Option(None, "--api-key"),
 ) -> None:
     """Download a dataset as a single file (Parquet, CSV, or GeoParquet).
@@ -438,6 +442,15 @@ def download_cmd(
     except EolasError as e:
         _bail(str(e), _exit_for(e))
 
+    if show_progress and no_progress:
+        _bail("--progress and --no-progress are mutually exclusive", EXIT_USAGE)
+    if show_progress:
+        _progress: Optional[bool] = True
+    elif no_progress:
+        _progress = False
+    else:
+        _progress = None
+
     if use_live:
         if freshness != "auto":
             err_console.print(
@@ -455,7 +468,7 @@ def download_cmd(
                 name,
                 path=out,
                 format=live_fmt,
-                progress=False if no_progress else None,
+                progress=_progress,
             )
         except EolasError as e:
             _bail(str(e), _exit_for(e))
@@ -474,7 +487,7 @@ def download_cmd(
                 freshness=freshness,
                 format=server_fmt,
                 path=out,
-                progress=False if no_progress else None,
+                progress=_progress,
             )
         except BulkUpgradeRequired as e:
             err_console.print(f"[red]error:[/red] {e}")
@@ -488,7 +501,7 @@ def download_cmd(
                     name,
                     path=out,
                     format=live_fmt,
-                    progress=False if no_progress else None,
+                    progress=_progress,
                 )
             except EolasError as e:
                 _bail(str(e), _exit_for(e))

{eolas_data-1.3.19 → eolas_data-1.3.20}/eolas_data/client.py

@@ -1296,7 +1296,9 @@ class Client:
             return False
         if "ipykernel" in sys.modules:
             return True
-        return sys.stdout.isatty()
+        # tqdm writes to stderr; many terminals/IDEs pipe stdout but keep stderr
+        # on the controlling TTY (Cursor, VS Code, script wrappers).
+        return sys.stderr.isatty() or sys.stdout.isatty()
 
     @staticmethod
     def _resolve_progress_phases(progress: ProgressControl) -> dict[str, bool]:
@@ -1401,8 +1403,10 @@ class Client:
             unit_scale=True,
             unit_divisor=1024,
             desc=label,
+            file=sys.stderr,
+            dynamic_ncols=True,
             disable=not show_progress,
-            leave=False,
+            leave=True,
         ) as bar:
             with dest.open("wb") as fh:
                 # 1 MiB chunks: responsive bar updates (bar refreshes ~once per

{eolas_data-1.3.19 → eolas_data-1.3.20}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "eolas-data"
-version = "1.3.19"
+version = "1.3.20"
 description = "Python client for the eolas.fyi statistical data API (NZ + OECD; Australia on roadmap)"
 readme = "README.md"
 license = { text = "MIT" }

{eolas_data-1.3.19 → eolas_data-1.3.20}/tests/test_progress.py

@@ -478,6 +478,20 @@ def test_progress_phase_selectors():
     assert Client._resolve_show_progress("download", "read") is False
 
 
+def test_progress_auto_detect_uses_stderr_tty():
+    """tqdm writes to stderr; progress should show when stderr is a TTY even if stdout is piped."""
+    from unittest.mock import patch
+    from eolas_data.client import Client
+
+    with patch("sys.stdout.isatty", return_value=False), \
+         patch("sys.stderr.isatty", return_value=True):
+        assert Client._progress_auto_detect() is True
+
+    with patch("sys.stdout.isatty", return_value=False), \
+         patch("sys.stderr.isatty", return_value=False):
+        assert Client._progress_auto_detect() is False
+
+
 def test_progress_resolver_detects_jupyter():
     """Jupyter wraps stdout so isatty() is False, but the user IS interactive
     and tqdm.auto can render a widget. Resolver must return True when