:zap: A Fast, Extensible Progress Bar for Python and CLI
This report summarizes scanner evidence for tqdm/tqdm, a Python project with 31,353 GitHub stars. SynthScan examined 10,576 lines of code across 94 source files, recording 212 pattern matches distributed across 12 syntactic categories. The legacy adjusted pattern signal is 35.2 (High pattern signal); it is not an authorship estimate.
Use the findings to ask whether maintainers can explain intent, verify dependencies, simplify unnecessary scaffolding, and focus review effort. Risk Payload v1 adds ownership, supply-chain, over-engineering, and review-effort vectors when available. These are prompts for human verification, not probabilities, security findings, or measured maintenance costs.
Use each vector to guide manual verification of the underlying findings.
Can maintainers explain intent, assumptions, and trade-offs? 77 finding(s).
Are imports declared and package/API names verified? 65 finding(s).
Are wrappers, guards, and repeated structures necessary? 121 finding(s).
Which changes need focused human review? 212 finding(s).
This chart tracks the legacy adjusted pattern score across scan runs. Changes can reflect source changes, scan coverage, or detector/scoring versions; they do not measure AI adoption or prove that a team refactored code. Compare runs only when their scoring versions are compatible. The dashed line tracks the raw pattern-hit count.
Groups findings by configured severity weight. Severity is not a confidence estimate, security rating, or proof that a package is missing. Verify imports against the project's manifests and inspect each finding in its local design context.
This horizontal bar chart shows where configured pattern scores accumulate across directories. Treat the bars as locations to inspect, not as evidence of authorship or code quality. Use the file-level findings to decide whether a directory needs a focused ownership, dependency, complexity, or review check.
The scanner identified 212 distinct pattern matches across 12 syntactic categories. Each entry below represents a discrete location in the source code where the engine recorded a detector match to inspect in context. Expand any category row to inspect the individual file paths, line numbers, code snippets, and the lexical context (CODE, COMMENT, or STRING) in which each match was detected.
Reading the findings table: The Severity column indicates the configured finding weight (CRITICAL / HIGH / MEDIUM / LOW). The Context column identifies whether the match occurred inside executable code, an inline comment, or a string literal — legacy comment-context matches receive a ×1.5 score weight. The ⚡ bolt icon marks clustered matches: three or more patterns within a 10-line window, each receiving an additional ×1.5 density multiplier under the legacy scoring model.
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| HIGH | tqdm/std.py | 70 | except (ImportError, OSError): # pragma: no cover | CODE |
| HIGH | tqdm/std.py | 570 | except TypeError: | CODE |
| HIGH | tqdm/std.py | 700 | except KeyError: | CODE |
| HIGH | tqdm/std.py | 908 | except TypeError: | CODE |
| HIGH | tqdm/cli.py | 23 | except TqdmTypeError: | CODE |
| HIGH | tqdm/utils.py | 81 | except ModuleNotFoundError: | CODE |
| HIGH | tqdm/utils.py | 64 | except Exception: # nosec B110 | CODE |
| HIGH | tqdm/utils.py | 73 | except KeyError: # keep unconverted (`str`) | CODE |
| HIGH | tqdm/utils.py | 185 | except ReferenceError: | CODE |
| HIGH | tqdm/utils.py | 192 | except ReferenceError: | CODE |
| HIGH | tqdm/notebook.py | 61 | except ImportError: | CODE |
| HIGH | tqdm/notebook.py | 132 | except ValueError: | CODE |
| HIGH | tqdm/notebook.py | 33 | except ImportError: | CODE |
| HIGH | tqdm/contrib/logging.py | 10 | except ImportError: | CODE |
| HIGH | tqdm/contrib/__init__.py | 60 | except ImportError: | CODE |
| HIGH | tqdm/contrib/__init__.py | 39 | except (OSError, ValueError): | CODE |
| HIGH | tqdm/contrib/itertools.py | 19 | except (TypeError, AttributeError): | CODE |
| HIGH | tqdm/contrib/itertools.py | 29 | except (TypeError, AttributeError): | CODE |
| HIGH | tqdm/contrib/itertools.py | 41 | except (TypeError, AttributeError): | CODE |
| HIGH | tqdm/contrib/itertools.py | 57 | except (TypeError, AttributeError): | CODE |
| HIGH | tqdm/contrib/itertools.py | 72 | except (TypeError, AttributeError): | CODE |
| HIGH | tqdm/contrib/itertools.py | 88 | except (TypeError, AttributeError): | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | tests/tests_tqdm.py | 326 | def test_native_string_io_for_default_file(monkeypatch): | CODE |
| LOW | tests/tests_tqdm.py | 335 | def test_unicode_string_io_for_specified_file(): | CODE |
| LOW | tests/tests_tqdm.py | 351 | def test_iterate_over_csv_rows(tmp_file): | CODE |
| LOW | tests/tests_tqdm.py | 622 | def test_smoothed_dynamic_min_iters(caperr): | CODE |
| LOW | tests/tests_tqdm.py | 650 | def test_smoothed_dynamic_min_iters_with_min_interval(caperr): | CODE |
| LOW | tests/tests_tqdm.py | 805 | def test_close_after_stream_closed(tmp_file): | CODE |
| LOW | tests/tests_tqdm.py | 1296 | def test_deprecation_exception(tmp_file): | CODE |
| LOW | tests/tests_rich.py | 17 | def test_rich_fraction_column_no_total(): | CODE |
| LOW⚡ | tests/tests_contrib_logging.py | 48 | def test_should_call_tqdm_write(self, logger, messages): | CODE |
| LOW⚡ | tests/tests_contrib_logging.py | 53 | def test_should_call_handle_error_if_exception_was_thrown(self, logger, monkeypatch): | CODE |
| LOW⚡ | tests/tests_contrib_logging.py | 63 | def test_should_not_swallow_certain_exceptions(self, logger, exception_class): | CODE |
| LOW⚡ | tests/tests_contrib_logging.py | 71 | def test_should_return_none_for_no_handlers(self): | CODE |
| LOW⚡ | tests/tests_contrib_logging.py | 74 | def test_should_return_none_without_stream_handler(self): | CODE |
| LOW⚡ | tests/tests_contrib_logging.py | 78 | def test_should_return_none_for_stream_handler_not_stdout_or_stderr(self): | CODE |
| LOW⚡ | tests/tests_contrib_logging.py | 82 | def test_should_return_stream_handler_if_stream_is_stdout(self): | CODE |
| LOW⚡ | tests/tests_contrib_logging.py | 86 | def test_should_return_stream_handler_if_stream_is_stderr(self): | CODE |
| LOW⚡ | tests/tests_contrib_logging.py | 92 | def test_should_add_and_remove_tqdm_handler(self, logger): | CODE |
| LOW⚡ | tests/tests_contrib_logging.py | 98 | def test_should_remove_and_restore_console_handlers(self, logger): | CODE |
| LOW⚡ | tests/tests_contrib_logging.py | 107 | def test_should_inherit_console_logger_formatter(self, logger): | CODE |
| LOW⚡ | tests/tests_contrib_logging.py | 115 | def test_should_inherit_console_handler_filters(self, logger, messages): | CODE |
| LOW | tests/tests_contrib_logging.py | 128 | def test_should_not_remove_stream_handlers_not_for_stdout_or_stderr(self, logger): | CODE |
| LOW⚡ | tests/tests_contrib_logging.py | 139 | def test_should_add_and_remove_handler_from_root_logger_by_default(self): | CODE |
| LOW⚡ | tests/tests_contrib_logging.py | 147 | def test_should_add_and_remove_handler_from_custom_logger(self, logger): | CODE |
| LOW⚡ | tests/tests_contrib_logging.py | 155 | def test_should_not_fail_with_logger_without_console_handler(self, logger): | CODE |
| LOW⚡ | tests/tests_contrib_logging.py | 161 | def test_should_format_message(self, logger, messages): | CODE |
| LOW⚡ | tests/tests_contrib_logging.py | 169 | def test_use_root_logger_by_default_and_write_to_custom_tqdm(self, messages): | CODE |
| LOW⚡ | tests/tests_pandas.py | 21 | def test_pandas_rolling_expanding(caperr): | CODE |
| LOW | tests/tests_pandas.py | 95 | def test_pandas_groupby_apply(caperr): | CODE |
| LOW | tests/tests_pandas.py | 137 | def test_pandas_apply_args_deprecation(caperr): | CODE |
| LOW | tests/tests_concurrent.py | 33 | def test_concurrent_map_unknown_len(mapper, caperr): | CODE |
| LOW | tests/tests_concurrent.py | 73 | def test_interpreter_map_lock(tmp_path): | CODE |
| LOW | tests/tests_perf.py | 166 | def test_manual_basic_overhead(): | CODE |
| LOW | tests/tests_perf.py | 239 | def test_manual_overhead_hard(): | CODE |
| LOW | tests/tests_perf.py | 260 | def test_iter_overhead_simplebar_hard(): | CODE |
| LOW | tests/tests_perf.py | 282 | def test_manual_overhead_simplebar_hard(): | CODE |
| LOW | tests/tests_itertools.py | 77 | def test_combinations_with_replacement(caperr): | CODE |
| LOW | tests/tests_synchronisation.py | 45 | def _monitor_pretest_posttest(): | CODE |
| LOW | tests/tests_synchronisation.py | 100 | def test_monitoring_and_cleanup(fake_sleep): | CODE |
| LOW | tests/tests_synchronisation.py | 186 | def test_monitor_atexit_does_not_deadlock_on_stuck_get_lock(): | CODE |
| LOW | tests/tests_notebook.py | 4 | def test_notebook_disabled_description(): | CODE |
| LOW⚡ | tqdm/keras.py | 114 | def _implements_train_batch_hooks(): | CODE |
| LOW⚡ | tqdm/keras.py | 118 | def _implements_test_batch_hooks(): | CODE |
| LOW⚡ | tqdm/keras.py | 122 | def _implements_predict_batch_hooks(): | CODE |
| LOW | tqdm/contrib/logging.py | 35 | def _is_console_logging_handler(handler): | CODE |
| LOW | tqdm/contrib/logging.py | 40 | def _get_first_found_console_logging_handler(handlers): | CODE |
| LOW | tqdm/contrib/itertools.py | 67 | def combinations_with_replacement(iterable, r, total=None, tqdm_class=tqdm_auto, **kwargs): | CODE |
| LOW | examples/redirect_print.py | 22 | def std_out_err_redirect_tqdm(): | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | tests/tests_tqdm.py | 17 | CODE | |
| LOW | tests/tests_main.py | 40 | CODE | |
| LOW | tqdm/_main.py | 3 | CODE | |
| LOW | tqdm/_main.py | 4 | CODE | |
| LOW | tqdm/_tqdm_gui.py | 3 | CODE | |
| LOW | tqdm/_tqdm_gui.py | 4 | CODE | |
| LOW | tqdm/_tqdm_notebook.py | 3 | CODE | |
| LOW | tqdm/_tqdm_notebook.py | 4 | CODE | |
| LOW | tqdm/__init__.py | 1 | CODE | |
| LOW | tqdm/__init__.py | 1 | CODE | |
| LOW | tqdm/__init__.py | 2 | CODE | |
| LOW | tqdm/__init__.py | 3 | CODE | |
| LOW | tqdm/__init__.py | 4 | CODE | |
| LOW | tqdm/__init__.py | 5 | CODE | |
| LOW | tqdm/__init__.py | 6 | CODE | |
| LOW | tqdm/__init__.py | 6 | CODE | |
| LOW | tqdm/__init__.py | 6 | CODE | |
| LOW | tqdm/__init__.py | 6 | CODE | |
| LOW | tqdm/__init__.py | 6 | CODE | |
| LOW | tqdm/__init__.py | 6 | CODE | |
| LOW | tqdm/__init__.py | 6 | CODE | |
| LOW | tqdm/__init__.py | 9 | CODE | |
| LOW | tqdm/utils.py | 80 | CODE | |
| LOW | tqdm/_tqdm.py | 3 | CODE | |
| LOW | tqdm/_tqdm.py | 4 | CODE | |
| LOW | tqdm/autonotebook.py | 33 | CODE | |
| LOW | tqdm/autonotebook.py | 33 | CODE | |
| LOW | tqdm/autonotebook.py | 31 | CODE | |
| LOW | tqdm/autonotebook.py | 31 | CODE | |
| LOW | tqdm/_utils.py | 4 | CODE | |
| LOW | tqdm/_utils.py | 4 | CODE | |
| LOW | tqdm/_utils.py | 4 | CODE | |
| LOW | tqdm/_utils.py | 4 | CODE | |
| LOW | tqdm/_utils.py | 4 | CODE | |
| LOW | tqdm/_utils.py | 4 | CODE | |
| LOW | tqdm/_utils.py | 4 | CODE | |
| LOW | tqdm/_utils.py | 4 | CODE | |
| LOW | tqdm/_utils.py | 4 | CODE | |
| LOW | tqdm/_utils.py | 4 | CODE | |
| LOW | tqdm/_utils.py | 4 | CODE | |
| LOW | tqdm/_utils.py | 4 | CODE | |
| LOW | tqdm/_utils.py | 4 | CODE | |
| LOW | tqdm/_utils.py | 4 | CODE | |
| LOW | tqdm/_utils.py | 4 | CODE | |
| LOW | tqdm/_utils.py | 4 | CODE | |
| LOW | tqdm/_utils.py | 4 | CODE | |
| LOW | tqdm/contrib/logging.py | 9 | CODE | |
| LOW | tqdm/contrib/logging.py | 9 | CODE | |
| LOW | tqdm/contrib/logging.py | 9 | CODE | |
| LOW | tqdm/contrib/logging.py | 9 | CODE | |
| LOW | tqdm/contrib/bells.py | 18 | CODE | |
| LOW | tqdm/contrib/bells.py | 20 | CODE | |
| LOW | tqdm/contrib/bells.py | 22 | CODE | |
| LOW | tqdm/contrib/bells.py | 24 | CODE | |
| LOW | examples/include_no_requirements.py | 3 | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| HIGH⚡ | tests/tests_pandas.py | 28 | assert res1.equals(res2) | CODE |
| HIGH⚡ | tests/tests_pandas.py | 32 | assert res3.equals(res4) | CODE |
| HIGH | tests/tests_pandas.py | 44 | assert res1.equals(res2) | CODE |
| HIGH | tests/tests_pandas.py | 48 | assert res3.equals(res4) | CODE |
| HIGH | tests/tests_pandas.py | 67 | assert res1.equals(res2) | CODE |
| HIGH | tests/tests_pandas.py | 73 | assert res1.equals(res2) | CODE |
| HIGH | tests/tests_pandas.py | 86 | assert res3.equals(res4) | CODE |
| HIGH | tests/tests_pandas.py | 108 | assert res1.equals(res2) | CODE |
| HIGH | examples/tqdm_requests.py | 14 | The local file path in which to save the url [default: /dev/null]. | STRING |
| HIGH | examples/tqdm_wget.py | 20 | The local file path in which to save the url [default: /dev/null]. | STRING |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | tests/tests_perf.py | 70 | except Exception: | CODE |
| LOW | tqdm/asyncio.py | 83 | except Exception as e: # noqa: BLE001 | CODE |
| MEDIUM | tqdm/asyncio.py | 80 | def wrap_awaitable(i, f): | CODE |
| LOW | tqdm/std.py | 673 | except Exception as e: # pragma: nocover | CODE |
| LOW | tqdm/cli.py | 239 | except Exception: | STRING |
| LOW | tqdm/utils.py | 64 | except Exception: # nosec B110 | CODE |
| LOW | tqdm/utils.py | 240 | except Exception: | CODE |
| LOW | tqdm/utils.py | 243 | except Exception: | CODE |
| LOW | tqdm/utils.py | 275 | except Exception: | CODE |
| MEDIUM | tqdm/utils.py | 235 | def _is_utf(encoding): | CODE |
| MEDIUM | tqdm/utils.py | 270 | def inner(fp): | CODE |
| LOW | tqdm/autonotebook.py | 30 | except Exception: | CODE |
| LOW | tqdm/contrib/telegram.py | 48 | except Exception as e: | CODE |
| LOW | tqdm/contrib/telegram.py | 74 | except Exception as e: | CODE |
| LOW | tqdm/contrib/telegram.py | 85 | except Exception as e: | CODE |
| LOW | tqdm/contrib/discord.py | 51 | except Exception as e: | CODE |
| LOW | tqdm/contrib/discord.py | 78 | except Exception as e: | CODE |
| LOW | tqdm/contrib/discord.py | 90 | except Exception as e: | CODE |
| LOW | tqdm/contrib/slack.py | 35 | except Exception as e: | CODE |
| LOW | tqdm/contrib/slack.py | 53 | except Exception as e: | CODE |
| LOW | tqdm/contrib/utils_worker.py | 34 | except Exception as e: | CODE |
| LOW | examples/redirect_print.py | 29 | except Exception as exc: | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | tqdm/_monitor.py | 6 | __all__ = ["TMonitor", "TqdmSynchronisationWarning"] | CODE |
| LOW | tqdm/keras.py | 14 | __all__ = ['TqdmCallback'] | CODE |
| LOW | tqdm/asyncio.py | 16 | __all__ = ['tqdm_asyncio', 'tarange', 'tqdm', 'trange'] | CODE |
| LOW | tqdm/std.py | 26 | __all__ = ['tqdm', 'trange', | CODE |
| LOW | tqdm/__init__.py | 11 | __all__ = ['tqdm', 'tqdm_gui', 'trange', 'tgrange', 'tqdm_pandas', | CODE |
| LOW | tqdm/rich.py | 18 | __all__ = ['tqdm_rich', 'trrange', 'tqdm', 'trange'] | CODE |
| LOW | tqdm/tk.py | 19 | __all__ = ['tqdm_tk', 'ttkrange', 'tqdm', 'trange'] | CODE |
| LOW | tqdm/cli.py | 13 | __all__ = ["main"] | CODE |
| LOW | tqdm/dask.py | 8 | __all__ = ['TqdmCallback'] | CODE |
| LOW | tqdm/_tqdm_pandas.py | 4 | __all__ = ['tqdm_pandas'] | CODE |
| LOW | tqdm/autonotebook.py | 38 | __all__ = ["tqdm", "trange"] | CODE |
| LOW | tqdm/notebook.py | 65 | __all__ = ['tqdm_notebook', 'tnrange', 'tqdm', 'trange'] | CODE |
| LOW | tqdm/gui.py | 21 | __all__ = ['tqdm_gui', 'tgrange', 'tqdm', 'trange'] | CODE |
| LOW | tqdm/auto.py | 40 | __all__ = ["tqdm", "trange"] | CODE |
| LOW | tqdm/contrib/concurrent.py | 12 | __all__ = ['thread_map', 'process_map', 'interpreter_map'] | CODE |
| LOW | tqdm/contrib/bells.py | 13 | __all__ = ['tqdm', 'trange'] | CODE |
| LOW | tqdm/contrib/telegram.py | 21 | __all__ = ['TelegramIO', 'tqdm_telegram', 'ttgrange', 'tqdm', 'trange'] | CODE |
| LOW | tqdm/contrib/discord.py | 23 | __all__ = ['DiscordIO', 'tqdm_discord', 'tdrange', 'tqdm', 'trange'] | CODE |
| LOW | tqdm/contrib/__init__.py | 13 | __all__ = ['tenumerate', 'tzip', 'tmap'] | CODE |
| LOW | tqdm/contrib/slack.py | 23 | __all__ = ['SlackIO', 'tqdm_slack', 'tsrange', 'tqdm', 'trange'] | CODE |
| LOW | tqdm/contrib/itertools.py | 10 | __all__ = [ | CODE |
| LOW | tqdm/contrib/utils_worker.py | 10 | __all__ = ['MonoWorker'] | CODE |
| LOW | examples/include_no_requirements.py | 11 | __all__ = ['tqdm'] | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | tests/tests_tqdm.py | 124 | CODE | |
| LOW | tests/tests_tqdm.py | 1460 | CODE | |
| LOW | tqdm/_monitor.py | 62 | CODE | |
| LOW | tqdm/asyncio.py | 23 | CODE | |
| LOW | tqdm/std.py | 368 | CODE | |
| LOW | tqdm/std.py | 774 | CODE | |
| LOW | tqdm/std.py | 960 | CODE | |
| LOW | tqdm/std.py | 1166 | CODE | |
| LOW | tqdm/std.py | 1203 | CODE | |
| LOW | tqdm/std.py | 855 | CODE | |
| LOW | tqdm/std.py | 856 | CODE | |
| LOW | tqdm/cli.py | 55 | CODE | |
| LOW | tqdm/cli.py | 156 | CODE | |
| LOW | tqdm/utils.py | 34 | CODE | |
| LOW | tqdm/utils.py | 53 | CODE | |
| LOW | tqdm/contrib/logging.py | 47 | CODE | |
| LOW | tqdm/contrib/concurrent.py | 107 | CODE | |
| LOW | examples/7zx.py | 38 | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| HIGH | tqdm/asyncio.py | 0 | ipython/jupyter notebook progress bar decorator for iterators. includes a default `range` iterator printing to `stderr`. | STRING |
| HIGH | tqdm/std.py | 0 | ipython/jupyter notebook progress bar decorator for iterators. includes a default `range` iterator printing to `stderr`. | STRING |
| HIGH | tqdm/notebook.py | 0 | ipython/jupyter notebook progress bar decorator for iterators. includes a default `range` iterator printing to `stderr`. | STRING |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| MEDIUM | tests/tests_rlock.py | 28 | # Creating a progress bar should initialize the lock | COMMENT |
| MEDIUM | tests/tests_rlock.py | 33 | # Creating a progress bar again should reuse the lock | COMMENT |
| MEDIUM | tqdm/notebook.py | 219 | # Initialize parent class + avoid printing by using gui=True | COMMENT |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| MEDIUM | tqdm/std.py | 800 | >>> # Now you can use `progress_apply` instead of `apply` | STRING |
| MEDIUM | examples/pandas_progress_apply.py | 12 | # Now you can use `progress_apply` instead of `apply` | COMMENT |
| LOW | examples/tqdm_wget.py | 34 | Don't forget to close() or __exit__() | STRING |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | tests/tests_perf.py | 79 | CODE | |
| LOW | tqdm/std.py | 463 | CODE | |
| LOW | tqdm/std.py | 960 | CODE | |
| LOW | tqdm/contrib/concurrent.py | 107 | CODE |
| Severity | File | Line | Snippet | Context |
|---|---|---|---|---|
| LOW | tests/tests_tqdm.py | 201 | # bar gets chopped | COMMENT |
| LOW | examples/pandas_progress_apply.py | 21 | # def inner(df, func, *args, **kwargs): | COMMENT |