ollama-ruby 0.3.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c0e3428486bf4d60d1e4a64574a9c04bb41da5a5fe76b5f4bc37c5f089221cf3
-  data.tar.gz: 0a2f6f5269c97b22493400448204116aebef642273c024aee474a38741dfdce5
+  metadata.gz: 29863f68627a05541de5eab810850b0509db94c1d91b2e9a5a9be9bd387e8aea
+  data.tar.gz: 07f3558153a0a724c08e27a86482e0951070348bf25641d2a9feed113e3e7046
 SHA512:
-  metadata.gz: 3fd8db76a1cad30ba41af287e1abb77a102913f09f1648c9fbaf89f5e3bf4f3dace4a39cc6b72da456b633eb42d331b356134aecc196b112c7f94215177b4023
-  data.tar.gz: 4541a1e93c2714b786cb21b5e401ffc48a08e05c39bfac860e8cdd275a447bbc7db0b6cf80fee5f459f86734320a90362418a50f4174d53ece4e1a9d2f1dc647
+  metadata.gz: 11c405277b59c6acc75c24220942dd883bb7aec99d97d19bc9baf8d61aa4e5dc59af905631dc37641b91babdd9e5ab7305720a8720451db7b4bb6ca067833913
+  data.tar.gz: 129f49e2d4b5cb65b7999f666f33798511b8a34b1be84bbc7bd4433872cd7c323812cd4dd3e8d2ae325cb013cfb6403db8181c8cbe641139469e5ea9821cc71d

data/CHANGES.md

@@ -1,5 +1,53 @@
 # Changes
 
+## 2024-09-21 v0.4.0
+
+### Change Log for **1.2.3**
+
+#### New Features
+
+* Added `-E` option to disable embeddings for this chat session.
+* Added `-M` option to load document embeddings into (empty) MemoryCache for this chat session.
+* Added CSV parsing support to `ollama_chat`.
+* Improved error handling in `Ollama::Utils::Fetcher` methods.
+
+#### Bug Fixes
+
+* Handle case in `ollama_chat` where responses don't provide counts, display 0
+  rates instead.
+
+#### Refactoring and Improvements
+
+* Updated eval count and rate display in FollowChat class.
+* Refactor system prompt display and chunk listing in chat output.
+* Refactor cache implementation to use Ollama::Documents::Cache::Common module.
+* Improved system prompt formatting in `ollama_chat` script.
+* Renamed `tags` method to `tags_set` in `Ollama::Documents::Record` class.
+
+#### Documentation
+
+* Added comments to ColorizeTexts utility class.
+
+## 2024-09-15 v0.3.2
+
+* Add color support to chooser module:
+	+ Include `Term::ANSIColor` in `Ollama::Utils::Chooser` module
+    + Use `blue`, `on_blue` ANSI color for selected item in query method
+* Refactor summarize method to also import sources:
+	+ Added `content` variable to store result of `parse_source`
+	+ Replaced `or return` with explicit assignment and return
+	+ Added calls to `source_io.rewind` and `import_document`
+* Add new test for `file_argument_spec.rb`
+* Refactor tag list initialization and merging:
+	+ Use array literals for initializing tags lists
+	+ Use array literals for passing to merge method
+* Update dependencies and dates in Rakefile and gemspec:
+	+ Removed '.utilsrc' from ignored files in Rakefile
+	+ Updated date in `ollama-ruby.gemspec` to "2024-09-13"
+	+ Removed 'utils' development dependency from `ollama-ruby.gemspec`
+* Refactor `search_web` method to allow n parameter to be optional and default
+  to 1.
+
 ## 2024-09-12 v0.3.1
 
 * Update dependencies and date in gemspec files:

data/README.md

@@ -43,6 +43,8 @@ ollama_chat [OPTIONS]
   -c CHAT        a saved chat conversation to load
   -C COLLECTION  name of the collection used in this conversation
   -D DOCUMENT    load document and add to collection (multiple)
