term 0.9.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e51b6635d1ddd8ec42d76472d61136d793ce0fdc
+  data.tar.gz: 136a6f2a1c9806d3ae1151c2ac6018f62fa5cd3f
+SHA512:
+  metadata.gz: 5b19ee7b84affd20ab6d3bafa73f9fe1bd85cfbafa7fa32e02130130b2ac9cce41fbf98fe49db40a842b45dc1439dc4bca8ee688cd84858aba4d56742f8b35f8
+  data.tar.gz: bcba95e7207d0ac572c1adf28d81380fc3d246971a102e527908b52af6e851c2dbc639011159aae106856b58b9176ddfbc839303af67e214820a56fa9969d4ba

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 cuihq
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,43 @@
+# Term
+
+A toolkit of Terminal. Rich support for color, mouse, and lightweight component.
+
+> http://invisible-island.net/xterm/ctlseqs/ctlseqs.html
+
+## Installation
+
+### required
+
+> \>ruby 2.0
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'term'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install term
+
+## Usage
+
+see the examples.
+
+## Development
+
+After checking out the repo, run `bundle` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/cuihq/term. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/lib/term.rb

@@ -0,0 +1,21 @@
+# coding: utf-8
+
+railties_path = File.expand_path('..', __FILE__)
+$:.unshift(railties_path)
+
+require 'term/version'
+require 'term/bell'
+require 'term/checkbox'
+require 'term/code'
+require 'term/color'
+require 'term/confirm'
+require 'term/cursor'
+require 'term/font'
+require 'term/input'
+require 'term/password'
+require 'term/process_bar'
+require 'term/qrcode'
+require 'term/redio'
+require 'term/style'
+require 'term/table'
+require 'term/window'

data/lib/term/bell.rb

@@ -0,0 +1,14 @@
+# coding: utf-8
+
+# @author {mailto:cuihaiqin@gmail.com cuihq}
+class IO
+  # ring a bell to a terminal.
+  #
+  # @example
+  #   IO.bell
+  # @return self
+  def self.bell
+    print "\a"
+    self
+  end
+end

data/lib/term/checkbox.rb

@@ -0,0 +1,85 @@
+# coding: utf-8
+
+require 'term/cursor'
+require 'term/input'
+
+# @author {mailto:cuihaiqin@gmail.com cuihq}
+module Enumerable
+  # the checkbox widget.
+  #
+  # A checkbox allows a user to select same value from Enumerable.
+  # @example
+  #   ['a', 'b', 7].checkbox
+  # @return [Array] the selected of values
+  def checkbox
+    size.times { print $/ }
+    @begin_pos = IO.up(size).hide.pos
+    @checkbox_res = []
+    process_input_checkbox
+    IO.show
+    @checkbox_res
+  end
+
+  private
+
+  # select checkbox item.
+  def select_checkbox_item(index)
+    index = index.to_s.to_i % size
+    @checkbox_res.delete(index) || @checkbox_res.push(index)
+    print_checkbox index
+  end
+
+  # print checkbox.
+  def print_checkbox(index = 0)
+    IO.to @begin_pos
+    @res = index.to_s.to_i % size
+    @item_ys = []
+    each_with_index do |item, num|
+      print_checkbox_item item, num
+    end
+  end
+
+  # print checkbox item.
+  def print_checkbox_item(item, num)
+    @item_ys[num] = IO.pos[:y]
+    num == @res ? print('➡️ ') : print('  ')
+    if @checkbox_res.include? num
+      print " ☑️ #{num}. #{item}#{$/}"
+    else
+      print " ⬜️ #{num}. #{item}#{$/}"
+    end
+  end
+
+  # process checkbox input.
+  def process_input_checkbox
+    print_checkbox
+    @checkbox_loop = true
+    while @checkbox_loop
+      input = IO.input
+      process_checkbox_mouse_click input
+      process_checkbox_keyboard_input input[:key]
+    end
+  end
+
+  # process checkbox mouse click event.
+  def process_checkbox_mouse_click(input)
+    type = input[:type]
+    pos = input[:pos]
+    if type == :left_pressed
+      list_item = @item_ys.find_index pos[:y]
+      select_checkbox_item list_item if list_item
+    end
+  end
+
+  # process checkbox keyboard input event.
+  def process_checkbox_keyboard_input(key)
+    case key
+    when :enter then @checkbox_loop = false
+    when /\d/ then select_checkbox_item(key)
+    when :down then print_checkbox(@res.succ)
+    when :up then print_checkbox(@res.pred)
+    when :space, :right, :left, :tab
+      select_checkbox_item @res
+    end
+  end
+end

data/lib/term/code.rb

