dcicutils 8.8.3.1b8__tar.gz → 8.8.3.1b9__tar.gz

{dcicutils-8.8.3.1b8 → dcicutils-8.8.3.1b9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: dcicutils
-Version: 8.8.3.1b8
+Version: 8.8.3.1b9
 Summary: Utility package for interacting with the 4DN Data Portal and other 4DN resources
 Home-page: https://github.com/4dn-dcic/utils
 License: MIT

{dcicutils-8.8.3.1b8 → dcicutils-8.8.3.1b9}/dcicutils/progress_bar.py

@@ -106,7 +106,7 @@ class ProgressBar:
             return True
         return False
 
-    def set_total(self, value: int) -> None:
+    def set_total(self, value: int, _norefresh: bool = False) -> None:
         if value == self._total:
             # If the total has not changed since last set then do nothing.
             return
@@ -117,13 +117,15 @@ class ProgressBar:
                 # the total during the course of a single ProgressBar instance.
                 self._bar.reset()
                 self._bar.total = value
-                self._bar.refresh()
+                if not _norefresh:
+                    self._bar.refresh()
 
-    def set_progress(self, value: int) -> None:
+    def set_progress(self, value: int, _norefresh: bool = False) -> None:
         if isinstance(value, int) and value >= 0:
             if (self._bar is not None) or self._initialize():
                 self._bar.n = value
-                self._bar.refresh()
+                if not _norefresh:
+                    self._bar.refresh()
 
     def increment_progress(self, value: int) -> None:
         if isinstance(value, int) and value > 0:
@@ -131,6 +133,13 @@ class ProgressBar:
                 self._bar.update(value)
                 self._bar.refresh()
 
+    def set_description(self, value: str) -> None:
+        if isinstance(value, str):
+            self._description = self._format_description(value)
+            if self._bar is not None:
+                # FYI: tqdm.set_description seems to imply a refresh.
+                self._bar.set_description(self._description)
+
     def reset_eta(self) -> None:
         # Since set_total does nothing if total is the same, provide
         # a way to reset the ETA if starting over with the same total.
@@ -142,11 +151,10 @@ class ProgressBar:
             self._bar.n = progress
             self._bar.refresh()
 
-    def set_description(self, value: str) -> None:
-        if isinstance(value, str):
-            self._description = self._format_description(value)
-            if self._bar is not None:
-                self._bar.set_description(self._description)
+    def reset(self, total: int, progress: int = 0, description: Optional[str] = None) -> None:
+        self.set_total(total, _norefresh=True)
+        self.set_progress(progress, _norefresh=True)
+        self.set_description(description)
 
     def done(self, description: Optional[str] = None) -> None:
         if self._done or self._bar is None:

{dcicutils-8.8.3.1b8 → dcicutils-8.8.3.1b9}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "dcicutils"
-version = "8.8.3.1b8"  # TODO: To become 8.8.4
+version = "8.8.3.1b9"  # TODO: To become 8.8.4
 description = "Utility package for interacting with the 4DN Data Portal and other 4DN resources"
 authors = ["4DN-DCIC Team <support@4dnucleome.org>"]
 license = "MIT"