Added class for easy granular marker configuration

Author: wolph

examples.py

@@ -176,9 +176,10 @@ def multi_progress_bar_example(left=True):
             bar.update(progress, jobs=jobs, force=True)
             time.sleep(0.02)
 
+
 @example
 def granular_progress_example():
-    widgets=[
+    widgets = [
         progressbar.GranularBar(markers=" ▏▎▍▌▋▊▉█", left='', right='|'),
         progressbar.GranularBar(markers=" ▁▂▃▄▅▆▇█", left='', right='|'),
         progressbar.GranularBar(markers=" ▖▌▛█", left='', right='|'),

progressbar/utils.py

@@ -192,7 +192,7 @@ def __init__(self, target, capturing=False, listeners=set()):
         self.listeners = listeners
         self.needs_clear = False
 
-    def isatty(self):
+    def isatty(self):  # pragma: no cover
         return self.target.isatty()
 
     def write(self, value):

progressbar/widgets.py

@@ -909,6 +909,15 @@ def get_values(self, progress, data):
         return ranges
 
 
+class GranularMarkers:
+    smooth = ' ▏▎▍▌▋▊▉█'
+    bar = ' ▁▂▃▄▅▆▇█'
+    snake = ' ▖▌▛█'
+    fade_in = ' ░▒▓█'
+    dots = ' ⡀⡄⡆⡇⣇⣧⣷⣿'
+    growing_circles = ' .oO'
+
+
 class GranularBar(AutoWidthWidgetBase):
     '''A progressbar that can display progress at a sub-character granularity
     by using multiple marker characters.
@@ -920,14 +929,18 @@ class GranularBar(AutoWidthWidgetBase):
      - Fade in: ` ░▒▓█`
      - Dots: ` ⡀⡄⡆⡇⣇⣧⣷⣿`
      - Growing circles: ` .oO`
+
+    The markers can be accessed through GranularMarkers. GranularMarkers.dots
+    for example
     '''
 
-    def __init__(self, markers=' ▏▎▍▌▋▊▉█', left='|', right='|', **kwargs):
+    def __init__(self, markers=GranularMarkers.smooth, left='|', right='|',
+                 **kwargs):
         '''Creates a customizable progress bar.
 
         markers - string of characters to use as granular progress markers. The
                   first character should represent 0% and the last 100%.
-                  Ex: ` .oO`
+                  Ex: ` .oO`.
         left - string or callable object to use as a left border
         right - string or callable object to use as a right border
         '''

tests/test_monitor_progress.py

@@ -213,7 +213,8 @@ def test_granular_bar(testdir):
         items=list(range(5)),
     )))
     pprint.pprint(result.stderr.lines, width=70)
-    assert result.stderr.lines == [u'',
+    assert result.stderr.lines == [
+        u'',
         u'|                                                          |',
         u'|OOOOOOOOOOO.                                              |',
         u'|OOOOOOOOOOOOOOOOOOOOOOO                                   |',