assemble-manifest v0.1.3

Generates JSON and/or YAML manifest files from given source files or directories or source files.

This project is more of a proof of concept or sandbox for generating:

• Component manifests
• component.json
• package.json
• jQuery Plugin Package Manifest
• JSON or YAML formatted lists of files of certain types in given directories, grouped into "collections".
• Or just use it to sync the metadata in your root .json files: package.json, component.json, *.jquery.json, _config.yml etc.

See some of the example manifests generated with this task.

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 assemble-manifest --save-dev

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

grunt.loadNpmTasks('assemble-manifest');

The "manifest" task

Overview

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

grunt.initConfig({
  manifest: {
    options: {
      // Task-specific options go here.
    },
    your_target: {
      // Target-specific file lists and/or options go here.
    }
  }
})

Options

manifestrc

Type: String Default value: null

If a .manifestrc file is specified, any options defined therein will be used. The .manifestrc file must be valid JSON and looks something like this:

{
  "indent": 2,
  "sorted": true,
  "metadata": [],
  "exclude": [
    "firstKey",
    "secondKey"
  ]
}

debug

Type: Boolean Default: false

When set to true, the output will include all omitted properties for inspection.

format

Type: String Default: json

Option to specify output format for dest files. Case insensitive, and may be either YAML or JSON format. Any of the following will work:

sorted

Type: Boolean Default: false

Sorts ouput objects and properties in alphabetical order.

indent

Type: Number Default: 2

Number of spaces to indent the output. Currently only works for .json files, not .yml.

collections

Type: Object Default: null

Build collections (arrays) of files with specific extensions from given source directories.

To build a specific collection, just add the collection to the collections object, then define the pattern(s) for files that should be included in the collection. specify the extension pattern(s) for the src files you want to add to your dest file(s). For pre-defined collections, you don't need to do anything to explicity add the collection itself, the task takes care of that for you. For example:

images: {
  options: {
    name: 'Image Manifest'
    collections: {
      "images": [
        "jpg",
        "png",
        "gif"
      ]
    }
  },
  files: {
    'dest/images.json': ['assets/**/*.*'],
  }
}

Will yield an images collection that includes an array of files that match the extensions specified in the collection:

Output: images.json

{
  "images": [
    "assets/img/one.jpg",
    "assets/img/two.jpg",
    "assets/img/three.gif",
    "assets/img/icons/icon-a.png",
    "assets/img/icons/icon-b.png",
    ...
  ]
}

Usage Examples

See some of the example manifests generated with this task.

Let's say the goal is to build a component.json from a package.json. We could:

• Do a one-to-one transfer of objects and properties
• Override any objects or properties in the options by simply adding the new value to the options.
• Remove any objects or properties in the options by making the value undefined (this is a quick fix, will revisit but it works for now.)
• Define new objects and properties in the options block.

manifest: {
  options: {
    metadata: 'metadata.json', // optional source of metatdata
    name: 'assemble-manifest'
    version: '0.1.0'
    description: 'Generates JSON and/or YAML manifest files from given source files or directories or source files.'
  },
  // build component.json from package.json
  package: {
    files: {
      'package.json': []
    }
  },
  component: {
    files: {
      'component.json': []
    }
  }
}

Default Options

manifest: {
  options: {
    collections: true,
    debug: false,
    exclude: [],
    format: 'json',
    include: [],
    indent: 2,
    manifestrc: [],
    metadata: [],
    sorted: false
  },
  // build component.json from package.json
  component: {
    files: {
      'component.json': ['package.json']
    }
  }
}

Custom Options

On the way...

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.

License

MIT License

Release History

(Nothing yet)