+  -M             use (empty) MemoryCache for this chat session
+  -E             disable embeddings for this chat session
   -v             use voice output
   -h             this help
 ```

data/Rakefile

@@ -13,9 +13,10 @@ GemHadar do
   description 'Library that allows interacting with the Ollama API'
   test_dir    'spec'
   ignore      '.*.sw[pon]', 'pkg', 'Gemfile.lock', '.AppleDouble', '.bundle',
-    '.yardoc', 'tags', 'errors.lst', 'cscope.out', 'coverage', 'tmp', 'corpus'
+    '.yardoc', 'doc', 'tags', 'errors.lst', 'cscope.out', 'coverage', 'tmp',
+    'corpus'
   package_ignore '.all_images.yml', '.tool-versions', '.gitignore', 'VERSION',
-     '.utilsrc', '.rspec', *Dir.glob('.github/**/*', File::FNM_DOTMATCH)
+     '.rspec', *Dir.glob('.github/**/*', File::FNM_DOTMATCH)
   readme      'README.md'
 
   executables << 'ollama_console' << 'ollama_chat' <<
@@ -40,8 +41,9 @@ GemHadar do
   dependency             'pdf-reader',            '~> 2.0'
   development_dependency 'all_images',            '~> 0.4'
   development_dependency 'rspec',                 '~> 3.2'
-  development_dependency 'utils'
   development_dependency 'webmock'
+  development_dependency 'debug'
+  development_dependency 'simplecov'
 
   licenses << 'MIT'
 

data/bin/ollama_chat

@@ -14,6 +14,7 @@ require 'uri'
 require 'nokogiri'
 require 'rss'
 require 'pdf/reader'
+require 'csv'
 
 class OllamaChatConfig
   include ComplexConfig
@@ -47,7 +48,7 @@ class OllamaChatConfig
       splitter:
         name: RecursiveCharacter
         chunk_size: 1024
-    cache: Ollama::Documents::RedisCache
+    cache: Ollama::Documents::Cache::RedisBackedMemoryCache
     redis:
       url: <%= ENV.fetch('REDIS_URL', 'null') %>
     debug: <%= ENV['OLLAMA_CHAT_DEBUG'].to_i == 1 ? true : false %>
@@ -130,11 +131,11 @@ class FollowChat
     prompt_eval_duration = response.prompt_eval_duration / 1e9
     stats_text = {
       eval_duration:        Tins::Duration.new(eval_duration),
-      eval_count:           response.eval_count,
-      eval_rate:            bold { "%.2f c/s" % (response.eval_count / eval_duration) } + color(111),
+      eval_count:           response.eval_count.to_i,
+      eval_rate:            bold { "%.2f c/s" % (response.eval_count.to_i / eval_duration) } + color(111),
       prompt_eval_duration: Tins::Duration.new(prompt_eval_duration),
-      prompt_eval_count:    response.prompt_eval_count,
-      prompt_eval_rate:     bold { "%.2f c/s" % (response.prompt_eval_count / prompt_eval_duration) } + color(111),
+      prompt_eval_count:    response.prompt_eval_count.to_i,
+      prompt_eval_rate:     bold { "%.2f c/s" % (response.prompt_eval_count.to_i / prompt_eval_duration) } + color(111),
       total_duration:       Tins::Duration.new(response.total_duration / 1e9),
       load_duration:        Tins::Duration.new(response.load_duration / 1e9),
     }.map { _1 * '=' } * ' '
@@ -144,10 +145,12 @@ class FollowChat
   end
 end
 
-def search_web(query, n = 5)
+def search_web(query, n = nil)
+  n = n.to_i
+  n < 1 and n = 1
   query = URI.encode_uri_component(query)
   url = "https://www.duckduckgo.com/html/?q=#{query}"
-  Ollama::Utils::Fetcher.new.get(url) do |tmp|
+  Ollama::Utils::Fetcher.new(debug: $config.debug).get(url) do |tmp|
     result = []
     doc = Nokogiri::HTML(tmp)
     doc.css('.results_links').each do |link|
@@ -300,6 +303,16 @@ def parse_source(source_io)
     end
     source_io.rewind
     source_io.read
+  when 'text/csv'
+    result = +''
+    CSV.table(File.new(source_io), col_sep: ?,).each do |row|
+      next if row.fields.select(&:present?).size == 0
+      result << row.map { |pair|
+        pair.compact.map { _1.to_s.strip } * ': ' if pair.last.present?
+      }.select(&:present?).map { _1.prepend('  ') } * ?\n
+      result << "\n\n"
+    end
+    result
   when %r(\Atext/)
     source_io.read
   when 'application/rss+xml'
@@ -310,11 +323,7 @@ def parse_source(source_io)
     source_io.read
   when 'application/pdf'
     reader = PDF::Reader.new(source_io)
-    result = +''
-    reader.pages.each do |page|
-      result << page.text
-    end
-    result
+    reader.pages.inject(+'') { |result, page| result << page.text }
   else
     STDERR.puts "Cannot import #{source_io&.content_type} document."
     return
@@ -322,10 +331,7 @@ def parse_source(source_io)
 end
 
 def import_document(source_io, source)
-  unless $config.embedding.enabled
-    STDOUT.puts "Embedding disabled, I won't import any documents, try: /summarize"
-    return
-  end
+  embedding_enabled? or return parse_source(source_io)
   puts "Importing #{italic { source_io&.content_type }} document #{source.to_s.inspect}."
   text = parse_source(source_io) or return
   text.downcase!
@@ -362,7 +368,7 @@ end
 def fetch_source(source, &block)
   case source
   when %r(\Ahttps?://\S+)
-    Utils::Fetcher.get(source) do |tmp|
+    Utils::Fetcher.get(source, debug: $config.debug) do |tmp|
       block.(tmp)
     end
   when %r(\Afile://(?:(?:[.-]|[[:alnum:]])*)(/\S*)|([~.]?/\S*))
@@ -382,7 +388,11 @@ def summarize(source)
   puts "Now summarizing #{source.to_s.inspect}."
   source_content =
     fetch_source(source) do |source_io|
-      parse_source(source_io) or return
+      content = parse_source(source_io)
+      content.present? or return
+      source_io.rewind
+      import_document(source_io, source)
+      content
     end
   $config.prompts.summarize % source_content
 end
@@ -428,7 +438,7 @@ ensure
 end
 
 def choose_collection(default_collection)
-  collections = [ default_collection ] + $documents.collections
+  collections = [ default_collection ] + $documents.collections.map(&:to_s)
   collections = collections.uniq.sort
   $documents.collection = collection =
     Ollama::Utils::Chooser.choose(collections) || default_collection
@@ -447,7 +457,11 @@ def collection_stats
 end
 
 def configure_cache
-  Object.const_get($config.cache)
+  if $opts[?M]
+    Ollama::Documents::MemoryCache
+  else
+    Object.const_get($config.cache)
+  end
 rescue => e
   STDERR.puts "Caught #{e.class}: #{e} => Falling back to MemoryCache."
   Ollama::Documents::MemoryCache
@@ -463,6 +477,14 @@ def set_markdown(value)
   end
 end
 
+def clear_messages(messages)
+  messages.delete_if { _1.role != 'system' }
+end
+
+def embedding_enabled?
+  $config.embedding.enabled && !$opts[?E]
+end
+
 def display_chat_help
   puts <<~end
     /paste                                   to paste content
@@ -493,7 +515,9 @@ def usage
       -s SYSTEM      the system prompt to use as a file, OLLAMA_CHAT_SYSTEM
       -c CHAT        a saved chat conversation to load
       -C COLLECTION  name of the collection used in this conversation
-      -D DOCUMENT    load document and add to collection (multiple)
+      -D DOCUMENT    load document and add to embeddings collection (multiple)
+      -M             use (empty) MemoryCache for this chat session
+      -E             disable embeddings for this chat session
       -v             use voice output
       -h             this help
 
@@ -505,28 +529,28 @@ def ollama
   $ollama
 end
 
-opts = go 'f:u:m:s:c:C:D:vh'
+$opts = go 'f:u:m:s:c:C:D:MEvh'
 
-config = OllamaChatConfig.new(opts[?f])
+config = OllamaChatConfig.new($opts[?f])
 $config = config.config
 
-opts[?h] and usage
+$opts[?h] and usage
 
 puts "Configuration read from #{config.filename.inspect} is:", $config
 
-base_url = opts[?u] || $config.url
+base_url = $opts[?u] || $config.url
 $ollama      = Client.new(base_url:, debug: $config.debug)
 
-model        = choose_model(opts[?m], $config.model.name)
+model        = choose_model($opts[?m], $config.model.name)
 options      = Options[$config.model.options]
 model_system = pull_model_unless_present(model, options)
 messages     = []
 
-if $config.embedding.enabled
+if embedding_enabled?
   embedding_model         = $config.embedding.model.name
   embedding_model_options = Options[$config.embedding.model.options]
   pull_model_unless_present(embedding_model, embedding_model_options)
-  collection = opts[?C] || $config.embedding.collection
+  collection = $opts[?C] || $config.embedding.collection
   $documents = Documents.new(
     ollama:,
     model:         $config.embedding.model.name,
@@ -536,7 +560,7 @@ if $config.embedding.enabled
     redis_url:     $config.redis.url?,
   )
 
-  document_list = opts[?D].to_a
+  document_list = $opts[?D].to_a
   if document_list.any?(&:empty?)
     puts "Clearing collection #{bold{collection}}."
     $documents.clear
@@ -564,18 +588,21 @@ else
   $documents = Documents.new(ollama:, model:)
 end
 
-if voice = ($config.voice if opts[?v])
+if voice = ($config.voice if $opts[?v])
   puts "Using voice #{bold{voice}} to speak."
 end
 markdown = set_markdown($config.markdown)
 
-if opts[?c]
-  messages.concat load_conversation(opts[?c])
+if $opts[?c]
+  messages.concat load_conversation($opts[?c])
 else
   if system = Ollama::Utils::FileArgument.
-      get_file_argument(opts[?s], default: $config.prompts.system? || model_system)
+      get_file_argument($opts[?s], default: $config.prompts.system? || model_system)
     messages << Message.new(role: 'system', content: system)
-    puts "Configured system prompt is:\n#{italic { system }}"
+    puts <<~end
+      Configured system prompt is:
+      #{italic{Ollama::Utils::Width.wrap(system, percentage: 90)}}
+    end
   end
 end
 
@@ -601,11 +628,11 @@ loop do
     list_conversation(messages, markdown)
     next
   when %r(^/clear$)
-    messages.clear
+    clear_messages(messages)
     puts "Cleared messages."
     next
   when %r(^/clobber$)
-    messages.clear
+    clear_messages(messages)
     $documents.clear
     puts "Cleared messages and collection."
     next
@@ -648,6 +675,8 @@ loop do
       puts "Not enough messages in this conversation."
       redo
     end
+    parse_content = false
+    content
   when %r(^/summarize\s+(.+))
     parse_content = false
     content       = summarize($1) or next
@@ -676,9 +705,12 @@ loop do
   when %r(^/)
     display_chat_help
     next
-  when nil, ''
+  when ''
     puts "Type /quit to quit."
     next
+  when nil
+    puts "Goodbye."
+    exit 0
   end
 
   content, tags = if parse_content
@@ -687,7 +719,7 @@ loop do
                     [ content, Utils::Tags.new ]
                   end
 
-  if $config.embedding.enabled && content
+  if embedding_enabled? && content
     records = $documents.find_where(
       content.downcase,
       tags:,
@@ -695,10 +727,9 @@ loop do
       text_size:  $config.embedding.found_texts_size?,
       text_count: $config.embedding.found_texts_count?,
     )
-    found_texts = records.map(&:text)
-    unless found_texts.empty?
-      content += "\nConsider these chunks for your answer:\n"\
-        "#{found_texts.join("\n\n---\n\n")}"
+    unless records.empty?
+      content += "\nConsider these chunks for your answer:\n\n"\
+        "#{records.map { [ _1.text, _1.tags_set ] * ?\n }.join("\n\n---\n\n")}"
     end
   end
 
@@ -706,8 +737,8 @@ loop do
   handler = FollowChat.new(messages:, markdown:, voice:)
   ollama.chat(model:, messages:, options:, stream: true, &handler)
 
-  if records
-    puts records.map { |record|
+  if embedding_enabled? && !records.empty?
+    puts "", records.map { |record|
       link = if record.source =~ %r(\Ahttps?://)
                record.source
              else

data/lib/ollama/documents/cache/common.rb

@@ -0,0 +1,17 @@
+module Ollama::Documents::Cache::Common
+  attr_writer :prefix
+
+  def collections(prefix)
+    unique = Set.new
+    full_each { |key, _| unique << key[/\A#{prefix}(.*)-/, 1] }
+    unique.map(&:to_sym)
+  end
+
+  def pre(key)
+    [ @prefix, key ].join
+  end
+
+  def unpre(key)
+    key.sub(/\A#@prefix/, '')
+  end
+end

data/lib/ollama/documents/{memory_cache.rb → cache/memory_cache.rb}

@@ -1,11 +1,13 @@
+require 'ollama/documents/cache/common'
+
 class Ollama::Documents::MemoryCache
+  include Ollama::Documents::Cache::Common
+
   def initialize(prefix:)
     @prefix = prefix
     @data   = {}
   end
 
-  attr_writer :prefix
-
   def [](key)
     @data[pre(key)]
   end
@@ -23,11 +25,11 @@ class Ollama::Documents::MemoryCache
   end
 
   def size
-    @data.size
+    count
   end
 
   def clear
-    @data.clear
+    @data.delete_if { |key, _| key.start_with?(@prefix) }
     self
   end
 
@@ -36,11 +38,7 @@ class Ollama::Documents::MemoryCache
   end
   include Enumerable
 
-  def pre(key)
-    [ @prefix, key ].join
-  end
-
-  def unpre(key)
-    key.sub(/\A#@prefix/, '')
+  def full_each(&block)
+    @data.each(&block)
   end
 end

data/lib/ollama/documents/cache/redis_backed_memory_cache.rb

@@ -0,0 +1,44 @@
+require 'redis'
+
+class Ollama::Documents
+  class RedisBackedMemoryCache < MemoryCache
+    def initialize(prefix:, url: ENV['REDIS_URL'])
+      super(prefix:)
+      url or raise ArgumentError, 'require redis url'
+      @prefix, @url = prefix, url
+      @redis_cache  = Ollama::Documents::RedisCache.new(prefix:, url:)
+      @redis_cache.full_each do |key, value|
+        @data[key] = value
+      end
+    end
+
+    def redis
+      @redis_cache.redis
+    end
+
+    def []=(key, value)
+      super
+      redis.set(pre(key), JSON(value))
+    end
+
+    def delete(key)
+      result = redis.del(pre(key))
+      super
+      result
+    end
+
+    def clear
+      redis.scan_each(match: "#@prefix*") { |key| redis.del(key) }
+      super
+      self
+    end
+
+    def pre(key)
+      [ @prefix, key ].join
+    end
+
+    def unpre(key)
+      key.sub(/\A#@prefix/, '')
+    end
+  end
+end

data/lib/ollama/documents/{redis_cache.rb → cache/redis_cache.rb}

@@ -1,13 +1,14 @@
+require 'ollama/documents/cache/common'
 require 'redis'
 
 class Ollama::Documents::RedisCache
+  include Ollama::Documents::Cache::Common
+
   def initialize(prefix:, url: ENV['REDIS_URL'])
     url or raise ArgumentError, 'require redis url'
     @prefix, @url = prefix, url
   end
 
-  attr_writer :prefix
-
   def redis
     @redis ||= Redis.new(url: @url)
   end
@@ -48,11 +49,11 @@ class Ollama::Documents::RedisCache
   end
   include Enumerable
 
-  def pre(key)
-    [ @prefix, key ].join
-  end
-
-  def unpre(key)
-    key.sub(/\A#@prefix/, '')
+  def full_each(&block)
+    redis.scan_each do |key|
+      value = redis.get(key) or next
+      value = JSON(value, object_class: Ollama::Documents::Record)
+      block.(key, value)
+    end
   end
 end

data/lib/ollama/documents.rb

@@ -3,8 +3,11 @@ require 'digest'
 
 class Ollama::Documents
 end
-require 'ollama/documents/memory_cache'
-require 'ollama/documents/redis_cache'
+class Ollama::Documents::Cache
+end
+require 'ollama/documents/cache/memory_cache'
+require 'ollama/documents/cache/redis_cache'
+require 'ollama/documents/cache/redis_backed_memory_cache'
 module Ollama::Documents::Splitters
 end
 require 'ollama/documents/splitters/character'
@@ -16,11 +19,15 @@ class Ollama::Documents
 
   class Record < JSON::GenericObject
     def to_s
-      my_tags = Ollama::Utils::Tags.new(tags)
+      my_tags = tags_set
       my_tags.empty? or my_tags = " #{my_tags}"
       "#<#{self.class} #{text.inspect}#{my_tags} #{similarity || 'n/a'}>"
     end
 
+    def tags_set
+      Ollama::Utils::Tags.new(tags)
+    end
+
     def ==(other)
       text == other.text
     end
@@ -28,15 +35,19 @@ class Ollama::Documents
     alias inspect to_s
   end
 
-  def initialize(ollama:, model:, model_options: nil, collection: :default, cache: MemoryCache, redis_url: nil)
-    @ollama, @model, @model_options, @collection = ollama, model, model_options, collection
+  def initialize(ollama:, model:, model_options: nil, collection: default_collection, cache: MemoryCache, redis_url: nil)
+    @ollama, @model, @model_options, @collection = ollama, model, model_options, collection.to_sym
     @cache, @redis_url = connect_cache(cache), redis_url
   end
 
+  def default_collection
+    :default
+  end
+
   attr_reader :ollama, :model, :collection
 
   def collection=(new_collection)
-    @collection = new_collection
+    @collection   = new_collection.to_sym
     @cache.prefix = prefix
   end
 
@@ -137,15 +148,7 @@ class Ollama::Documents
   end
 
   def collections
-    case @cache
-    when MemoryCache
-      [ @collection ]
-    when RedisCache
-      prefix = '%s-' % self.class
-      Documents::RedisCache.new(prefix:, url: @redis_url).map { _1[/#{prefix}(.*)-/, 1] }.uniq
-    else
-      []
-    end
+    ([ default_collection ] + @cache.collections('%s-' % self.class)).uniq
   end
 
   def tags
@@ -156,7 +159,7 @@ class Ollama::Documents
 
   def connect_cache(cache_class)
     cache = nil
-    if cache_class == RedisCache
+    if cache_class.instance_method(:redis)
       begin
         cache = cache_class.new(prefix:)
         cache.size

data/lib/ollama/utils/chooser.rb

@@ -1,8 +1,10 @@
 require 'amatch'
 require 'search_ui'
+require 'term/ansicolor'
 
 module Ollama::Utils::Chooser
   include SearchUI
+  include Term::ANSIColor
 
   module_function
 
@@ -17,7 +19,7 @@ module Ollama::Utils::Chooser
       },
       query: -> _answer, matches, selector {
         matches.each_with_index.map { |m, i|
-          i == selector ? "#{Term::ANSIColor.blue{?⮕}} #{m.on_blue}" : "  #{m}"
+          i == selector ? "#{blue{?⮕}} #{on_blue{m}}" : "  #{m}"
         } * ?\n
       },
       found: -> _answer, matches, selector {

data/lib/ollama/utils/colorize_texts.rb

@@ -3,11 +3,20 @@ class Ollama::Utils::ColorizeTexts
   include Term::ANSIColor
   include Ollama::Utils::Width
 
+  # Initializes a new instance of Ollama::Utils::ColorizeTexts
+  #
+  # @param [Array<String>] texts the array of strings to be displayed with colors
+  #
+  # @return [Ollama::Utils::ColorizeTexts] an instance of Ollama::Utils::ColorizeTexts
   def initialize(*texts)
-    texts = texts.map(&:to_a)
+    texts  = texts.map(&:to_a)
     @texts = Array(texts.flatten)
   end
 
+  # Returns a string representation of the object, including all texts content,
+  # colored differently and their sizes.
+  #
+  # @return [String] The formatted string.
   def to_s
     result = +''
     @texts.each_with_index do |t, i|
@@ -22,6 +31,14 @@ class Ollama::Utils::ColorizeTexts
 
   private
 
+  # Returns the nearest RGB color to the given ANSI color
+  #
+  # @param [color] color The ANSI color attribute
+  #
+  # @return [Array<RGBTriple>] An array containing two RGB colors, one for black and
+  #   one for white text, where the first is the closest match to the input color
+  #   when printed on a black background, and the second is the closest match
+  #   when printed on a white background.
   def text_color(color)
     color = Term::ANSIColor::Attribute[color]
     [
@@ -30,6 +47,9 @@ class Ollama::Utils::ColorizeTexts
     ].max_by { |t| t.distance_to(color) }
   end
 
+  # Returns an array of colors for each step in the gradient
+  #
+  # @return [Array<Array<Integer>>] An array of RGB color arrays
   def colors
     @colors ||= (0..255).map { |i|
       [