aster-src
Source files reader for aster.
Usage
This module is part of aster and is available via aster.src
.
You use it in build scripts whenever you want to get list of files for executing build pipeline:
var aster = ; aster// ...;
aster.src
returns Rx.Observable
which, in order, emits single inner observable collection of file ASTs wrapped with custom {type: 'File', program: ..., loc: {source: 'fileName.js'}}
node.
API
src(patterns, options)
patterns
Type: String|String[]
List of patterns as array of strings or one comma-separated string.
options
Type: Object
glob
module options (see https://github.com/isaacs/node-glob#options for details).
options.noglob
Type: Boolean
Default: false
Set to true if you want patterns
to be used as explicit list of files instead of globbing patterns (used by aster-watch).
options.parse
Type: Function|Boolean|Object
Default: true
- If preconfigured parser (i.e.,
require('aster-parse-js')({loc: false})
) or customfunction (files) { ... }
is passed, it will be used as is. - If boolean is passed:
true
means files should be parsed with parser associated with file extension (see aster-parse).false
means files should not be parsed and so they are pushed as{path: string, contents: string}
object.
- If object is passed, it will be used as parsing options.
src.registerParser(extension, parser)
Method for registering custom parsers associated with extension, see asterParse.registerParser for details.