boilerplate, gulpfile, quickstart

Author: filipesilva

gulpfile.js

@@ -84,16 +84,15 @@ var _excludeMatchers = _excludePatterns.map(function(excludePattern){
 });
 
 var _exampleBoilerplateFiles = [
-  'a2docs.css',
+  'src/styles.css',
+  'src/systemjs.config.js',
+  'src/tsconfig.json',
+  'bs-config.json',
+  'bs-config.e2e.json',
   'package.json',
-  'styles.css',
-  'systemjs.config.js',
-  'tsconfig.json',
   'tslint.json'
 ];
 
-var _exampleDartWebBoilerPlateFiles = ['a2docs.css', 'styles.css'];
-
 var _exampleUnitTestingBoilerplateFiles = [
   'browser-test-shim.js',
   'karma-test-shim.js',
@@ -102,8 +101,6 @@ var _exampleUnitTestingBoilerplateFiles = [
 
 var _exampleConfigFilename = 'example-config.json';
 
-var _styleLessName = 'a2docs.less';
-
 // Gulp flags:
 //
 //   --lang=[all | ts | js | dart | 'ts|js' | 'ts|js|dart' | ...]
@@ -182,21 +179,12 @@ function runE2e() {
     // fast; skip all setup
     promise = Promise.resolve(true);
   } else  {
-    /*
-       // Not 'fast'; do full setup
-    var spawnInfo = spawnExt('npm', ['install'], { cwd: EXAMPLES_PATH});
-    promise = spawnInfo.promise.then(function() {
-      copyExampleBoilerplate();
-      spawnInfo = spawnExt('npm', ['run', 'webdriver:update'], {cwd: EXAMPLES_PATH});
-      return spawnInfo.promise;
-    });
-    */
     // Not 'fast'; do full setup
     gutil.log('runE2e: install _examples stuff');
     var spawnInfo = spawnExt('npm', ['install'], { cwd: EXAMPLES_PATH});
     promise = spawnInfo.promise
+      .then(copyExampleBoilerplate)
       .then(function() {
-        buildStyles(copyExampleBoilerplate, _.noop);
         gutil.log('runE2e: update webdriver');
         spawnInfo = spawnExt('npm', ['run', 'webdriver:update'], {cwd: EXAMPLES_PATH});
         return spawnInfo.promise;
@@ -284,7 +272,7 @@ function runE2eTsTests(appDir, outputFile) {
 
   var config = {
     build: exampleConfig.build || 'tsc',
-    run: exampleConfig.run || 'http-server:e2e'
+    run: exampleConfig.run || 'serve:e2e'
   };
 
   var appBuildSpawnInfo = spawnExt('npm', ['run', config.build], { cwd: appDir });
@@ -350,7 +338,7 @@ function runProtractorAoT(appDir, outputFile) {
     promise = promise.then(() =>
      spawnExt('node', [copyFileCmd], { cwd: appDir }).promise );
   }
-  var aotRunSpawnInfo = spawnExt('npm', ['run', 'http-server:e2e', 'aot', '--', '-s'], { cwd: appDir });
+  var aotRunSpawnInfo = spawnExt('npm', ['run', 'serve:e2e', 'aot', '--', '-s'], { cwd: appDir });
   return runProtractor(promise, appDir, aotRunSpawnInfo, outputFile);
 }
 
@@ -364,7 +352,7 @@ function runE2eDartTests(appDir, outputFile) {
   gutil.log('AppDir for Dart e2e: ' + appDir);
   gutil.log('Deploying from: ' + deployDir);
 
-  var appRunSpawnInfo = spawnExt('npm', ['run', 'http-server:e2e', '--', deployDir, '-s'], { cwd: httpLaunchDir });
+  var appRunSpawnInfo = spawnExt('npm', ['run', 'serve:e2e', '--', deployDir, '-s'], { cwd: httpLaunchDir });
   if (!appRunSpawnInfo.proc.pid) {
     gutil.log('http-server failed to launch over ' + deployDir);
     return false;
@@ -448,7 +436,7 @@ gulp.task('help', taskListing.withFilters(function(taskName) {
 }));
 
 // requires admin access because it adds symlinks
-gulp.task('add-example-boilerplate', function(done) {
+gulp.task('add-example-boilerplate', function() {
   var realPath = path.join(EXAMPLES_PATH, '/node_modules');
   var nodeModulesPaths = excludeDartPaths(getNodeModulesPaths(EXAMPLES_PATH));
 
@@ -457,55 +445,31 @@ gulp.task('add-example-boilerplate', function(done) {
     fsUtils.addSymlink(realPath, linkPath);
   });
 
-  return buildStyles(copyExampleBoilerplate, done);
+  return copyExampleBoilerplate();
 });
 
 
 // copies boilerplate files to locations
 // where an example app is found
 gulp.task('_copy-example-boilerplate', function (done) {
-  return argv.fast ? done() : buildStyles(copyExampleBoilerplate, done);
+  return argv.fast ? done() : copyExampleBoilerplate();
 });
 
-//Builds Angular Docs CSS file from Bootstrap npm LESS source
-//and copies the result to the _examples folder to be included as
-//part of the example boilerplate.
-function buildStyles(cb, done){
-  gulp.src(path.join(STYLES_SOURCE_PATH, _styleLessName))
-    .pipe(less())
-    .pipe(gulp.dest(BOILERPLATE_PATH)).on('end', function(){
-      cb().then(function() { done(); });
-    });
-}
-
 // copies boilerplate files to locations
 // where an example app is found
 // also copies certain web files (e.g., styles.css) to ~/_examples/**/dart/**/web
 function copyExampleBoilerplate() {
   gutil.log('Copying example boilerplate files');
-  var sourceFiles = _exampleBoilerplateFiles.map(function(fn) {
-    return path.join(BOILERPLATE_PATH, fn);
-  });
   var examplePaths = excludeDartPaths(getExamplePaths(EXAMPLES_PATH));
 
-  var dartWebSourceFiles = _exampleDartWebBoilerPlateFiles.map(function(fn){
-    return path.join(BOILERPLATE_PATH, fn);
-  });
-  var dartExampleWebPaths = getDartExampleWebPaths(EXAMPLES_PATH);
-
   // Make boilerplate files read-only to avoid that they be edited by mistake.
   var destFileMode = '444';
-  return copyFiles(sourceFiles, examplePaths, destFileMode)
-    .then(function() {
-      return copyFiles(dartWebSourceFiles, dartExampleWebPaths, destFileMode);
-    })
+  return copyFiles(_exampleBoilerplateFiles, BOILERPLATE_PATH, examplePaths, destFileMode)
     // copy the unit test boilerplate
     .then(function() {
-      var unittestSourceFiles =
-        _exampleUnitTestingBoilerplateFiles
-          .map(function(name) { return path.join(EXAMPLES_TESTING_PATH, name); });
       var unittestPaths = getUnitTestingPaths(EXAMPLES_PATH);
-      return copyFiles(unittestSourceFiles, unittestPaths, destFileMode);
+      return copyFiles(_exampleUnitTestingBoilerplateFiles,
+        EXAMPLES_TESTING_PATH, unittestPaths, destFileMode);
     })
     .catch(function(err) {
       gutil.log(err);
@@ -582,9 +546,6 @@ function deleteExampleBoilerPlate() {
   var unittestPaths = getUnitTestingPaths(EXAMPLES_PATH);
 
   return deleteFiles(_exampleBoilerplateFiles, examplePaths)
-    .then(function() {
-      return deleteFiles(_exampleDartWebBoilerPlateFiles, dartExampleWebPaths);
-    })
     .then(function() {
       return deleteFiles(_exampleUnitTestingBoilerplateFiles, unittestPaths);
     });
@@ -1053,15 +1014,15 @@ function harpJsonSetJade2NgTo(v) {
 // Copies fileNames into destPaths, setting the mode of the
 // files at the destination as optional_destFileMode if given.
 // returns a promise
-function copyFiles(fileNames, destPaths, optional_destFileMode) {
+function copyFiles(fileNames, originPath, destPaths, optional_destFileMode) {
   var copy = Q.denodeify(fsExtra.copy);
   var chmod = Q.denodeify(fsExtra.chmod);
   var copyPromises = [];
   destPaths.forEach(function(destPath) {
     fileNames.forEach(function(fileName) {
-      var baseName = path.basename(fileName);
-      var destName = path.join(destPath, baseName);
-      var p = copy(fileName, destName, { clobber: true});
+      var originName = path.join(originPath, fileName);
+      var destName = path.join(destPath, fileName);
+      var p = copy(originName, destName, { clobber: true});
       if(optional_destFileMode !== undefined) {
         p = p.then(function () {
           return chmod(destName, optional_destFileMode);

public/docs/_examples/.gitignore

@@ -1,22 +1,15 @@
-# _exampleBoilerplateFiles
-.editorconfig
-karma.conf.js
-karma-test-shim.js
-package.json
-*/**/styles.css
-systemjs.config.js
-*/**/tsconfig.json
-tslint.json
-wallaby.js
+# _boilerplate files
+!_boilerplate/*
+*/*/src/styles.css
+*/*/src/systemjs.config.js
+*/*/src/tsconfig.json
+*/*/bs-config.e2e.json
+*/*/bs-config.json
+*/*/package.json
+*/*/tslint.json
 
+# example files
 _test-output
 **/ts/**/*.js
 **/js-es6*/**/*.js
 **/ts-snippets/**/*.js
-*.d.ts
-
-!**/*e2e-spec.js
-!systemjs.config.1.js
-!**/systemjs.config.extras.js
-!_boilerplate/*
-_boilerplate/a2docs.css

public/docs/_examples/_boilerplate/bs-config.e2e.json

@@ -0,0 +1,14 @@
+{
+  "open": false,
+  "logLevel": "silent",
+  "port": 8080,
+  "server": {
+    "baseDir": "src",
+    "routes": {
+      "/node_modules": "node_modules"
+    },
+    "middleware": {
+      "0": null
+    }
+  }
+}

public/docs/_examples/_boilerplate/bs-config.json

@@ -0,0 +1,8 @@
+{
+  "server": {
+    "baseDir": "src",
+    "routes": {
+      "/node_modules": "node_modules"
+    }
+  }
+}

public/docs/_examples/_boilerplate/package.json

@@ -4,21 +4,29 @@
   "private": true,
   "description": "Example package.json, only contains needed scripts for examples. See _examples/package.json for master package.json.",
   "scripts": {
-    "start": "tsc && concurrently \"tsc -w\" \"lite-server\" ",
-    "e2e": "tsc && concurrently \"http-server\" \"protractor protractor.config.js\"",
-    "http-server": "tsc && http-server",
-    "http-server:e2e": "http-server",
-    "http-server:cli": "http-server dist/",
-    "lite": "lite-server",
-    "lite:aot": "lite-server -c aot/bs-config.json",
-    "test": "tsc && concurrently \"tsc -w\" \"karma start karma.conf.js\"",
-    "tsc": "tsc",
-    "tsc:w": "tsc -w",
+    "build": "tsc -p src/",
+    "build:watch": "tsc -p src/ -w",
+    "build:e2e": "tsc -p e2e/",
+    "serve": "lite-server",
+    "serve:e2e": "lite-server -c=bs-config.e2e.json",
+    "prestart": "npm run build",
+    "start": "concurrently \"npm run build:watch\" \"npm run serve\"",
+    "pree2e": "webdriver-manager update && npm run build:e2e",
+    "e2e": "concurrently \"npm run serve:e2e\" \"npm run protractor\" --kill-others --success first",
+    "protractor": "protractor protractor.config.js",
+    "pretest": "npm run build",
+    "test": "concurrently \"npm run build:watch\" \"karma start karma.conf.js\"",
+    "pretest:once": "npm run build",
+    "test:once": "karma start karma.conf.js --single-run",
+    "lint": "tslint ./src/**/*.ts -t verbose",
+
+    "build:cli": "ng build --no-progress",
+    "serve:cli": "http-server dist/",
+    "build:aot": "ngc -p tsconfig-aot.json && rollup -c rollup-config.js",
+    "serve:aot": "lite-server -c aot/bs-config.json",
     "start:webpack": "webpack-dev-server --inline --progress --port 8080",
     "test:webpack": "karma start karma.webpack.conf.js",
     "build:webpack": "rimraf dist && webpack --config config/webpack.prod.js --bail",
-    "build:cli": "ng build --no-progress",
-    "build:aot": "ngc -p tsconfig-aot.json && rollup -c rollup-config.js",
     "build:babel": "babel app -d app --extensions \".es6\" --source-maps",
     "copy-dist-files": "node ./copy-dist-files.js",
     "i18n": "ng-xi18n"

public/docs/_examples/_boilerplate/styles.css renamed to public/docs/_examples/_boilerplate/src/styles.css

@@ -0,0 +1,11 @@
+{
+  "open": false,
+  "logLevel": "silent",
+  "port": 8080,
+  "server": {
+    "baseDir": "dist",
+    "middleware": {
+      "0": null
+    }
+  }
+}

public/docs/_examples/_boilerplate/systemjs.config.js renamed to public/docs/_examples/_boilerplate/src/systemjs.config.js

@@ -1,4 +1,4 @@
 {
   "build": "build:cli",
-  "run": "http-server:cli"
+  "run": "serve:cli"
 }