add support for superagent codegen

codegens/nodejs-superagent/.gitignore

@@ -0,0 +1,68 @@
+.DS_Store
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Prevent IDE stuff
+.idea
+.vscode
+*.sublime-*
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+.coverage
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (http://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Typescript v1 declaration files
+typings/
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variables file
+.env
+
+out/
+
+run.js

codegens/nodejs-superagent/.jsdoc-config.json

@@ -0,0 +1,34 @@
+{
+  "tags": {
+    "allowUnknownTags": true,
+    "dictionaries": ["jsdoc", "closure"]
+  },
+  "source": {
+    "include": ["lib"],
+    "includePattern": ".+\\.js(doc)?$",
+    "excludePattern": "(^|\\/|\\\\)_"
+  },
+
+  "plugins": [
+    "plugins/markdown"
+  ],
+
+  "templates": {
+    "cleverLinks": false,
+    "monospaceLinks": false,
+    "highlightTutorialCode" : true
+  },
+
+  "opts": {
+    "template": "./node_modules/postman-jsdoc-theme",
+    "encoding": "utf8",
+    "destination": "./out/docs",
+    "recurse": true,
+    "readme": "README.md"
+  },
+
+  "markdown": {
+    "parser": "gfm",
+    "hardwrap": false
+  }
+}

codegens/nodejs-superagent/.npmignore

@@ -0,0 +1,74 @@
+### NPM Specific: Disregard recursive project files
+### ===============================================
+/.editorconfig
+/.gitmodules
+/test
+
+### Borrowed from .gitignore
+### ========================
+
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Prevent IDE stuff
+.idea
+.vscode
+*.sublime-*
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+.coverage
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (http://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Typescript v1 declaration files
+typings/
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variables file
+.env
+
+out/

codegens/nodejs-superagent/README.md

@@ -0,0 +1,68 @@
+# codegen-nodejs-superagent
+
+> Converts Postman-SDK Request into code snippet for nodejs-superagent.
+
+#### Prerequisites
+To run the module, ensure that you have NodeJS >= v6. A copy of the NodeJS installable can be downloaded from https://nodejs.org/en/download/package-manager.
+
+## Using the Module
+The module will expose an object which will have property `convert` which is the function for converting the Postman-SDK request to nodejs-superagent code snippet and `getOptions` function which returns an array of supported options.
+
+### convert function
+Convert function will take three parameters
+* `request`- Postman-SDK Request object
+
+* `options`- options is an object which can have following properties
+    * `indentType`- String denoting type of indentation for code snippet. eg: 'Space', 'Tab'
+    * `indentCount`- positiveInteger representing count of indentation required.
+    * `requestTimeout` : Integer denoting time after which the request will bail out in milli-seconds
+    * `trimRequestBody` : Trim request body fields
+    * `followRedirect` : Boolean denoting whether to redirect a request
+    * `ES6_enabled` : Boolean denoting whether to generate snippet with ES6 features
+
+* `callback`- callback function with first parameter as error and second parameter as string for code snippet
+
+##### Example:
+```js
+var request = new sdk.Request('www.google.com'),  //using postman sdk to create request  
+    options = {
+        indentType: 'Space',
+        indentCount: 2,
+        ES6_enabled: true
+    };
+convert(request, options, function(error, snippet) {
+    if (error) {
+        //  handle error
+    }
+    //  handle snippet
+});
+```
+
+### getOptions function
+
+This function returns a list of options supported by this codegen.
+
+#### Example
+```js
+var options = getOptions();
+
+console.log(options);
+// output
+// [
+//       {
+//         name: 'Set indentation count',
+//         id: 'indentCount',
+//         type: 'positiveInteger',
+//         default: 2,
+//         description: 'Set the number of indentation characters to add per code level'
+//       },
+//       ...
+// ]
+```
+
+### Guideline for using generated snippet
+* Generated snippet requires `superagent` and `fs` modules.
+
+* Since Postman-SDK Request object doesn't provide complete path of the file, it needs to be manually inserted in case of uploading a file.
+
+* This module doesn't support cookies.

codegens/nodejs-superagent/index.js

@@ -0,0 +1 @@
+module.exports = require('./lib');

codegens/nodejs-superagent/lib/index.js

@@ -0,0 +1,22 @@
+const { convert, getOptions } = require('./superagent'),
+  mainCollection = require('../test/unit/fixtures/testcollection/collection.json'),
+  sdk = require('postman-collection');
+const request = new sdk.Request(mainCollection.item[0].request);
+
+// console.log(JSON.stringify(request));
+
+console.log(convert(request, {
+  // indentType: 'Tab',
+  // indentCount: 1
+}, function (error, snippet) {
+  if (error) {
+    expect.fail(null, null, error);
+    return;
+  }
+  console.log(snippet);
+}));
+
+module.exports = {
+  convert: require('./superagent').convert,
+  getOptions: require('./superagent').getOptions
+};