#GROM.js Awesome co-powered build system.

npm install -g gromjs

Why?

The goal of grom.js is to be a plugin-less build system that will allow to use any node module to process files without pain. Gives more control

Super simple

In gromfile.js:

var processor = require('files-processor')
var R = require('ramda')

module.exports.task = function* (){
  var filesSet = yield this.read(['path/to/files'])
  var mappedFilesSet = filesSet.map(function*(file){
    var newSource = processor(yield file.source())
    return file.clone(newSource, { ext: '.processed'})
  })

  return yield this.write('path/to/dist', mappedFilesSet)
}

In terminal:

$ gromjs task

That's it. No special grom-whatever plugins, use whatever you want.

API

• yield this.read(glob)
  Returns ordered Set of Files

• yield this.watch(glob)
  Returns events emitter, uses npm module watch and watch.createMonitor method

• yield this.write(glob, Set)
  Accepts glob, Set of Files and writes everything in right place.

• yield this.async(tasks)
  Accepts array of tasks and runs in asynchronously and independent to each other.

• yield this.seq(tasks)
  Runs tasks one by one from left to right, every next one get result from previous.

Set

Is a set of Files uniq by glob, have next methods:

• elements()
  Returns Set's elements

• isContains(file)
  Checks if file is in Set by file's glob

• add(file)
  Returns new Set with all elements plus new one

• remove(element)
  Returns new Set without single element

• union(set)
  Returns new Set that is union of elements from both sets

• intersection(set)
  Returns new Set that is intersection between sets

• difference(set)
  Returns new Set that is difference between sets

• filter(iterator*)
  Returns new Set with filtered elements

• sort(iterator*)
  Returns new Set with sorted elements

• reduce(iterator*, accumulator)
  Returns reduced value

• map(iterator*)
  Returns new Set with mapped elements

• forEach(iterator*)
  Iterates over elements and returns current Set

File

• path()
  Returns full path

• glob()
  Returns glob

• name()
  Returns name with extension

• source()
  Generator, returns file's source code

• clone([glob], [source])
  Creates new File, glob can be presented as hash with dir, name, ext fields which will be merged with parent file's path, path also can be just a string, if glob or source isn't provided, clone takes it from parent.

Examples:

run tasks in sequence:

var filesProcessor = require('files-processor')

var read = function* (){
  return yield this.read('/some/path/to/**.ext')
}

var processSet = function* (set){
  return set.map(function* (file){
    var source = yield file.source()
    return file.clone(yield extProcessor(source), { ext: 'js' })
  })
}

var write = function* (set){
  return yield this.write('/another/path', set)
}

module.exports.default = function* three(){
  yield this.seq([read, processSet, write])
}

watch files:

module.exports.default = function* three(){
  var monitor = yield this.watch('*.js')
  monitor.on('change', function* (Set){
    yield this.async(someTask)
  })
}

compile less:

var less = require('less')

module.exports.compileLess = function* compileLess (){
  var lessFilesSet = yield this.read('./code/**.less')

  var cssFilesSet = yield lessFilesSet.map(function* (file){
    var lessContents = (yield file.source()).toString()
    var css = (yield less.render(lessContents, {})).css
    return file.clone(css, { ext: 'css' })
  })

  return yield this.write('./dist', cssFilesSet)
}

CLI

$ gromjs <task-name>

TODO

• Tasks logger
• Tests
• More examples

License

MIT © Dmitriy Kharchenko