Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including inversify-oclif-utils with all npm packages installed. Try it out:

var inversifyOclifUtils = require("inversify-oclif-utils")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

inversify-oclif-utils v0.1.1

Create oclif commands with inversify

inversify-oclif-utils

Create oclif commands with InversifyJS.

oclif Version Downloads/week License CircleCI codecov

Getting Started

These instructions will get you up and running.

Prerequisites

Make sure you have InversifyJS and Oclif installed.

It's best to start with a fresh Oclif installation and add InversifyJS to it. Ofcourse you could install Oclif in an existing project manually (but you have to figure this out on your own).

Installing

Install this plugin with npm:

npm install inversify-oclif-utils --save

Or with Yarn:

yarn add inversify-oclif-utils

Afterwards add it to your package.json:

{
  ...,
  "oclif": {
    ...,
    "plugins": {
      "inversify-oclif-utils"
    }
  }
}

Creating Commands

Now we will get you started with creating commands.

... injecting Services

If you want to inject other services into your commands, you must setup the container like this:

import { useContainer } from 'inversify-oclif-utils'
import { Container } from 'inversify'

const container = new Container();
useContainer(container);

You do this before running any Oclif commands. For example, at the top of your Oclif "binary" in the /bin folder.

Afterwards you can inject other services in your commands like this:

import { Command } from 'inversify-oclif-utils'
import { inject } from 'inversify'

export class YourCommand extends Command {

  @inject(FooService)
  protected foo!: FooService

  async run () {
    this.log(this.foo.bar())
    return true
  }
}

Please note, that you have to use my implementation of the Command class for it to work.

... loading Commands dynamically

If you want to dynamically load your commands into Oclif without putting them in a specified command directory (the default way in Oclif). You can use our @command() decorator.

import { command } from 'inversify-oclif-utils'
import { Command } from '@oclif/command'

@command('your:command')
export class YourCommand extends Command {
  ...
}

The command can then be run by:

./bin/YOURBIN your:command

Make sure you put commands that are loaded with the decorator not into the Oclif command directory. Otherwise it might be loaded twice.

... or both

You can do both things at once.

import { Command, command } from 'inversify-oclif-utils'
import { inject } from 'inversify'

@command('your:command')
export class YourCommand extends Command {

  @inject(FooService)
  protected foo!: FooService

  async run () {
    this.log(this.foo.bar())
    return true
  }
}

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Acknowledgments

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free