nestjs-console

nestjs-console

NestJS Console is a module that provide a cli. A ready to use service class for your module that exposes the required methods to register commands and sub commands using the npm package commander

Install

npm install nestjs-console
# or unig yarn
yarn install nestjs-console

Prepare the cli endpoint

Create a file next to main.ts named console.ts
Import your app module or any module you want to be loaded. Usually this is your main nestjs module.

import { bootstrap } from 'nestjs-console';
import { AppModule } from './bundles/app';

bootstrap(AppModule, { logger: false }).catch(e => console.log('Error', e));

Usage

Import the ConsoleModule inside your module

// module.ts
import { Module } from '@nestjs/common';
import { ConsoleModule } from 'nestjs-console';
import { MyService } from './service';

@Module({
    imports: [
        ConsoleModule // Import the module where you need it
    ],
    exports: [MyService]
})
export class MyModule {}

You can now inject the ConsoleService inside any nestjs providers, controllers...

// service.ts
import { Injectable } from '@nestjs/common';
import { ConsoleService } from 'nestjs-console';

@Injectable()
export class MyService {
    constructor(private readonly consoleService: ConsoleService) {
        this.consoleService
            .getCli()
            .command('mycommand')
            .options('-a, --all', 'an exemple of options')
            .action(this.myCommand.bind(this));
    }

    myCommand(options) {
        //See Ora npm package for details about spinner
        const spin = this.consoleService.createSpinner();
        spin.start();
        // DO SOME WORK
        spin.stop();
    }
}

Documentation

A typedoc is generated and available on github https://pop-code.github.io/nestjs-console