class_docstr: maximum-compatibility tqdm-based progressbars
class_docstr_tok: ["maximum-compatibility","tqdm-based","progressbars"]
docstr: bytes   : shortcut for
      `unit='B', unit_scale=True, unit_divisor=1024, miniters=1`
  desc  : persists after `close()`
  level  : effective logging level for determining `disable`;
      used only if `disable` is unspecified
  disable  : If (default: None) or False,
      will be determined by logging level.
      May be overridden to `True` due to non-TTY status.
      Skip override by specifying env var `DVC_IGNORE_ISATTY`.
  kwargs  : anything accepted by `tqdm.tqdm()`
docstr_tok: ["bytes",":","shortcut","for","`","unit=","'","B","'",",","unit_scale=True",",","unit_divisor=1024",",","miniters=1","`","desc",":","persists","after","`","close","(",")","`","level",":","effective","logging","level","for","determining","`","disable","`",";","used","only","if","`","disable","`","is","unspecified","disable",":","If","(","default",":","None",")","or","False",",","will","be","determined","by","logging","level",".","May","be","overridden","to","`","True","`","due","to","non-TTY","status",".","Skip","override","by","specifying","env","var","`","DVC_IGNORE_ISATTY","`",".","kwargs",":","anything","accepted","by","`","tqdm.tqdm","(",")","`"]
code: def __init__(  # noqa: PLR0913
      self,
      iterable=None,
      disable=None,
      level=logging.ERROR,
      desc=None,
      leave=False,
      bar_format=None,
      bytes=False,  # noqa: A002
      file=None,
      total=None,
      postfix=None,
      **kwargs,
  ):
      """
      bytes   : shortcut for
          `unit='B', unit_scale=True, unit_divisor=1024, miniters=1`
      desc  : persists after `close()`
      level  : effective logging level for determining `disable`;
          used only if `disable` is unspecified
      disable  : If (default: None) or False,
          will be determined by logging level.
          May be overridden to `True` due to non-TTY status.
          Skip override by specifying env var `DVC_IGNORE_ISATTY`.
      kwargs  : anything accepted by `tqdm.tqdm()`
      """
      kwargs = kwargs.copy()
      if bytes:
          kwargs = {**self.BYTES_DEFAULTS, **kwargs}
      else:
          kwargs.setdefault(
              "unit_scale", total > 999 if total else True
          )
      if file is None:
          file = sys.stderr
      # auto-disable based on `logger.level`
      if not disable:
          disable = logger.getEffectiveLevel() > level
      # auto-disable based on TTY
      if (
          not disable
          and not env2bool(DVC_IGNORE_ISATTY)
          and hasattr(file, "isatty")
      ):
          disable = not file.isatty()
      super().__init__(
          iterable=iterable,
          disable=disable,
          leave=leave,
          desc=desc,
          bar_format="!",
          lock_args=(False,),
          total=total,
          **kwargs,
      )
      self.postfix = postfix or {"info": ""}
      if bar_format is None:
          if self.__len__():
              self.bar_format = (
                  self.BAR_FMT_DEFAULT_NESTED
                  if self.pos
                  else self.BAR_FMT_DEFAULT
              )
          else:
              self.bar_format = self.BAR_FMT_NOTOTAL
      else:
          self.bar_format = bar_format
      self.refresh()
  
file_path: dvc/dvc/progress.py
imports: import logging
  import sys
  from threading import RLock
  from typing import TYPE_CHECKING
  from tqdm import tqdm
  from dvc.env import DVC_IGNORE_ISATTY
  from dvc.utils import env2bool
label_desc: Use image node_id 1 to create a new Tqdm object from inherited base classes: tqdm with example: obj = Tqdm(iterable, disable, level, desc, leave, bar_format, bytes, file, total, postfix)