ngMigration Assistant

ngMigration Assistant is an easy-to-use command line utility that scans an AngularJS application and recommends how to migrate to Angular.

!ajs-app-dark-slow

Getting Started

$3

Whether you are using npm or yarn package manager, install ngma globally.
``


npm install -g ngma


yarn global add ngma

$3

ngMigration Assistant will scan the current working directory or the input directory.`ngma`

`App Composition`

`$3`

Runs the analysis on the provided directory and returns a recommendation on which migration path to take to Angular. It looks at the complexity, source lines of code (sloc), antipatterns, AngularJS version, and preparation necessary for migration. It identifies the files that need to be modified and the specific changes that will prepare the app for upgrading.

`$3`

* `buildPathIgnoringGlobs()`Builds a new filesystem by removing files matching the ignore globs using glob. Returns as an array of the new filesystem. *`getGlobsFromGitignore()`Parses .gitignore file into an array of globs and appends default globs to the array. Filters out patterns starting with ! from the array because ! means to never ignore. Returns the globs to ignore.`countLinesOfCode()` asynchronous* Counts sloc using node-sloc to traverse new filesystem returned by buildPathIgnoringGlobs(). Returns a promise that resolves to sloc. *`runAnalysis()`Traverses through filtered filesystem returned by buildPathIgnoringGlobs() and calls testFile() to run the individual tests.`runAntiPatternReport()` asynchronous* Creates the anti-pattern report and calculates the rewriteThreshold runRecommendation() uses. Each time an anti-pattern is found, general instructions and files needing corrections are appended to the preparation report. Returns a promise that resolves to the preparation report.`runRecommendation()`` asynchronous* Recommendation algorithm that checks type of application (AngularJS, Angular, or hybrid), checks if sloc is under the rewriteThreshold, and checks if passes the ngUpgrade requirements. Returns a recommendation and preparation report.

$3

* node-glob
* parse-gitignore
* node-sloc
* readline-sync

Authors

Elana Olson - ellamaolson

License

App Composition

$3

Runs the analysis on the provided directory and returns a recommendation on which migration path to take to Angular. It looks at the complexity, source lines of code (sloc), antipatterns, AngularJS version, and preparation necessary for migration. It identifies the files that need to be modified and the specific changes that will prepare the app for upgrading.

$3

* `buildPathIgnoringGlobs()`

 Builds a new filesystem by removing files matching the ignore globs using glob. Returns as an array of the new filesystem.
*

`getGlobsFromGitignore()`

 Parses .gitignore file into an array of globs and appends default globs to the array. Filters out patterns starting with ! from the array because ! means to never ignore. Returns the globs to ignore.

`countLinesOfCode()`

asynchronous* Counts sloc using node-sloc to traverse new filesystem returned by buildPathIgnoringGlobs(). Returns a promise that resolves to sloc.
*

`runAnalysis()`

 Traverses through filtered filesystem returned by buildPathIgnoringGlobs() and calls testFile() to run the individual tests.

`runAntiPatternReport()`

asynchronous* Creates the anti-pattern report and calculates the rewriteThreshold runRecommendation() uses. Each time an anti-pattern is found, general instructions and files needing corrections are appended to the preparation report. Returns a promise that resolves to the preparation report.

`runRecommendation()`` asynchronous* Recommendation algorithm that checks type of application (AngularJS, Angular, or hybrid), checks if sloc is under the rewriteThreshold, and checks if passes the ngUpgrade requirements. Returns a recommendation and preparation report.