terminal
💎 terminal-ui
Terminal output styling with intuitive, clean and easy API written by Crystal.
Installation
Add this to your application's shard.yml
:
dependencies:
terminal-ui:
github: icyleaf/terminal-ui.cr
Usage
require "terminal/ui"
Terminal::UI.message "hello world" # => "hello world"
Terminal::UI.success "well done" # => "\e[32mwell done\e[0m"
Terminal::UI.important "Your password is too easy" # => "\e[33mYour password is too easy\e[0m"
Terminal::UI.error "Invaild username or password" # => "\e[31mInvaild username or password\e[0m"
Terminal::UI.command "crystal version" # => "\e[36m$ crystal version\e[0m"
Methods
Full methods below:
method | level | description
---|---|---
header | INFO
| normal default color with table border (Not compatible with emoji)
+-----+
|Install|
+-----+
message | INFO
| normal default color
success | INFO
| green color
important | WARN
| yellow color
error | ERROR
| red color
verbose | DEBUG
| normal default color
deprecated | WARN
| blue with bold color
command | INFO
| cyan color
crash | Exception | normal default color
Enable/Disable color
Terminal::UI.enable_color
/Terminal::UI.disable_color
Verbose mode
Set Enviroment TERMINAL_UI_SHOW_TIMESTAMP
to 1/true
Terminal::UI.success "Installed successful"
# => "INFO 2017-10-22 12:45:33 \e[32mInstalled successful\e[0m"
Adviances
All the output based on Logger
, Here support one way to custom the given io and logger formatter.
io = IO::Memory.new
Terminal::UI.logger_io(io, Logger::Formatter.new { |severity, datetime, progname, message, io|
io << "VERBOSE" << datetime.to_s("%F") << message
})
Terminal::UI.message "Welcome to use terminal-ui"
# => "VERBOSE 2017-10-22 Welcome to use terminal-ui"
How to Contribute
Your contributions are always welcome! Please submit a pull request or create an issue to add a new question, bug or feature to the list.
All Contributors are on the wall.
You may also like
- halite - HTTP Requests Client with a chainable REST API, built-in sessions and loggers.
- totem - Load and parse a configuration file or string in JSON, YAML, dotenv formats.
- markd - Yet another markdown parser built for speed, Compliant to CommonMark specification.
- poncho - A .env parser/loader improved for performance.
- popcorn - Easy and Safe casting from one type to another.
- fast-crystal - 💨 Writing Fast Crystal 😍 -- Collect Common Crystal idioms.
License
MIT License © icyleaf