Skip to content

hershel/plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

f1330e0 Β· Jul 22, 2018

History

21 Commits
Jul 22, 2018
Jul 16, 2018
Jul 15, 2018
Jul 16, 2018
Jul 16, 2018
Jul 15, 2018
Jul 15, 2018
Jul 16, 2018
Jul 15, 2018
Jul 16, 2018
Jul 15, 2018
Jul 16, 2018
Jul 15, 2018

Repository files navigation

@hershel/plugin

Plugin helper for Hershel

When you don't want your plugin to have access to an instance of an encapsulated Hershel Client, you can

  • Use the skip-override hidden property
  • Use this module

In addition if you use this module when creating new plugins, you can declare the expected Hershel version that your plugin needs and the plugin name.

Install

npm i @hershel/plugin

hershel should be installed as well.

Usage

This module can do for you:

Add the skip-override property
Check the minimum version of Hershel
Add plugin name

Example

const myPlugin = plugin((instance, opts, next) => {
  // your code
  next()
})

If you need to set a minimum version of hershel for your plugin, just add the semver range

const { plugin } = require('@hershel/plugin')

const myPlugin = (instance, opts, next) => {
  // your plugin code
  next()
}

plugin(myPlugin, { hershel: '1.x.x' })

By default, the plugin name will be the function name, or anonymous for anonymous function. If you want to override the name, just set { name: '' } like this:

const { plugin } = require('@hershel/plugin')

const myPlugin = (instance, opts, next) => {
  // your plugin code
  next()
}

plugin(myPlugin, { name: 'myAwesomePlugin' })

You can turn off adding skip-override hidden property with { shouldSkipOverride: false }

Related

Thanks

Hershel uses part of Fastify's theoretical logic, a fast and low overhead web framework for Node.js.

License

MIT