# remi

> A plugin registrator.

Latest version **2.0.1** (published 2016-07-07) · MIT license · 0 weekly downloads

## Install

```sh
npm install remi
pnpm add remi
yarn add remi
bun add remi
```

## Health

**Score 25/100 (F)** — status: abandoned.

Positive: has types; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.0.1 |
| Published | 2016-07-07 |
| First published | 2016-01-09 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 2 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 4 |
| Author | Zoltan Kochan |
| Maintainers | zkochan |
| Keywords | plugin, plugins, extension, register |

## Links

- npm: https://www.npmjs.com/package/remi
- Repository: https://github.com/remijs/remi
- Homepage: https://github.com/remijs/remi#readme
- Issues: https://github.com/remijs/remi/issues
- npm.io page: https://npm.io/package/remi

## Dependencies (2)

- [magic-hook](https://npm.io/package/magic-hook.md) ^2.0.0
- [babel-runtime](https://npm.io/package/babel-runtime.md) ^6.9.0

## Recent versions

- 2.0.1 (latest) — 2016-07-07
- 2.0.0-0 (next) — 2016-06-11
- 1.1.0-1 (tsc) — 2016-06-09
- 2.0.0-1 — 2016-07-03
- 2.0.0 — 2016-06-09
- 1.1.1 — 2016-05-21
- 1.1.0 — 2016-05-21
- 1.1.0-0 — 2016-03-20
- 1.0.0 — 2016-02-21
- 0.5.1 — 2016-02-05
- 0.5.0 — 2016-01-30
- 0.4.1 — 2016-01-26
- 0.4.0 — 2016-01-26
- 0.3.0 — 2016-01-16
- 0.2.1 — 2016-01-14
- … 3 more at https://npm.io/package/remi/versions

## README

# remi

> A plugin registrator.

<!--@shields('npm', 'travis', 'coveralls')-->
[![npm version](https://img.shields.io/npm/v/remi.svg)](https://www.npmjs.com/package/remi) [![Build Status](https://img.shields.io/travis/remijs/remi/master.svg)](https://travis-ci.org/remijs/remi) [![Coverage Status](https://img.shields.io/coveralls/remijs/remi/master.svg)](https://coveralls.io/r/remijs/remi?branch=master)
<!--/@-->

Plugins allow you to very easily break your application up into isolated pieces of
business logic, and reusable utilities.

Inspired by [hapi's plugins](http://hapijs.com/tutorials/plugins).

## Installation

```sh
npm install --save remi
```

## Creating a plugin

Plugins are very simple to write. At their core they are an object with a register
function that has the signature function `(server, options, next)`. That `register`
function then has an `attributes` object attached to it to provide some
additional information about the plugin, such as name and version.

A very simple plugin looks like:

```js
let myPlugin = {
  register(app, options, next) {
    next()
  }
}

myPlugin.register.attributes = {
  name: 'myPlugin',
  version: '1.0.0',
}
```

Or when written as an external module:

```js
module.exports = function(app, options, next) {
  next()
}

module.exports.attributes = {
  pkg: require('./package.json'),
}
```

Note that in the first example, we set the `name` and `version` attributes specifically,
however in the second we set a `pkg` parameter with the contents of package.json as
its value. Either method is acceptable.

## The register method

As we've seen above, the register method accepts three parameters, `app`, `options`, and `next`.

The `options` parameter is simply whatever options the user passes to your plugin.
No changes are made and the object is passed directly to your register method.

`next` is a method to be called when your plugin has completed whatever steps are
necessary for it to be registered. This method accepts only one parameter, `err`,
that should only be defined if an error occurred while registering your plugin.

The `app` object is a reference to the `app` your plugin is being loaded in.

## Loading a plugin

Plugins can be loaded one at a time, or as a group in an array, by the
`register()` method of a `Remi` object, for example:

```js
const remi = require('remi')

// load one plugin
let registrator = remi(app)
registrator
  .register(require('myplugin'))
  .then(() => console.log('myplugin was successfully registered'))
  .catch(err => console.error('Failed to load plugin:', err))

// load multiple plugins
registrator
  .register([require('myplugin'), require('yourplugin')])
  .catch(err => console.error('Failed to load plugin:', err))
```

To pass options to your plugin, we instead create an object with `register` and `options` keys, such as:

```js
registrator.register({
  register: require('myplugin'),
  options: {
    message: 'hello'
  }
})
```

These objects can also be passed in an array:

```js
registrator.register([{
  register: require('plugin1'),
  options: {}
}, {
  register: require('plugin2'),
  options: {}
}])
```

## License

[MIT](./LICENSE) © [Zoltan Kochan](http://kochan.io)

---
_Source: https://npm.io/package/remi · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
