Merge branch 'release/4.1.0'

Author: wolph

.coveragerc

@@ -22,3 +22,4 @@ exclude_lines =
     raise NotImplementedError
     if 0:
     if __name__ == .__main__.:
+    if types.TYPE_CHECKING:

.github/workflows/main.yml

@@ -14,14 +14,13 @@ jobs:
         python-version: ['3.7', '3.8', '3.9', '3.10']
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v3
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v2
+      uses: actions/setup-python@v4
       with:
         python-version: ${{ matrix.python-version }}
     - name: Install dependencies
       run: |
-        python -m pip install --upgrade pip
-        pip install tox tox-gh-actions
+        python -m pip install --upgrade pip tox
     - name: Test with tox
       run: tox

README.rst

@@ -237,3 +237,68 @@ Bar with wide Chinese (or other multibyte) characters
     )
     for i in bar(range(10)):
         time.sleep(0.1)
+
+Showing multiple (threaded) independent progress bars in parallel
+==============================================================================
+
+While this method works fine and will continue to work fine, a smarter and
+fully automatic version of this is currently being made:
+https://github.com/WoLpH/python-progressbar/issues/176
+
+.. code:: python
+
+    import random
+    import sys
+    import threading
+    import time
+
+    import progressbar
+
+    output_lock = threading.Lock()
+
+
+    class LineOffsetStreamWrapper:
+        UP = '\033[F'
+        DOWN = '\033[B'
+
+        def __init__(self, lines=0, stream=sys.stderr):
+            self.stream = stream
+            self.lines = lines
+
+        def write(self, data):
+            with output_lock:
+                self.stream.write(self.UP * self.lines)
+                self.stream.write(data)
+                self.stream.write(self.DOWN * self.lines)
+                self.stream.flush()
+
+        def __getattr__(self, name):
+            return getattr(self.stream, name)
+
+
+    bars = []
+    for i in range(5):
+        bars.append(
+            progressbar.ProgressBar(
+                fd=LineOffsetStreamWrapper(i),
+                max_value=1000,
+            )
+        )
+
+        if i:
+            print('Reserve a line for the progressbar')
+
+
+    class Worker(threading.Thread):
+        def __init__(self, bar):
+            super().__init__()
+            self.bar = bar
+
+        def run(self):
+            for i in range(1000):
+                time.sleep(random.random() / 100)
+                self.bar.update(i)
+
+
+    for bar in bars:
+        Worker(bar).start()

progressbar/__about__.py

@@ -19,7 +19,7 @@
 long running operations.
 '''.strip().split())
 __email__ = '[email protected]'
-__version__ = '4.0.0'
+__version__ = '4.1.0'
 __license__ = 'BSD'
 __copyright__ = 'Copyright 2015 Rick van Hattem (Wolph)'
 __url__ = 'https://github.com/WoLpH/python-progressbar'

progressbar/py.typed

@@ -199,8 +199,8 @@ def __init__(self, target: types.IO, capturing: bool = False,
         self.listeners = listeners or set()
         self.needs_clear = False
 
-    def isatty(self):  # pragma: no cover
-        return self.target.isatty()
+    def __getattr__(self, name):  # pragma: no cover
+        return getattr(self.target, name)
 
     def write(self, value: str) -> None:
         if self.capturing:

progressbar/utils.py

@@ -21,6 +21,12 @@ basepython = python3
 deps = flake8
 commands = flake8 {toxinidir}/progressbar {toxinidir}/tests {toxinidir}/examples.py
 
+[testenv:pyright]
+changedir =
+basepython = python3
+deps = pyright
+commands = pyright {toxinidir}/progressbar
+
 [testenv:docs]
 changedir =
 basepython = python3