Ghost/ghost/pretty-cli
2020-05-25 01:19:06 +00:00
..
lib Added full suite of log functions 2019-03-10 15:08:53 +00:00
test Added full suite of log functions 2019-03-10 15:08:53 +00:00
.eslintrc.js Pretty CLI - provide a styled sywac instance 2018-09-21 13:12:12 +01:00
index.js 🎨 Update to use files array in package.json 2018-11-29 16:04:13 +00:00
LICENSE 2020 2020-01-07 19:06:08 +00:00
package.json Update dependency mocha to v7.2.0 2020-05-25 01:19:06 +00:00
README.md 2020 2020-01-07 19:06:08 +00:00

Pretty CLI

A mini-module to style a sywac instance in a standard way

Install

Either: npm install @tryghost/pretty-cli --save

Or: yarn add @tryghost/pretty-cli

Usage

E.g. const prettyCLI = require('@tryghost/pretty-cli');

prettyCLI is a pre-styled instance of the sywac API.

See the sywac quickstart and config guide for full usage.

Example:

#!/usr/bin/env node
const prettyCLI = require('@tryghost/pretty-cli');


prettyCLI
  .command({
    flags: 'myTask [option]',
    desc: 'Run myTask',
    run: (argv) =>  { ... do something here }
  })
  .parseAndExit();

Pretty CLI also provides a common UI interface, providing log functions to output coloured messages to the UI:

const ui = require('@tryghost/pretty-cli/ui');`

ui.log.info('Done');
ui.log.warn('Uh Oh', 'Something went wrong');

You can also grab a fresh instance of the api with prettyCLI.Api.get().

The style rules used are available at prettyCLI.styles.

Test

  • yarn lint run just eslint
  • yarn test run lint && tests

Copyright & License

Copyright (c) 2013-2020 Ghost Foundation - Released under the MIT license.