Skip to content

BHAlrm/grunt-bower-dependencies-to-rjs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

grunt-bower-dependencies-to-rjs

Automagically wire-up installed Bower components dependencies as shim into your RequireJS config

Getting Started

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, install this plugin with this command:

npm install grunt-bower-dependencies-to-rjs --save-dev

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

grunt.loadNpmTasks('grunt-bower-dependencies-to-rjs');

Example usage

grunt.initConfig({
  bowerShimToRjs: {
    target: {
      rjsConfig: 'app/config.js'
    }
  }
});

grunt.loadNpmTasks('grunt-bower-dependencies-to-rjs');

grunt.registerTask('default', ['bowerShimToRjs']);

Documentation

When the bower task is run it merges the paths of installed Bower components into the paths property of your RequireJS config.

You trigger this task from another task in your Gruntfile or through the CLI: grunt bower

rjsConfig

Required
Type: String

Specify a relative path to your RequireJS config.

Make sure to specify the baseUrl property in your RequireJS config if you want to use relative paths.

Options

exclude

Default: []
Type: Array

Specify components to be excluded from being added to the RequireJS config.

bowerShimToRjs: {
  all: {
    rjsConfig: 'scripts/main.js',
    options: {
      exclude: ['moment']
    }
  }
}

application.name

Default: name of application that initial in bower.json
Type: String

Specify compress application filename it being added to the RequireJS shim config

bowerShimToRjs: {
  all: {
    rjsConfig: 'scripts/main.js',
    options: {
      application: {
        name: 'yourCompressApplicationFileName'
      }
    }
  }
}

application.exclude

Default: [] Type: Array

Specify components of main application to be excluded from being added to the RequireJS config.

bowerShimToRjs: {
  all: {
    rjsConfig: 'scripts/main.js',
    options: {
      application: {
        exclude: ['dependecy1', 'dependency2']
      }
    }
  }
}

application.overwrite

Default: [] Type: Array

Specify components of main application to be over write name from being added to the RequireJS config.

bowerShimToRjs: {
  all: {
    rjsConfig: 'scripts/main.js',
    options: {
      application: {
        overwrite: {
            'tobeoverwrotenmodulename': 'ToBeOverWriteModuleName'
        }
      }
    }
  }
}

Things to remember

Config file

If you do not already have a config.js file at the location specified by the --config option then one will be generated for you. A basic config.js file looks like this:

requirejs.config({
  shim: {},
  paths: {}
});

Credit

Thanks for grunt-bower-requirejs's contributor(https://github.com/yeoman/grunt-bower-requirejs). I use theire module for my reference.

License

MIT license and copyright Bhakarut

About

auto configuration the dependencies from bower.json to target rjs file.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published