@tushar-br/desktop 1.0.283 → 1.0.284

package/staging_area/micro projects/SD -Advanced Media Processing Toolkit Automated Downloader, Segmenter & Neural Dubber/.venv/Lib/site-packages/tqdm/tk.py

@@ -1,196 +0,0 @@
-"""
-Tkinter GUI progressbar decorator for iterators.
-
-Usage:
->>> from tqdm.tk import trange, tqdm
->>> for i in trange(10):
-...     ...
-"""
-import re
-import sys
-import tkinter
-import tkinter.ttk as ttk
-from warnings import warn
-
-from .std import TqdmExperimentalWarning, TqdmWarning
-from .std import tqdm as std_tqdm
-
-__author__ = {"github.com/": ["richardsheridan", "casperdcl"]}
-__all__ = ['tqdm_tk', 'ttkrange', 'tqdm', 'trange']
-
-
-class tqdm_tk(std_tqdm):  # pragma: no cover
-    """
-    Experimental Tkinter GUI version of tqdm!
-
-    Note: Window interactivity suffers if `tqdm_tk` is not running within
-    a Tkinter mainloop and values are generated infrequently. In this case,
-    consider calling `tqdm_tk.refresh()` frequently in the Tk thread.
-    """
-
-    # TODO: @classmethod: write()?
-
-    def __init__(self, *args, **kwargs):
-        """
-        This class accepts the following parameters *in addition* to
-        the parameters accepted by `tqdm`.
-
-        Parameters
-        ----------
-        grab  : bool, optional
-            Grab the input across all windows of the process.
-        tk_parent  : `tkinter.Wm`, optional
-            Parent Tk window.
-        cancel_callback  : Callable, optional
-            Create a cancel button and set `cancel_callback` to be called
-            when the cancel or window close button is clicked.
-        """
-        kwargs = kwargs.copy()
-        kwargs['gui'] = True
-        # convert disable = None to False
-        kwargs['disable'] = bool(kwargs.get('disable', False))
-        self._warn_leave = 'leave' in kwargs
-        grab = kwargs.pop('grab', False)
-        tk_parent = kwargs.pop('tk_parent', None)
-        self._cancel_callback = kwargs.pop('cancel_callback', None)
-        super().__init__(*args, **kwargs)
-
-        if self.disable:
-            return
-
-        if tk_parent is None:  # Discover parent widget
-            try:
-                tk_parent = tkinter._default_root
-            except AttributeError:
-                raise AttributeError(
-                    "`tk_parent` required when using `tkinter.NoDefaultRoot()`")
-            if tk_parent is None:  # use new default root window as display
-                self._tk_window = tkinter.Tk()
-            else:  # some other windows already exist
-                self._tk_window = tkinter.Toplevel()
-        else:
-            self._tk_window = tkinter.Toplevel(tk_parent)
-
-        warn("GUI is experimental/alpha", TqdmExperimentalWarning, stacklevel=2)
-        self._tk_dispatching = self._tk_dispatching_helper()
-
-        self._tk_window.protocol("WM_DELETE_WINDOW", self.cancel)
-        self._tk_window.wm_title(self.desc)
-        self._tk_window.wm_attributes("-topmost", 1)
-        self._tk_window.after(0, lambda: self._tk_window.wm_attributes("-topmost", 0))
-        self._tk_n_var = tkinter.DoubleVar(self._tk_window, value=0)
-        self._tk_text_var = tkinter.StringVar(self._tk_window)
-        pbar_frame = ttk.Frame(self._tk_window, padding=5)
-        pbar_frame.pack()
-        _tk_label = ttk.Label(pbar_frame, textvariable=self._tk_text_var,
-                              wraplength=600, anchor="center", justify="center")
-        _tk_label.pack()
-        self._tk_pbar = ttk.Progressbar(
-            pbar_frame, variable=self._tk_n_var, length=450)
-        if self.total is not None:
-            self._tk_pbar.configure(maximum=self.total)
-        else:
-            self._tk_pbar.configure(mode="indeterminate")
-        self._tk_pbar.pack()
-        if self._cancel_callback is not None:
-            _tk_button = ttk.Button(pbar_frame, text="Cancel", command=self.cancel)
-            _tk_button.pack()
-        if grab:
-            self._tk_window.grab_set()
-
-    def close(self):
-        if self.disable:
-            return
-
-        self.disable = True
-
-        with self.get_lock():
-            self._instances.remove(self)
-
-        def _close():
-            self._tk_window.after('idle', self._tk_window.destroy)
-            if not self._tk_dispatching:
-                self._tk_window.update()
-
-        self._tk_window.protocol("WM_DELETE_WINDOW", _close)
-
-        # if leave is set but we are self-dispatching, the left window is
-        # totally unresponsive unless the user manually dispatches
-        if not self.leave:
-            _close()
-        elif not self._tk_dispatching:
-            if self._warn_leave:
-                warn("leave flag ignored if not in tkinter mainloop",
-                     TqdmWarning, stacklevel=2)
-            _close()
-
-    def clear(self, *_, **__):
-        pass
-
-    def display(self, *_, **__):
-        self._tk_n_var.set(self.n)
-        d = self.format_dict
-        # remove {bar}
-        d['bar_format'] = (d['bar_format'] or "{l_bar}<bar/>{r_bar}").replace(
-            "{bar}", "<bar/>")
-        msg = self.format_meter(**d)
-        if '<bar/>' in msg:
-            msg = "".join(re.split(r'\|?<bar/>\|?', msg, maxsplit=1))
-        self._tk_text_var.set(msg)
-        if not self._tk_dispatching:
-            self._tk_window.update()
-
-    def set_description(self, desc=None, refresh=True):
-        self.set_description_str(desc, refresh)
-
-    def set_description_str(self, desc=None, refresh=True):
-        self.desc = desc
-        if not self.disable:
-            self._tk_window.wm_title(desc)
-            if refresh and not self._tk_dispatching:
-                self._tk_window.update()
-
-    def cancel(self):
-        """
-        `cancel_callback()` followed by `close()`
-        when close/cancel buttons clicked.
-        """
-        if self._cancel_callback is not None:
-            self._cancel_callback()
-        self.close()
-
-    def reset(self, total=None):
-        """
-        Resets to 0 iterations for repeated use.
-
-        Parameters
-        ----------
-        total  : int or float, optional. Total to use for the new bar.
-        """
-        if hasattr(self, '_tk_pbar'):
-            if total is None:
-                self._tk_pbar.configure(maximum=100, mode="indeterminate")
-            else:
-                self._tk_pbar.configure(maximum=total, mode="determinate")
-        super().reset(total=total)
-
-    @staticmethod
-    def _tk_dispatching_helper():
-        """determine if Tkinter mainloop is dispatching events"""
-        codes = {tkinter.mainloop.__code__, tkinter.Misc.mainloop.__code__}
-        for frame in sys._current_frames().values():
-            while frame:
-                if frame.f_code in codes:
-                    return True
-                frame = frame.f_back
-        return False
-
-
-def ttkrange(*args, **kwargs):
-    """Shortcut for `tqdm.tk.tqdm(range(*args), **kwargs)`."""
-    return tqdm_tk(range(*args), **kwargs)
-
-
-# Aliases
-tqdm = tqdm_tk
-trange = ttkrange

