{"record":{"id":"917b35f9d2625094","repo":"tqdm/tqdm","slug":"this-function-will-be-removed-in-tqdm-5-0-0-pleas-917b35","errorCode":null,"errorMessage":"This function will be removed in tqdm==5.0.0\nPlease use `tqdm.gui.*` instead of `tqdm._tqdm_gui.*`","messagePattern":"This function will be removed in tqdm==5\\.0\\.0\nPlease use `tqdm\\.gui\\.\\*` instead of `tqdm\\._tqdm_gui\\.\\*`","errorType":"console","errorClass":"TqdmDeprecationWarning","httpStatus":null,"severity":"warning","filePath":"tqdm/_tqdm_gui.py","lineNumber":7,"sourceCode":"from warnings import warn\n\nfrom .gui import *  # NOQA\nfrom .gui import __all__  # NOQA\nfrom .std import TqdmDeprecationWarning\n\nwarn(\"This function will be removed in tqdm==5.0.0\\n\"\n     \"Please use `tqdm.gui.*` instead of `tqdm._tqdm_gui.*`\",\n     TqdmDeprecationWarning, stacklevel=2)\n","sourceCodeStart":1,"sourceCodeEnd":10,"githubUrl":"https://github.com/tqdm/tqdm/blob/96f2e60e4584cdab57a23602e27043d0465254ad/tqdm/_tqdm_gui.py#L1-L10","documentation":"Importing the legacy shim tqdm._tqdm_gui emits a module-level TqdmDeprecationWarning (removal in tqdm 5.0.0); the module merely re-exports tqdm.gui. It signals your code (or a dependency) is using the pre-4.x module path for the matplotlib GUI progress bar.","triggerScenarios":"`import tqdm._tqdm_gui` or `from tqdm._tqdm_gui import tqdm_gui` at any point in the process.","commonSituations":"Ancient example code for GUI progress bars, stale dependencies, or copy-pasted snippets predating the tqdm 4.x restructure.","solutions":["Replace with from tqdm.gui import tqdm_gui / trange","Locate the stale importer with python -W error to raise on the warning and show the traceback","Upgrade/downgrade the dependency that imports the old path","Suppress if unfixable: filterwarnings('ignore', category=tqdm.std.TqdmDeprecationWarning)"],"exampleFix":"# before\nfrom tqdm._tqdm_gui import tqdm_gui\n\n# after\nfrom tqdm.gui import tqdm_gui","handlingStrategy":"validation","validationCode":"import warnings\nwarnings.filterwarnings('error', category=DeprecationWarning)\ntry:\n    import tqdm._tqdm_gui\nexcept DeprecationWarning:\n    raise SystemExit('migrate to tqdm.gui')","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Use tqdm.gui for GUI bars","Search for _tqdm_gui in vendored code and dependencies before tqdm 5.x","Pin tqdm <5 until legacy imports are gone"],"tags":["tqdm","deprecation","gui","import"],"backgroundTag":"deprecated-module-import","analyzedSha":"96f2e60e4584cdab57a23602e27043d0465254ad","analyzedAt":"2026-08-28T11:23:10.474Z","schemaVersion":2},"datasetVersion":"2026-08-28T16:17:29.566Z"}