create contrib submodule

.meta/.readme.rst

@@ -769,7 +769,7 @@ A reusable canonical example is given below:
     import contextlib
     import sys
     from tqdm import tqdm
-    from tqdm.utils import DummyTqdmFile  # write to tqdm
+    from tqdm.contrib import DummyTqdmFile
 
 
     @contextlib.contextmanager

MANIFEST.in

@@ -7,6 +7,9 @@ include logo.png
 include Makefile
 include tox.ini
 
+# Non-std submodules
+recursive-include tqdm/contrib *.py
+
 # Test suite
 recursive-include tqdm/tests *.py
 include requirements-dev.txt

README.rst

@@ -949,7 +949,7 @@ A reusable canonical example is given below:
     import contextlib
     import sys
     from tqdm import tqdm
-    from tqdm.utils import DummyTqdmFile  # write to tqdm
+    from tqdm.contrib import DummyTqdmFile
 
 
     @contextlib.contextmanager

examples/redirect_print.py

@@ -15,7 +15,7 @@ from time import sleep
 import contextlib
 import sys
 from tqdm import tqdm
-from tqdm.utils import DummyTqdmFile
+from tqdm.contrib import DummyTqdmFile
 
 
 @contextlib.contextmanager

tqdm/contrib/__init__.py

@@ -0,0 +1,10 @@
+from tqdm import tqdm
+from tqdm.utils import ObjectWrapper
+
+
+class DummyTqdmFile(ObjectWrapper):
+    """Dummy file-like that will write to tqdm"""
+    def write(self, x, nolock=False):
+        # Avoid print() second call (useless \n)
+        if len(x.rstrip()) > 0:
+            tqdm.write(x, file=self._wrapped, nolock=nolock)

tqdm/tests/tests_tqdm.py

@@ -15,7 +15,7 @@ from tqdm import tqdm
 from tqdm import trange
 from tqdm import TqdmDeprecationWarning
 from tqdm.std import Bar
-from tqdm.utils import DummyTqdmFile
+from tqdm.contrib import DummyTqdmFile
 
 try:
     from StringIO import StringIO

tqdm/utils.py

@@ -187,15 +187,6 @@ class ObjectWrapper(object):
         self.wrapper_setattr('_wrapped', wrapped)
 
 
-class DummyTqdmFile(ObjectWrapper):
-    """Dummy file-like that will write to tqdm"""
-    def write(self, x, nolock=False):
-        from tqdm import tqdm
-        # Avoid print() second call (useless \n)
-        if len(x.rstrip()) > 0:
-            tqdm.write(x, file=self._wrapped, nolock=nolock)
-
-
 class SimpleTextIOWrapper(ObjectWrapper):
     """
     Change only `.write()` of the wrapped object by encoding the passed