This adds the ability to import custom targets, and custom target clients by way of two new APIs:

• addTarget
• addTargetClient

Why? A couple reasons!

1. Lately it's seemed that pulling in support for new targets, and clients, has become a bit of a blocker. It's no fun to have a repo with more than a handful of useful clients as open pull requests waiting to be merged. With the ability to have a sort of plugin infrastructure, users can just load in whatever custom target they'd like that isn't officially supported here.
2. I work at @readmeio and we're working on generating some slimmed down code samples on our customer sites, which is requiring us to create custom target clients and without the ability to inject these into the library (short of maintaining an ongoing fork), there's no way we can currently convert HAR representations for them.

Adding custom targets/languages

const customTargetModule = require('./customTargetModule');
HTTPSnippet.addTarget(customTargetModule);

The syntax for adding a new custom targets is identical to how they're currently stored within src/targets:

module.exports = {
  info: {
    key: 'js-variant',
    title: 'JavaScript Variant',
    extname: '.js',
    default: 'xhr'
  },
  xhr: require('./xhr')
};

With this, you'd supply this full export into addTarget and it'll handle validating the construction of the object and appending it to the instance targets variable so it can later be used with .convert(...).

Adding a custom target client

const customClient = require('./customClient');
HTTPSnippet.addTargetClient('node', customClient);

Since clients currently have no awareness to what target/language they're for, the API for adding a custom client is a little different however the data structure behind the plugin is still identical to how they're currently structured.

var helpers = require('./helpers')
var CodeBuilder = require('../../helpers/code-builder')

module.exports = function (source, options) {
  // code here to handle translating a HAR to Guzzle
}

module.exports.info = {
  key: 'guzzle',
  title: 'Guzzle',
  link: 'http://docs.guzzlephp.org/en/stable/',
  description: 'Guzzle is a PHP HTTP client library'
}

As with addTarget, you'd just load this file and pass it directly into addTargetClient and then you can immediately generate code snippets for it:

const snippet = new HTTPSnippet(har);
console.log(snippet.convert('php', 'guzzle'));