1.4.2 • Published 4 years ago

erte v1.4.2

Weekly downloads
6
License
AGPL-3.0
Repository
-
Last release
4 years ago

erte

npm version

erte Colours Strings' Foreground And Background And Shows String Difference With Color.

yarn add erte
npm i erte
lud erte
yarn add @artdeco/erte
npm i @artdeco/erte
lud @artdeco/erte

Table Of Contents

API

The package is available by importing its default and named functions:

import erte, { c, b } from 'erte'

erte(  source: string,  target: string,): string

Compares the strings using the diff package, and outputs a coloured version where strings don't match with green or red differences. Returns a string which uses shell-codes to highlight differences.

  • source* string: The string to compare.
  • target* string: The string to comparison against.
import erte from 'erte'

const s = 'test this string'
const e = 'test this string with extra data'
const m = 'test this'

const green = erte(s, e)
console.log(green)

const red = erte(s, m)
console.log(red)

const grey = erte(s, s)
console.log(grey)
test this string with extra data
test this string
test this string

extra

missing

same

c(  string: string,  color: Color,  opts=: !Options,): string

Colors the foreground using an ANSI sequence.

  • string* string: The string to color.
  • color* Color: The color to use.
  • opts !Options (optional): Additional options. Only available in the paid version.

Any text in strings can be coloured using the c and b methods. They accept a colour, and additional ANSI transformations.

('black' | 'red' | 'green' | 'yellow' | 'blue' | 'magenta' | 'cyan' | 'white' | 'grey') Color: The color to apply.

Options: Additional options. Only available in the paid version.

NameTypeDescription
boldbooleanThe bold ANSI.
underlinebooleanThe ͟u͟n͟d͟e͟r͟l͟i͟n͟e͟ ANSI.
reversebooleanThe reverse ANSI (inverses background and foreground).
concealbooleanThe conceal ANSI (doesn't show symbols).
import { c } from 'erte'

const redText = c('RED ALERT', 'red', {
  underline: true,
  bold: true,
  conceal: true,
  reverse: true,
})
console.log(redText)

c

b(  string: string,  color: Color,  opts=: !Options,): string

Colors the background with specified ANSI color.

  • string* string: The string to color backgroud of.
  • color* Color: The color to use.
  • opts !Options (optional): Additional options. Only available in the paid version.
import { b } from 'erte'

const greenText = b('VEGAN', 'green')
console.log(greenText)

b

Copyright & License

The diff package is released under BSD License by Kevin Decker. Artwork by Erte.

GNU Affero General Public License v3.0