Script for migrating Bootstrap 2.x code to Bootstrap 3.x
Supports
- html
- js
- less
- py
Make sure to backup your code before running this script on it!
This script will automatically search your code and make necessary
replacements to migrate your codebase to Bootstrap 3.x. It will create a
warnings.md file in the cwd with all of the line numbers that you will need
to update by hand along with helpful warning messages.
- Configure
config.yml(or a copy of it) to point to your project(s) directories. The directories defined here get recursively traversed. Currently there is no way to blacklist directories, this only behaves like a whitelist. - Run
python migrate.py config.yml bootstrap2to3.json runto upgrade the directories (optionally replaceconfig.ymlwith the name of your config file).
This tool supports two commands, run and dump. run executes a migration
file on the contents of a directory. dump creates a template migration file
for a directory.
You can also use this tool as a general python/web refactoring tool. To export
the list of CSS and LESS variables used by your program, run
python migrate.py config.yml output.json dump. This will create/overwrite
output.json with dictionaries that you can edit by hand. You can change
output.json to any file name you want.
After editing the outputed file with your refactoring data, you can refactor
your program by running python migrate.py config.yml output.json run
(you'll need to replace output.json with the name of the outputed file).
This program attempts to make the replacements suggested at http://getbootstrap.com/migration/ . It also attempts to warn for the removed CSS classes.
Change:
@bodyBackgroundto@body-bg@textColorto@text-color@linkColorto@link-color@linkColorHoverto@link-hover-color@blueto@brand-primary@greento@brand-success@redto@brand-danger@orangeto@brand-warning@gridColumnsto@grid-columns@gridGutterWidthto@grid-gutter-width@sansFontFamilyto@font-family-sans-serif@serifFontFamilyto@font-family-serif@monoFontFamilyto@font-family-monospace@baseFontSizeto@font-size-base@baseFontFamilyto@font-family-base@baseLineHeightto@line-height-base@headingsFontFamilyto@headings-font-family@headingsFontWeightto@headings-font-weight@headingsColorto@headings-color@fontSizeLargeto@font-size-large@fontSizeSmallto@font-size-small@paddingLargeto@padding-large-vertical @padding-large-horizontal@paddingSmallto@padding-small-vertical @padding-small-horizontal@paddingMinito@padding-xs-vertical @padding-xs-horizontal@baseBorderRadiusto@border-radius-base@borderRadiusLargeto@border-radius-large@borderRadiusSmallto@border-radius-small@tableBackgroundto@table-bg@tableBackgroundAccentto@table-bg-accent@tableBackgroundHoverto@table-bg-hover@placeholderTextto@input-color-placeholder@inputBackgroundto@input-bg@inputBorderto@input-border@inputBorderRadiusto@input-border-radius@inputDisabledBackgroundto@input-bg-disabled@navbarHeightto@navbar-height@navbarBackgroundto@navbar-default-bg@navbarTextto@navbar-default-color@navbarLinkColorto@navbar-default-link-color@navbarLinkColorHoverto@navbar-default-link-hover-color@navbarLinkColorActiveto@navbar-default-link-active-color@navbarLinkBackgroundHoverto@navbar-default-link-hover-bg@navbarLinkBackgroundActiveto@navbar-default-link-active-bg@dropdownBackgroundto@dropdown-bg@dropdownBorderto@dropdown-border@dropdownLinkColorto@dropdown-link-color@dropdownLinkColorHoverto@dropdown-link-hover-color@dropdownLinkBackgroundHoverto@dropdown-link-hover-bg
Warn about removal:
@yellow@pink@purple@iconSpritePath@iconWhiteSpritePath@gridColumnWidth@gridColumnWidth1200@gridGutterWidth1200@gridColumnWidth768@gridGutterWidth768@altFontFamily@fontSizeMini@heroUnitBackground@heroUnitHeadingColor@heroUnitLeadColor@tableBorder@formActionsBackground@btnPrimaryBackground@btnPrimaryBackgroundHighlight@warningText@warningBackground@errorText@errorBackground@successText@successBackground@infoText@infoBackground@navbarBackgroundHighlight@navbarBrandColor@navbarSearchBackground@navbarSearchBackgroundFocus@navbarSearchBorder@navbarSearchPlaceholderColor@navbarCollapseWidth@navbarCollapseDesktopWidth