npm

npm’s 2019 JavaScript ecosystem survey analysis is now available!Get your copy here »

inversify-oclif-utils

0.1.1 • Public • Published

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

install

npm i inversify-oclif-utils

Downloadsweekly downloads

0

version

0.1.1

license

MIT

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar
Report a vulnerability