Nougat Predominant Middleware

    This package has been deprecated

    Author message:

    Use @microsoft/gulp-core-build instead.

    gulp-core-build
    TypeScript icon, indicating that this package has built-in type declarations

    0.7.1 • Public • Published

    gulp-core-build npm version

    Build Status Dependencies

    The gulp build system, along with its rich plugin ecosystem, is a very powerful tool for web development projects. However project gulp build setups become difficult to manage over time, as gulpfiles grow in complexity. This project simplifies a number of aspects of getting a build setup going for a majority of scenarios.

    Core build defines a contract for tasks to implement, such that they can share opinions about where things end up. Tasks are modular but they are designed to work well together.

    With gulp core build, your gulpfile translates into a list of task definitions, each which define what to run:

    'use strict';
     
    // Import core build and the tasks the project needs.
    let build = require('gulp-core-build');
    let lint = require('gulp-core-build-typescript').tslint;
    let typescript = require('gulp-core-build-typescript').typescript;
    let sass = require('gulp-core-build-sass').default;
    let karma = require('gulp-core-build-karma').default;
    let webpack = require('gulp-core-build-webpack').default;
    let serve = require('gulp-core-build-serve').default;
     
    // Define gulp tasks.
    let buildTasks = build.task('build', build.parallel(lint, typescript, sass));
    let testTasks = build.task('test', build.serial(buildTasks, karma));
    let bundleTasks = build.task('bundle', build.serial(buildTasks, webpack));
    let serveTasks = build.task('serve', build.serial(bundleTasks, serve));
    let defaultTasks = build.task('default', testTasks);
     
    // Initialize!
    build.initialize(require('gulp'));

    Usage

    Within your project, install gulp, gulp-core-build, and the tasks you need:

    npm install --save-dev gulp gulp-core-build
    

    Then install the tasks you need:

    npm install --save-dev gulp-core-build-typescript gulp-core-build-karma gulp-core-build-webpack gulp-core-build-serve
    
    

    Create a gulpfile.js that sets up the tasks in the way you want them to run:

    'use strict';
     
    // Import core build.
    let build = require('gulp-core-build');
     
    // Import the tasks.
    let lint = require('gulp-core-build-typescript').tslint;
    let typescript = require('gulp-core-build-typescript').typescript;
    let sass = require('gulp-core-build-sass').default;
    let karma = require('gulp-core-build-karma').default;
    let webpack = require('gulp-core-build-webpack').default;
    let serve = require('gulp-core-build-serve').default;
     
    // Define gulp tasks.
    let buildTasks = build.task('build', build.parallel(lint, typescript, sass));
    let testTasks = build.task('test', build.serial(buildTasks, karma));
    let bundleTasks = build.task('bundle', build.serial(buildTasks, webpack));
    let serveTasks = build.task('serve', build.serial(bundleTasks, serve));
    let defaultTasks = build.task('default', testTasks);
     
    // Tell the build to set up gulp tasks with the given gulp instance.
    build.initialize(require('gulp'));

    Once this is set up, you should be able to execute the gulp tasks and they should run in the order you defined.

    Available tasks

    Task name Description
    gulp-core-build-typescript Builds and lints typescript.
    gulp-core-build-sass Compiles sass into css, into js modules, that are theme friendly.
    gulp-core-build-webpack Runs webpack given a config, and outputs libraries plus the stats and logging.
    gulp-core-build-serve Sets up a server and live reload for a quick dev loop.

    API

    task(name, task)

    Defines a named task to be registered with gulp as a primary gulp task, which will run the provided task when execution.

    parallel(tasks)

    Runs a given list of tasks in parallel execution order.

    serial(tasks)

    Runs a given list of tasks in serial execution order.

    initialize(gulpInstance, [buildOtions])

    Registers the gulp tasks.

    The options are broken down into task-specific sections, and all are optional, so only provide the ones that require deviating from defaults:

    build.initializeTasks(
      require('gulp'),
      {
        build: { /* build options */ },
        bundle: { /* bundle options */ },
        test: { /* test options */ },
        serve: { /* serve options */ },
        nuke: { /* nuke options */ }
      });

    Building gulp-core-build

    1. npm install --force
    2. gulp

    Defining a custom task

    License

    MIT

    Keywords

    none

    Install

    npm i gulp-core-build

    DownloadsWeekly Downloads

    33

    Version

    0.7.1

    License

    MIT

    Last publish

    Collaborators

    • dzearing