Automated generation of 'colour schemed' stylesheets from less files.

description.md

Description of problem

You have a directory (colour-scheme/) containing .less (each defining a different colour scheme). For each of those files (call it scheme-x.less), compile it with the "core" .less file(s) (stored elsewhere) to create style-x.css.

Preferably, by adding a .less file to colour-scheme/ directory and running a grunt task, the appropriate style-?.css should be created. That is, no editing of Gruntfile.js is required.

Directory layout is below.

layout.txt

assets/css
|
| — less/
    |
    | — core.less
    |
    | — colour-schemes/
        | — scheme-red.less
        | — scheme-blue.less
        | — scheme-green.less
|
| — style-red.css  (generated)
| — style-blue.css  (generated)
| — style-green.css  (generated)

Building off of kaiser's contrib-less/contrib-concat implementation, here is one way in which you can resolve the problem dynamically (turns out I was wrong about using a multitask - doing so causes the task to fail as it requires explicit configuration properties for each individual target. Regular custom tasks don't test the Grunt environment before executing, and thus don't fail as a result of missing target configs):

var path = require( 'path' );
var fs = require( 'fs' );

module.exports = function( grunt ) {
    // Initialize Grunt configuration
    grunt.initConfig({
        colourScheme: {     // Default configuration for the colourScheme task
            paths: {                // Relative path parts. All paths but 'root' are relative to 'root'
                root: 'assets/css',                 // Relative to Grunt's process.cwd()
                lessCore: 'less',                   // Directory containing the core LESS file
                lessSchemes: 'colour-schemes',      // Directory contianing individual colour schemes
                lessCache: '.less-cache',           // Directory to which concatenated LESS files will be written
                dest: '.'                           // Directory to which the final compiled CSS file will be written
            },
            filenames: {
                lessCore: 'core'                    // Name of the primary LESS file that schemes will be compiled with
            }
        },
        concat: {
            colourScheme: {         // Important bits established at runtime in compileColourScheme()
            }
        },
        less: {
            colourScheme: {         // Important bits established at runtime in compileColourScheme()
            }
        }
    });

    // Load external tasks

    grunt.loadNpmTasks( 'grunt-contrib-concat' );
    grunt.loadNpmTasks( 'grunt-contrib-less' );

    // Register custom tasks

    grunt.registerTask( 'colourScheme', function( colour ) {
        var config = grunt.config.get( this.name );
        var colourSchemesDir = path.join(
            config.paths.root,
            config.paths.lessSchemes
        );
        var files;

        if( 'undefined' === typeof colour || ! colour )
            files = fs.readdirSync( colourSchemesDir );
        else
            files = [ colourSchemesDir + '/scheme-' + colour + '.less' ];

        for( var i = 0; i < files.length; i++ ) {
            compileColourScheme( files[ i ], config );
        }
    });

    // Define utility functions

    /**
     * Compiles the specified LESS file with the LESS core file to produce a colour scheme stylesheet.
     *
     * @param {string} lessScheme The path to a colour scheme's LESS file relative to the Gruntfile
     * @param {object} config
     */
    function compileColourScheme( lessScheme, config ) {
        if( 'undefined' === typeof config || ! config )
            config = grunt.config.get( 'colourScheme' );

        if( fs.existsSync( lessScheme ) ) {
            var colour = lessScheme.slice(
                lessScheme.lastIndexOf( 'scheme-' ) + new String('scheme-').length,
                lessScheme.lastIndexOf( '.less' )
            );
            var lessCoreDir = path.join(
                config.paths.root,
                config.paths.lessCore
            );
            var lessCoreFile = path.join(
                lessCoreDir,
                config.filenames.lessCore + '.less'
            );
            var lessCacheFile = path.join(
                config.paths.root,
                config.paths.lessCache,
                config.filenames.lessCore + '-' + colour + '.less'
            );
            var destCssFile = path.join(
                config.paths.root,
                config.paths.dest,
                config.filenames.lessCore + '-' + colour + '.css'
            );
            var compilationFileMap = {};

            // Can't use an expression as an inline obj def property key - establish less task's "files" option here
            compilationFileMap[ destCssFile ] = lessCacheFile;

            // Establish run-time options for the concat:colourScheme task-target
            grunt.config.set( 'concat.colourScheme.src', [ lessCoreFile, lessScheme ] );
            grunt.config.set( 'concat.colourScheme.dest', lessCacheFile );

            // Establish run-time options for the less:colourScheme task-target
            grunt.config.set( 'less.colourScheme.files', compilationFileMap );
            grunt.config.set( 'less.colourScheme.options.path', lessCoreDir );

            // Execute the concat:colourScheme and less:colourScheme tasks sequentially
            grunt.task.run( [ 'concat:colourScheme', 'less:colourScheme' ] );
        }
        else {
            console.log('Scheme source file "' + lessScheme + '" does not exist.');
        }
    }
};