@@ -0,0 +1,24 @@
+# cording: utf-8
+
+require 'rouge'
+
+# @author {mailto:cuihaiqin@gmail.com cuihq}
+class String
+  # a code syntax highlighter.
+  #
+  # @example Code
+  #   code_str = <<-EOF
+  #   class A
+  #     def b
+  #       puts 'c'
+  #     end
+  #   end
+  #   EOF
+  #   code_str.code 'ruby'
+  # @see https://github.com/jneen/rouge rouge
+  # @param name [String] the code name
+  # @return [String] the format code string with color
+  def code(name)
+    Rouge.highlight(self, name.to_s, 'terminal256')
+  end
+end

data/lib/term/color.rb

@@ -0,0 +1,252 @@
+# coding: utf-8
+
+# @author {mailto:cuihaiqin@gmail.com cuihq}
+class String
+  # string colors.
+  # @see http://www.termsys.demon.co.uk/vtansi.htm ANSI/VT100 Control sequences.
+  COLOR = {
+    black: 30,
+    red: 31,
+    green: 32,
+    yellow: 33,
+    blue: 34,
+    magenta: 35,
+    cyan: 36,
+    light_gray: 37,
+    default_color: 39,
+    dark_gray: 90,
+    light_red: 91,
+    light_green: 92,
+    light_yellow: 93,
+    light_blue: 94,
+    light_magenta: 95,
+    light_cyan: 96,
+    white: 97
+  }.freeze
+
+  # @!method black
+  #   black string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method black_background
+  #   black background string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method red
+  #   red string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method red_background
+  #   red background string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method green
+  #   green string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method green_background
+  #   green background string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method yellow
+  #   yellow string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method yellow_background
+  #   yellow background string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method blue
+  #   blue string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method blue_background
+  #   blue background string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method magenta
+  #   magenta string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method magenta_background
+  #   magenta background string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method cyan
+  #   cyan string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method cyan_background
+  #   cyan background string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method light_gray
+  #   light gray string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method light_gray_background
+  #   light gray background string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method default_color
+  #   default color string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method default_color_background
+  #   default color background string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method dark_gray
+  #   dark gray string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method dark_gray_background
+  #   dark gray background string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method light_red
+  #   light red string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method light_red_background
+  #   light red background string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method light_green
+  #   light green string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method light_green_background
+  #   light green background string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method light_yellow
+  #   light yellow string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method light_yellow_background
+  #   light yellow background string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method light_blue
+  #   light blue string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method light_blue_background
+  #   light blue background string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method light_magenta
+  #   light magenta string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method light_magenta_background
+  #   light magenta background string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method light_cyan
+  #   light cyan string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method light_cyan_background
+  #   light cyan background string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method white
+  #   white string.
+  #
+  #   @return [String] the formatting string
+
+  # @!method white_background
+  #   white background string.
+  #
+  #   @return [String] the formatting string
+  COLOR.each do |name, value|
+    define_method(name) do
+      "\e[#{value}m#{self}\e[0m"
+    end
+    define_method("#{name}_background") do
+      "\e[#{10 + value}m#{self}\e[0m"
+    end
+  end
+
+  # string color.
+  #
+  # @example color
+  #   "mystring".color :black # keywords
+  #   "mystring".color 123 # 256 colors
+  #   "mystring".color '#000' # true color
+  # @param name [Object] the color name
+  # @return [String] the formatting string
+  def color(name)
+    set_256_color(name) || set_rbg_color(name) ||
+      set_keyword_color(name) || self
+  end
+
+  # string background color.
+  #
+  # @example background color
+  #   "mystring".background_color :black # keywords
+  #   "mystring".background_color 123 # 256 colors
+  #   "mystring".background_color '#000' # true color
+  # @param name [Object] the background color name
+  # @return [String] the formatting string
+  def background_color(name)
+    set_256_color(name, 48) || set_rbg_color(name, 48) ||
+      set_keyword_color(name, '_background') || self
+  end
+
+  private
+
+  # set 256 color.
+  def set_256_color(name, num = 38)
+    color_index = name.to_i
+    "\e[#{num};5;#{color_index}m#{self}\e[0m" if color_index.between? 1, 256
+  end
+
+  # set rgb color.
+  def set_rbg_color(name, num = 38)
+    color_name = name.to_s
+    if /^#(?<r>\h{1,2})(?<g>\h{1,2})(?<b>\h{1,2})$/ =~ color_name
+      "\e[#{num};2;#{r.to_i(16)};#{g.to_i(16)};#{b.to_i(16)}m#{self}\e[0m"
+    end
+  end
+
+  # set keyword color.
+  def set_keyword_color(name, suffix = '')
+    color_name = name.to_s.to_sym
+    send "#{color_name}#{suffix}" if COLOR.key? color_name
+  end
+end