Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

    make-transformpublic

    make-transform

    Make simple string based functions into browserify transforms. This does not return anything like a true stream and, as a result, is very small to browserify.

    The objective was to implement just the API needed to support:

    • using it as a browserify transform
    • process.stdin.pipe(transform).pipe(process.stdout)
    • fs.createReadStream('input.js').pipe(transform).pipe(process.stdout)
    • process.stdin.pipe(transform).pipe(fs.createWriteStream('output.js'))
    • fs.createReadStream('input.js').pipe(transform).pipe(fs.createWriteStream('output.js'))

    In short, this is a helper for when you are forced to interface with streams by factors outside your controll, but the actual API is just processing strings (a far simpler abstraction).

    Build Status Dependency Status NPM version

    Installation

    npm install make-transform
    

    API

    makeTransform(fn(filename, source))

    Make a browserify transform out of a function which takes filename and source as arguments and returns a string.

    If a source argument is provided when called, it will just pass through to fn.

    Example:

    var makeTransform = require('make-transform')
     
    module.exports = makeTransform(function (file, source) {
      return source.toLowerCase()
    })
     
    var res = module.exports('file.js', 'FUNCTION (STR) { RETURN STR.SPLIT("") }')
    // res => 'function (str) { return str.split("") }'
     
    var strm = module.exports('file.js')
    strm.end('FUNCTION (STR) { RETURN STR.SPLIT("") }')
    strm.pipe(concat(function (res) {
      // res => 'function (str) { return str.split("") }'
    }))

    makeTransform.async(fn(filename, source, callback))

    Make a browserify transform out of a function which takes filename, source and callback as arguments and calls the callback with an optional error and a string.

    If a source argument and callback is provided when called, it will just pass through to fn.

    Example:

    var makeTransform = require('make-transform')
     
    module.exports = makeTransform.async(function (file, source, callback) {
      callback(null, source.toLowerCase())
    })
     
    module.exports('file.js', 'FUNCTION (STR) { RETURN STR.SPLIT("") }', function (err, res) {
      // res => 'function (str) { return str.split("") }'
    })
     
    var strm = module.exports('file.js')
    strm.end('FUNCTION (STR) { RETURN STR.SPLIT("") }')
    strm.pipe(concat(function (res) {
      // res => 'function (str) { return str.split("") }'
    }))

    Promises

    Promise support was ommitted in an effor to keep this library ludicrously small. It's easy enough to make your own "promise transform" though:

    var makeTransform = require('make-transform')
    var Promise = require('promise')
     
    function transform(file, source) {
      // return a promise for a string here
    }
    var streaming = makeTransform.async(Promise.nodeify(transform))
    module.exports = streaming
    module.exports.promise = transform

    License

    MIT

    Keywords

    none

    install

    npm i make-transform

    Downloadsweekly downloads

    2

    version

    1.0.0

    license

    none

    repository

    githubgithub

    last publish

    collaborators

    • avatar