Marko v3 Migration Tool
This tool can be used to migrate a project that uses Marko v2 to be compatible with Marko v3. All taglibs and templates within the project (excluding anything under node_modules) will automatically be migrated.
Installation
npm install marko-migrate --global
Usage
⚠️ ⚠️ WARNING: This tool modifies a project in place! Make sure you are using source control or have your code backed up! If you are using source control then make sure everything has been committed first! ⚠️ ⚠️
IMPORTANT: Make sure you run an npm install for your current project before running the migration script!
NOTE: Node.js v4+ is required
Migrate a project and use the HTML syntax
cd my-project/
marko-migrate --syntax html
Migrate a project and use the concise syntax
cd my-project/
marko-migrate --syntax concise
Migrate a single file and use the concise syntax
cd my-project/
marko-migrate --template src/template.marko --syntax concise
Example Output
You will receive output similar to the following:
marko-migrate --syntax html[modified] package.json - [info] Updated "marko" version: ^2.7.3 → ^3.0.0-rc.1 (in "dependencies") - [info] Updated "marko-widgets" version: ^5.0.0-beta → ^6.0.0-alpha.1 (in "dependencies") - [info] Updated "lasso" version: ^1.10.1 → ^2.0.0 (in "dependencies")[modified] test/mocha-phantomjs/test-page.marko[modified] src/pages/home/template.marko[modified] src/pages/error/template.marko[modified] src/components/app-todo-item/template.marko[modified] src/components/app-notifications-overlay/template.marko[modified] src/components/app-notification/template.marko[modified] src/components/app-main/template.marko[modified] src/components/app-header/template.marko[modified] src/components/app-footer/template.marko[modified] src/components/app/template.marko[moved] src/marko-taglib.json → src/marko.json PENDING TASKS:[task] The following installed package should now be migrated: node_modules/browser-refresh-taglib/marko-taglib.json[task] The following installed package should now be migrated: node_modules/lasso/marko-taglib.json[task] The following installed package should now be migrated: node_modules/marko-widgets/marko-taglib.json Migration completed successfully!:- 0 warning(s)- 3 pending task(s)