pry-theme 0.1.3 → 0.2.0

data/lib/pry-theme/declaration.rb

@@ -0,0 +1,120 @@
+module PryTheme
+  class Color
+
+    # @since 0.2.0
+    # @api private
+    class Declaration
+
+      class << self
+        def translate(decl, color_model)
+          decl = Declaration.new(decl, color_model)
+          decl.parse
+          decl.to_color
+        end
+        alias_method :t, :translate
+      end
+
+      def initialize(color_decl, color_model)
+        validate_effects(color_decl, color_model)
+
+        @color_decl  = color_decl
+        @color_model = color_model
+        @color_class = PryTheme.const_get(:"Color#{ color_model }")
+        @effects     = {}
+        @parsed      = false
+      end
+
+      def parse
+        if @parsed
+          return
+        else
+          case @color_decl.size
+          when 3 then build_from_two_layers
+          when 2 then build_from_two_args
+          when 1 then build_from_arg
+          end
+          @parsed = true
+        end
+      end
+
+      def to_color
+        [:readable, :hex, :rgb, :term].each do |type|
+          begin
+            return @color_class.new({
+              :from => type,
+              :foreground => @fg,
+              :background => @bg
+            }.merge!(@effects))
+          rescue ArgumentError, TypeError
+            next
+          end
+        end
+        raise PryTheme::ThemeError,
+          %|malformed color declaration (#{ [@fg, @bg].compact.join(', ') })|
+      end
+
+      private
+
+      def validate_effects(color_decl, color_model)
+        incorrect_color_model = (color_model != 256)
+        incorrect_declaration = (color_decl.any? do |decl|
+          decl.is_a?(Array) && decl.all? { |elem| elem.is_a?(Symbol) }
+        end)
+
+        if incorrect_color_model && incorrect_declaration
+          raise PryTheme::ThemeError,
+            'effects are available only for 256-color themes'
+        end
+      end
+
+      def build_effects
+        if @color_decl.any?
+          @effects = @color_decl.shift.inject({}) { |h, k| h[k] = true; h }
+        end
+      end
+
+      def build_from_two_layers
+        @fg, @bg = 2.times.map { @color_decl.shift }
+        build_effects
+      end
+
+      def build_from_two_args
+        if decl_has_bg_key?
+          @bg = @color_decl.first[:bg]
+          @color_decl.shift
+        else
+          @fg = @color_decl.shift
+          if @color_decl.last.is_a?(Array)
+            @bg = @color_decl.shift if decl_contains_rgb?
+          else
+            @bg = @color_decl.shift
+          end
+        end
+        build_effects
+      end
+
+      def build_from_arg
+        f = @color_decl.first
+        if decl_has_bg_key?
+          @bg = f[:bg]
+          @color_decl.shift
+        elsif f.is_a?(String) || f.is_a?(Fixnum)
+          @fg = @color_decl.shift
+        else
+          build_effects
+        end
+      end
+
+      def decl_has_bg_key?
+        f = @color_decl.first
+        f.is_a?(Hash) && f.has_key?(:bg)
+      end
+
+      def decl_contains_rgb?
+        l = @color_decl.last
+        l.size == 3 && l.all? { |decl| decl.is_a?(Fixnum) }
+      end
+
+    end
+  end
+end

data/lib/pry-theme/definition.rb

@@ -0,0 +1,111 @@
+module PryTheme
+  class Theme
+
+    # @since 0.2.0
+    # @api private
+    module DynamicMethod
+      def def_dynamic_methods(*dynamic_methods)
+        dynamic_methods.each { |attr|
+          define_method(attr) do |*args|
+            name = :"@#{ attr }"
+            if args.first
+              decl =
+                Color::Declaration.t(args, instance_variable_get(:@color_model))
+              instance_variable_set(name, decl)
+            end
+            instance_variable_get(name)
+          end
+        }
+      end
+    end
+
+    # @since 0.2.0
+    # @api private
+    module DefaultAttrs
+      def set_default_attrs(attrs)
+        default_color = PryTheme.const_get(:"Color#{ @color_model }").new
+        attrs.each do |attr|
+          instance_variable_set(:"@#{ attr }", default_color.dup)
+        end
+      end
+
+      def set_nested_attrs
+        regexp { set_default_attrs(Definition::Regexp::ATTRS) }
+        shell  { set_default_attrs(Definition::Shell::ATTRS)  }
+        string { set_default_attrs(Definition::String::ATTRS) }
+      end
+
+      def method_missing(meth, *args, &block)
+        raise PryTheme::ThemeError, %|unknown option "#{ meth }"|
+      end
+    end
+
+    # @since 0.2.0
+    # @api private
+    # @todo: possibly, try to avoid duplication.
+    class Definition
+      extend DynamicMethod
+      include DefaultAttrs
+
+      ATTRS = [
+        :class_, :class_variable, :comment, :constant, :error, :float,
+        :global_variable, :inline_delimiter, :instance_variable, :integer,
+        :keyword, :method, :predefined_constant, :symbol
+      ]
+
+      def_dynamic_methods *ATTRS
+
+      def initialize(color_model, &block)
+        @color_model = color_model
+        set_default_attrs(ATTRS) and set_nested_attrs
+        instance_eval(&block)
+      end
+
+      def regexp(&block)
+        @regexp = Definition::Regexp.new(@color_model, &block) if block_given?
+        @regexp
+      end
+
+      def shell(&block)
+        @shell = Definition::Shell.new(@color_model, &block) if block_given?
+        @shell
+      end
+
+      def string(&block)
+        @string = Definition::String.new(@color_model, &block) if block_given?
+        @string
+      end
+
+      class Compound
+        extend DynamicMethod
+        include DefaultAttrs
+
+        ATTRS = [:self_, :char, :content, :delimiter, :escape]
+
+        def_dynamic_methods *ATTRS
+
+        def initialize(color_model, &block)
+          @color_model = color_model
+          set_default_attrs(ATTRS)
+          instance_eval(&block)
+        end
+      end
+
+      class Regexp < Compound
+        ATTRS = [:modifier]
+
+        def_dynamic_methods *ATTRS
+
+        def initialize(color_model, &block)
+          @color_model = color_model
+          set_default_attrs(ATTRS)
+          super
+        end
+      end
+
+      Shell = Class.new(Compound)
+      String = Class.new(Compound)
+    end
+
+  end
+end

data/lib/pry-theme/formattable.rb

@@ -0,0 +1,26 @@
+module PryTheme
+  module Formattable
+
+    FORMATTING = {
+      :bold      => 1,
+      :italic    => 3,
+      :underline => 4
+    }
+
+    def bold
+      options[:bold] && FORMATTING[:bold]
+    end
+    def bold?; !!bold; end
+
+    def italic
+      options[:italic] && FORMATTING[:italic]
+    end
+    def italic?; !!italic; end
+
+    def underline
+      options[:underline] && FORMATTING[:underline]
+    end
+    def underline?; !!underline; end
+
+  end
+end

data/lib/pry-theme/hex.rb

@@ -0,0 +1,76 @@
+module PryTheme
+  # @since 0.2.0
+  # @api private
+  #
+  # Represents a HEX colour. It's possible to convert a HEX instance into {TERM}
+  # or {RGB} colours. However, this conversion is half-duplex (see {RGB}). This
+  # class validates its input (you won't see malformed or nonexistent HEX
+  # colours).
+  #
+  # @note Conversion to {TERM} relies on {RGB#to_term}, as a {HEX} instance
+  #   converts itself to {RGB} first, and only then to {TERM}.
+  # @example Conversion to RGB
+  #   HEX.new('#ffffff').to_rgb #=> (RGB: 255, 255, 255)
+  # @example Conversion to TERM
+  #   HEX.new('#ffffff').to_term(16) #=> (TERM-16: 15)
+  #
+  #   # Approximation.
+  #   HEX.new('#fc33ea').to_term #=> (TERM-256: 207)
+  class HEX
+
+    # Represents a single HEX "digit".
+    BYTE = /[A-F\d]{2}/i
+
+    # A hex String must be prefixed with an octothorp. Use any letter case.
+    PATTERN = /\A#(#{ BYTE }){3}\z/i
+
+    # @param [String] value must be a valid hex number
+    def initialize(value)
+      validate_value(value)
+      @value = value
+    end
+
+    # @return [String]
+    def inspect
+      "(HEX: #{ @value })"
+    end
+
+    # @example
+    #   HEX.new('#33aabb').to_s #=> "#33aabb"
+    # @return [String]
+    def to_s
+      @value
+    end
+
+    # Converts `self` into {RGB}.
+    # @return [RGB]
+    def to_rgb
+      RGB.new(@value[1..-1].scan(BYTE).map! { |b| b.to_i(16) })
+    end
+
+    # Converts `self` into {TERM}.
+    # @return [RGB]
+    def to_term(color_model = 256)
+      to_rgb.to_term(color_model)
+    end
+
+    private
+
+    # Validates whether +value+ is a valid hex colour value.
+    #
+    # @param [String] value
+    # @raise [TypeError] if +value+ isn't String
+    # @raise [ArgumentError] if +value+ is malformed
+    # @return [void]
+    def validate_value(value)
+      unless value.is_a?(String)
+        raise TypeError, "can't convert #{ value.class } into PryTheme::HEX"
+      end
+      if value !~ PryTheme::HEX::PATTERN
+        raise ArgumentError, %|invalid value for PryTheme::HEX#new(): "#{ value }"|
+      end
+      true
+    end
+
+  end
+end

data/lib/pry-theme/preview.rb

@@ -0,0 +1,74 @@
+module PryTheme
+  class Preview
+
+    def initialize(theme)
+      @theme = theme
+    end
+
+    def short
+      cur_theme = ThemeList.current_theme
+      @theme.activate
+      [header, description, '--', short_snippet].join("\n")
+    ensure
+      @theme.disable
+      cur_theme.activate
+    end
+
+    def long
+      long_snippet
+    end
+
+    def description
+      @theme.description
+    end
+
+    def header
+      Pry::Helpers::Text.bold("#{ @theme.name } / #{ @theme.color_model }")
+    end
+
+    def banner(msg)
+      safe_width = 80
+      delimiter = ('-' * safe_width)
+      [delimiter,
+       Pry::Helpers::Text.bold(msg.center(safe_width)),
+       delimiter
+      ].join("\n") + "\n"
+    end
+
+    private
+
+    def short_snippet
+      code = Pry::Helpers::CommandHelpers.unindent(<<-'CODE')
+        1: class Theme
+        2:   def method
+        3:     @ivar, @@cvar, lvar = 10_000, 400.00, "string"
+        4:   end
+        5: end
+      CODE
+      Pry::Helpers::BaseHelpers.colorize_code(code)
+    end
+
+    def long_snippet
+      code = Pry::Helpers::CommandHelpers.unindent(<<-CODE)
+        # "#{ @theme.name }" theme.
+        class PryTheme::ThisIsAClass
+          def this_is_a_method
+            THIS_IS_A_CONSTANT  = :this_is_a_symbol
+            this_is_a_local_var = "\#{this} \#@is a string.\\n"
+            this_is_a_float     = 10_000.00
+            this_is_an_integer  = 10_000
+
+            # TRUE and FALSE are predefined constants.
+            $this_is_a_global_variable = TRUE or FALSE
+
+            @this_is_an_instance_variable = `echo '\#@hi \#{system} call\\n'`
+            @@this_is_a_class_variable    = @@@\\\\$ # An error.
+
+            /[0-9]{1,3}this \#{is} a regexp\\w+/xi
+          end
+        end
+      CODE
+      Pry::Helpers::BaseHelpers.colorize_code(code)
+    end
+  end
+end

data/lib/pry-theme/rgb.rb

@@ -1,23 +1,248 @@
 module PryTheme
-  module RGB
-
-    SYSTEM = [
-      [0x00, 0x00, 0x00], [0x80, 0x00, 0x00], [0x00, 0x80, 0x00],
-      [0x80, 0x80, 0x00], [0x00, 0x00, 0x80], [0x80, 0x00, 0x80],
-      [0x00, 0x80, 0x80], [0xc0, 0xc0, 0xc0], [0x80, 0x80, 0x80],
-      [0xff, 0x00, 0x00], [0x00, 0xff, 0x00], [0xff, 0xff, 0x00],
-      [0x00, 0x00, 0xff], [0xff, 0x00, 0xff], [0x00, 0xff, 0xff],
-      [0xff, 0xff, 0xff]
+  # @since 0.2.0
+  # @api private
+  #
+  # Represents an RGB colour. It's possible to convert an RGB instance into
+  # {HEX} or {TERM} colours. However, this conversion is half-duplex. If an RGB
+  # instance gets converted to {TERM} format, there is a high chance that it
+  # will be approximated to fit in range of colour model (colour model can be
+  # set via an argument of the conversion method). This class validates its
+  # input (you won't see malformed of nonexistent RGB colours).
+  #
+  # @example Conversion to HEX
+  #   RGB.new([0, 0, 0]).to_hex #=> (HEX: #000000)
+  # @example Conversion to TERM
+  #   RGB.new([0, 0, 0]).to_term(8) #=> (TERM-8: 0)
+  #
+  #   # Approximation.
+  #   RGB.new([254, 244, 231]).to_term(8) #=> (TERM-8: 7)
+  class RGB
+
+    # 8 colours. For the standard GNU/Linux terminal emulator.
+    LINUX = [
+      [  0,   0,   0], [128,   0,   0], [  0, 128,   0],
+      [128, 128,   0], [  0,   0, 128], [128,   0, 128],
+      [  0, 128, 128], [192, 192, 192]
+    ]
+
+    # 16 colours. For cmd.exe on Windows and other miserable terminals.
+    SYSTEM = LINUX + [
+      [128, 128, 128], [255,   0,   0], [  0, 255,   0], [255, 255,   0],
+      [  0,   0, 255], [255,   0, 255], [  0, 255, 255], [255, 255, 255]
     ]
 
+    # The next 216 colours. For men.
     COLORS = [
-      [0, 0, 0], [0, 0, 95], [0, 0, 135], [0, 0, 175], [0, 0, 215], [0, 0, 255], [0, 95, 0], [0, 95, 95], [0, 95, 135], [0, 95, 175], [0, 95, 215], [0, 95, 255], [0, 135, 0], [0, 135, 95], [0, 135, 135], [0, 135, 175], [0, 135, 215], [0, 135, 255], [0, 175, 0], [0, 175, 95], [0, 175, 135], [0, 175, 175], [0, 175, 215], [0, 175, 255], [0, 215, 0], [0, 215, 95], [0, 215, 135], [0, 215, 175], [0, 215, 215], [0, 215, 255], [0, 255, 0], [0, 255, 95], [0, 255, 135], [0, 255, 175], [0, 255, 215], [0, 255, 255], [95, 0, 0], [95, 0, 95], [95, 0, 135], [95, 0, 175], [95, 0, 215], [95, 0, 255], [95, 95, 0], [95, 95, 95], [95, 95, 135], [95, 95, 175], [95, 95, 215], [95, 95, 255], [95, 135, 0], [95, 135, 95], [95, 135, 135], [95, 135, 175], [95, 135, 215], [95, 135, 255], [95, 175, 0], [95, 175, 95], [95, 175, 135], [95, 175, 175], [95, 175, 215], [95, 175, 255], [95, 215, 0], [95, 215, 95], [95, 215, 135], [95, 215, 175], [95, 215, 215], [95, 215, 255], [95, 255, 0], [95, 255, 95], [95, 255, 135], [95, 255, 175], [95, 255, 215], [95, 255, 255], [135, 0, 0], [135, 0, 95], [135, 0, 135], [135, 0, 175], [135, 0, 215], [135, 0, 255], [135, 95, 0], [135, 95, 95], [135, 95, 135], [135, 95, 175], [135, 95, 215], [135, 95, 255], [135, 135, 0], [135, 135, 95], [135, 135, 135], [135, 135, 175], [135, 135, 215], [135, 135, 255], [135, 175, 0], [135, 175, 95], [135, 175, 135], [135, 175, 175], [135, 175, 215], [135, 175, 255], [135, 215, 0], [135, 215, 95], [135, 215, 135], [135, 215, 175], [135, 215, 215], [135, 215, 255], [135, 255, 0], [135, 255, 95], [135, 255, 135], [135, 255, 175], [135, 255, 215], [135, 255, 255], [175, 0, 0], [175, 0, 95], [175, 0, 135], [175, 0, 175], [175, 0, 215], [175, 0, 255], [175, 95, 0], [175, 95, 95], [175, 95, 135], [175, 95, 175], [175, 95, 215], [175, 95, 255], [175, 135, 0], [175, 135, 95], [175, 135, 135], [175, 135, 175], [175, 135, 215], [175, 135, 255], [175, 175, 0], [175, 175, 95], [175, 175, 135], [175, 175, 175], [175, 175, 215], [175, 175, 255], [175, 215, 0], [175, 215, 95], [175, 215, 135], [175, 215, 175], [175, 215, 215], [175, 215, 255], [175, 255, 0], [175, 255, 95], [175, 255, 135], [175, 255, 175], [175, 255, 215], [175, 255, 255], [215, 0, 0], [215, 0, 95], [215, 0, 135], [215, 0, 175], [215, 0, 215], [215, 0, 255], [215, 95, 0], [215, 95, 95], [215, 95, 135], [215, 95, 175], [215, 95, 215], [215, 95, 255], [215, 135, 0], [215, 135, 95], [215, 135, 135], [215, 135, 175], [215, 135, 215], [215, 135, 255], [215, 175, 0], [215, 175, 95], [215, 175, 135], [215, 175, 175], [215, 175, 175], [215, 175, 215], [215, 175, 255], [215, 215, 0], [215, 215, 95], [215, 215, 135], [215, 215, 175], [215, 215, 215], [215, 215, 255], [215, 255, 0], [215, 255, 95], [215, 255, 135], [215, 255, 175], [215, 255, 215], [215, 255, 255], [255, 0, 0], [255, 0, 95], [255, 0, 135], [255, 0, 175], [255, 0, 215], [255, 0, 255], [255, 95, 0], [255, 95, 95], [255, 95, 135], [255, 95, 175], [255, 95, 215], [255, 95, 255], [255, 135, 0], [255, 135, 95], [255, 135, 135], [255, 135, 175], [255, 135, 215], [255, 135, 255], [255, 175, 0], [255, 175, 95], [255, 175, 135], [255, 175, 175], [255, 175, 215], [255, 175, 255], [255, 215, 0], [255, 215, 95], [255, 215, 135], [255, 215, 175], [255, 215, 215], [255, 215, 255], [255, 255, 0], [255, 255, 95], [255, 255, 135], [255, 255, 175], [255, 255, 215]
+      [  0,   0,   0], [  0,   0,  95], [  0,   0, 135], [  0,   0, 175],
+      [  0,   0, 215], [  0,   0, 255], [  0,  95,   0], [  0,  95,  95],
+      [  0,  95, 135], [  0,  95, 175], [  0,  95, 215], [  0,  95, 255],
+      [  0, 135,   0], [  0, 135,  95], [  0, 135, 135], [  0, 135, 175],
+      [  0, 135, 215], [  0, 135, 255], [  0, 175,   0], [  0, 175,  95],
+      [  0, 175, 135], [  0, 175, 175], [  0, 175, 215], [  0, 175, 255],
+      [  0, 215,   0], [  0, 215,  95], [  0, 215, 135], [  0, 215, 175],
+      [  0, 215, 215], [  0, 215, 255], [  0, 255,   0], [  0, 255,  95],
+      [  0, 255, 135], [  0, 255, 175], [  0, 255, 215], [  0, 255, 255],
+      [ 95,   0,   0], [ 95,   0,  95], [ 95,   0, 135], [ 95,   0, 175],
+      [ 95,   0, 215], [ 95,   0, 255], [ 95,  95,   0], [ 95,  95,  95],
+      [ 95,  95, 135], [ 95,  95, 175], [ 95,  95, 215], [ 95,  95, 255],
+      [ 95, 135,   0], [ 95, 135,  95], [ 95, 135, 135], [ 95, 135, 175],
+      [ 95, 135, 215], [ 95, 135, 255], [ 95, 175,   0], [ 95, 175,  95],
+      [ 95, 175, 135], [ 95, 175, 175], [ 95, 175, 215], [ 95, 175, 255],
+      [ 95, 215,   0], [ 95, 215,  95], [ 95, 215, 135], [ 95, 215, 175],
+      [ 95, 215, 215], [ 95, 215, 255], [ 95, 255,   0], [ 95, 255,  95],
+      [ 95, 255, 135], [ 95, 255, 175], [ 95, 255, 215], [ 95, 255, 255],
+      [135,   0,   0], [135,   0,  95], [135,   0, 135], [135,   0, 175],
+      [135,   0, 215], [135,   0, 255], [135,  95,   0], [135,  95,  95],
+      [135,  95, 135], [135,  95, 175], [135,  95, 215], [135,  95, 255],
+      [135, 135,   0], [135, 135,  95], [135, 135, 135], [135, 135, 175],
+      [135, 135, 215], [135, 135, 255], [135, 175,   0], [135, 175,  95],
+      [135, 175, 135], [135, 175, 175], [135, 175, 215], [135, 175, 255],
+      [135, 215,   0], [135, 215,  95], [135, 215, 135], [135, 215, 175],
+      [135, 215, 215], [135, 215, 255], [135, 255,   0], [135, 255,  95],
+      [135, 255, 135], [135, 255, 175], [135, 255, 215], [135, 255, 255],
+      [175,   0,   0], [175,   0,  95], [175,   0, 135], [175,   0, 175],
+      [175,   0, 215], [175,   0, 255], [175,  95,   0], [175,  95,  95],
+      [175,  95, 135], [175,  95, 175], [175,  95, 215], [175,  95, 255],
+      [175, 135,   0], [175, 135,  95], [175, 135, 135], [175, 135, 175],
+      [175, 135, 215], [175, 135, 255], [175, 175,   0], [175, 175,  95],
+      [175, 175, 135], [175, 175, 175], [175, 175, 215], [175, 175, 255],
+      [175, 215,   0], [175, 215,  95], [175, 215, 135], [175, 215, 175],
+      [175, 215, 215], [175, 215, 255], [175, 255,   0], [175, 255,  95],
+      [175, 255, 135], [175, 255, 175], [175, 255, 215], [175, 255, 255],
+      [215,   0,   0], [215,   0,  95], [215,   0, 135], [215,   0, 175],
+      [215,   0, 215], [215,   0, 255], [215,  95,   0], [215,  95,  95],
+      [215,  95, 135], [215,  95, 175], [215,  95, 215], [215,  95, 255],
+      [215, 135,   0], [215, 135,  95], [215, 135, 135], [215, 135, 175],
+      [215, 135, 215], [215, 135, 255], [215, 175,   0], [215, 175,  95],
+      [215, 175, 135], [215, 175, 175], [215, 175, 175], [215, 175, 215],
+      [215, 175, 255], [215, 215,   0], [215, 215,  95], [215, 215, 135],
+      [215, 215, 175], [215, 215, 215], [215, 215, 255], [215, 255,   0],
+      [215, 255,  95], [215, 255, 135], [215, 255, 175], [215, 255, 215],
+      [215, 255, 255], [255,   0,   0], [255,   0,  95], [255,   0, 135],
+      [255,   0, 175], [255,   0, 215], [255,   0, 255], [255,  95,   0],
+      [255,  95,  95], [255,  95, 135], [255,  95, 175], [255,  95, 215],
+      [255,  95, 255], [255, 135,   0], [255, 135,  95], [255, 135, 135],
+      [255, 135, 175], [255, 135, 215], [255, 135, 255], [255, 175,   0],
+      [255, 175,  95], [255, 175, 135], [255, 175, 175], [255, 175, 215],
+      [255, 175, 255], [255, 215,   0], [255, 215,  95], [255, 215, 135],
+      [255, 215, 175], [255, 215, 215], [255, 215, 255], [255, 255,   0],
+      [255, 255,  95], [255, 255, 135], [255, 255, 175], [255, 255, 215]
     ]
 
-    GREYSCALE = (0x08..0xee).step(0x0a).map { |v| [v] * 3 }
+    # The next 16 colours. For zen.
+    GREYSCALE = (0x08..0xEE).step(0x0A).map { |v| [v] * 3 }
+
+    # Combine everything into a full featured 256 colour RGB model.
+    TABLE = SYSTEM + COLORS + GREYSCALE
+
+    # The key points that are used to calculate the nearest match of an RGB.
+    BYTEPOINTS_256 = [0x00, 0x5f, 0x87, 0xaf, 0xd7, 0xff]
+
+    # @param [Array<Integer>, String] value a String will be converted to Array
+    # @raise [TypeError] if the +value+ is neither Array or String
+    def initialize(value)
+      @value =
+        case value
+        when Array
+          validate_array(value)
+          value
+        when String
+          validate_array(value = value.scan(/\d+/).map!(&:to_i))
+          value
+        else
+          raise TypeError, "can't convert #{ value.class } into PryTheme::RGB"
+        end
+    end
+
+    # @return [String]
+    def inspect
+      "(RGB: #{ to_s })"
+    end
+
+    # Converts the RGB to a terminal colour equivalent.
+    #
+    # @note Accepts the following numbers: 256, 16, 8.
+    # @param [Integer] color_model
+    # @raise [ArgumentError] if +color_model+ parameter is incorrect
+    # @return [TERM] a TERM representation of the RGB
+    def to_term(color_model = 256)
+      term = case color_model
+             when 256 then PryTheme::RGB::TABLE.index(@value)
+             when 16  then PryTheme::RGB::SYSTEM.index(@value)
+             when 8   then PryTheme::RGB::LINUX.index(@value)
+             else raise ArgumentError,
+                        "invalid value for PryTheme::HEX#to_term(): #{ @value }"
+             end
+      term = find_among_term_colors(term, color_model) if term.nil?
+      PryTheme::TERM.new(term, color_model)
+    end
+
+    # Converts the RGB to a HEX colour equivalent.
+    # @return [HEX] a HEX representation of the RGB
+    def to_hex
+      PryTheme::HEX.new("#%02x%02x%02x" % @value)
+    end
+
+    # @example
+    #   RGB.new([0, 12, 255]).to_s #=> "0, 12, 255"
+    # @return [String]
+    def to_s
+      @value.join(', ')
+    end
+
+    # @example
+    #   RGB.new([0, 12, 255]).to_s #=> [0, 12, 255]
+    # @return [Array<Integer>]
+    def to_a
+      @value
+    end
+
+    # @example
+    #   RGB.new([0, 0, 0]).to_css #=> 'rgb(0, 0, 0)'
+    # @return [String]
+    def to_css
+      "rgb(#{ to_s })"
+    end
+
+    private
+
+    # Checks whether the +ary+ has correct number of elements and these elements
+    # are valid RGB numbers.
+    #
+    # @param [Array<Integer>] ary
+    # @raise [ArgumentError] if the +ary+ is invalid
+    # @return [void]
+    def validate_array(ary)
+      correct_size = ary.size.equal?(3)
+      correct_vals = ary.all?{ |val| val.is_a?(Fixnum) && val.between?(0, 255) }
+      return true if correct_size && correct_vals
+      raise ArgumentError,
+            %|invalid value for PryTheme::RGB#validate_array(): "#{ ary }"|
+    end
+
+    # Approximates the given +byte+ to a terminal colour value within range of
+    # 256 colours.
+    #
+    # @param [Integer] byte a number between 0 and 255
+    # @return [Integer] approximated number
+    def nearest_term_256(byte)
+      for i in 0..4
+        lower, upper = BYTEPOINTS_256[i], BYTEPOINTS_256[i + 1]
+        next unless byte.between?(lower, upper)
+
+        distance_from_lower = (lower - byte).abs
+        distance_from_upper = (upper - byte).abs
+        closest = distance_from_lower < distance_from_upper ? lower : upper
+      end
+      closest
+    end
+
+    # The same as {#nearest_term_256}, but returns a number beteen 0 and 15.
+    #
+    # @note Oh, come on. At least it works!
+    # @todo use more realistic algorithm.
+    def nearest_term_16(byte)
+      byte / 16
+    end
+
+    # The same as {#nearest_term_256}, but returns a number beteen 0 and 7.
+    #
+    # @note Oh, come on. At least it works!
+    # @todo use more realistic algorithm.
+    def nearest_term_8(byte)
+      byte / 32
+    end
+
+    # Finds an approximated +term+ colour among the colour numbers within the
+    # given +color_model+.
+    #
+    # @param [Integer] term a colour to be approximated
+    # @param [Integer] color_model possible values {#to_term}
+    # @return [Integer] approximated number, which fits in range of color_model
+    def find_among_term_colors(term, color_model)
+      rgb = @value.map { |byte| nearest_term_256(byte) }
+      term = PryTheme::RGB::TABLE.index(rgb)
+      approximate(term, color_model)
+    end
+
+    # Approximates +term+ in correspondence with +color_model+
+    #
+    # @see #nearest_term_16
+    # @see #nearest_term_8
+    # @param [Integer] term a colour to be approximated
+    # @param [Integer] color_model possible values {#to_term}
+    # @return [Integer] approximated number, which fits in range of color_model
+    def approximate(term, color_model)
+      needs_approximation = (term > color_model - 1)
 
-    def self.table
-      SYSTEM + COLORS + GREYSCALE
+      if needs_approximation
+        case color_model
+        when 16 then nearest_term_16(term)
+        when 8  then nearest_term_8(term)
+        end
+      else
+        term
+      end
     end
 
   end