asyncprogress 0.3.5__tar.gz → 0.3.6__tar.gz

{asyncprogress-0.3.5 → asyncprogress-0.3.6}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: asyncprogress
-Version: 0.3.5
-Summary: Async-aware progress bars for Python's asyncio ecosystem. Zero mandatory dependencies.
+Version: 0.3.6
+Summary: Async-aware progress bars for Python's asyncio ecosystem
 License: MIT
 License-File: LICENSE
-Keywords: asyncio,progress,progress-bar,async,tqdm
+Keywords: async,asyncio,progress,progress-bar,tqdm
 Author: AgentSoft
 Author-email: agentsoft@example.com
 Requires-Python: >=3.9,<4.0
@@ -19,9 +19,8 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
-Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Provides-Extra: color
-Requires-Dist: colorama (>=0.4.4) ; extra == "color"
 Project-URL: Homepage, https://github.com/agentsoft/asyncprogress
 Project-URL: Repository, https://github.com/agentsoft/asyncprogress
 Description-Content-Type: text/markdown
@@ -49,7 +48,3 @@ synchronous code. `asyncprogress` is built from the ground up for `asyncio`:
 ## Installation
 
 
-
-```bash
-pip install asyncprogress
-```

{asyncprogress-0.3.5 → asyncprogress-0.3.6}/README.md

@@ -20,8 +20,3 @@ synchronous code. `asyncprogress` is built from the ground up for `asyncio`:
 
 ## Installation
 
-
-
-```bash
-pip install asyncprogress
-```

{asyncprogress-0.3.5 → asyncprogress-0.3.6}/pyproject.toml

@@ -1,13 +1,13 @@
 [tool.poetry]
 name = "asyncprogress"
-version = "0.3.5"
-description = "Async-aware progress bars for Python's asyncio ecosystem. Zero mandatory dependencies."
+version = "0.3.6"
+description = "Async-aware progress bars for Python's asyncio ecosystem"
 authors = ["AgentSoft <agentsoft@example.com>"]
 readme = "README.md"
 license = "MIT"
 homepage = "https://github.com/agentsoft/asyncprogress"
 repository = "https://github.com/agentsoft/asyncprogress"
