api-console-dependency-manager


A npm module to detect and install Mulesoft's API console dependencies.

This module is mainly used in the api-console-builder.

API

Shorthand functions:

- installDependencies(workingDir, logger, opts) -> new DependendenciesManager#installDependencies(workingDir, logger, opts)

The module exposes 2 classes:

- DependendenciesManager
- DependenciesOptions

$3

``javascript
const consoleDependencies = require('api-console-dependency-manager');

consoleDependencies.installDependencies('./build/', console, {
verbose: true,
parser: true,
app: true
})
.then(() => console.log('Dependencies are now installed'))
.catch(cause => console.error(cause));
`

equivalent to

`javascript
const {DependendenciesManager, DependenciesOptions} = require('api-console-github-resolver');

const options = new DependenciesOptions({
verbose: true,
parser: true,
app: true
});
const workingDir = './build/';
const logger = console; // Winston or other with console like interface
const manager = new DependendenciesManager(workingDir, logger, options);
manager.installDependencies()
.then(() => console.log('Dependencies are now installed'))
.catch(cause => console.error(cause));
`

$3

| Property | Type | Default | Description |
| -------- | -------- | -------- | -------- |
| verbose | Boolean | false | Prints verbose output while installing dependencies. This is used to build install command for bower which is printing console output by default. |
| parser | Boolean | false | If set it installs RAML javascript parser with the enhancer. Deprecated: This option is only relevant for the console version 4. It may be removed in future releases. Set isV4 option when using this one. |
| app | Boolean | false | If set it installs app-route element to support standalone application architecture of the API console. Deprecated: This option is only relevant for the console version 4. It may be removed in future releases. Set isV4 option when using this one. |
| isV4 | Boolean | false | Compatibility mode with API console version 4. If set then it works as module created for v4 (versions 0.x.x of the module) |
| optionalDependencies | Array | undefined | List of optional dependencies to install besides the ones installed with bower file. It contains the list to of bower dependencies as it would be defined in bower.json file. This isn relevant for console v5 build process which manages dependencies differently. |

$3

#### Constructor

##### Arguments

| Property | Type | Description |
| -------- | -------- | -------- |
| workingDir | String | Path to a working directory where the console is processed. Usually it's where the bower.json file is. |
| options | Object or DependenciesOptions | Build options passed to the module. |
| logger | Object | Any logger with the interface compatible with platform's console object. |

#### installDependencies()

Installs dependencies in the workingDir`.

##### Return

Resolved promise when operation is completed.

Changes in stable version

- Order of arguments is reversed
- It uses locally installed Bower dependency and does not checks if bower is installed on local machine.
- Now additional dependencies has to be defined in the configuration options