Merge pull request #56 from tifroz/master

Added extractor API including tests and example code

README.md

@@ -116,6 +116,25 @@ youtubedl.getSubs(url, options, function(err, files) {
 
 For more usage info on youtube-dl and the arguments you can pass to it, do `youtube-dl -h` or go to the [youtube-dl documentation][].
 
+## Getting the list of extractors
+
+```js
+var youtubedl = require('youtube-dl');
+youtubedl.getExtractors(true, function(err, list) {
+  console.log('Found ' + list.length + ' extractors');
+  for (var i = 0; i < list.length; i++) {
+    console.log(list[i]);
+  }
+});
+```
+
+Will print something like
+
+    Found 521 extractors
+    1up.com
+    220.ro
+    24video
+    3sat
 
 # Install
 

example/extractors.js

@@ -0,0 +1,12 @@
+var ytdl = require('..');
+
+ytdl.getExtractors(true, function(err, list) {
+  console.log('Found ' + list.length + ' extractors');
+  var show = 4;
+  for (var  i = 0; i < Math.min(show, list.length); i++) {
+    console.log(list[i]);
+  }
+  if (list.length > show) {
+    console.log('...' + (list.length-show) + ' not shown')
+  }
+});

lib/youtube-dl.js

@@ -305,3 +305,22 @@ ytdl.getSubs = function(url, options, callback) {
     callback(null, files);
   });
 };
+
+/**
+ * @param {!Boolean} descriptions
+ * @param {!Object} options
+ * @param {Function(!Error, Object)} callback
+ */
+ytdl.getExtractors = function(descriptions, options, callback) {
+  if (typeof options === 'function') {
+    callback = options;
+    options = {};
+  } else if (typeof descriptions === 'function') {
+    callback = descriptions;
+    options = {};
+    descriptions = false;
+  }
+
+  var args = descriptions ? ['--extractor-descriptions'] : ['--list-extractors'];
+  call(null, args, null, options, callback);
+};

test/extractors.js

@@ -0,0 +1,27 @@
+var vows   = require('vows');
+var ytdl   = require('..');
+var assert = require('assert');
+
+vows.describe('getExtractors').addBatch({
+  'plain extractors': {
+    'topic': function() {
+      ytdl.getExtractors(false, this.callback);
+    },
+
+    'extractors returned': function(err, extractors) {
+      assert.isNull(err);
+      assert.isArray(extractors);
+    }
+  },
+
+  'extractors with description': {
+    'topic': function() {
+      ytdl.getExtractors(true, this.callback);
+    },
+
+    'extractors returned': function(err, formats) {
+      assert.isNull(err);
+      assert.isArray(formats);
+    }
+  }
+}).export(module);