frint-cli

frint-cli

CLI for Frint

• Guide
  • Installation
  • Usage
  • Built-in commands
  • Using plugins
  • Developing your own plugin

---

Guide

Installation

With npm:

$ npm install -g frint-cli

Usage

From your Terminal:

$ frint

Will list all the commands available to you.

Built-in commands

init

Scaffolds a new FrintJS application in an empty directory:

$ mkdir my-directory && cd my-directory

$ frint init

To scaffold a certain example, as available in the repository here:

$ frint init --example exampleName

version

Shows the current version of frint-cli:

$ frint version

help

Shows help text of commands:

$ frint help init
$ frint help help

Using plugins

You can install frint-cli plugins just like a regular npm package in your project:

$ npm install --save frint-cli-hello

.frintrc

To register this new CLI plugin, update your .frintrc file in your project's root directory:

{
  "plugins": [
    "frint-cli-hello",
    "./some-relative/path"
  ]
}

Run the plugin

Now the frint-cli-hello plugin can be run as:

$ frint hello
world

Developing your own plugin

Building a plugin for frint-cli, is just like developing a regular FrintJS app.

// frint-cli-hello/index.js
const createApp = require('frint').createApp;

module.exports = createApp({
  name: 'hello', // this is the subcommand name in `$ frint hello`

  providers: [
    {
      name: 'summary',
      useValue: 'Short help text',
    },
    {
      name: 'description',
      useValue: 'Long help text',
    },
    {
      name: 'execute',
      useFactory: function () {
        return function () { // this returned function will be excuted
          console.log('world!');
        }
      },
    }
  ],
});

It is required that you have a provider called execute, which returns a function. This function will then be called when the subcommand is run.

To register multiple commands from the same plugin, you can export an array of App classes.

The summary and description is used when the user is trying to get help text by running:

$ frint help hello

Providers available in plugins

• console (Console): The same console available in NodeJS globally
• pwd (String): Current working directory
• config (Object): As available in .frintrc file
• params (Object): An yargs compatible object after parsing CLI options
• fs (Object): Node's fs module

Changelog

v2.7.0 (2017-09-22)

Pull Requests

• frint-data
  • #305 frint-data: Reactive data modelling. (@fahad19)
• frint-cli, frint-compat, frint-component-handlers, frint-component-utils, frint-model, frint-react-server, frint-react, frint-router-react, frint-router, frint-store, frint-test-utils, frint
  • #304 Enable execution of npm scripts within subpackage folder. (@discosultan)

Committers: 2

• Fahad Ibnay Heylaal (fahad19)
• Jaanus Varus (discosultan)