-keywords = ["asyncio", "progress", "progress-bar", "async", "tqdm"]
+keywords = ["async", "asyncio", "progress", "progress-bar", "tqdm"]
 classifiers = [
     "Development Status :: 4 - Beta",
     "Intended Audience :: Developers",
@@ -17,14 +17,13 @@ classifiers = [
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
-    "Topic :: Software Development :: Libraries",
+    "Topic :: Software Development :: Libraries :: Python Modules",
     "Framework :: AsyncIO",
 ]
 packages = [{include = "asyncprogress", from = "src"}]
 
 [tool.poetry.dependencies]
 python = "^3.9"
-colorama = {version = ">=0.4.4", optional = true}
 
 [tool.poetry.extras]
 color = ["colorama"]
@@ -42,19 +41,18 @@ build-backend = "poetry.core.masonry.api"
 [tool.pytest.ini_options]
 asyncio_mode = "auto"
 testpaths = ["tests"]
-addopts = "--tb=short"
 
 [tool.ruff]
 line-length = 100
 target-version = "py39"
 
 [tool.ruff.lint]
-select = ["E", "F", "I", "UP"]
+select = ["E", "F", "UP", "I"]
 ignore = ["E501"]
 
 [tool.coverage.run]
-source = ["src/asyncprogress"]
-omit = ["tests/*"]
+source = ["asyncprogress"]
+branch = true
 
 [tool.coverage.report]
 show_missing = true

{asyncprogress-0.3.5 → asyncprogress-0.3.6}/src/asyncprogress/__init__.py

@@ -22,4 +22,4 @@ __all__ = [
     "aprogress_as_completed",
 ]
 
-__version__ = "0.3.5"
+__version__ = "0.3.6"

{asyncprogress-0.3.5 → asyncprogress-0.3.6}/src/asyncprogress/_eta.py

@@ -1,7 +1,5 @@
 """
-EWMA-based ETA calculator for asyncprogress.
-
-Pure math — no I/O, fully unit-testable.
+EWMA-based ETA calculator for async progress tracking.
 """
 
 from __future__ import annotations
@@ -11,12 +9,11 @@ class EWMACalculator:
     """
     Exponential Weighted Moving Average calculator for ETA estimation.
 
-    Uses EWMA over completion timestamps rather than simple linear regression,
-    which better handles the bursty completion patterns common in async I/O.
+    Uses EWMA over completion timestamps to estimate items/second rate,
+    which handles bursty async I/O patterns better than simple linear regression.
 
     Args:
-        alpha: Smoothing factor (0 < alpha <= 1).
-               Higher values give more weight to recent samples.
+        alpha: Smoothing factor. Higher = more weight on recent samples.
                Recommended range: 0.1 (smooth) to 0.5 (reactive).
     """
 
@@ -33,15 +30,18 @@ class EWMACalculator:
         if self._last_timestamp is not None and self._last_completed is not None:
             dt = timestamp - self._last_timestamp
             dc = completed - self._last_completed
-            if dt > 0:
+            if dt > 0 and dc >= 0:
                 instant_rate = dc / dt
                 if self._ewma_rate is None:
                     self._ewma_rate = instant_rate
                 else:
                     self._ewma_rate = (
-                        self._alpha * instant_rate + (1 - self._alpha) * self._ewma_rate
+                        self._alpha * instant_rate
+                        + (1 - self._alpha) * self._ewma_rate
                     )
-            # If dt == 0, we skip updating the rate (same timestamp)
+            elif dt == 0:
+                # Same timestamp — rate stays unchanged, don't update
+                pass
         self._last_timestamp = timestamp
         self._last_completed = completed
 

{asyncprogress-0.3.5 → asyncprogress-0.3.6}/src/asyncprogress/_renderer.py

@@ -1,37 +1,43 @@
 """
-Terminal rendering for asyncprogress.
-
-String formatting only — no I/O, fully unit-testable.
+Terminal rendering for progress bars and spinners.
 """
 
 from __future__ import annotations
 
 SPINNER_FRAMES: list[str] = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"]
 
-ANSI_COLORS: dict[str, str] = {
-    "black": "\033[30m",
-    "red": "\033[31m",
-    "green": "\033[32m",
-    "yellow": "\033[33m",
-    "blue": "\033[34m",
-    "magenta": "\033[35m",
-    "cyan": "\033[36m",
-    "white": "\033[37m",
-    "bright_black": "\033[90m",
-    "bright_red": "\033[91m",
-    "bright_green": "\033[92m",
-    "bright_yellow": "\033[93m",
-    "bright_blue": "\033[94m",
-    "bright_magenta": "\033[95m",
-    "bright_cyan": "\033[96m",
-    "bright_white": "\033[97m",
+_ANSI_COLORS: dict[str, str] = {
+    "black": "\x1b[30m",
+    "red": "\x1b[31m",
+    "green": "\x1b[32m",
+    "yellow": "\x1b[33m",
+    "blue": "\x1b[34m",
+    "magenta": "\x1b[35m",
+    "cyan": "\x1b[36m",
+    "white": "\x1b[37m",
+    "bright_black": "\x1b[90m",
+    "bright_red": "\x1b[91m",
+    "bright_green": "\x1b[92m",
+    "bright_yellow": "\x1b[93m",
+    "bright_blue": "\x1b[94m",
+    "bright_magenta": "\x1b[95m",
+    "bright_cyan": "\x1b[96m",
+    "bright_white": "\x1b[97m",
 }
-ANSI_RESET = "\033[0m"
+_ANSI_RESET = "\x1b[0m"
 
 _SI_PREFIXES = ["", "K", "M", "G", "T", "P"]
 _BINARY_PREFIXES = ["", "Ki", "Mi", "Gi", "Ti", "Pi"]
 
 
+def _apply_color(text: str, color: str) -> str:
+    """Apply ANSI color to text."""
+    code = _ANSI_COLORS.get(color.lower(), "")
+    if not code:
+        return text
+    return f"{code}{text}{_ANSI_RESET}"
+
+
 def _format_duration(seconds: float) -> str:
     """Format seconds as H:MM:SS or M:SS."""
     m, s = divmod(int(seconds), 60)
@@ -41,14 +47,6 @@ def _format_duration(seconds: float) -> str:
     return f"{m}:{s:02d}"
 
 
-def _apply_color(text: str, color: str) -> str:
-    """Apply ANSI color to text."""
-    code = ANSI_COLORS.get(color.lower(), "")
-    if not code:
-        return text
-    return f"{code}{text}{ANSI_RESET}"
-
-
 def _scale_value(value: float, divisor: int) -> tuple[float, str]:
     """Return (scaled_value, prefix_string) for display."""
     prefixes = _BINARY_PREFIXES if divisor == 1024 else _SI_PREFIXES
@@ -63,13 +61,13 @@ class BarRenderer:
     """
     Renders a single-line progress bar string.
 
-    No I/O — returns strings only. Fully unit-testable.
+    No I/O is performed here — only string formatting.
     """
 
     def _compute_percentage(self, completed: int, total: int) -> float:
         """Compute percentage, handling total=0 gracefully."""
         if total == 0:
-            return 100.0  # Empty collection is trivially complete
+            return 100.0
         return min(100.0, (completed / total) * 100.0)
 
     def _format_count(
@@ -127,11 +125,7 @@ class BarRenderer:
         unit_scale: bool = False,
         unit_divisor: int = 1000,
     ) -> str:
-        """
-        Render a single-line deterministic progress bar string.
-
-        Returns a string ready for terminal output (no newline).
-        """
+        """Return a single-line progress bar string ready for terminal output."""
         parts: list[str] = []
 
         if description:
@@ -139,7 +133,7 @@ class BarRenderer:
 
         if total is not None:
             pct = self._compute_percentage(completed, total)
-            filled = int(bar_width * pct / 100)
+            filled = int(bar_width * completed / total) if total > 0 else bar_width
             bar = fill_char * filled + empty_char * (bar_width - filled)
             parts.append(f" {bar} ")
 
@@ -162,9 +156,10 @@ class BarRenderer:
         if show_eta and eta is not None:
             parts.append(f"ETA: {_format_duration(eta)}")
 
-        rate_str = self._format_rate(rate, unit, unit_scale, unit_divisor)
-        if rate_str:
-            parts.append(rate_str)
+        if rate is not None:
+            rate_str = self._format_rate(rate, unit, unit_scale, unit_divisor)
+            if rate_str:
+                parts.append(rate_str)
 
         line = " ".join(parts)
         if color:
@@ -186,11 +181,7 @@ class BarRenderer:
         unit_scale: bool = False,
         unit_divisor: int = 1000,
     ) -> str:
-        """
-        Render a single-line spinner for indeterminate progress.
-
-        Activates automatically when total is None.
-        """
+        """Render a single-line spinner for indeterminate progress."""
         spinner = SPINNER_FRAMES[frame_index % len(SPINNER_FRAMES)]
         parts: list[str] = []
         if description:

{asyncprogress-0.3.5 → asyncprogress-0.3.6}/src/asyncprogress/_terminal.py

@@ -15,19 +15,19 @@ def is_tty(file: TextIO = sys.stderr) -> bool:
 
 def move_cursor_up(n: int = 1) -> str:
     """Return ANSI escape sequence to move cursor up n lines."""
-    return f"\033[{n}A"
+    return f"\x1b[{n}A"
 
 
 def erase_line() -> str:
     """Return ANSI escape sequence to erase the current line."""
-    return "\033[2K\r"
+    return "\x1b[2K\r"
 
 
 def hide_cursor() -> str:
     """Return ANSI escape sequence to hide the cursor."""
-    return "\033[?25l"
+    return "\x1b[?25l"
 
 
 def show_cursor() -> str:
     """Return ANSI escape sequence to show the cursor."""
-    return "\033[?25h"
+    return "\x1b[?25h"