@clipchamp/ng-builders

Angular Builders

This package provides Angular CLI builders for the Stryker Mutator framework and Google Cloud deployments.

Stryker Builder

Easily integrate the Stryker Mutator framework for mutation testing into your Angular app(s).

Installation

1. Install Stryker and the necessary plugins for your Angular app

npm i -D stryker stryker-api stryker-typescript stryker-jest-runner

1. Install stryker builder

npm i -D @clipchamp/ng-builders

1. Add custom architect config to your angular.json

[...]
"lint":  { 
    "builder":  "@angular-devkit/build-angular:tslint",
    "options":  {
	    "tsConfig":  ["src/tsconfig.json",  "src/tsconfig.spec.json"],
	    "exclude":  ["**/node_modules/**"]
    }
},
"mutate":  {
    	"builder":  "@clipchamp/ng-builders:stryker",
	"options":  {
		"configPath": "....", // path is relative to the project folder or workspace root (both are checked)
		"mutator": "typescript",
		[...]
	}
},
[...]

Configuration

You can either pass a configuration file through the options object in the architect or configure Stryker directly there.

Usage

Depending on how you called your architect you need to change this command.

    ng run my-app:mutate

GCloud Builder

Easily deploy your Angular application to Google App Engine.

Installation

1. Install gcloud builder

npm i -D @clipchamp/ng-builders

1. Add custom architect config to your angular.json

[...]
"lint":  { 
    "builder":  "@angular-devkit/build-angular:tslint",
    "options":  {
	    "tsConfig":  ["src/tsconfig.json",  "src/tsconfig.spec.json"],
	    "exclude":  ["**/node_modules/**"]
    }
},
"deploy":  {
    "builder":  "@clipchamp/ng-builders:gcloud",
	"options":  {
		"browserTarget": "project:build", // target build (same as ng serve's browserTarget)
		"yamlFilePath": "...", // path to your app.yaml file
		"applicationName": "...", // name of the application service that is deployed
		"deployConfigPath" "...", // optional: path to a deploy config script that exposes before and after deploy hooks
		[...]
	}
},
[...]

Configuration

You can either pass a configuration file through the options object in the architect or configure it through the before deploy hook.

Usage

Depending on how you called your architect you need to change this command.

    ng run my-app:deploy