elasticsearch-js/scripts/generate/js_api/index.js

var _ = require('../../../src/lib/utils');
var asset = require('assert');
var path = require('path');
var fs = require('fs');
var mkdirp = require('mkdirp');

var outputPath = _.joinPath(__dirname, '../../../src/lib/api.js');

var templates = require('./templates');

// completely delete the output directory
var clean = (function () {
  function rmDirRecursive(path) {
    fs.readdirSync(path).forEach(function (file, index) {
      var curPath = path + '/' + file;
      if (fs.statSync(curPath).isDirectory()) { // recurse
        rmDirRecursive(curPath);
      } else { // delete file
        fs.unlinkSync(curPath);
      }
    });
    fs.rmdirSync(path);
  }

  return function (path) {
    try {
      var stats = fs.statSync(path);
      if (stats && stats.isDirectory()) {
        console.log('removing', path, 'directory recursively');
        rmDirRecursive(path);
      } else {
        console.log('removing', path);
        fs.unlinkSync(path);
      }
      return true;
    } catch (e) {
      return false;
    }
  };

})();

require('./spec').on('ready', function (specs) {
  var defs = [];
  var namespaces = [];

  clean(outputPath);
  var actions = _.map(specs, function (spec) {
    spec.urls = _.map(
      _.sortBy(
        _.transform(spec.urls, function (note, url, i) {
          var optionalVars = {};
          var requiredVars = {};
          var param;
          var target;
          var urlParamRE = /\{(\w+)\}/g;

          if (url.charAt(0) !== '/') {
            url = '/' + url;
          }

          while (match = urlParamRE.exec(url)) {
            param = spec.urlParts[match[1]] || {};
            target = (param.required || !param.default) ? requiredVars : optionalVars;
            target[match[1]] = _.omit(param, 'required');
          }

          [requiredVars, optionalVars].forEach(function (vars) {
            _.each(vars, function (v, name) {
              vars[name] = _.omit(v, 'description');
            })
          })

          note.push(_.omit({
            fmt: url.replace(urlParamRE, '<%=$1%>'),
            opt: _.size(optionalVars) ? optionalVars : null,
            req: _.size(requiredVars) ? requiredVars : null,
            sortOrder: _.size(requiredVars) * -1
          }, function (v) { return !v; }));
        }, [])
      , 'sortOrder')
    , function (url) {
      return _.omit(url, 'sortOrder');
    });

    var docUrl = spec.docUrl;
    var location = _.map(spec.name.split('.'), _.camelCase).join('.');

    spec = _.pick(spec, [
      'methods',
      'params',
      'urls',
      'needBody',
      'bulkBody',
      'castNotFound'
    ]);

    spec.params = _.transform(spec.params, function (note, param, name) {
      param.name = name;
      note[name] = _.pick(param, [
        'type', 'default', 'options', 'required'
      ]);
    }, {});

    if (~location.indexOf('.')) {
      var steps = location.split('.');
      namespaces.push(steps.slice(0, -1).join('.'));
      location = steps.join('.prototype.');
    }

    // escape method names with "special" keywords
    location = location.replace(/(^|\.)(delete|default)(\.|$)/g, '[\'$2\']');
    return {
      spec: spec,
      location: location,
      docUrl: docUrl
    };
  });

  console.log('writing', actions.length, 'api actions to', outputPath);
  fs.writeFileSync(outputPath, templates.apiFile({
    actions: actions,
    namespaces: _.unique(namespaces.sort(), true)
  }));
});