grunt-jasper

Grunt task for build and package jasper application

Getting Started

This plugin requires Grunt.

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-jasper --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-jasper');

The "jasper" task

Overview

In your project's Gruntfile, add a section named jasper to the data object passed into grunt.initConfig().

grunt.initConfig({
  jasper: {
    options: {
    
    },

    target: {
      options:{
        package: false
      }
    }
    
  }
})

Options

options.singlePage

Type: String Default value: `index.html'

Path to the single page, that will be modified during build process. Page must contain and areas

options.appPath

Type: String Default value: `app'

Path to application root. Task will search areas, components, etc.. in this folder.

options.package

Type: Boolean Default value: false

If true task will package your application to 'options.packageOutput' path;

options.packageOutput

Type: String Default value: 'dist'

Specifying destination of application package

options.baseScripts

Type: Array Default value: []

Specifying array of scripts, base dependencies of application like: angularjs, jasperjs, jquery, lodash, etc... (place in the options.singlePage)

options.startup

Type: String Default value: ''

Specifying startup script path, which bootstrap the application.

options.baseCss

Type: Array|Object Default value: []

Specifying array of stylesheet, which need to be referenced to the page before component's styles. You can specify here any css framework style (Twitter bootstrap) or normalize styles. If you want to split your css style into multiple file while packaging setup this property as config object:

grunt.initConfig({
  jasper: {
    options: {
      baseCss: {
                'bootstrap.min.css':[
                  'test/testApp/bootstrap.css'
                ],
                'all.min.css': [
                  'test/testApp/base.css'
                  //all component's style will be in the last target
                ]
              }      
    }
  }
})

options.values

Type: String Default value: []

Specifying application configuration JSON file. Properties from this configuration file will registered as 'values', during task execution.

options.fileVersion

type: 'Boolean' Default value: false

If true task will append MD5 hash of content of application scripts, during package process to avoid client cache. 'scripts/_base.min.js' --> 'scripts/base.min.js?v=c5fa12138e2da9ddb6023f11533777c0'

options.jDebugEnabled

type: 'Boolean' Default value: false

Is jDebug enabled. If enabled task will reference to index page jDebugSrc script if options.package == false.

options.jDebugSrc

type: 'String' Default value: 'node_modules/jdebug/lib/jdebug.js'

Specifies a path to jDebug client side library.

Usage Examples

In this example, the options are used to build and package jasper application. Two target are used: for development process (debug) and package (release).

grunt.initConfig({
  jasper: {
    options: {
      singlePage: 'index.html',
      appPath: 'app',
      values: 'path/to/values.json',
      
      packageOutput: 'dist',
      
      bootstrapScripts: [
        'vendor/angularjs/angular.js',
        'vendor/angularjs/angular-route.js',
        'vendor/scriptjs/script.js',

        'vendor/jasper/jasper.js',

        '%areas_config%',
        '%routes_config%',
        
        'app/bootstrap.js'
      ],
      
      baseCss: [
        'vendor/bootstrap/bootstrap.min.css'
      ],

      defaultRoutePath: '/'
    },

    debug: {
      options:{
        package: false
      }
    },

    release: {
      options: {
        package: true,
        fileVersion: true
      }
    }
  }
})

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.

Release History

(Nothing yet)

License

Licensed under the MIT license.