natty-ui 0.6.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 666f2716f2f1d017789bbbfef2d640b7c89af6d006ea051e8575282c806b88f6
-  data.tar.gz: 44922a307f8f62e69d3df00ba656be1164ba20234ac12d621df0eb86fa5ce39e
+  metadata.gz: 2010faafec270df6749dff93943748316c626939965e501dbe6bdb224514e2dc
+  data.tar.gz: 0eecd3c29cc7b90cd70a6d40245b18fdbc8556232b6a3795ba2d92ffbaea5123
 SHA512:
-  metadata.gz: 74d474a1f3876ae3825cadc289250a8f3fb545b4147c26c20861a90b3e9665b249cde0075ae9813a1d668c69671540cb332aaf75cae667fc4a9fe5c0d272a88e
-  data.tar.gz: 4a872db3d8b96ddf6edf42b865eb9dffc8ee87994d6ae6617c842055062eeca4c45f4bac8df644b1e1a0a7b0fd5e4cfd6c53cee88c6a66681657b83879f12c19
+  metadata.gz: 6d2939a6c9bd6256a9de3e14b80ab9a67a6fa1108f20f2073e6ef0762789531016ef641bbfd451a0f3ac6c87079bd771a71853043744e481ed867616e392466e
+  data.tar.gz: 106fc8ddca80ccf6eb8933fdf835d7373afba963df8625267f37b1a9795ac6be22671123e18baa72ec6b5ded1c3f76f98d5f4dd905de935d465a2751ce690fad

data/.yardopts

@@ -0,0 +1,12 @@
+--readme README.md
+--title 'NattyUI Documentation'
+--charset utf-8
+--markup markdown
+--tag comment
+--hide-tag comment
+--embed-mixins
+--exclude lib/natty-ui/ansi_wrapper.rb
+lib/**/*.rb
+-
+README.md
+LICENSE

data/README.md

@@ -1,6 +1,6 @@
 # NattyUI ![version](https://img.shields.io/gem/v/natty-ui?label=)
 
