node-scm-source

Creates a scm-source JSON object according to Zalando STUPS documentation.

Usage

Synchronous use (only with Node 0.12 or better):

var scm = require('node-scm-source');
scm();
> { revision: '79c5e3549682f918c81bdf36a4e361e0360d0c8e',
  url: '[email protected]:zalando-stups/node-scm-source.git',
  status: '',
  author: 'npiccolotto' }

Asynchronous use (mandatory with everything below Node 0.12):

var scm = require('node-scm-source');
scm(function(json) {
    // do something    
});

node-scm-source will throw an error if you try to use it synchronously on Node <0.12.

Example integration with gulp

// using sync api here
var scm = require('node-scm-source'),
    fs = require('fs'),
    gulp = require('gulp');
gulp.task('scm', function(done) {
    fs.writeFile('scm-source.json', JSON.stringify(scm(), null, 4), done);
});

NPM Scripts and CLI

For convenience, it exposes scm-source command to that outputs the information to STDOUT which can be used from package.json script:

// package.json
{
    ...
    "scripts": {
        "scm": "scm-source > scm-source.json"
    },
    ...
    "devDependencies": {
        "node-scm-source": "latest",
        ...
    }

And then you could do npm run scm to generate the file. You could also install this package globally to provide access to scm-source command from your favorite shell.