cli: add --null

README.rst

@@ -471,6 +471,8 @@ Extra CLI Options
 * update_to  : bool, optional  
     If true, will treat input as total elapsed iterations,
     i.e. numbers to assign to ``self.n``.
+* null  : bool, optional  
+    If true, will discard input (no stdout).
 * manpath  : str, optional  
     Directory in which to install tqdm man pages.
 * comppath  : str, optional  

tqdm/cli.py

@@ -3,9 +3,9 @@
 """
 from .std import tqdm, TqdmTypeError, TqdmKeyError
 from ._version import __version__  # NOQA
-import sys
-import re
 import logging
+import re
+import sys
 __all__ = ["main"]
 log = logging.getLogger(__name__)
 
@@ -148,6 +148,8 @@ def posix_pipe(fin, fout, delim=b'\\n', buf_size=256,
         update_to  : bool, optional
             If true, will treat input as total elapsed iterations,
             i.e. numbers to assign to `self.n`.
+        null  : bool, optional
+            If true, will discard input (no stdout).
         manpath  : str, optional
             Directory in which to install tqdm man pages.
         comppath  : str, optional
@@ -248,8 +250,15 @@ def main(fp=sys.stderr, argv=None):
         tee = tqdm_args.pop('tee', False)
         manpath = tqdm_args.pop('manpath', None)
         comppath = tqdm_args.pop('comppath', None)
+        if tqdm_args.pop('null', False):
+            class stdout(object):
+                @staticmethod
+                def write(_):
+                    pass
+        else:
+            stdout = sys.stdout
+            stdout = getattr(stdout, 'buffer', stdout)
         stdin = getattr(sys.stdin, 'buffer', sys.stdin)
-        stdout = getattr(sys.stdout, 'buffer', sys.stdout)
         if manpath or comppath:
             from os import path
             from shutil import copyfile

tqdm/completion.sh

@@ -12,7 +12,7 @@ _tqdm(){
     COMPREPLY=($(compgen -W       'CRITICAL FATAL ERROR WARN WARNING INFO DEBUG NOTSET' -- ${cur}))
     ;;
   *)
-    COMPREPLY=($(compgen -W '--ascii --bar_format --buf_size --bytes --comppath --delim --desc --disable --dynamic_ncols --help --initial --leave --lock_args --log --manpath --maxinterval --mininterval --miniters --ncols --nrows --position --postfix --smoothing --tee --total --unit --unit_divisor --unit_scale --update --update_to --version --write_bytes -h -v' -- ${cur}))
+    COMPREPLY=($(compgen -W '--ascii --bar_format --buf_size --bytes --comppath --delim --desc --disable --dynamic_ncols --help --initial --leave --lock_args --log --manpath --maxinterval --mininterval --miniters --ncols --nrows --null --position --postfix --smoothing --tee --total --unit --unit_divisor --unit_scale --update --update_to --version --write_bytes -h -v' -- ${cur}))
     ;;
   esac
 }

tqdm/tqdm.1

@@ -272,6 +272,12 @@ numbers to assign to \f[C]self.n\f[].
 .RS
 .RE
 .TP
+.B \-\-null=\f[I]null\f[]
+bool, optional.
+If true, will discard input (no stdout).
+.RS
+.RE
+.TP
 .B \-\-manpath=\f[I]manpath\f[]
 str, optional.
 Directory in which to install tqdm man pages.