Command::styles

styles

since 0.1.0

Sets the Styles for terminal output.

Example

Spec

TOML

name = "myprog"
[styles]
header = { fg = "blue", bg = "#f0f0f0", underline = 7, effects = ["bold", "italic"] }
error = { fg = "bright-red" }
usage = { fg = "green" }
literal = { fg = "magenta" }
placeholder = { fg = "white" }
valid = { fg = "bright-green" }
invalid = { fg = "#ff0000" }
context = { fg = "yellow", bg = "#000000", effects = ["bold"] }
context-value = { fg = "cyan", bg = "#000000", effects = ["bold"] }
[args]
foo = { help = "It does foo stuff", short = 'f', long = "foo", value-name = "FOO", default-value = "bar", env = "MY_FOO", action = "set" }

YAML

name: myprog
styles:
  header:
    fg: blue
    bg: '#f0f0f0'
    underline: 7
    effects:
    - bold
    - italic
  error:
    fg: bright-red
  usage:
    fg: green
  literal:
    fg: magenta
  placeholder:
    fg: white
  valid:
    fg: bright-green
  invalid:
    fg: '#ff0000'
  context:
    fg: yellow
    bg: '#000000'
    effects:
    - bold
  context-value:
    fg: cyan
    bg: '#000000'
    effects:
    - bold
args:
  foo:
    help: It does foo stuff
    short: f
    long: foo
    value-name: FOO
    default-value: bar
    env: MY_FOO
    action: set

JSON

{
  "name": "myprog",
  "styles": {
    "header": {
      "fg": "blue",
      "bg": "#f0f0f0",
      "underline": 7,
      "effects": [
        "bold",
        "italic"
      ]
    },
    "error": {
      "fg": "bright-red"
    },
    "usage": {
      "fg": "green"
    },
    "literal": {
      "fg": "magenta"
    },
    "placeholder": {
      "fg": "white"
    },
    "valid": {
      "fg": "bright-green"
    },
    "invalid": {
      "fg": "#ff0000"
    },
    "context": {
      "fg": "yellow",
      "bg": "#000000",
      "effects": [
        "bold"
      ]
    },
    "context-value": {
      "fg": "cyan",
      "bg": "#000000",
      "effects": [
        "bold"
      ]
    }
  },
  "args": {
    "foo": {
      "help": "It does foo stuff",
      "short": "f",
      "long": "foo",
      "value-name": "FOO",
      "default-value": "bar",
      "env": "MY_FOO",
      "action": "set"
    }
  }
}

Input

myprog --help

Output

Usage: myprog [OPTIONS]

Options:
  -f, --foo <FOO>  It does foo stuff [env: MY_FOO=] [default: bar]
  -h, --help       Print help