added api.md generation [ci skip]

Author: Spencer Alger

dist/elasticsearch.angular.js

@@ -0,0 +1,39 @@
+# Errors
+
+These are the standard Error types which may be passed back from the client. To access the constructors access the errors module via `require('elasticsearch').errors`.
+
+## ConnectionFault
+The connection was unable to initiate or complete a request with the Elasticsearch node.
+
+## NoConnections
+All of the connections in the ConnectionPool are dead.
+
+## RequestTimeout
+The request timed-out.
+
+## Serialization
+The response received from Elasticsearch could not be deserilaized.
+
+## 503 or ServiceUnavailable
+Elasticsearch responded with a 503 status.
+
+## 500 or InternalServerError
+Elasticsearch responded with a 500 status.
+
+## 412 or PreconditionFailed
+Elasticsearch responded with a 412 status.
+
+## 409 or Conflict
+Elasticsearch responded with a 409 status.
+
+## 403 or Forbidden
+Elasticsearch responded with a 403 status.
+
+## 404 or NotFound
+Elasticsearch responded with a 404 status.
+
+## 400 or BadRequest
+Elasticsearch responded with a 400 status.
+
+## Generic
+Elasticsearch responded with a status that does not map to it's own error type.

dist/elasticsearch.angular.min.js

@@ -8,6 +8,7 @@ var clean = require('../../clean');
 var urlParamRE = /\{(\w+)\}/g;
 
 var outputPath = _.joinPath(__dirname, '../../../src/lib/api.js');
+var docOutputPath = _.joinPath(__dirname, '../../../docs/api.md');
 
 function download() {
   require('./actions').on('ready', function (actions) {
@@ -27,6 +28,9 @@ function download() {
       actions: actions,
       namespaces: _.unique(namespaces.sort(), true)
     }));
+    fs.writeFileSync(docOutputPath, templates.apiDocs({
+      actions: actions
+    }));
   });
 }
 

dist/elasticsearch.js

@@ -0,0 +1,39 @@
+# API
+
+## Table Of Contents
+
+<%
+
+function esc(str) {
+  return str.replace(/\|/g, '&#124;');
+}
+
+var _paramWithDefault = paramWithDefault;
+paramWithDefault = function (name, _default) {
+  return esc(_paramWithDefault(name, _default));
+};
+
+var _paramType = paramType;
+paramType = function (type) {
+  return esc(_paramType(type));
+};
+
+_.each(actions, function (action) {%>
+  - [<%= action.name %>](#<%= action.name.toLowerCase().replace(/[^\w]/g, '') %>)<%
+})
+
+_.each(actions, function (action) {
+%>
+
+### <%= action.name %>()
+
+<%= action.docUrl %>
+
+| Name | Type | Description |
+| ---- | ---- | ----------- |
+<%
+  _.each(action.allParams, function(param, paramName) {
+%>|`<%= paramWithDefault(paramName, param.default) %>` | <%= paramType(param.type) %> | <%= esc(param.description || '') %>|
+<% })
+
+}); %>

dist/elasticsearch.min.js

@@ -87,13 +87,13 @@ var templateGlobals = {
   paramType: function (type) {
     switch (type && type.toLowerCase ? type.toLowerCase() : 'any') {
     case 'time':
-      return 'Date|Number';
+      return 'Date or Number';
     case 'any':
       return '*';
     case 'enum':
       return 'String';
     case 'list':
-      return 'String|ArrayOfStrings|Boolean';
+      return 'String or String[] or Boolean';
     default:
       return _.ucfirst(type);
     }
@@ -125,5 +125,6 @@ fs.readdirSync(path.resolve(__dirname)).forEach(function (filename) {
 templates.text = templates.string;
 
 module.exports = {
-  apiFile: templates.api_file
+  apiFile: templates.api_file,
+  apiDocs: templates.api_docs
 };