Changelog¶
Unreleased¶
Say in MAINTAINING.md that
just release-checkreporting noUnreleasedentries straight after a cut means nothing is pending, not that the changelog was lost.Add
.gitattributeswith* text=auto, so the repository stores text files with LF whatever the committing machine used..editorconfigasked for this and could not enforce it.Drop
max_line_lengthfor Python from.editorconfig. It said 88 while ruff enforces 120, so an editor honouring it flagged code that passes lint.Store
src/bootstrap4/widgets.pywith LF line endings. It was the only file in the repository with CRLF, and.gitattributesrenormalises it.Fail
just linton trailing whitespace, and strip it injust format..editorconfigasked for it and nothing enforced it, so it depended on each person’s editor. Markdown hard line breaks, which are exactly two trailing spaces, are preserved.Fail
just lintifCHANGELOG.mdhas more than one## Unreleasedheading, or has it below a released section. Branches that each add the heading merge without a conflict.
26.3 (2026-10-11)¶
Breaking: Drop support for Python 3.10, end of life since 2026-10-01. The floor is now Python 3.11.
Breaking: Fix invalid HTML in
RadioSelectButtonGroup. Every option label carried the widget’s ownid, so a group of N options rendered N+1 identicalidattributes and no label was associated with its input. Labels now carryforpointing at their own input and noid(#309).Fix
RadioSelectButtonGroupnot rendering as a button group. The renderer replaced the class attribute of a widget’s enclosing element instead of adding to it, discardingbtn-group btn-group-toggle. Django’s ownRadioSelectandCheckboxSelectMultipleset no class there, so their output is unchanged (#894).Fix
{% buttons layout="horizontal" %}emitting Bootstrap 3 markup: the label carriedcontrol-labelinstead ofcol-form-label, and the wrapper had norowfor thecol-*classes to divide, so the button did not line up with the fields above it (#895).Fix
form_check_classbeing ignored for single checkboxes; it was only applied toRadioSelectandCheckboxSelectMultiple(#290).Fix
show_labelandlabel_classbeing ignored for the label next to a checkbox.show_label=Falseandshow_label='sr-only'now addsr-only,show_label='skip'omits the label, andlabel_classextendsform-check-labelinstead of being dropped (#127).Fix
sizenot being applied to the input group wrapper when a field has an addon, soinput-group-smandinput-group-lgwere missing and the addon rendered at the wrong height (#128).Add a system check that warns about keys in the
BOOTSTRAP4setting that the package does not read, such asbase_url, dropped in 0.0.8 (bootstrap4.W001, #883). Silence it withSILENCED_SYSTEM_CHECKSif you keep extra keys deliberately.Remove the
<7.0upper bound on theDjangodependency.Test on Python 3.15 (release candidate) against Django 6.1 and
main. The job is non-blocking and 3.15 is not yet advertised as supported.Fail the CI gate when any job fails, not only the test matrix. A failing docs or packaging build could previously be merged.
Cover
renderers.py,components.pyand the template tags with tests, and hold the line at 100%.InlineFieldRendererhad no tests at all, nor did theSelectDateWidget, file input andReadOnlyPasswordHashWidgetmarkup fixes, the non-dismissible alert, formset-level errors,{% buttons reset=... %}, or the asset tags with a URL set toNone.coverage reportnow fails below 100%, matching django-marina, django-bootstrap5, django-icons and django-bootstrap3.Cover
utils.py,forms.pyandtext.pywith tests.handle_var,parse_token_contents,remove_css_class,render_link_tag, everyrender_buttonsize and optional attribute, the standalone error renderers,render_field_and_labelin horizontal layout, andtext_concathad no tests.Cover pagination with tests.
get_pagination_contextand thebootstrap_paginationandbootstrap_url_replace_paramtags had no tests at all.Remove an unreachable guard in
get_pagination_context:pages_to_showis already an integer of at least one by that point, so the half window cannot be negative.Add
just release-check, which lists the commits since the last tag next to the currentUnreleasedentries, in two groups: those touchingsrc/, and those touching nothing insrc/. Tooling, CI and documentation changes ship too, and a list filtered tosrc/read as a complete one.Fail
just buildwhenuv.lockdoes not name the version inpyproject.toml, and addjust relockto fix it.uv sync --frozendoes not check the project’s own version, so a stale lock passed every packaging check.Run
coverage reportin CI, so the 100% floor can actually fail a build rather than only a local run (#904).Harden the workflows against the findings of a
zizmoraudit: the Dependabot job gates on the pull request author rather thangithub.actor,ci.ymldeclarescontents: readinstead of inheriting a write-capable token, and the publishing job no longer restores a shared cache. Restore thetimeout-minutesthe Dependabot and release jobs had lost (#900).Fail
just linton invisible and bidirectional control characters, which do not render in a diff and can therefore hide code (Trojan Source, CVE-2021-42574). Two were removed fromdocs/settings.rst(#888).Fix stale Bootstrap 3 class names in the
bootstrap_fielddocs:error_css_classdefaults tois-invalidandbound_css_classtois-valid, and the label getscol-form-labelin horizontal layout, notcontrol-label.Document why bound forms, including GET filter forms, render
is-validon every field, and how to switch that off (#276).Document that
use_i18ninBOOTSTRAP4is always overwritten by Django’sUSE_I18N.Add the shared AI assistance policy to
CONTRIBUTING.md, and the dependency update policy toMAINTAINING.md(#887, #900).Add a
CLAUDE.mdshim so Claude Code loadsAGENTS.md, and trimAGENTS.mdto what a session cannot read from the repo itself (#885).
26.2 (2026-08-28)¶
Drop support for Django 4.2 (EOL).
Add support for Django 6.1.
Fix
KeyErrorinurl_replace_paramwhen clearing a parameter that is not present in the URL (#862).Add a maintenance-round section and release-note ordering convention to MAINTAINING.md.
Add a 15-minute
timeout-minutesto every CI job.Add
typosspell checking tojust lint.Regenerate
uv.lock(stale Django>=4.2constraint in the lockfile’s own metadata after thepyproject.tomlfloor moved to>=5.2).Add MAINTAINING.md (version-support policy, release process); add scope statement and PR-review checklist to CONTRIBUTING.md.
Add AGENTS.md (#862).
Fix typos in
CHANGELOG.md.
26.1 (2026-01-03)¶
Refactor release workflow to tag-based publishing via GitHub Actions (#843).
Remove support for Django 5.1 (EOL) (#840).
25.3 (2025-11-14)¶
Remove support for Python 3.9 (EOL) (#833, #835).
Add support for Python 3.14 (#831).
Add support for Django 6.0 (#830).
25.2 (2025-07-31)¶
Symlink CHANGELOG.md into docs for Sphinx (#812).
Drop support for Django 5.0 (EOL) (#814).
Add support for Django 5.2 (#815).
Use astral-sh/setup-uv in GitHub Actions (#820, #821).
Use
uv build(#822).Use
uv.lockin GitHub Actions (#823).
25.1 (2025-03-01)¶
Announce maintenance mode (#808).
Switch to just and uv (#805).
Remove Python 3.8, add Python 3.13 (#805).
24.4 (2024-09-19)¶
Add support for Django 5.1 (#758).
24.3 (2024-04-17)¶
Reinstate setuptools_scm for build (#707).
24.2 (2024-04-16)¶
Remove setuptools_scm (#704).
Fix Read the Docs (#703).
Remove support for Django 3.2 (EOL).
24.1 (2024-01-29)¶
Fix CheckboxSelectMultiple on Django>4 (#672, @heso).
23.4 (2023-12-28)¶
Use setuptools-scm to build package (#664).
23.3 (2023-12-24)¶
Use ruff instead of black for formatting (#653).
Add support for Python 3.12 (#658).
Add support for Django 5.0 (#658).
Revert packaging tools to setuptools, build, tox and twine (#658).
23.2 (2023-06-28)¶
Fix references to example application (#648).
Remove support for Python 3.7 (EOL) (#646).
Switch to Hatch (#638).
Fix readthedocs (#603).
Remove version restriction on importlib-metadata (#604).
Replace m2r2 with sphinx-mdinclude (#605).
23.1 (2023-04-05)¶
Add support for Django 4.2 (#601).
Update requirements and packages (#601).
Stop using coveralls (#601).
22.3 (2022-11-23)¶
Add support for Python 3.11 (#554).
22.2 (2022-08-08)¶
Update Bootstrap to 4.6.2 (#499).
Drop support for Django 2.2 (EOL) (#500).
Add support for Django 4.1 (#500).
22.1 (2022-03-07)¶
Add support for Django 4 (#447).
Fix urls in example (#418, #444).
21.2 (2021-12-27)¶
Drop support for Django 4 (#398).
Drop support for Django 3.1 (EOL, #399).
Drop support for Python 3.6 (EOL, #399).
Fix CI.
21.1 (2021-11-03)¶
Switch to a CalVer YY.MINOR versioning scheme. MINOR is the number of the release in the given year. This is the first release in 2021 using this scheme, so its version is 21.1. The next version this year will be 21.2. The first version in 2022 will be 22.1.
Add support for Django 4.0 and Python 3.10 (#349).
Fix faulty example code (#347).
3.0.1 (2021-05-01)¶
No line break in FileInput in horizontal layout.
Actually use the bundles JavaScript.
3.0.0 (2021-04-09)¶
Drop support for Django 3.0, extended support stopped on 2021-04-01).
Add support for Django 3.2.
Use bundled Bootstrap JavaScript, no need for separate popper.js.
Updated default Bootstrap to 4.6.0.
Add Dependabot for updates to dependencies.
Rename AUTHORS.md to AUTHORS, remove authors section from documentation.
Revert to setuptools for packaging.
Add Python 3.9 to Travis CI.
Add docs and tests to sdist.
Use GitHub Actions for CI.
Fix example by not installing editable version.
2.3.1 (2020-10-16)¶
Fix CHANGELOG.
2.3.0 (2020-10-11)¶
Updated default Bootstrap to 4.5.2.
Updated CSS/JavaScript URLs to newer versions (thanks @emmceemoore).
Replace
m2rwithm2r2to support Sphinx3.Update Sphinx dependency because of security update.
Use Django 3.1 in
toxmatrix, fix warning in tests.Add
toxto development dependencies.Accept importlib-metadata 2.x.x (thanks @dbaty).
Add Python 3.9 to tox matrix.
2.2.0 (2020-07-01)¶
Fix coveralls.
Add Django 3.1 to tox matrix.
2.1.1 (2020-06-18)¶
Fix date in CHANGELOG.
Fix typo in pyproject.toml (#222).
2.1.0 (2020-06-17)¶
Convert HISTORY.rst to Markdown and rename to CHANGELOG.md.
Convert README.rst, AUTHORS.rst and CONTRIBUTING.rst to Markdown, and change extension to .md.
Update CONTRIBUTING.md to reflect use of
poetry.Drop contributing.rst from documentation.
Rename default branch ‘master’ to ‘main’.
2.0.1 (2020-06-02)¶
Set beautifulsoup4 requirement to >= 4.8.0 (fixes #216).
Do not assume all inputs are inside labels (fixes #215).
2.0.0 (2020-06-01)¶
Use poetry (https://python-poetry.org/) for dependency management and packaging.
Drop support for Python 3.5.
Fix form-check-{label,input} classes applied too broadly. These should only be applied to labels and inputs found underneath the enclosing widget div for radio and checkbox select, not on the whole document.
Allow to display radio and checkbox elements inline using the
form-checkclasses.
1.1.2 (2019-12-13)¶
Restructure tox and Makefile.
Add test for
bootstrap4.__version__.
1.1.1 (2019-12-11)¶
Remove tag command from Makefile.
Reinstate
bootstrap4.__version__(#186).Add test for using a different jQuery version (#184).
1.1.0 (2019-12-09)¶
Update default Bootstrap to v4.3.1.
Add support for Python 3.8, Django 3 and Django master.
Switch to Django
manage.pyfor test running.Update Makefile commands.
Update tox configuration.
Use correct license (BSD-3-Clause).
Fix typo’s in docstrings.
Update Travis configuration.
Drop MANIFEST.in, use
setuptools_scm.Stop using
_version.py, use git tags for versioning.Fixed issues with labels and input (#174 and #181).
1.0.1 (2019-08-30)¶
Fix support for Python 3.5 (#168).
Set correct Python versions in setup.py.
Fix
make testcommand.
1.0.0 (2019-08-30)¶
Set default class for buttons to
btn-primary(#150.Drop support for Python 2 and Django 1.11, 2.0 and 2.1 (#155).
Template tag
bootstrap_fieldnow allows 3 values forshow_label:True,False,sr-onlyandskip\. In the case ofFalse/sr-onlythe label is hidden but present for screen readers. Whenshow_labelis set toskip, the label is not generated at all.Fix validation on input groups (#122).
No longer duplicate jquery in bootstrap4.html (#139, #140).
Apply
form-check,form-check-labelandform-check-inputclasses to appropriate tags forRadioSelectandCheckboxSelectMultiplewidgets (#141).Errors on file inputs are shown (#146).
Only display non-field errors in form alert block (#161).
Reinstate
bootstrap4_titleblock tobootstrap4.html(#156).Fix typo in
alert-dismissibleclass (#142).Honor the
form_group_classparameter in thebuttonstag (#162).
0.0.8 (2019-03-12)¶
Drop support for the
base_urlsetting (#105).Remove use of “falsy” as a string literal (#111).
Fix javascript inclusion bugs (#71).
Allow email to have addons (#131).
Do not mark placeholder text as safe (#135).
0.0.7 (2018-08-22)¶
Improve alert accessibility (#93.
Add a new widget: RadioSelectButtonGroup (#103.
Several fixes and improvements to HTML renderin.
Switch to explicit Travis test.
Upgrade Bootstrap to 4.1.1
Upgrade jQuery to 3.3.1
Upgrade Popper to 1.14.3
Fixed
bootstrap4.htmlto add jQuery per settinginclude_jquery=[False|'full'|'slim'].Adopt Black formatting, see https://github.com/ambv/black.
0.0.6 (2018-02-14)¶
Change form help text element from div to small (#60).
Upgrade Bootstrap to 4.0.0 (#66).
0.0.5 (2018-01-03)¶
Drop develop branch, work with master and feature branches.
Clean up
HISTORY.rst.Upgrade Bootstrap to 4.0.0-beta.3.
Use
col-4rather thancol-xs-4(#54).Added pagination alignment options (#56).
Fixed form field errors and help texts (#39.
Use django language if
USE_I18N=True(#53).
0.0.4 (2017-10-26)¶
Upgrade Bootstrap to 4.0.0-beta.2.
Fix settings, tags and tests for remote JS and CSS.
0.0.3 (2017-09-24)¶
Upgraded bootstrap4 to the beta version.
[0.0.2] - (2017-09-06, not released on PyPI)¶
Upgraded jQuery version from CDN to 3.2.1 (#17).
Added proper pagination layout classes (#19).
0.0.1 (2017-06-04)¶
First release.
Remove
bootstrap_icon, BS4 no longer has default icons.Various changes to get from 3 to 4, started MIGRATE.rst.
Started
django-bootstrap4based ondjango-bootstrap3.Thanks everybody that contributed to
django-bootstrap3!