grunt-asar
v0.1.5
Published
Grunt plugin to generate atom-shell asar archives.
Downloads
13
Readme
grunt-asar
Grunt plugin to generate atom-shell asar packages.
This exposes just the most basic functionality at the moment. Convert a whole directory into an asar archive. Symbolic links are currently not tested.
Now supports grunt file expansion.
Getting Started
This plugin requires Grunt ~0.4.0
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-asar --save-dev
Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:
grunt.loadNpmTasks('grunt-asar');
The "asar" task
Overview
In your project's Gruntfile, add a section named asar
to the data object passed into grunt.initConfig()
.
grunt.initConfig({
asar: {
your_target: {
// Target-specific file lists and/or options go here.
files: {
// Your simple dir-to-file mappings go here
// 'archivename.asar': ['some/path'],
},
},
your_advanced_target: {
// Your expanding patterns go like this
// cwd: 'some/path',
// src: ['**/*'],
// expand: true,
// dest: 'archivename.asar'
},
},
});
Usage Examples
grunt.initConfig({
asar: {
all: { // target
files: {
'app.asar': ['app/'],
'modules.asar': ['node_modules/'],
},
},
},
});
The same example with targets for each archive.
grunt.initConfig({
asar: {
app: { // target
files: {
'app.asar': ['app/'],
},
},
modules: { // target
files: {
'modules.asar': ['node_modules/'],
},
},
},
});
You can also use grunt file expansion to filter.
grunt.initConfig({
asar: {
my_app: {
cwd: 'some/path',
// Skip png's and the folder 'dir1' and its contents.
src: ['**/*', '!**/*.png', '!dir1', '!dir1/**/*'],
expand: true,
dest: 'my_app.asar'
},
},
});
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.