fix(deps): update dependency django-debug-toolbar to v6
This MR contains the following updates:
Package | Change | Age | Adoption | Passing | Confidence |
---|---|---|---|---|---|
django-debug-toolbar (changelog) |
~4.4 -> ~6.0
|
Release Notes
django-commons/django-debug-toolbar (django-debug-toolbar)
v6.0.0
Description
The v6.0.0 release of Django Debug Toolbar significantly revamps how panels for the toolbar work. Each panel will now persist its data in a store. A store can either be backed by various backends. The toolbar will support a memory and database backend to start.
The toolbar is now using Django's SafeExceptionReporterFilter.cleanse_setting()
function to filter out sensitive information. Some data will be replaced with "********************"
. This is because the toolbar could be configured to write the request information to a persistent store such as a cache or database.
Django applications with basic installations are backwards compatible with this change. If there are hooks into the internals of the toolbar, such as DebugToolbar.store_id
then it will be backwards incompatible.
Third-party panels will need updating. Any data that is stored in record_stats
will need to be fetched back out from self.get_stats()
before being able to be rendered. This is to support loading an instance of the toolbar from persisted data. A simple example of this transition can be found in debug_toolbar/panels/cache.py
in MR 2138
How to upgrade
-
Changes required if the toolbar isn't installed entirely programmatically
- If you experience
RuntimeError: Model class debug_toolbar.models.HistoryEntry doesn't declare an explicit app_label and isn't in an application in INSTALLED_APPS
, you need to remove the reference to the toolbar's urls in yoururls.py
file andMIDDLEWARE
setting when the toolbar isn't inINSTALLED_APPS
- If you experience
- If you have a custom panel, you'll need to adjust
record_stats
and useself.get_stats()
to fetch data for rendering - If you'd like to use the database store, see
TOOLBAR_STORE_CLASS
for more info
Why did the internals change?
The Django Debug Toolbar is a popular package we did not want to block the community from pursuing the async path for Django applications. Writing the request data to a store better positions the toolbar for async projects. It also opens the door for it being usable in production as well with API integrations.
What's Changed
- Log serialization warning when a panel errors. by @tim-schilling in https://github.com/django-commons/django-debug-toolbar/pull/1810
- Improve clarity of record_stats for serialization. by @tim-schilling in https://github.com/django-commons/django-debug-toolbar/pull/1965
- Update serializable branch with main by @tim-schilling in https://github.com/django-commons/django-debug-toolbar/pull/2072
- Remove pin for django-csp. by @tim-schilling in https://github.com/django-commons/django-debug-toolbar/pull/2132
- Fixes #2073 -- Added DatabaseStore for persistent debug data storage. by @dr-rompecabezas in https://github.com/django-commons/django-debug-toolbar/pull/2121
- Disabled document.cookie linter by @tim-schilling in https://github.com/django-commons/django-debug-toolbar/pull/2139
- Added check for pytest as test runner for IS_RUNNING_TESTS. by @tim-schilling in https://github.com/django-commons/django-debug-toolbar/pull/2137
- Remove Type Hints from CspRenderingTestCase by @andoriyaprashant in https://github.com/django-commons/django-debug-toolbar/pull/2144
- Add show_toolbar_with_docker function for Docker IP handling by @matthiask in https://github.com/django-commons/django-debug-toolbar/pull/2153
- Support serializable toolbar by @tim-schilling in https://github.com/django-commons/django-debug-toolbar/pull/2138
- Deduplicate staticfiles by @matthiask in https://github.com/django-commons/django-debug-toolbar/pull/2155
- Fixes #2158 -- Made static file objects orderable by @matthiask in https://github.com/django-commons/django-debug-toolbar/pull/2161
- Fixes #2160 -- Corrected links to static files by @matthiask in https://github.com/django-commons/django-debug-toolbar/pull/2162
- Fixes #2151 -- Forwarded args and kwargs in URLMixin.url by @matthiask in https://github.com/django-commons/django-debug-toolbar/pull/2163
- Fixes #2159 -- Do not HTML-escape traces in the cache and profiling panel by @matthiask in https://github.com/django-commons/django-debug-toolbar/pull/2164
Full Changelog: https://github.com/django-commons/django-debug-toolbar/compare/5.2.0...6.0.0
Acknowlegements
Thank you to all the contributors who made this release possible. Thank you to @robhudson, @matthiask, @tim-schilling, @salty-ivy and @dr-rompecabezas for their support, development and reviews of the serializable toolbar changes. A special shout-out to @matthiask for leading the Djangonaut Space Session 4 team of @dr-rompecabezas, @andoriyaprashant and @blingblin-g.
v5.2.0
What's Changed
- Enhance RedirectsPanel with customizable redirect response hook by @blingblin-g in https://github.com/django-commons/django-debug-toolbar/pull/2104
- Sanitize sensitive variables in RequestPanel by @dr-rompecabezas in https://github.com/django-commons/django-debug-toolbar/pull/2105
- [pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/django-commons/django-debug-toolbar/pull/2112
- [pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/django-commons/django-debug-toolbar/pull/2115
- Dark Mode Conflict in Pygments Fixed by @andoriyaprashant in https://github.com/django-commons/django-debug-toolbar/pull/2111
- Fix #2109: Recursively unwrap loaders to support template partials by @matthiask in https://github.com/django-commons/django-debug-toolbar/pull/2117
- Refs #2096: The theme selector now controls all colors by @matthiask in https://github.com/django-commons/django-debug-toolbar/pull/2116
- Format the templates using djade by @matthiask in https://github.com/django-commons/django-debug-toolbar/pull/2120
- [pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/django-commons/django-debug-toolbar/pull/2122
- [pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/django-commons/django-debug-toolbar/pull/2126
- Keep pannel close button accessible with external styles by @TomHall2020 in https://github.com/django-commons/django-debug-toolbar/pull/2128
- Add CSS resets for height and min-height by @matthiask in https://github.com/django-commons/django-debug-toolbar/pull/2130
New Contributors
- @TomHall2020 made their first contribution in https://github.com/django-commons/django-debug-toolbar/pull/2128
Full Changelog: https://github.com/django-commons/django-debug-toolbar/compare/5.1.0...5.2.0
v5.1.0
What's Changed
- Update version for sigstore action to full version. by @tim-schilling in https://github.com/django-commons/django-debug-toolbar/pull/2056
- [pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/django-commons/django-debug-toolbar/pull/2053
- Add Django 5.2 to tox matrix by @tim-schilling in https://github.com/django-commons/django-debug-toolbar/pull/2064
- [pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/django-commons/django-debug-toolbar/pull/2063
- [pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/django-commons/django-debug-toolbar/pull/2067
- [pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/django-commons/django-debug-toolbar/pull/2077
- Update package metadata to include well-known labels by @andoriyaprashant in https://github.com/django-commons/django-debug-toolbar/pull/2078
- Pinned django-csp's version used for our tests by @matthiask in https://github.com/django-commons/django-debug-toolbar/pull/2084
- [pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/django-commons/django-debug-toolbar/pull/2080
- Add resources section to the documentation by @dr-rompecabezas in https://github.com/django-commons/django-debug-toolbar/pull/2081
- Make show toolbar callback function async/sync compatible. by @tim-schilling in https://github.com/django-commons/django-debug-toolbar/pull/2066
- Fix last name typo in resources.rst by @dr-rompecabezas in https://github.com/django-commons/django-debug-toolbar/pull/2085
- Add link to contributing documentation in CONTRIBUTING.md by @blingblin-g in https://github.com/django-commons/django-debug-toolbar/pull/2086
- Pull translations from transifex by @matthiask in https://github.com/django-commons/django-debug-toolbar/pull/2089
- Replace ESLint and prettier with biome by @matthiask in https://github.com/django-commons/django-debug-toolbar/pull/2090
- Enable a few of the disabled biome rules by @matthiask in https://github.com/django-commons/django-debug-toolbar/pull/2091
- Replace forEach loops with for...of loops by @matthiask in https://github.com/django-commons/django-debug-toolbar/pull/2093
- [pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/django-commons/django-debug-toolbar/pull/2095
- Add help command to the Makefile by @mrbazzan in https://github.com/django-commons/django-debug-toolbar/pull/2094
- Replace DebugConfiguredStorage with URLMixin in staticfiles panel by @dr-rompecabezas in https://github.com/django-commons/django-debug-toolbar/pull/2097
- Fix for exception-unhandled "forked" Promise chain by @karolyi in https://github.com/django-commons/django-debug-toolbar/pull/2101
- [pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/django-commons/django-debug-toolbar/pull/2102
- [pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/django-commons/django-debug-toolbar/pull/2107
- Fix Dark Mode Conflict in Pygments by @andoriyaprashant in https://github.com/django-commons/django-debug-toolbar/pull/2108
- Refactor on csp_nonce usage with django-csp by @tim-schilling in https://github.com/django-commons/django-debug-toolbar/pull/2088
New Contributors
- @andoriyaprashant made their first contribution in https://github.com/django-commons/django-debug-toolbar/pull/2078
- @dr-rompecabezas made their first contribution in https://github.com/django-commons/django-debug-toolbar/pull/2081
- @blingblin-g made their first contribution in https://github.com/django-commons/django-debug-toolbar/pull/2086
- @mrbazzan made their first contribution in https://github.com/django-commons/django-debug-toolbar/pull/2094
Full Changelog: https://github.com/django-commons/django-debug-toolbar/compare/5.0.1...5.1.0
v5.0.1
What's Changed
There were no functional changes in this version.
MRs
- Update release workflows to latest trusted publisher GHA. by @tim-schilling in https://github.com/django-commons/django-debug-toolbar/pull/2054
Full Changelog: https://github.com/django-commons/django-debug-toolbar/compare/5.0.0...5.0.1
v5.0.0
What's Changed
Please note that Django Debug Toolbar has now moved into the Django Commons organization.
Changelog
- Added Python 3.13 to the CI matrix.
- Removed support for Python 3.8 as it has reached end of life.
- Converted to Django Commons PyPI release process.
- Fixed a crash which occurred when using non-
str
static file values. - Documented experimental async support.
- Improved troubleshooting doc for incorrect mime types for .js static files
- Support async applications and ASGI from
Google Summer of Code Project 2024 <https://summerofcode.withgoogle.com/programs/2024/projects/iXVvyGYp>
__. - Added Django 5.1 to the CI matrix.
- Added support for the
LoginRequiredMiddleware
introduced in Django 5.1. - Support select and explain buttons for
UNION
queries on PostgreSQL. - Fixed internal toolbar requests being instrumented if the Django setting
FORCE_SCRIPT_NAME
was set. - Increase opacity of show Debug Toolbar handle to improve accessibility.
- Changed the
RedirectsPanel
to be async compatible. - Increased the contrast of text with dark mode enabled.
- Add translations for Bulgarian and Korean.
- Update translations for several languages.
- Include new translatable strings for translation.
- Fixed a crash which happened in the fallback case when session keys cannot be sorted.
MRs
- Async compatible debug-toolbar middleware by @salty-ivy in https://github.com/django-commons/django-debug-toolbar/pull/1938
- Add async tests by @salomvary in https://github.com/django-commons/django-debug-toolbar/pull/1835
- Update installation.rst by @Dr-Bernard in https://github.com/django-commons/django-debug-toolbar/pull/1967
- Make toolbar compatible with
FORCE_SCRIPT_NAME
by @dmartin in https://github.com/django-commons/django-debug-toolbar/pull/1970 - Support select and explain for UNION queries by @friedelwolff in https://github.com/django-commons/django-debug-toolbar/pull/1972
- Override
DEBUG=True
in async middleware compatibility tests by @salty-ivy in https://github.com/django-commons/django-debug-toolbar/pull/1977 - Quick hack for including csp_nonces from requests into script tags by @karolyi in https://github.com/django-commons/django-debug-toolbar/pull/1975
- Slightly increase opacity of debug toolbar button by @jribbens in https://github.com/django-commons/django-debug-toolbar/pull/1982
- Async compatible redirect panel by @salty-ivy in https://github.com/django-commons/django-debug-toolbar/pull/1976
-
🔧 update translation for Persian language by @elias-ebrahimpour in https://github.com/django-commons/django-debug-toolbar/pull/1873 - Add a paragraph describing our stance on Python typing by @matthiask in https://github.com/django-commons/django-debug-toolbar/pull/1979
- Dark mode text needs higher contrast by @myou1985 in https://github.com/django-commons/django-debug-toolbar/pull/1987
- Switch to Django Commons code of conduct by @tim-schilling in https://github.com/django-commons/django-debug-toolbar/pull/1978
- Update translations by @tim-schilling in https://github.com/django-commons/django-debug-toolbar/pull/1984
- Make Panels non async by default by @salty-ivy in https://github.com/django-commons/django-debug-toolbar/pull/1990
- Async compatible
StaticFilesPanel
by @salty-ivy in https://github.com/django-commons/django-debug-toolbar/pull/1983 - Refs #1668: Fixed the unsortable session keys fallback by @matthiask in https://github.com/django-commons/django-debug-toolbar/pull/1994
- Add Django 5.1 to the CI matrix by @matthiask in https://github.com/django-commons/django-debug-toolbar/pull/1995
- Use Heading-4 for MR template for screen-readers. by @tim-schilling in https://github.com/django-commons/django-debug-toolbar/pull/1999
- Async compatible
HistoryPanel
by @salty-ivy in https://github.com/django-commons/django-debug-toolbar/pull/1991 - Async compatible
SQLPanel
by @salty-ivy in https://github.com/django-commons/django-debug-toolbar/pull/1993 - Correct "middleware" typos by @korverdev in https://github.com/django-commons/django-debug-toolbar/pull/2003
- add support for LoginRequiredMiddleware with login_not_required decor… by @dulmandakh in https://github.com/django-commons/django-debug-toolbar/pull/2005
- Async integration tests by @salty-ivy in https://github.com/django-commons/django-debug-toolbar/pull/2001
- Modernize Python type hints and string formatting by @cclauss in https://github.com/django-commons/django-debug-toolbar/pull/2012
- Adding in support for Python 3.13 by @abeed-avayu in https://github.com/django-commons/django-debug-toolbar/pull/2014
- Fix #2011: Test the divisor, not the dividend for zero by @matthiask in https://github.com/django-commons/django-debug-toolbar/pull/2015
- Update Installation warning doc by @salty-ivy in https://github.com/django-commons/django-debug-toolbar/pull/2019
- Convert to Django Commons pypi-github release process by @tim-schilling in https://github.com/django-commons/django-debug-toolbar/pull/2017
- The static files panel shouldn't choke on unexpected data types by @matthiask in https://github.com/django-commons/django-debug-toolbar/pull/2021
- Update references to point to django-commons repo by @robhudson in https://github.com/django-commons/django-debug-toolbar/pull/2022
- Update pyupgrade's target version to Python 3.9 by @ulgens in https://github.com/django-commons/django-debug-toolbar/pull/2024
- I added more explanations to the example/readme file. by @jong-seoung in https://github.com/django-commons/django-debug-toolbar/pull/2027
- Adopt a basic security policy by @tim-schilling in https://github.com/django-commons/django-debug-toolbar/pull/2040
- Fix whitespace view in code by @thesayfulla in https://github.com/django-commons/django-debug-toolbar/pull/2043
- Documented experimental async support. by @tim-schilling in https://github.com/django-commons/django-debug-toolbar/pull/2045
- Updated Troubleshooting documentation: simpler mimetype workaround for .js file by @blep in https://github.com/django-commons/django-debug-toolbar/pull/2047
Google Summer of Code - Async project
This release contains the changes for async compatibility for the majority of panels. This is the result of the Google Summer of Code project by @salty-ivy. A massive thank you
New Contributors
- @Dr-Bernard made their first contribution in https://github.com/django-commons/django-debug-toolbar/pull/1967
- @dmartin made their first contribution in https://github.com/django-commons/django-debug-toolbar/pull/1970
- @friedelwolff made their first contribution in https://github.com/django-commons/django-debug-toolbar/pull/1972
- @karolyi made their first contribution in https://github.com/django-commons/django-debug-toolbar/pull/1975
- @jribbens made their first contribution in https://github.com/django-commons/django-debug-toolbar/pull/1982
- @elias-ebrahimpour made their first contribution in https://github.com/django-commons/django-debug-toolbar/pull/1873
- @myou1985 made their first contribution in https://github.com/django-commons/django-debug-toolbar/pull/1987
- @korverdev made their first contribution in https://github.com/django-commons/django-debug-toolbar/pull/2003
- @dulmandakh made their first contribution in https://github.com/django-commons/django-debug-toolbar/pull/2005
- @abeed-avayu made their first contribution in https://github.com/django-commons/django-debug-toolbar/pull/2014
- @robhudson made their first contribution in https://github.com/django-commons/django-debug-toolbar/pull/2022
- @ulgens made their first contribution in https://github.com/django-commons/django-debug-toolbar/pull/2024
- @jong-seoung made their first contribution in https://github.com/django-commons/django-debug-toolbar/pull/2027
- @thesayfulla made their first contribution in https://github.com/django-commons/django-debug-toolbar/pull/2043
- @blep made their first contribution in https://github.com/django-commons/django-debug-toolbar/pull/2047
Full Changelog: https://github.com/django-commons/django-debug-toolbar/compare/4.4.6...5.0.0
Configuration
-
If you want to rebase/retry this MR, check this box
This MR has been generated by Renovate Bot.