initial commit

Author: hparra

.editorconfig

@@ -0,0 +1,10 @@
+# editorconfig.org
+root = true
+
+[*]
+indent_style = tab
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+

.gitignore

@@ -0,0 +1,2 @@
+.DS_Store
+node_modules

.npmignore

@@ -0,0 +1,2 @@
+.DS_Store
+node_modules

LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2013 [Hector Parra](http://hectorparra.com/)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

README.md

@@ -0,0 +1,34 @@
+# gulp-cli
+
+CLI program piping plugin for [gulp](https://github.com/wearefractal/gulp). Uses [spawn](http://nodejs.org/api/child_process.html#child_process_child_process_spawn_command_args_options).
+
+**This plugin has NOT been test thoroughly**
+
+## Usage
+
+gulp-cli options follow spawn's conventions.
+
+Not all CLI programs support piping. In fact, many newer ones don't. Some programs require that you pass certain arguments if you intend to use stdin and/or stdout. Please check the documentation of the program you intend to use to ensure piping is supported.
+
+The following example pipes image files to ImageMagick's `convert`. In the case of `convert`, you must specify a `-` before arguments and after arguments if you wish to use stdin and stdout, respectively.
+
+```javascript
+var cli = require("gulp-cli");
+
+// example using ImageMagick's convert
+gulp.src("./src/images/*.{jpg,png,gif}")
+	.pipe(cli({
+		cmd: "convert",
+		args: [
+			"-",
+			"-resize",
+			"50%",
+			"-"
+		]
+	}))
+	.pipe(gulp.dest("./dist/images/"));
+```
+
+## The UNIX Pipe Philosophy
+
+If you write CLI programs please consider taking the time to support stdin & stdout. Piping is one of the reasons UNIX systems have endured the test of time. There is no reason to reinvent the wheel.

index.js

@@ -0,0 +1,40 @@
+var fs = require("fs");
+var es = require("event-stream");
+var clone = require("clone");
+var cp = require("child_process");
+
+module.exports = function(options) {
+	"use strict";
+
+	// generic cli plugin
+	function cli(file, callback) {
+
+		// clone file object, reset buffer
+		var newFile = clone(file);
+		newFile.contents = new Buffer(0);
+
+		// cli program
+		var program = cp.spawn(options.cmd, options.args);
+
+		// when program receives data add it to newFile buffer
+		program.stdout.on("data", function (buffer) {
+			newFile.contents = Buffer.concat([
+				newFile.contents,
+				buffer
+			]);
+		});
+
+		// when program finishes call callback
+		program.stdout.on("end", function (close) {
+			callback(null, newFile);
+		});
+
+		// "execute"
+		// write file buffer to program
+		program.stdin.write(file.contents, function () {
+			program.stdin.end();
+		});
+	}
+
+	return es.map(cli);
+}

package.json

@@ -0,0 +1,41 @@
+{
+	"name": "gulp-cli",
+	"description": "cli plugin for gulp",
+	"version": "0.1.",
+	"homepage": "https://github.com/hparra/gulp-cli",
+	"repository": {
+		"type": "git",
+		"url": "git://github.com/hparra/gulp-cli.git"
+	},
+	"author": {
+		"name": "Hector Parra",
+		"url": "http://hectorparra.com/"
+	},
+	"main": "./index.js",
+	"keywords": [
+		"gulpplugin",
+		"cli",
+		"shell",
+		"exec"
+	],
+	"dependencies": {
+		"event-stream": "*"
+	},
+	"devDependencies": {
+		"mocha": "*",
+		"should": "*",
+		"clone": "~0.1.11",
+		"event-stream": "~3.0.16"
+	},
+	"scripts": {
+		"test": "mocha"
+	},
+	"engines": {
+		"node": ">= 0.4.0"
+	},
+	"licenses": [
+		{
+			"type": "MIT"
+		}
+	]
+}