Plugin code and simple test

Author: w0rm

.gitignore

@@ -1,25 +1,3 @@
-# Logs
-logs
-*.log
-
-# Runtime data
-pids
-*.pid
-*.seed
-
-# Directory for instrumented libs generated by jscoverage/JSCover
-lib-cov
-
-# Coverage directory used by tools like istanbul
-coverage
-
-# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
-.grunt
-
-# Compiled binary addons (http://nodejs.org/api/addons.html)
-build/Release
-
-# Dependency directory
-# Deployed apps should consider commenting this line out:
-# see https://npmjs.org/doc/faq.html#Should-I-check-my-node_modules-folder-into-git
 node_modules
+npm-debug.log
+.DS_Store

.jshintrc

@@ -0,0 +1,16 @@
+{
+  "asi": true,
+  "boss": true,
+  "browser": true,
+  "node": true,
+  "expr": true,
+  "indent": 2,
+  "laxcomma": true,
+  "maxlen": 100,
+  "newcap": true,
+  "strict": false,
+  "trailing": true,
+  "undef": true,
+  "unused": true,
+  "quotmark": "single"
+}

README.md

@@ -1,4 +1,36 @@
 gulp-postcss
 ============
 
-PostCSS gulp plugin
+[PostCSS](https://github.com/postcss/postcss) gulp plugin
+
+## Basic usage
+
+```
+var postcss = require('gulp-postcss')
+var gulp = require('gulp')
+var autoprefixer = require('autoprefixer')
+var mqpacker = require('css-mqpacker')
+
+gulp.task('css', function () {
+  var processors = [
+    autoprefixer('last 1 version').postcss
+  , mqpacker.processor
+  ]
+  return gulp.src('./src/*.css')
+    .pipe(postcss(processors))
+    .pipe(gulp.dest('./dest'))
+})
+```
+
+## Source map support
+
+Source map is inlined by default, to extract map use together
+with [gulp-sourcemaps](https://github.com/floridoo/gulp-sourcemaps).
+
+```
+return gulp.src('./src/*.css')
+  .pipe(sourcemaps.init())
+  .pipe(postcss(processors))
+  .pipe(sourcemaps.write('.'))
+  .pipe(gulp.dest('./dest'))
+```

index.js

@@ -0,0 +1,43 @@
+var through = require('through2')
+var postcss = require('postcss')
+var applySourceMap = require('vinyl-sourcemaps-apply')
+var _ = require('lodash')
+
+
+module.exports = function (processors, options) {
+
+  return through.obj(transform)
+
+  function transform (file, encoding, cb) {
+
+    // Source map is inline by default
+    var opts = _.extend({ map: 'inline' }, options)
+    var processor = postcss()
+    var result
+
+    if (file.base && file.path) {
+      opts.from = file.relative
+    } else {
+      opts.from = file.path
+    }
+
+    processors.forEach(processor.use.bind(processor))
+
+    // Generate separate source map for gulp-sourcemap
+    if (file.sourceMap) {
+      opts.map = true
+    }
+
+    result = processor.process(file.contents.toString('utf8'), opts)
+
+    file.contents = new Buffer(result.css)
+
+    // Apply source map to the chain
+    if (file.sourceMap) {
+      applySourceMap(file, result.map.toString())
+    }
+
+    cb(null, file)
+  }
+
+}

package.json

@@ -0,0 +1,34 @@
+{
+  "name": "gulp-postcss",
+  "version": "0.0.1",
+  "description": "PostCSS gulp plugin",
+  "main": "index.js",
+  "scripts": {
+    "test": "mocha"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/w0rm/gulp-postcss.git"
+  },
+  "keywords": [
+    "gulp",
+    "postcss",
+    "css"
+  ],
+  "author": "Andrey Kuzmin <[email protected]>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/w0rm/gulp-postcss/issues"
+  },
+  "homepage": "https://github.com/w0rm/gulp-postcss",
+  "dependencies": {
+    "gulp-util": "^3.0.0",
+    "lodash": "^2.4.1",
+    "postcss": "^2.1.2",
+    "through2": "^0.6.1",
+    "vinyl-sourcemaps-apply": "^0.1.1"
+  },
+  "devDependencies": {
+    "mocha": "^1.21.4"
+  }
+}

test.js

@@ -0,0 +1,34 @@
+/* global it */
+
+var assert = require('assert')
+var gutil = require('gulp-util')
+var postcss = require('.')
+
+it('should transform css with multiple processors', function (cb) {
+
+  var stream = postcss(
+    [ doubler, doubler ]
+  , { map: false }  // omit source map for the test
+  )
+
+	stream.on('data', function (file) {
+    var result = file.contents.toString('utf8')
+    var target = 'a { color: black; color: black; color: black; color: black }'
+		assert.equal( result, target )
+		cb()
+	})
+
+	stream.write(new gutil.File({
+		contents: new Buffer('a { color: black }')
+	}))
+
+	stream.end()
+
+})
+
+
+function doubler (css) {
+  css.eachDecl(function (decl) {
+    decl.parent.prepend(decl.clone())
+  })
+}