welcomes

Welcome message for shells

Installation

$ npm install -g welcomes

Usage

Add welcomes --config config.json or welcomes time hangang custom-a custom-b --configs to your run commands file (.bashrc, .bash_profile or .zshrc etc.)

• Pre-installed plugins: time, hangang, dimibob
• custom-a is short for welcomes-plugin-custom-a npm package

Configuration

Basic

| Key | Description | Default | | :---: | :-------: | :---: | | dev -> boolean | false일 경우 에러 메세지가 출력되지 않습니다. | false | | verbose -> boolean | true일 경우 현재 설정이 출력됩니다. | false | | timeout -> number | 요청 타임아웃, 밀리초 단위 (axios 문서 참고) | 0 | | encoding -> string | 인코딩 (axios 문서 참고) | 'utf-8' |

time plugin

| Key | Description | Default | | :---: | :-------: | :---: | | locale -> string | 출력할 시간의 로케일 (moment 문서 참고) | null | | format -> string | 출력할 시간의 날짜 포맷 (moment 문서 참고) | 'HH:mm:ss' | | style -> string | 출력할 텍스트의 스타일 (chalk 문서 참고) | null | | color -> string | 출력할 텍스트의 배경색, bg 제외. (chalk 문서 참고) | 'white' | | fgColor -> string | 출력할 텍스트의 전경색 (chalk 문서 참고) | 'black' |

dimibob plugin

| Key | Description | Default | | :---: | :-------: | :---: | | ignoreSnack -> boolean | true일 경우 21시 40분 이전에도 간식 대신 다음 아침 메뉴를 출력합니다. | false | | onlyToday -> boolean | true일 경우 21시 40분부터 자정까지는 아무 것도 출력하지 않습니다. false일 경우 21시 40분부터 익일 8시 45분까지 다음 아침 메뉴를 출력합니다. | false | | cmd -> string | 출력할 명령어 이름 | 'dimibob' | | cmdFormat -> string | 출력할 명령어 인자의 날짜 포맷 (moment 문서 참고) | 'dimibob' | | likes -> string | 좋아하는 급식 리스트 (예시) 파일의 경로 null이 아닐 경우 해당되는 메뉴의 텍스트가 강조됨. | null | | likesColor -> string | likes가 null이 아닐 경우에만 필요 좋아하는 메뉴 텍스트의 강조 스타일 (chalk 문서 참고). | 'blue' | | server -> string | 디미고 급식 API의 주소. URL 파리미터 d로 날짜를 지정할 수 있어야 함. | 여기 | | paramFormat -> string | URL 파리미터 d의 날짜 포맷 (moment 문서 참고) | 'YYYYMMDD' |

hangang plugin

| Key | Description | Default | | :---: | :-------: | :---: | | icon -> string | 온도 좌측에 표시될 이모지 | '🌡' | | style -> string | 출력할 텍스트의 스타일 (chalk 문서 참고) | null | | fgColor -> string | 출력할 텍스트의 전경색 (chalk 문서 참고) | 'black' | | server -> string | 한강 온도 API의 주소. JSON으로 응답해야 하며, temp 필드가 현재 온도 값이어야 함. | 여기 |

Via CLI argument

$ welcomes time dimibob hangang \
  --dev --verbose --timeout 5000 \
  \
  --time:locale ko --time:format LLLL \
  --time:color yellow --time:fgColor magenta --time:style underline \
  \
  --dimibob:ignoreSnack \
  --dimibob:cmd bob --dimibob:cmdFormat L \
  --dimibob:paramFormat YYYYMMDD \
  --dimibob:server "http://dimigo.in/pages/dimibob_getdata.php" \
  --dimibob:likes ./favorites.txt --dimibob:likesColor yellow_underline_bold \
  \
  --hangang:icon='★' \
  --hangang:server "http://hangang.dkserver.wo.tc" \
  --hangang:style underline --hangang:fgColor red_bold

Via config file

$ cat welcomes.json
{
  "_": [
    "time",
    "dimibob",
    "hangang"
  ],

  "dev": true,
  "verbose": true,
  "timeout": 5000,

  "time": {
    "color": "yellow",
    "fgColor": "magenta",
    "style": "underline",

    "locale": "ko",
    "format": "LLLL"
  },

  "dimibob": {
    "cmd": "bob",
    "cmdFormat": "L",

    "onlyToday": false,
    "ignoreSnack": true,

    "likes": "./favorites.txt",
    "likesColor": "yellow_underline_bold",

    "paramFormat": "YYYYMMDD",
    "server": "http://dimigo.in/pages/dimibob_getdata.php"
  },

  "hangang": {
    "icon": "★",
    "style": "underline",
    "fgColor": "red_bold",

    "server": "http://hangang.dkserver.wo.tc"
  }
}

$ welcomes --config welcomes.json

Output

License

MIT License