-This is the beautiful, nice, nifty, fancy, neat, pretty, cool, lovely, natty user interface you like to have for your command line interfaces (CLI).
+This is the beautiful, nice, nifty, fancy, neat, pretty, cool, lovely, natty user interface you like to have for your command line applications. It contains elegant, simple and beautiful tools that enhance your command line interfaces functionally and aesthetically.
 
 - Gem: [rubygems.org](https://rubygems.org/gems/natty-ui)
 - Source: [github.com](https://github.com/mblumtritt/natty-ui)
@@ -13,40 +13,43 @@ Here you find elegant, simple and beautiful tools that enhance your command line
 You can simply decorate your text with named ANSI attributes and colors
 
 ```ruby
-UI = NattyUI::StdOut
-
-UI.puts "[[bold]]Hello [[ff7bfd]]World[[/]]!"
+ui.puts "[[bold]]Hello [[ff7bfd]]World[[/]]!"
 ```
 
 or use different types of messages
 
 ```ruby
-UI.info 'NattyUI installed'
-UI.warning 'Nice gem found!'
+ui.info 'NattyUI installed'
+ui.warning 'Nice gem found!'
 ```
 
-and headings
+and headings, framed sections, progress bars and tasks, queries, tables and much much more…
 
-```ruby
-UI.h1 'The Main Title (TMT)'
-UI.h2 'A Subtitle'
-```
+🚀 Have a look at the [features](https://rubydoc.info/gems/natty-ui/NattyUI/Features)!
 
-and framed sections
+![illustration](https://raw.githubusercontent.com/mblumtritt/natty-ui/main/examples/illustration.png)
 
-```ruby
-UI.framed 'Text Below In Frame' do |framed|
-  framed.puts 'This is the text'
-end
-```
+## NO_COLOR Convention
 
-or use progression displays like progress bars.
+NattyUI follows the [NO_COLOR convention](https://no-color.org).
 
-🚀 There are much more [features](https://rubydoc.info/gems/natty-ui/NattyUI/Features)!
+## Help
 
-📕 See the [online help](https://rubydoc.info/gems/natty-ui/NattyUI) for more details or have a look at the [examples](./examples/) directory to get an impression of the current feature set.
+📕 See the [online help](https://rubydoc.info/gems/natty-ui/NattyUI) and have a look at the [examples](./examples/) directory to learn from code.
 
-![illustration](https://raw.githubusercontent.com/mblumtritt/natty-ui/main/examples/illustration.png)
+### Run Examples
+
+You can execute the examples by
+
+```sh
+ruby ./examples/demo.rb
+```
+
+or see the non-ANSI version
+
+```sh
+NO_COLOR=1 ruby ./examples/demo.rb
+```
 
 ## Installation
 
@@ -59,7 +62,7 @@ gem install natty-ui
 or you can use [Bundler](http://gembundler.com/) to add NattyUI to your own project:
 
 ```shell
-bundle add 'natty-ui'
+bundle add natty-ui
 ```
 
 After that you only need one line of code to have everything together
@@ -67,29 +70,3 @@ After that you only need one line of code to have everything together
 ```ruby
 require 'natty-ui'
 ```
-
-## Run Examples
-
-You can execute the examples by
-
-```sh
-bundle exec ruby ./examples/basic.rb
-```
-
-or see the non-ANSI version
-
-```sh
-NO_COLOR=1 bundle exec ruby ./examples/basic.rb
-```
-
-## NO_COLOR Convention
-
-NattyUI follows the [NO_COLOR convention](https://no-color.org).
-
-## TODO
-
-Since I did not complete the tests and not all my ideas are already implemented I have this Todo list:
-
-- add more samples to help
-- add more tests
-- password prompt

data/examples/24bit-colors.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require 'natty-ui'
+
+RGB_COLORS = <<~RGB_COLORS.lines(chomp: true).map!(&:split)
+  #800000 #8b0000 #a52a2a #b22222 #dc143c #ff0000 #ff6347 #ff7f50
+  #cd5c5c #f08080 #e9967a #fa8072 #ffa07a #ff4500 #ff8c00 #ffa500
+  #ffd700 #b8860b #daa520 #eee8aa #bdb76b #f0e68c #808000 #ffff00
+  #9acd32 #556b2f #6b8e23 #7cfc00 #7fff00 #adff2f #006400 #008000
+  #228b22 #00ff00 #32cd32 #90ee90 #98fb98 #8fbc8f #00fa9a #00ff7f
+  #2e8b57 #66cdaa #3cb371 #20b2aa #2f4f4f #008080 #008b8b #00ffff
+  #00ffff #e0ffff #00ced1 #40e0d0 #48d1cc #afeeee #7fffd4 #b0e0e6
+  #5f9ea0 #4682b4 #6495ed #00bfff #1e90ff #add8e6 #87ceeb #87cefa
+RGB_COLORS
+
+ui.space
+ui.h1 '24-bit Color Support'
+ui.space
+
+RGB_COLORS.each { ui.puts _1.map { |v| " [[#{v}]]#{v}[[/]] " }.join }
+ui.space
+RGB_COLORS.each { ui.puts _1.map { |v| " [[on:#{v}]]#{v}[[/]] " }.join }
+ui.space

data/examples/3bit-colors.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require 'natty-ui'
+
+ui.space
+ui.h1 '3/4-bit Color Support'
+ui.space
+
+color = ->(n) { "[[#{n}]]#{n.ljust(14)}[[/]] [[on_#{n}]] sample text [[/]]" }
+%w[black red green yellow blue magenta cyan white].each do |name|
+  ui.puts "#{color[name]}    #{color["bright_#{name}"]}"
+end
+ui.space

data/examples/8bit-colors.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require 'natty-ui'
+
+ui.space
+ui.h1 '8-bit Color Support'
+ui.space
+
+color = ->(i) { "[[bg#{i = i.to_s(16).rjust(2, '0')}]] #{i} " }
+ui.msg 'System Colors', glyph: '[[27]]◉' do
+  ui.puts "[[#ff]]#{0.upto(7).map(&color).join}"
+  ui.puts "[[#00]]#{8.upto(15).map(&color).join}"
+  ui.space
+end
+
+ui.msg '6x6x6 Color Cube', glyph: '[[27]]◉' do
+  [16, 22, 28].each do |b|
+    b.step(b + 185, by: 36) do |i|
+      left = i.upto(i + 5).map(&color).join
+      right = (i + 18).upto(i + 23).map(&color).join
+      ui.puts "[[#ff]]#{left}[[bg_default]]  #{right}"
+    end
+    ui.space
+  end
+end
+
+ui.msg 'Grayscale', glyph: '[[27]]◉' do
+  ui.puts "[[#ff]]#{232.upto(243).map(&color).join}"
+  ui.puts "[[#ff]]#{244.upto(255).map(&color).join}"
+  ui.space
+end

data/examples/attributes.rb

@@ -2,13 +2,9 @@
 
 require 'natty-ui'
 
-UI = NattyUI::StdOut
-
-# helper:
-def hex(int) = int.to_s(16).rjust(2, '0')
-
-UI.space
-UI.h1 'NattyUI ANSI Attributes Demo', <<~TEXT
+ui.space
+ui.h1 'NattyUI ANSI Attributes Demo'
+ui.puts <<~TEXT
 
   This text contains all supported ANSI attrubtes and explains the available
   colors.
@@ -19,7 +15,8 @@ UI.h1 'NattyUI ANSI Attributes Demo', <<~TEXT
 
 TEXT
 
-UI.h2 'Attributes', <<~TEXT
+ui.h2 'Attributes'
+ui.puts <<~TEXT
 
   Some attributes are widely supported, such as [[bold]]bold[[/]], [[italic]]italic[[/]], [[underline]]underline[[/]], [[blink]]blink[[/]],
   [[invert]]invert[[/]] and [[strike]]strike[[/]], while others are rarely complete or correctly implemented,
@@ -28,138 +25,48 @@ UI.h2 'Attributes', <<~TEXT
 
   Different font types are very rarely displayed:
 
-    - [[primary_font]]primary_font[[/]]
-    - [[font1]]font1[[/]]
-    - [[font2]]font2[[/]]
-    - [[font3]]font3[[/]]
-    - [[font4]]font4[[/]]
-    - [[font5]]font5[[/]]
-    - [[font6]]font6[[/]]
-    - [[font7]]font7[[/]]
-    - [[font8]]font8[[/]]
-    - [[font9]]font9[[/]]
-    - [[fraktur]]fraktur[[/]]
+    [[primary_font]]primary_font[[/]]
+    [[fraktur]]fraktur[[/]]
+    [[font1]]font1[[/]]    [[font2]]font2[[/]]    [[font3]]font3[[/]]
+    [[font4]]font4[[/]]    [[font5]]font5[[/]]    [[font6]]font6[[/]]
+    [[font7]]font7[[/]]    [[font8]]font8[[/]]    [[font9]]font9[[/]]
 
 TEXT
 
-UI.h2 '3-bit and 4-bit Colors' do |sec|
-  sec.space
-  colors = %w[black red green yellow blue magenta cyan white].freeze
-  (colors + colors.map { |name| "bright_#{name}" }).each do |name|
-    sec.puts "  [[#{name}]]#{name.ljust(14)}[[/]] [[on_#{name}]]sample text"
-  end
+ui.h2 '3-bit and 4-bit Colors'
+ui.space
+color = ->(n) { "[[#{n}]]#{n.ljust(14)}[[/]] [[on_#{n}]]sample text[[/]]" }
+%w[black red green yellow blue magenta cyan white].each do |name|
+  ui.puts "#{color[name]}    #{color["bright_#{name}"]}"
 end
-UI.space
-
-UI.h2 '8-bit Colors' do |sec|
-  sec.space
-  sec.puts 'There are 256 pre-defined color which can be used by their index:'
-  sec.space
-
-  colors_std = 0.upto(15).map { |i| hex(i) }
-  colors216 = 16.upto(231).lazy.map { |i| hex(i) }
-  colors_gray1 = 232.upto(243).map { |i| hex(i) }
-  colors_gray2 = 244.upto(255).map { |i| hex(i) }
-
-  sec.puts colors_std.map { |i| "[[#{i}]] #{i} [[/]]" }.join
-  colors216.each_slice(18) do |slice|
-    sec.puts slice.map { |i| "[[#{i}]] #{i} [[/]]" }.join
-  end
-  sec.puts colors_gray1.map { |i| "[[#{i}]] #{i} [[/]]" }.join
-  sec.puts colors_gray2.map { |i| "[[#{i}]] #{i} [[/]]" }.join
-
-  sec.space
-  sec.puts colors_std.map { |i| "[[on:#{i}]] #{i} [[/]]" }.join
-  colors216.each_slice(18) do |slice|
-    sec.puts slice.map { |i| "[[on:#{i}]] #{i} [[/]]" }.join
-  end
-  sec.puts colors_gray1.map { |i| "[[on:#{i}]] #{i} [[/]]" }.join
-  sec.puts colors_gray2.map { |i| "[[on:#{i}]] #{i} [[/]]" }.join
+ui.space
+
+ui.h2 '8-bit Colors'
+ui.space
+ui.puts 'There are 256 pre-defined color which can be used by their index:'
+ui.space
+
+color = ->(i) { "[[bg#{i.to_s(16).rjust(2, '0')}]] #{i.to_s.rjust(2)} " }
+ui.msg 'System Colors', glyph: '[[27]]◉' do
+  ui.puts "[[#ff]]#{0.upto(7).map(&color).join}"
+  ui.puts "[[#00]]#{8.upto(15).map(&color).join}"
+  ui.space
 end
 
-UI.space
-UI.h2 '24-bit colors' do |sec|
-  sec.puts <<~TEXT
-
-    Modern terminal applications support 24-bit colors for foreground and background
-    RGB-color values. Here are just some samples:
-
-  TEXT
-
-  some_rgb = DATA.readlines(chomp: true).lazy.each_slice(8)
-
-  some_rgb.each do |slice|
-    sec.puts slice.map { |v| " [[#{v}]]#{v}[[/]] " }.join
+color = ->(i) { "[[bg#{i.to_s(16)}]] #{i.to_s.rjust(3)} " }
+ui.msg '6x6x6 Color Cube', glyph: '[[27]]◉' do
+  [16, 22, 28].each do |b|
+    b.step(b + 185, by: 36) do |i|
+      left = i.upto(i + 5).map(&color).join
+      right = (i + 18).upto(i + 23).map(&color).join
+      ui.puts "[[#ff]]#{left}[[bg_default]]  #{right}"
+    end
+    ui.space
   end
-  sec.space
-  some_rgb.each do |slice|
-    sec.puts slice.map { |v| " [[on:#{v}]]#{v}[[/]] " }.join
+
+  ui.msg 'Grayscale', glyph: '[[27]]◉' do
+    ui.puts "[[#ff]]#{232.upto(243).map(&color).join}"
+    ui.puts "[[#ff]]#{244.upto(255).map(&color).join}"
+    ui.space
   end
 end
-UI.space
-
-__END__
-#800000
-#8b0000
-#a52a2a
-#b22222
-#dc143c
-#ff0000
-#ff6347
-#ff7f50
-#cd5c5c
-#f08080
-#e9967a
-#fa8072
-#ffa07a
-#ff4500
-#ff8c00
-#ffa500
-#ffd700
-#b8860b
-#daa520
-#eee8aa
-#bdb76b
-#f0e68c
-#808000
-#ffff00
-#9acd32
-#556b2f
-#6b8e23
-#7cfc00
-#7fff00
-#adff2f
-#006400
-#008000
-#228b22
-#00ff00
-#32cd32
-#90ee90
-#98fb98
-#8fbc8f
-#00fa9a
-#00ff7f
-#2e8b57
-#66cdaa
-#3cb371
-#20b2aa
-#2f4f4f
-#008080
-#008b8b
-#00ffff
-#00ffff
-#e0ffff
-#00ced1
-#40e0d0
-#48d1cc
-#afeeee
-#7fffd4
-#b0e0e6
-#5f9ea0
-#4682b4
-#6495ed
-#00bfff
-#1e90ff
-#add8e6
-#87ceeb
-#87cefa

data/examples/demo.rb

@@ -0,0 +1,217 @@
+# frozen_string_literal: true
+
+require 'natty-ui'
+
+def attributes
+  ui.puts <<~TEXT
+
+    Some attributes are widely supported, such as [[bold]]bold[[/]], [[italic]]italic[[/]], [[underline]]underline[[/]], [[blink]]blink[[/]],
+    [[invert]]invert[[/]] and [[strike]]strike[[/]], while others are rarely complete or correctly implemented,
+    like [[faint]]faint[[/]], [[rapid_blink]]rapid_blink[[/]], [[double_underline]]double_underline[[/]], [[framed]]framed[[/]], [[encircled]]encircled[[/]], [[overlined]]overlined[[/]],
+    [[proportional]]proportional[[/]] and [[spacing]]spacing[[/]].
+
+    Different font types are very rarely displayed:
+
+      [[primary_font]]primary_font[[/]]
+      [[fraktur]]fraktur[[/]]
+      [[font1]]font1[[/]]    [[font2]]font2[[/]]    [[font3]]font3[[/]]
+      [[font4]]font4[[/]]    [[font5]]font5[[/]]    [[font6]]font6[[/]]
+      [[font7]]font7[[/]]    [[font8]]font8[[/]]    [[font9]]font9[[/]]
+
+  TEXT
+end
+
+def colors_3bit
+  color = ->(n) { "[[#{n}]]#{n.ljust(14)}[[/]] [[on_#{n}]]sample text[[/]]" }
+  %w[black red green yellow blue magenta cyan white].each do |name|
+    ui.puts "#{color[name]}    #{color["bright_#{name}"]}"
+  end
+end
+
+def colors_8bit
+  color = ->(i) { "[[bg#{i.to_s(16).rjust(2, '0')}]] #{i.to_s.rjust(2)} " }
+  ui.msg 'System Colors', glyph: '[[27]]◉' do
+    ui.puts "[[#ff]]#{0.upto(7).map(&color).join}"
+    ui.puts "[[#00]]#{8.upto(15).map(&color).join}"
+    ui.space
+  end
+
+  color = ->(i) { "[[bg#{i.to_s(16)}]] #{i.to_s.rjust(3)} " }
+  ui.msg '6x6x6 Color Cube', glyph: '[[27]]◉' do
+    [16, 22, 28].each do |b|
+      b.step(b + 185, by: 36) do |i|
+        left = i.upto(i + 5).map(&color).join
+        right = (i + 18).upto(i + 23).map(&color).join
+        ui.puts "[[#ff]]#{left}[[bg_default]]  #{right}"
+      end
+      ui.space
+    end
+  end
+
+  ui.msg 'Grayscale', glyph: '[[27]]◉' do
+    ui.puts "[[#ff]]#{232.upto(243).map(&color).join}"
+    ui.puts "[[#ff]]#{244.upto(255).map(&color).join}"
+    ui.space
+  end
+end
+
+def colors_24bit
+  ui.puts <<~TEXT
+    Modern terminal applications support 24-bit colors for foreground and background
+    RGB-color values. Here are just some samples:
+
+  TEXT
+  RGB_COLORS.each { ui.puts _1.map { |v| " [[#{v}]]#{v}[[/]] " }.join }
+  ui.space
+  RGB_COLORS.each { ui.puts _1.map { |v| " [[on:#{v}]]#{v}[[/]] " }.join }
+end
+
+def sections
+  ui.section do
+    ui.puts 'Sections can be stacked'
+    ui.section do
+      ui.puts TEXT_MID
+      ui.framed do
+        ui.puts TEXT_MID
+        next unless block_given?
+        ui.space
+        ui.hr
+        ui.space
+        yield
+      end
+    end
+  end
+end
+
+def heading
+  ui.h1 'This Is A H1 Heading'
+  ui.h2 'This Is A H2 Heading'
+  ui.h3 'This Is A H3 Heading'
+  ui.h4 'This Is A H4 Heading'
+  ui.h5 'This Is A H5 Heading'
+end
+
+def messages
+  ui.info 'Informative Message', TEXT_MID
+  ui.warning 'Warning Message', TEXT_MID
+  ui.error 'Error Message', TEXT_MID
+  ui.message '[[italic #fad]]Custom Message', TEXT_MID, glyph: '💡'
+  ui.failed 'Fail Message', TEXT_MID
+end
+
+def list_in_columns
+  ui.ls TEXT_LINES
+  ui.hr
+  ui.ls TEXT_LINES, compact: false
+end
+
+def tasks
+  ui.task('Initialize') { something }
+  ui.task('Establish server connection') do
+    ui.task('Open connection') { something }
+    ui.task('Send HELO') { something }
+    ui.task('Receive OLEH') { something }
+    ui.task('Send credentials') { something }
+    ui.task('Credentials accepted') { something }
+  end
+  ui.task 'Loading files' do
+    %w[readme.txt main.css main.html sub.html].each do |name|
+      ui.msg "Load file [[bright_yellow]]./source/#{name}[[/]]..."
+      something
+    end
+    ui.done 'Files loaded'
+  end
+  progress = ui.progress('Compress files', max_value: 11)
+  11.times do
+    progress.step
+    something
+  end
+  progress.done 'All compressed'
+end
+
+def table
+  ui.table { |tab| TEXT.each_line(chomp: true).each_slice(5) { tab.add(*_1) } }
+end
+
+# just simulate some work
+def something = sleep(0.5)
+def some = sleep(0.15)
+
+TEXT = <<~LOREM
+  Lorem [[yellow]]ipsum[[/]] dolor sit
+  amet, consectetur adipisicing
+  elit, sed do eiusmod tempor
+  incididunt ut labore et
+  dolore [[red]]magna[[/]] aliqua. Ut
+  enim ad minim veniam, quis
+  nostrud exercitation ullamco
+  laboris nisi ut aliquip ex
+  ea commodo [[bold]]consequat[[/]]. Duis
+  aute irure [[bold green]]dolor[[/]] in
+  reprehenderit in voluptate
+  velit [[underline]]esse cillum[[/]] dolore eu
+  fugiat nulla pariatur.
+  Excepteur sint occaecat
+  cupidatat non proident,
+  sunt in culpa qui officia
+  deserunt mollit anim id
+  est laborum.
+LOREM
+TEXT_LINES = TEXT.lines(chomp: true)
+TEXT_MID = TEXT_LINES.take(8).join(' ')
+TEXT_BIG = TEXT_LINES.join(' ')
+RGB_COLORS = <<~RGB_COLORS.lines(chomp: true).map!(&:split)
+  #800000 #8b0000 #a52a2a #b22222 #dc143c #ff0000 #ff6347 #ff7f50
+  #cd5c5c #f08080 #e9967a #fa8072 #ffa07a #ff4500 #ff8c00 #ffa500
+  #ffd700 #b8860b #daa520 #eee8aa #bdb76b #f0e68c #808000 #ffff00
+  #9acd32 #556b2f #6b8e23 #7cfc00 #7fff00 #adff2f #006400 #008000
+  #228b22 #00ff00 #32cd32 #90ee90 #98fb98 #8fbc8f #00fa9a #00ff7f
+  #2e8b57 #66cdaa #3cb371 #20b2aa #2f4f4f #008080 #008b8b #00ffff
+  #00ffff #e0ffff #00ced1 #40e0d0 #48d1cc #afeeee #7fffd4 #b0e0e6
+  #5f9ea0 #4682b4 #6495ed #00bfff #1e90ff #add8e6 #87ceeb #87cefa
+RGB_COLORS
+
+ui.page do
+  ui.h1 'NattyUI Demo'
+  loop do
+    ui.space
+    choice, title =
+      ui.query(
+        'Which Demo part do you like to see?',
+        :a => 'Attributes',
+        '3' => '3-bit and 4-bit Colors',
+        '8' => '8-bit Colors',
+        '2' => '24-bit colors',
+        'l' => 'List in Columns',
+        's' => 'Sections',
+        'S' => 'Sections with lists',
+        'z' => 'Sections with table',
+        't' => 'Tasks',
+        :q => 'Quit Demo',
+        :result => :all,
+        :display => :compact
+      )
+    break if choice.nil? || choice == 'q'
+    ui.cls.h2(title).space
+    case choice
+    when 'a'
+      attributes
+    when '3'
+      colors_3bit
+    when '8'
+      colors_8bit
+    when '2'
+      colors_24bit
+    when 't'
+      tasks
+    when 'l'
+      list_in_columns
+    when 's'
+      sections { messages }
+    when 'S'
+      sections { list_in_columns }
+    when 'z'
+      sections { table }
+    end
+  end
+end

data/examples/illustration.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require 'natty-ui'
+
+ui.space
+ui.msg('Natty UI', glyph: '⭐️') { ui.puts <<~TEXT }
+  This is the [[c4]]beautiful[[/]], [[c5]]nice[[/]], [[c6]]nifty[[/]], [[c7]]fancy[[/]], [[c8]]neat[[/]], [[c9]]pretty[[/]],  [[ca]]cool[[/]],
+  [[cb]]lovely[[/]], [[cc]]natty[[/]] [[bold]]user interface[[/]] you like to have for your command
+  line applications. It contains [[italic]]elegant[[/]], [[italic]]simple[[/]] and [[italic]]beautiful[[/]]
+  tools that enhance your command line interfaces functionally and
+  aesthetically.
+TEXT
+ui.msg('Features', glyph: '⭐️') { ui.ls(<<~FEATURES.lines(chomp: true)) }
+  [[bold red]]T[[/]] text attributes
+  🌈 text coloring
+  🎩 heading elements
+  📏 horizontal rulers
+  📝 message blocks
+  ✅ task blocks
+  [[bold blue]]""[[/]] quote blocks
+  🖼️ framed blocks
+  [[yellow]]┼┼[[/]] tables
+  💯 progress bars
+  [[bold red]]?[[/]] ask question
+  [[bold bright_white]]>[[bright_red]]_[[/]] user input
+FEATURES