Initial commit

Author: nDmitry

.editorconfig

@@ -0,0 +1,14 @@
+; http://EditorConfig.org
+
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.map]
+insert_final_newline = false

.gitignore

@@ -0,0 +1,6 @@
+.DS_Store
+.idea
+.sass-cache
+node_modules
+npm-debug.log
+tmp

.jshintrc

@@ -0,0 +1,14 @@
+{
+    "curly": true,
+    "eqeqeq": true,
+    "expr": true,
+    "immed": true,
+    "latedef": true,
+    "newcap": true,
+    "noarg": true,
+    "sub": true,
+    "undef": true,
+    "boss": true,
+    "eqnull": true,
+    "node": true
+}

.travis.yml

@@ -0,0 +1,5 @@
+language: node_js
+node_js:
+  - "0.10"
+before_script:
+  - npm install -g grunt-cli

CHANGELOG

@@ -0,0 +1,4 @@
+v0.1.0:
+    data: 2014-09-25
+    changes:
+      - First release

Gruntfile.js

@@ -0,0 +1,46 @@
+module.exports = function(grunt) {
+
+    'use strict';
+
+    require('load-grunt-tasks')(grunt);
+    require('time-grunt')(grunt);
+
+    grunt.initConfig({
+        jshint: {
+            all: [
+                'Gruntfile.js',
+                'tasks/*.js',
+                '<%= nodeunit.tests %>',
+            ],
+            options: {
+                jshintrc: '.jshintrc',
+            },
+        },
+
+        clean: {
+            tests: ['tmp'],
+        },
+
+        postcss: {
+            dist: {
+                options: {
+                    map: true,
+                    processors: [require('csswring').postcss]
+                },
+                src: 'test/fixtures/a.css',
+                dest: 'tmp/a.css'
+            },
+        },
+
+        nodeunit: {
+            tests: ['test/test.js'],
+        },
+
+    });
+
+    grunt.loadTasks('tasks');
+
+    grunt.registerTask('test', ['clean', 'postcss', 'nodeunit']);
+    grunt.registerTask('default', ['jshint', 'test']);
+
+};

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) Dmitry Nikitenko <[email protected]>
+
+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,51 @@
+# grunt-postcss
+[![Build Status](https://travis-ci.org/nDmitry/grunt-postcss.png?branch=master)](https://travis-ci.org/nDmitry/grunt-postcss)
+[![Dependency Status](https://david-dm.org/nDmitry/grunt-postcss.png)](https://david-dm.org/nDmitry/grunt-postcss)
+
+> Apply several post-processors to your CSS using [PostCSS](https://github.com/postcss/postcss).
+
+## Getting Started
+This plugin requires Grunt `~0.4.0`
+
+If you haven't used [Grunt](http://gruntjs.com/) before, be sure to check out the [Getting Started](http://gruntjs.com/getting-started) guide, as it explains how to create a [Gruntfile](http://gruntjs.com/sample-gruntfile) as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:
+
+```shell
+npm install grunt-postcss --save-dev
+```
+
+Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:
+
+```js
+grunt.loadNpmTasks('grunt-postcss');
+```
+
+## Usage
+
+```js
+grunt.initConfig({
+  postcss: {
+    options: {
+      map: true,
+      processors: [
+        require('autoprefixer-core')({browsers: 'last 1 version'}).postcss
+        require('csswring').postcss
+      ]
+    },
+    dist: {
+      src: 'css/*.css'
+    },
+  },
+});
+```
+
+The usage and options are similar with [grunt-autoprefixer](https://github.com/nDmitry/grunt-autoprefixer#options). The only new options is:
+
+#### options.processors
+Type: `Array`
+Default value: `[]`
+
+An array of PostCSS compatible post-processors.
+
+## Why would I use this?
+
+Unlike the traditional approach with separate plugins, grunt-postcss allows you to parse and save CSS only once applying all post-processors in memory and thus reducing your build time. PostCSS is also a simple tool for writing your own CSS post-processors.

package.json

@@ -0,0 +1,44 @@
+{
+  "name": "grunt-postcss",
+  "version": "0.1.0",
+  "description": "Apply several post-processors to your CSS using PostCSS",
+  "author": {
+    "name": "Dmitry Nikitenko",
+    "email": "[email protected]"
+  },
+  "repository": "nDmitry/grunt-postcss",
+  "license": "MIT",
+  "engines": {
+    "node": ">= 0.10.0"
+  },
+  "scripts": {
+    "test": "grunt test"
+  },
+  "keywords": [
+    "gruntplugin",
+    "css",
+    "postprocessor",
+    "postcss"
+  ],
+  "files": [
+    "tasks",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "chalk": "^0.5.1",
+    "diff": "^1.0.8",
+    "postcss": "^2.2.5"
+  },
+  "devDependencies": {
+    "csswring": "^1.3.0",
+    "grunt": "^0.4.5",
+    "grunt-contrib-clean": "^0.6.0",
+    "grunt-contrib-jshint": "^0.10.0",
+    "grunt-contrib-nodeunit": "^0.4.0",
+    "load-grunt-tasks": "^0.6.0",
+    "time-grunt": "^1.0.0"
+  },
+  "peerDependencies": {
+    "grunt": "^0.4.5"
+  }
+}

tasks/postcss.js

@@ -0,0 +1,94 @@
+'use strict';
+
+var path = require('path');
+var postcss = require('postcss');
+var diff = require('diff');
+var chalk = require('chalk');
+
+module.exports = function(grunt) {
+
+    var options;
+    var processor = postcss();
+
+    /**
+     * Returns an input map contents if a custom map path was specified
+     * @param {string} from Input CSS path
+     * @returns {?string}
+     */
+    function getPrevMap(from) {
+        if (typeof options.map.prev === 'string') {
+            var mapPath = options.map.prev + path.basename(from) + '.map';
+
+            if (grunt.file.exists(mapPath)) {
+                return grunt.file.read(mapPath);
+            }
+        }
+    }
+
+    /**
+     * @param {string} input Input CSS contents
+     * @param {string} from Input CSS path
+     * @param {string} to Output CSS path
+     * @returns {{css: string, map: ?string}}
+     */
+    function process(input, from, to) {
+        return processor.process(input, {
+            map: (typeof options.map === 'boolean') ? options.map : {
+                prev: getPrevMap(from),
+                inline: options.map.inline,
+                annotation: options.map.annotation,
+                sourcesContent: options.map.sourcesContent
+            },
+            from: from,
+            to: to
+        });
+    }
+
+    /**
+     * @param {string} msg Log message
+     */
+    function log(msg) {
+        if (!options.silent) {
+            grunt.log.writeln(msg);
+        }
+    }
+
+    grunt.registerMultiTask('postcss', 'Process CSS files.', function() {
+        options = this.options({
+            diff: false,
+            map: false,
+            processors: [],
+            silent: false
+        });
+
+        options.processors.forEach(processor.use.bind(processor));
+
+        this.files.forEach(function(f) {
+            if (!f.src.length) {
+                return grunt.fail.warn('No source files were found.');
+            }
+
+            f.src
+                .forEach(function(filepath) {
+                    var dest = f.dest || filepath;
+                    var input = grunt.file.read(filepath);
+                    var output = process(input, filepath, dest);
+
+                    grunt.file.write(dest, output.css);
+                    log('File ' + chalk.cyan(dest) + ' created.');
+
+                    if (output.map) {
+                        grunt.file.write(dest + '.map', output.map.toString());
+                        log('File ' + chalk.cyan(dest + '.map') + ' created (source map).');
+                    }
+
+                    if (options.diff) {
+                        var diffPath = (typeof options.diff === 'string') ? options.diff : dest + '.diff';
+
+                        grunt.file.write(diffPath, diff.createPatch(dest, input, output.css));
+                        log('File ' + chalk.cyan(diffPath) + ' created (diff).');
+                    }
+                });
+        });
+    });
+};

test/expected/a.css

@@ -0,0 +1,3 @@
+a {
+    color: blue;
+}

test/expected/a.css.map

@@ -0,0 +1,43 @@
+'use strict';
+
+var grunt = require('grunt');
+
+/*
+ ======== A Handy Little Nodeunit Reference ========
+ https://github.com/caolan/nodeunit
+
+ Test methods:
+ test.expect(numAssertions)
+ test.done()
+ Test assertions:
+ test.ok(value, [message])
+ test.equal(actual, expected, [message])
+ test.notEqual(actual, expected, [message])
+ test.deepEqual(actual, expected, [message])
+ test.notDeepEqual(actual, expected, [message])
+ test.strictEqual(actual, expected, [message])
+ test.notStrictEqual(actual, expected, [message])
+ test.throws(block, [error], [message])
+ test.doesNotThrow(block, [error], [message])
+ test.ifError(value)
+ */
+
+exports.autoprefixer = {
+
+    sm: function(test) {
+        var actual = {
+            css: grunt.file.read('tmp/a.css'),
+            map: JSON.parse(grunt.file.read('tmp/a.css.map'))
+        };
+
+        var expected = {
+            css: grunt.file.read('test/expected/a.css'),
+            map: JSON.parse(grunt.file.read('test/expected/a.css.map'))
+        };
+
+        test.strictEqual(actual.css, expected.css);
+        test.deepEqual(actual.map, expected.map);
+        test.done();
+    }
+
+};