package/staging_area/micro projects/SD -Advanced Media Processing Toolkit Automated Downloader, Segmenter & Neural Dubber/.venv/Lib/site-packages/tqdm/tqdm.1

@@ -1,243 +0,0 @@
-.\" Automatically generated by Pandoc 3.8.3
-.\"
-.TH "TQDM" "1" "2015\-2026" "tqdm User Manuals"
-.SH NAME
-tqdm \- fast, extensible progress bar for Python and CLI
-.SH SYNOPSIS
-tqdm [\f[I]options\f[R]]
-.SH DESCRIPTION
-See \c
-.UR https://github.com/tqdm/tqdm
-.UE \c
-\&.
-Can be used as a pipe:
-.IP
-.EX
-$ \f[I]# count lines of code\f[R]
-$ cat *.py \f[B]|\f[R] tqdm \f[B]|\f[R] wc \-l
-327it [00:00, 981773.38it/s]
-327
-
-$ \f[I]# find all files\f[R]
-$ find . \-name \(dq*.py\(dq \f[B]|\f[R] tqdm \f[B]|\f[R] wc \-l
-432it [00:00, 833842.30it/s]
-432
-
-\f[I]# ... and more info\f[R]
-$ find . \-name \(aq*.py\(aq \-exec wc \-l \(rs{} \(rs; \(rs
-  \f[B]|\f[R] tqdm \-\-total 432 \-\-unit files \-\-desc counting \(rs
-  \f[B]|\f[R] awk \(aq{ sum += $1 }; END { print sum }\(aq
-counting: 100%\f[B]|\f[R]█████████\f[B]|\f[R] 432/432 [00:00<00:00, 794361.83files/s]
-131998
-.EE
-.SH OPTIONS
-.TP
-\-h, \-\-help
-Print this help and exit.
-.TP
-\-v, \-\-version
-Print version and exit.
-.TP
-\-\-desc=\f[I]desc\f[R]
-str, optional.
-Prefix for the progressbar.
-.TP
-\-\-total=\f[I]total\f[R]
-int or float, optional.
-The number of expected iterations.
-If unspecified, len(iterable) is used if possible.
-If float(\(lqinf\(rq) or as a last resort, only basic progress
-statistics are displayed (no ETA, no progressbar).
-If \f[CR]gui\f[R] is True and this parameter needs subsequent updating,
-specify an initial arbitrary large positive number, e.g.\ 9e9.
-.TP
-\-\-leave
-bool, optional.
-If [default: True], keeps all traces of the progressbar upon termination
-of iteration.
-If \f[CR]None\f[R], will leave only if \f[CR]position\f[R] is
-\f[CR]0\f[R].
-.TP
-\-\-ncols=\f[I]ncols\f[R]
-int, optional.
-The width of the entire output message.
-If specified, dynamically resizes the progressbar to stay within this
-bound.
-If unspecified, attempts to use environment width.
-The fallback is a meter width of 10 and no limit for the counter and
-statistics.
-If 0, will not print any meter (only stats).
-.TP
-\-\-mininterval=\f[I]mininterval\f[R]
-float, optional.
-Minimum progress display update interval [default: 0.1] seconds.
-.TP
-\-\-maxinterval=\f[I]maxinterval\f[R]
-float, optional.
-Maximum progress display update interval [default: 10] seconds.
-Automatically adjusts \f[CR]miniters\f[R] to correspond to
-\f[CR]mininterval\f[R] after long display update lag.
-Only works if \f[CR]dynamic_miniters\f[R] or monitor thread is enabled.
-.TP
-\-\-miniters=\f[I]miniters\f[R]
-int or float, optional.
-Minimum progress display update interval, in iterations.
-If 0 and \f[CR]dynamic_miniters\f[R], will automatically adjust to equal
-\f[CR]mininterval\f[R] (more CPU efficient, good for tight loops).
-If > 0, will skip display of specified number of iterations.
-Tweak this and \f[CR]mininterval\f[R] to get very efficient loops.
-If your progress is erratic with both fast and slow iterations (network,
-skipping items, etc) you should set miniters=1.
-.TP
-\-\-ascii=\f[I]ascii\f[R]
-bool or str, optional.
-If unspecified or False, use unicode (smooth blocks) to fill the meter.
-The fallback is to use ASCII characters \(rq 123456789#\(lq.
-.TP
-\-\-disable
-bool, optional.
-Whether to disable the entire progressbar wrapper [default: False].
-If set to None, disable on non\-TTY.
-.TP
-\-\-unit=\f[I]unit\f[R]
-str, optional.
-String that will be used to define the unit of each iteration [default:
-it].
-.TP
-\-\-unit\-scale=\f[I]unit_scale\f[R]
-bool or int or float, optional.
-If 1 or True, the number of iterations will be reduced/scaled
-automatically and a metric prefix following the International System of
-Units standard will be added (kilo, mega, etc.)
-[default: False].
-If any other non\-zero number, will scale \f[CR]total\f[R] and
-\f[CR]n\f[R].
-.TP
-\-\-dynamic\-ncols
-bool, optional.
-If set, constantly alters \f[CR]ncols\f[R] and \f[CR]nrows\f[R] to the
-environment (allowing for window resizes) [default: False].
-.TP
-\-\-smoothing=\f[I]smoothing\f[R]
-float, optional.
-Exponential moving average smoothing factor for speed estimates (ignored
-in GUI mode).
-Ranges from 0 (average speed) to 1 (current/instantaneous speed)
-[default: 0.3].
-.TP
-\-\-bar\-format=\f[I]bar_format\f[R]
-str, optional.
-Specify a custom bar string formatting.
-May impact performance.
-[default: `{l_bar}{bar}{r_bar}'], where l_bar=`{desc}:
-{percentage:3.0f}%|' and r_bar=`| {n_fmt}/{total_fmt}
-[{elapsed}<{remaining}, \(cq \(cq{rate_fmt}{postfix}]' Possible vars:
-l_bar, bar, r_bar, n, n_fmt, total, total_fmt, percentage, elapsed,
-elapsed_s, ncols, nrows, desc, unit, rate, rate_fmt, rate_noinv,
-rate_noinv_fmt, rate_inv, rate_inv_fmt, postfix, unit_divisor,
-remaining, remaining_s, eta.
-Note that a trailing \(lq:\(rq is automatically removed after {desc} if
-the latter is empty.
-.TP
-\-\-initial=\f[I]initial\f[R]
-int or float, optional.
-The initial counter value.
-Useful when restarting a progress bar [default: 0].
-If using float, consider specifying \f[CR]{n:.3f}\f[R] or similar in
-\f[CR]bar_format\f[R], or specifying \f[CR]unit_scale\f[R].
-.TP
-\-\-position=\f[I]position\f[R]
-int, optional.
-Specify the line offset to print this bar (starting from 0) Automatic if
-unspecified.
-Useful to manage multiple bars at once (eg, from threads).
-.TP
-\-\-postfix=\f[I]postfix\f[R]
-dict or *, optional.
-Specify additional stats to display at the end of the bar.
-Calls \f[CR]set_postfix(**postfix)\f[R] if possible (dict).
-.TP
-\-\-unit\-divisor=\f[I]unit_divisor\f[R]
-float, optional.
-[default: 1000], ignored unless \f[CR]unit_scale\f[R] is True.
-.TP
-\-\-write\-bytes
-bool, optional.
-Whether to write bytes.
-If (default: False) will write unicode.
-.TP
-\-\-lock\-args=\f[I]lock_args\f[R]
-tuple, optional.
-Passed to \f[CR]refresh\f[R] for intermediate output (initialisation,
-iterating, and updating).
-.TP
-\-\-nrows=\f[I]nrows\f[R]
-int, optional.
-The screen height.
-If specified, hides nested bars outside this bound.
-If unspecified, attempts to use environment height.
-The fallback is 20.
-.TP
-\-\-colour=\f[I]colour\f[R]
-str, optional.
-Bar colour (e.g.\ `green', `#00ff00').
-.TP
-\-\-delay=\f[I]delay\f[R]
-float, optional.
-Don\(cqt display until [default: 0] seconds have elapsed.
-.TP
-\-\-delim=\f[I]delim\f[R]
-chr, optional.
-Delimiting character [default: `\(rsn'].
-Use `\(rs0' for null.
-N.B.: on Windows systems, Python converts `\(rsn' to `\(rsr\(rsn'.
-.TP
-\-\-buf\-size=\f[I]buf_size\f[R]
-int, optional.
-String buffer size in bytes [default: 256] used when \f[CR]delim\f[R] is
-specified.
-.TP
-\-\-bytes
-bool, optional.
-If true, will count bytes, ignore \f[CR]delim\f[R], and default
-\f[CR]unit_scale\f[R] to True, \f[CR]unit_divisor\f[R] to 1024, and
-\f[CR]unit\f[R] to `B'.
-.TP
-\-\-tee
-bool, optional.
-If true, passes \f[CR]stdin\f[R] to both \f[CR]stderr\f[R] and
-\f[CR]stdout\f[R].
-.TP
-\-\-update
-bool, optional.
-If true, will treat input as newly elapsed iterations, i.e.\ numbers to
-pass to \f[CR]update()\f[R].
-Note that this is slow (\(ti2e5 it/s) since every input must be decoded
-as a number.
-.TP
-\-\-update\-to
-bool, optional.
-If true, will treat input as total elapsed iterations, i.e.\ numbers to
-assign to \f[CR]self.n\f[R].
-Note that this is slow (\(ti2e5 it/s) since every input must be decoded
-as a number.
-.TP
-\-\-null
-bool, optional.
-If true, will discard input (no stdout).
-.TP
-\-\-manpath=\f[I]manpath\f[R]
-str, optional.
-Directory in which to install tqdm man pages.
-.TP
-\-\-comppath=\f[I]comppath\f[R]
-str, optional.
-Directory in which to place tqdm completion.
-.TP
-\-\-log=\f[I]log\f[R]
-str, optional.
-CRITICAL|FATAL|ERROR|WARN(ING)|[default: `INFO']|DEBUG|NOTSET.
-.SH AUTHORS
-tqdm developers \c
-.UR https://github.com/tqdm
-.UE \c.