Home

Awesome

ng-parsel

<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->

All Contributors

<!-- ALL-CONTRIBUTORS-BADGE:END -->

Coverage Status

Convert your Angular components to JSON

<div style="display: flex; justify-content: center"> <img src="https://github.com/angular-experts-io/ng-parsel/blob/main/docs/logo.png?raw=true" style="width: 250px"> </div> <!-- START doctoc generated TOC please keep comment here to allow auto update --> <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE --> <!-- END doctoc generated TOC please keep comment here to allow auto update -->

What is this module about

This module extracts the most important information of your Angular code base and converts it into JSON. Having the most important parts of your Angular code base as JSON can be very useful to perform custom analysis or to display APIs. Displaying APIs is especially useful for library authors that want to illustrate their library in a component showcase.

Getting started

Install

Install ng-parsel as a dev dependency in your repository.

npm i -D @angular-experts/ng-parsel

Init configuration

Once installed you can use npx to create an initial configuration for ng-parsel.

npx @angular-experts/ng-parsel init

Running this command will create a .parselrc.json configuration file in the root of your repository. Check the initial configuration and adjust if needed. The configuration properties and their meaning are explained in the configuration section.

Commands

Parse

To parse the code base you can either create a parse script in your package.jsonwhich calls ng-parsel or you can use npx.

Parse script

Add the following script to your package.json.

"parse": "@angular-experts/ng-parsel parse"

Once added, you can open up a terminal and run the following command.

npm run parse

NPX

To parse your code base with npx you can run the follwoing command inisde a terminal of your choice.

npx @angular-experts/ng-parsel parse

Configuration

ng-parsel offers the following configurations.

PropertyDefault valueDescription
src'src'Glob to query all the src files that should be parsed
out'ng-parsel'Output directory
parseComponentstrueIf set to true ng-parsel will parse Angular Components and include them in the output.
parseServicestrueIf set to true ng-parsel will parse Angular Services and include them in the output.
parsePipestrueIf set to true ng-parsel will parse Angular Pipes and include them in the output.
parseDirectivestrueIf set to true ng-parsel will parse Angular Directives and include them in the output.
parseModulestrueIf set to true ng-parsel will parse Angular Modules and include them in the output.
parseHarnessestrueIf set to true ng-parsel will parse Harness test files (all files ending with .harness.ts) and include them in the output.
parseValidatorstrueIf set to true ng-parsel will parse Validators (all files ending with .validator.ts) and include them in the output.
parseSpecstrueIf set to true ng-parsel will parse testing files (all files ending with .spec.ts) and include them in the output.
singleFiletrueIf set to to true the output will be written to a ng-parsel.json file in the output directory. If set to false, ng-parsel will generate multiple output files, one for each componentType. (Find out more on component types in the next section)

Stats

The stats command is a command that gives you a quick overview of your Angular application. It shows you how many components, services, pipes, directives, modules, harnesses and specs you have in your application. Furthermore, it shows you interesting insights, like how many are standanlone and how many are part of a module. To run the stats command you can either create a stats script in your package.jsonwhich calls ng-parsel or you can use npx;

Stats script

"stats": "@angular-experts/ng-parsel stats"

NPX

npx @angular-experts/ng-parsel stats

Types

Currently ng-parsel classifies each file into one of the following NgParselOutputType.

Unknown files will not be parsed. If you need support for additional types please raise an issue or open a PR.

Type detection

Harnesses, Specs and Validators are detected by the filename. Everything that ends with .spec will be classified as a spec file. Everything that ends with .harness will be classified as a harness file. Everything that ends with .validator will be classified as a validator file.

All other types are detected by their Angular decorators.

Outputs

Single outputs will be written to a ng-parsel.json file in the output directory. If singleFile is set to false ng-parsel will generate multiple output files, one for each componentType. (Find out more on component types)

Contributors

<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --> <!-- prettier-ignore-start --> <!-- markdownlint-disable --> <table> <tbody> <tr> <td align="center" valign="top" width="14.28%"><a href="https://medium.com/@kevinkreuzer"><img src="https://avatars.githubusercontent.com/u/5468954?v=4?s=100" width="100px;" alt="Kevin Kreuzer"/><br /><sub><b>Kevin Kreuzer</b></sub></a><br /><a href="https://github.com/angular-experts-io/ng-parsel/commits?author=kreuzerk" title="Code">💻</a> <a href="https://github.com/angular-experts-io/ng-parsel/issues?q=author%3Akreuzerk" title="Bug reports">🐛</a> <a href="#content-kreuzerk" title="Content">🖋</a> <a href="https://github.com/angular-experts-io/ng-parsel/commits?author=kreuzerk" title="Documentation">📖</a> <a href="#design-kreuzerk" title="Design">🎨</a> <a href="#ideas-kreuzerk" title="Ideas, Planning, & Feedback">🤔</a> <a href="#maintenance-kreuzerk" title="Maintenance">🚧</a> <a href="#platform-kreuzerk" title="Packaging/porting to new platform">📦</a> <a href="#research-kreuzerk" title="Research">🔬</a></td> <td align="center" valign="top" width="14.28%"><a href="https://www.npmjs.com/~ngdaddy"><img src="https://avatars.githubusercontent.com/u/81327266?v=4?s=100" width="100px;" alt="@NgDaddy"/><br /><sub><b>@NgDaddy</b></sub></a><br /><a href="#ideas-NgDaddy" title="Ideas, Planning, & Feedback">🤔</a></td> <td align="center" valign="top" width="14.28%"><a href="https://medium.com/@lilbeqiri"><img src="https://avatars.githubusercontent.com/u/24731032?v=4?s=100" width="100px;" alt="Ilir Beqiri"/><br /><sub><b>Ilir Beqiri</b></sub></a><br /><a href="https://github.com/angular-experts-io/ng-parsel/commits?author=ilirbeqirii" title="Code">💻</a> <a href="https://github.com/angular-experts-io/ng-parsel/commits?author=ilirbeqirii" title="Tests">⚠️</a></td> <td align="center" valign="top" width="14.28%"><a href="http://quentin.monmert.pagesperso-orange.fr/"><img src="https://avatars.githubusercontent.com/u/9989211?v=4?s=100" width="100px;" alt="Quentin"/><br /><sub><b>Quentin</b></sub></a><br /><a href="#maintenance-qmonmert" title="Maintenance">🚧</a> <a href="https://github.com/angular-experts-io/ng-parsel/commits?author=qmonmert" title="Code">💻</a></td> </tr> </tbody> </table> <!-- markdownlint-restore --> <!-- prettier-ignore-end --> <!-- ALL-CONTRIBUTORS-LIST:END --> <!-- prettier-ignore-start --> <!-- markdownlint-disable --> <!-- markdownlint-restore --> <!-- prettier-ignore-end --> <!-- ALL-CONTRIBUTORS-LIST:END -->