feat(inputformats): Add inputFormats to JS Transformers

README.md

@@ -89,6 +89,15 @@ _requires the underlying transform to implement `.renderFileAsync`, `.renderFile
 
 Transform a file asynchronously. If a callback is provided, it is called as `callback(err, data)`, otherwise a Promise is returned.
 
+### `.inputFormats`
+
+```js
+var formats = transformer.inputFormats();
+=> ['md', 'markdown']
+```
+
+Returns an array of strings representing potential input formats for the transform. If not provided directly by the transform, results in an array containing the name of the transform.
+
 ## License
 
 MIT

index.js

@@ -325,3 +325,10 @@ Transformer.prototype.renderFileAsync = function (filename, options, locals, cb)
     }.bind(this)), cb);
   }
 };
+
+/**
+ * inputFormats
+ */
+Transformer.prototype.inputFormats = function() {
+  return this._tr.inputFormats || [this._tr.name];
+};

test/index.js

@@ -38,3 +38,4 @@ require('./compile-file-client');
 require('./compile-file-client-async');
 require('./render');
 require('./render-async');
+require('./input-format');

test/input-format.js

@@ -0,0 +1,31 @@
+'use strict';
+
+var assert = require('assert');
+var test = require('./test');
+var createTransformer = require('../');
+
+test('inputFormats - with tr.inputFormats', function (override) {
+  var tr = createTransformer({
+    name: 'test',
+    outputFormat: 'html',
+    inputFormats: [
+      'html',
+      'htm'
+    ],
+    render: function (str, options) {
+      return str;
+    }
+  });
+  assert.deepEqual(tr.inputFormats(), ['html', 'htm']);
+});
+
+test('inputFormats - without tr.inputFormats', function (override) {
+  var tr = createTransformer({
+    name: 'test',
+    outputFormat: 'html',
+    render: function (str, options) {
+      return str;
+    }
+  });
+  assert.deepEqual(tr.inputFormats(), ['test']);
+});