Ghost/ghost/pretty-cli
2019-04-22 01:28:43 +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
index.js 🎨 Update to use files array in package.json 2018-11-29 16:04:13 +00:00
LICENSE 2019 2019-01-01 14:27:50 +00:00
package.json Update Test & linting packages 2019-04-22 01:28:43 +00:00
README.md Update README.md to mention ui.log 2019-04-05 12:41:24 +01: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) 2018-2019 Ghost Foundation - Released under the MIT license.