add LOGBAR_ANITMATION env control (#37)

Signed-off-by: Qubitium <qubitium@modelcloud.ai>

Author: Qubitium

README.md

@@ -23,6 +23,7 @@
 - Stackable progress bars that stay anchored while your logs flow freely.
 - Built-in styling for progress bar fills, colors, gradients, and head glyphs.
 - Animated progress titles with a subtle sweeping highlight.
+  Set `LOGBAR_ANIMATION=0` to disable the highlight animation.
 - Column-aware table printer with spans, width hints, and `fit` sizing.
 - Zero dependencies; works anywhere Python runs.
 
@@ -128,7 +129,7 @@ with log.spinner("Loading model") as spinner:
     warm_up()
 ```
 
-The rolling bar animates automatically while attached. Close it explicitly with `spinner.close()` if you are not using the context manager.
+The rolling bar animates automatically while attached. Close it explicitly with `spinner.close()` if you are not using the context manager. Set `LOGBAR_ANIMATION=0` to disable the title highlight sweep on progress labels.
 
 ### Multiple Progress Bars
 

logbar/progress.py

@@ -4,13 +4,15 @@
 # Contact: qubitium@modelcloud.ai, x.com/qubitium
 
 import datetime
+import os
 import re
 import sys
 import time
 import threading
 from contextlib import contextmanager, nullcontext
 from dataclasses import dataclass, replace
 from enum import Enum
+from functools import lru_cache
 from typing import Iterable, Optional, Union, TYPE_CHECKING, Sequence
 from warnings import warn
 
@@ -74,6 +76,12 @@ def _iter_ansi_tokens(text: str):
         i += 1
 
 
+@lru_cache(maxsize=1)
+def _env_animation_enabled() -> bool:
+    value = os.environ.get("LOGBAR_ANIMATION", "1")
+    return str(value).strip().lower() not in {"0", "false", "off", "no"}
+
+
 def _fg_256(code: int) -> str:
     return f"\033[38;5;{code}m"
 
@@ -878,6 +886,8 @@ def _truncate_ansi(self, text: str, limit: int) -> str:
         return ''.join(result)
 
     def _should_animate_title(self) -> bool:
+        if not _env_animation_enabled():
+            return False
         isatty = getattr(sys.stdout, "isatty", None)
         if not callable(isatty):
             return False

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "LogBar"
-version = "0.2.2"
+version = "0.2.3"
 description = "A unified Logger and ProgressBar util with zero dependencies."
 readme = "README.md"
 requires-python = ">=3"

tests/test_progress.py

@@ -3,6 +3,7 @@
 # SPDX-License-Identifier: Apache-2.0
 # Contact: qubitium@modelcloud.ai, x.com/qubitium
 
+import subprocess
 import random
 import re
 import sys
@@ -139,6 +140,36 @@ def test_title_animation_skips_ansi_sequences(self):
         with redirect_stdout(StringIO()):
             pb.close()
 
+    def test_title_animation_respects_logbar_animation_env(self):
+        script = (
+            "from types import SimpleNamespace\n"
+            "import sys\n"
+            "from logbar.progress import ProgressBar\n"
+            "pb = ProgressBar(range(1)).manual()\n"
+            "sys.stdout = SimpleNamespace(isatty=lambda: True, write=lambda *_: None, flush=lambda: None)\n"
+            "sys.__stdout__.write('1\\n' if pb._should_animate_title() else '0\\n')\n"
+        )
+
+        enabled = subprocess.run(
+            [sys.executable, "-c", script],
+            cwd="/root/LogBar",
+            capture_output=True,
+            text=True,
+            env={},
+            check=True,
+        )
+        self.assertEqual(enabled.stdout.strip(), "1")
+
+        disabled = subprocess.run(
+            [sys.executable, "-c", script],
+            cwd="/root/LogBar",
+            capture_output=True,
+            text=True,
+            env={"LOGBAR_ANIMATION": "0"},
+            check=True,
+        )
+        self.assertEqual(disabled.stdout.strip(), "0")
+
     def test_draw_respects_terminal_width(self):
         pb = log.pb(100).title("TITLE").subtitle("SUBTITLE").manual()
         pb.current_iter_step = 50