mll 2.1.0 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1bfa93d983183ee395ce32f023a9536220884f0d
-  data.tar.gz: fd3504c892015ccf15a5f451c7877115186a138b
+  metadata.gz: 66cecae3ebfe3b1589979a8146bb036f5f8a7203
+  data.tar.gz: dd4fd79c9a5684e9cdefa25845a0530c1c897b5a
 SHA512:
-  metadata.gz: 38fd3e00c764eae431fa980369b2f7deff86908529343a3fb07fe37ad6c02e354b87e9ebdfd13a1581f9af8b4e3ce7cd00547840b78132a43c2ecede1ffa135d
-  data.tar.gz: f4f393855791bf20d726cecef3d6858a7f9cde8267b91abd59a413d689b0a3e613113958bab3c3b33205771eec42f56cd8fe7dca8cb9170f737ee2dd69f7a5fe
+  metadata.gz: 1b0b5f12be754586a9e65a437924d5ac6153596c9fc5225da5820948b8f1fb10b49b42db02ac89a089f3872b26aba8d8896b5ae5d6bc4479d41398f3dc4ec18c
+  data.tar.gz: 5fe76c75a56556b8e77e7855e28d006828fb963e1f943b14a7ec7ab4051c691280f365d25a9bbdb3640b82859bf1816b3f6ef44b033c149fcf89504a5af9ec75

data/.travis.yml

@@ -0,0 +1,43 @@
+language: ruby
+rvm:
+ - 1.9.2
+ - 1.9.3
+ - 2.0.0
+ - 2.0.0-p451 # OS X 10.9.4
+ - 2.1.0
+ - 2.1.2
+ - 2.1.3
+ - "2.1"
+ - 2.2.0
+ - "2.2"
+ - ruby-head
+ - jruby-19mode
+ - jruby-head
+ - rbx
+ - rbx-2
+os:
+  - linux
+  - osx
+matrix:
+  allow_failures:
+    - rvm: 1.9.2 # "undefined method `lazy' for []:Array"
+      os: linux
+    - rvm: 1.9.2 # "Requested binary installation but no rubies are available to download"
+      os: osx
+    - rvm: 1.9.3 # "undefined method `lazy' for []:Array"
+    - rvm: "2.2" # "Requested binary installation but no rubies are available to download"
+      os: osx
+    - rvm: ruby-head # "undefined method `hexdigest' for #<OpenSSL::Digest:0x007fda73e3b458>"
+      os: osx
+    - rvm: jruby-19mode # "undefined method `lazy' for []:Array"
+      os: linux
+    - rvm: jruby-19mode # "Requested binary installation but no rubies are available to download"
+      os: osx
+    - rvm: jruby-head # 4 failures in #map
+    - rvm: rbx # 5 failures
+    - rvm: rbx-2 # 5 failures
+env:
+  - rvm_max_time_flag=60
+before_install:
+  - gem install bundler
+script: rake spec

data/Gemfile.lock

@@ -0,0 +1,29 @@
+PATH
+  remote: .
+  specs:
+    mll (2.1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    diff-lcs (1.2.5)
+    rspec (3.1.0)
+      rspec-core (~> 3.1.0)
+      rspec-expectations (~> 3.1.0)
+      rspec-mocks (~> 3.1.0)
+    rspec-core (3.1.7)
+      rspec-support (~> 3.1.0)
+    rspec-expectations (3.1.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.1.0)
+    rspec-mocks (3.1.3)
+      rspec-support (~> 3.1.0)
+    rspec-support (3.1.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.7)
+  mll!
+  rspec (~> 3.1.0)

data/README.md

@@ -1,6 +1,7 @@
 # MLL (Mathematica Language Library)
 
-[![Gem Version](https://badge.fury.io/rb/mll.svg)](http://badge.fury.io/rb/mll)
+[![Gem Version](https://badge.fury.io/rb/mll.svg)](http://badge.fury.io/rb/mll)  
+[![Build Status](https://travis-ci.org/Nakilon/mll.svg)](https://travis-ci.org/Nakilon/mll)
 
 ### What
 
@@ -99,7 +100,7 @@ module MLL
     def dimensions
       lambda do |list, limit = nil|
         enumerator = Enumerator.new do |e|
-          while list.map(&:class).uniq == [Array] &&
+          while list.all?{ |i| i.respond_to? :each } &&
             # TODO refactor into depth-first yielding
     def nest_while
       # TODO finish me
@@ -115,7 +116,12 @@ module MLL
           }]].tap do |stack|
             stack.each do |ai, ri|
               # TODO try to make #table lazy (Enumerator instead of Array)
+    def grid
+      lambda do |table, **options|
+        # TODO smth with this #.all?
+        # TODO https://reference.wolfram.com/language/ref/Alignment.html
   # TODO not sure if we need any other kind of Listability except of #range[[Array]]
+  # TODO #power[]
 ```
 
 #### spec/_spec.rb
@@ -127,6 +133,8 @@ module MLL
 # TODO ? let(:fake_lambda){ ->(*args){fail} }
 # TODO rewrite all Lazy#to_a into Lazy#force (it's not recursive and not documented)
 # TODO maybe make indexes count from 0 not 1
+# TODO merge similar examples
+# TODO deprecate tests that would obviously fail another tests
 describe MLL do
   describe "List Manipulation" do
     describe "Constructing Lists" do
@@ -141,7 +149,7 @@ describe MLL do
           # TODO maybe move it to README.md
       describe "#map" do
         # TODO we'll need less nested mappings when we implement stop on depths depletion
-        describe "Details and Options:" do
+        describe "Details:" do
           example "levels n1 though n2" do
             expect(map[[1,[2,[3,[4,[5,6]]]]], [2,4], ->(i){ [i] }].
               # TODO smth _<>
@@ -161,6 +169,7 @@ describe MLL do
       # TODO move #nest_list and #fold_list and others here?
       # TODO examples in README.rb
       describe "#nest_while" do
+        # TODO examples to README.md
         describe "Details:" do
           # TODO a lot
         describe "Scope:" do
@@ -175,6 +184,65 @@ describe MLL do
           # TODO example "find the next twin prime after 888" do
         describe "Properties & Relations:" do
           # TODO "#nest_while can be expressed in terms of a while loop" do
+  describe "Numerical Data" do
+    describe "#mean" do
+      # TODO examples to README.md
+  describe "Grids & Tables" do
+    describe "#grid" do
+      describe "Details:" do
+        # TODO SpanFromLeft SpanFromAbove SpanFromBoth
+        # TODO The following options can be given
+        # TODO Common settings for Frame
+        # TODO The spec(k) can have the following forms
+        # TODO With ItemSize->Automatic will break elements across multiple lines
+        # TODO "settings can be used for BaselinePosition" do
+      describe "Scope:" do
+        # TODO Draw all the frames in red
+        # TODO Put a frame around the first row and column
+        # TODO Draw different frames with different styles
+        # TODO Put dividers at all horizontal positions
+        # TODO Put dividers at all vertical positions
+        # TODO Put dividers at the third horizontal and second vertical positions
+        # TODO Make the element 4 span the column to its right
+        # TODO Make it span three rows
+        # TODO Span throughout a 2×2 block
+        # TODO Draw the grid with a pink background
+        # TODO Alternating pink and yellow at successive horizontal positions
+        # TODO Alternating pink and yellow at successive vertical positions
+        # TODO Make the grid contents red
+        # TODO "set the horizontal spacing between items" do
+        # TODO "set the horizontal and vertical spacings" do
+        # TODO "grids can be nested" do
+      describe "Options:" do
+        # TODO "align elements around the center of the grid" do
+        # TODO "align numbers on the decimal point" do
+        # TODO draw the grid with a pink background
+        # TODO Pink and gray backgrounds for the first and second columns
+        # TODO An equivalent syntax
+        # TODO Pink and gray backgrounds for the first and second rows
+        # TODO Alternating pink and gray backgrounds
+        # TODO Alternating backgrounds with yellow superimposed in the first and last positions
+        # TODO Set the background for specific items
+        # TODO Set the background for a subregion of the grid
+        # TODO Draw all interior dividers
+        # TODO Draw a divider at every other horizontal position
+        # TODO Include the final position
+        # TODO Draw dividers with specified styles
+        # TODO "frame specific elements" do
+        # TODO "frame a region" do
+        # TODO "make each item a fixed number of character-widths wide" do
+        # TODO "ItemSize->All makes all items the same size" do
+        # TODO "prevent line-wrapping" do
+        # TODO "set one overall style for grid items" do
+        # TODO "style specific elements" do
+        # TODO "style a region" do
+        # TODO "insert no additional space between rows or columns" do
+        # TODO "specify spacing with numeric values" do
+        # TODO "use different spacings at the first vertical divider" do
+      describe "Properties & Relations:" do
+        # TODO "the elements of a Grid can be extracted with #[]" do
+      describe "Neat examples:" do
+        # TODO "a Sudoku grid" do
 # TODO http://reference.wolfram.com/language/guide/HandlingArraysOfData.html
 # TODO http://reference.wolfram.com/language/guide/ComputationWithStructuredDatasets.html
 ```

data/lib/mll.rb

@@ -7,7 +7,7 @@ module MLL
         list = [list]
         enumerator = Enumerator.new do |e|
           # String.size shall not pass
-          while list.map(&:class).uniq == [Array] &&
+          while list.all?{ |i| i.respond_to? :each } &&
                 list.map(&:size).uniq.size == 1
             # TODO refactor into depth-first yielding
             e << list.first.size
@@ -103,7 +103,7 @@ module MLL
               # "undefined method `replace' for #<Enumerator::Lazy: []>"
               ai.replace ri.first.map{ |i|
                 if ri.size == 1
-                  f.call(*ai, i)
+                  f.respond_to?(:call) ? f.call(*ai, i) : f
                 else
                   [*ai.dup, i].tap{ |t| stack << [t, ri.drop(1)] }
                 end
@@ -114,6 +114,39 @@ module MLL
       end
     end
 
+    # http://www.unicode.org/charts/PDF/U2500.pdf
+    # https://en.wikipedia.org/wiki/Box_Drawing
+    def grid
+      lambda do |table, **options|
+        raise ArgumentError.new("unknown value of :alignment option '#{options[:alignment]}'") unless \
+          alignment = {
+            nil => :center,
+            :center => :center,
+            :left => :ljust,
+            :right => :rjust,
+          }[options[:alignment]]
+        frames = {
+          nil  => "              ",
+          true => "┃ ┏┓ ┗┛━ ┃━━┃ ",
+          :all => "┃┃┏┓╋┗┛━━┣┳┻┫ ",
+        }[options[:frame]]
+        raise ArgumentError.new("unknown value of :frame option '#{options[:frame]}'") if options[:frame] && !frames
+        # TODO smth with this #.all?
+        table = [table] unless table.all?{ |e| e.respond_to? :each }
+        width = table.map(&:size).max - 1
+        strings = table.map{ |row| row.dup.tap{ |a| a[width] = a[width] }.map(&:to_s) }
+        sizes = strings.transpose.map{ |col| col.map(&:size).max }
+        # TODO https://reference.wolfram.com/language/ref/Alignment.html
+        [
+          [frames[2], sizes.map{ |size| frames[7] * size }.join(frames[10]), frames[3]].join,
+          strings.map{ |row| [frames[0], row.zip(sizes).map{ |str, size| str.method(alignment).call size }.join(frames[1]), frames[0]].join }.join(
+            [?\n, frames[9], sizes.map{ |size| frames[8] * size }.join(frames[4]), frames[12], ?\n].join
+          ),
+          [frames[5], sizes.map{ |size| frames[7] * size }.join(frames[11]), frames[6]].join,
+        ].join(?\n) + ?\n
+      end
+    end
+
     def define_listable_function name, &block
       (class << self; self end).class_eval do
         define_method name do
@@ -175,6 +208,7 @@ module MLL
   define_listable_function(:divide)   { |*args| raise ArgumentError.new("need two arguments") unless args.size == 2 ; args[0] / args[1] }
   define_listable_function(:_plus)    { |*args| raise ArgumentError.new("need two arguments") unless args.size == 2 ; args[0] + args[1] }
   define_listable_function(:_times)   { |*args| raise ArgumentError.new("need two arguments") unless args.size == 2 ; args[0] * args[1] }
+  # TODO #power[]
   # define_listable_function (:power)   { |*args| raise ArgumentError.new("need two arguments") unless args.size == 2 ; args[0] ** args[1] }
 
   # http://reference.wolfram.com/language/ref/Orderless.html

data/mll.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |spec|
   spec.name          = "mll"
-  spec.version       = "2.1.0"
+  spec.version       = "2.2.0"
   spec.authors       = ["Victor Maslov"]
   spec.email         = ["nakilon@gmail.com"]
   spec.summary       = "Mathematica Language Library in Ruby"

data/spec/_spec.rb

@@ -18,6 +18,13 @@ require_relative File.join "..", "lib", "mll"
 
 # TODO maybe make indexes count from 0 not 1
 
+# TODO merge similar examples
+# TODO deprecate tests that would obviously fail another tests
+
+
+# File.read("spec/_spec.rb").scan(/.*\n/).each_with_index{ |e,i| p [i+1,e] if e["\xe2\x80\x90"] || e["\xc3\x97"] }; 0
+
+
 # http://reference.wolfram.com/language/guide/LanguageOverview.html
 describe MLL do
 
@@ -51,7 +58,7 @@ describe MLL do
 
         describe "Scope:" do
 
-          example "threads element‐wise over lists" do
+          example "threads element-wise over lists" do
             expect(subtract[[1,2,3,4],0.5]).to be_a Enumerator
             expect(subtract[[1,2,3,4],0.5].to_a).to eq [0.5,1.5,2.5,3.5]
             expect(subtract[6,[3,2]]).to be_a Enumerator
@@ -92,7 +99,7 @@ describe MLL do
 
         describe "Scope:" do
 
-          example "threads element‐wise over lists" do
+          example "threads element-wise over lists" do
             expect(divide[[2,3,4,5],2.0]).to be_a Enumerator
             expect(divide[[2,3,4,5],2.0].to_a).to eq [1,1.5,2,2.5]
             expect(divide[6,[3,2]]).to be_a Enumerator
@@ -140,7 +147,7 @@ describe MLL do
           example "sums numbers" do
             expect(plus[2,3,4]).to eq 9
           end
-          example "threads element‐wise over lists" do
+          example "threads element-wise over lists" do
             # idk why not in Scope
             expect(plus[[3,4,5],2]).to be_a Enumerator
             expect(plus[[3,4,5],2].to_a).to eq [5,6,7]
@@ -154,7 +161,7 @@ describe MLL do
 
         describe "Scope:" do
 
-          example "threads element‐wise over lists" do
+          example "threads element-wise over lists" do
             expect(plus[[10,20,30],[1,2,3]]).to be_a Enumerator
             expect(plus[[10,20,30],[1,2,3]].to_a).to eq [11,22,33]
             expect(plus[[[1,2],[3,4]],5]).to be_a Enumerator
@@ -198,7 +205,7 @@ describe MLL do
           example "multiplies numbers" do
             expect(times[2,3,4]).to eq 24
           end
-          example "threads element‐wise over lists" do
+          example "threads element-wise over lists" do
             expect(times[[3,4,5],2]).to be_a Enumerator
             expect(times[[3,4,5],2].to_a).to eq [6,8,10]
             expect(times[2,3,[4,5]]).to be_a Enumerator
@@ -211,7 +218,7 @@ describe MLL do
 
         describe "Scope:" do
 
-          example "threads element‐wise over lists" do
+          example "threads element-wise over lists" do
             expect(times[[2,3],[4,5]]).to be_a Enumerator
             expect(times[[2,3],[4,5]].to_a).to eq [8,15]
             expect(times[[[1,2],[3,4]],5]).to be_a Enumerator
@@ -257,14 +264,18 @@ describe MLL do
             expect(table[->(i){ i+2 }, [0, 20, 2]]).to be_a Array
             expect(table[->(i){ i+2 }, [0, 20, 2]]).to eq [2,4,6,8,10,12,14,16,18,20,22]
           end
-          example "make a 4×3 matrix" do
+          example "a list of 10 x's" do
+            expect(table[?x, 10]).to be_a Array
+            expect(table[?x, 10]).to eq [?x]*10
+          end
+          example "make a 4x3 matrix" do
             expect(table[->(i,j){ 10*i + j }, 4, 3]).to be_a Array
             expect(table[->(i,j){ 10*i + j }, 4, 3]).to eq [[11,12,13],[21,22,23],[31,32,33],[41,42,43]]
           end
 
         end
 
-        example "table(lambda, n1, min..max, [max, min, -step])" do
+        example "table[lambda, n1, min..max, [max, min, -step]]" do
           expect(table[->(i,j,k){ [i,j,k] }, 3, 2..3, [5, 1, -2]]).to be_a Array
           expect(table[->(i,j,k){ [i,j,k] }, 3, 2..3, [5, 1, -2]]).to eq \
           [
@@ -289,7 +300,7 @@ describe MLL do
 
         describe "Applications:" do
 
-          example "column table(binomial, )" do
+          example "column table[binomial, ]" do
             skip "#binomial and #column are yet to be implemented"
           end
 
@@ -323,15 +334,15 @@ describe MLL do
 
         describe "Basic Examples:" do
 
-          example "range(n)" do
+          example "range[n]" do
             expect(range[4]).to be_a Enumerator
             expect(range[4].to_a).to eq [1,2,3,4]
           end
-          example "range(n1, n2)" do
+          example "range[n1, n2]" do
             expect(range[2,5]).to be_a Enumerator
             expect(range[2,5].to_a).to eq [2,3,4,5]
           end
-          example "range(min, max, step)" do
+          example "range[min, max, step]" do
             expect(range[1,2,0.5]).to be_a Enumerator
             expect(range[1,2,0.5].to_a).to eq [1,1.5,2] # can be precision problems
             expect(range[2,6,2].to_a).to eq [2,4,6]
@@ -341,7 +352,7 @@ describe MLL do
         end
 
         # NOTE: Wolfram Mathematica can't do this
-        example "range(max, min, -step)" do
+        example "range[max, min, -step]" do
           expect(range[10,-5,-2]).to be_a Enumerator
           expect(range[10,-5,-2].to_a).to eq [10,8,6,4,2,0,-2,-4]
           expect(range[3,1,-1].to_a).to eq [3,2,1]
@@ -381,7 +392,7 @@ describe MLL do
 
         end
 
-        example "range(min..max)" do
+        example "range[min..max]" do
           expect(range[1..3]).to be_a Enumerator
           range[1..3].each do |i|
             expect(i).to be_a Enumerator
@@ -446,7 +457,7 @@ describe MLL do
           end
 
           # NOTE: Wolfram Mathematica can't do this
-          example "subdivide(max, min, n)" do
+          example "subdivide[max, min, n]" do
             expect(subdivide[1,-1,8]).to be_a Enumerator
             expect(subdivide[1,-1,8].to_a).to eq [1,0.75,0.5,0.25,0,-0.25,-0.5,-0.75,-1]
           end
@@ -455,7 +466,7 @@ describe MLL do
 
         describe "Properties & Relations:" do
 
-          example "subdivide[xmin,xmax,n] is equivalent to xmin+(xmax-xmin)Range[0,n]/n" do
+          example "subdivide[xmin, xmax, n] is equivalent to xmin+(xmax-xmin)Range[0,n]/n" do
             expect(subdivide[2,10,4].to_a).to eq plus[2,divide[times[10-2,range[0,4]],4]].to_a
           end
 
@@ -618,7 +629,7 @@ describe MLL do
 
         # TODO we'll need less nested mappings when we implement stop on depths depletion
 
-        describe "Details and Options:" do
+        describe "Details:" do
 
           example "levels n1 though n2" do
             expect(map[[1,[2,[3,[4,[5,6]]]]], [2,4], ->(i){ [i] }]).to be_a Enumerator
@@ -791,6 +802,8 @@ describe MLL do
       # http://reference.wolfram.com/language/ref/NestWhile.html
       describe "#nest_while" do
 
+        # TODO examples to README.md
+
         describe "Details:" do
           # TODO a lot
         end
@@ -869,12 +882,10 @@ describe MLL do
           expect(tally[[1, 1, 2, 1, 3, 2, 1]]).to be_a Hash
           expect(tally[[1, 1, 2, 1, 3, 2, 1]]).to eq({1=>4, 2=>2, 3=>1})
         end
-
         example "use test argument to count elements with the same class" do
           expect(tally[[[1,2], [1,2,3,4], 1, [1,2,3,4], 1], ->(i,j){ i.class == j.class }]).to be_a Hash
           expect(tally[[[1,2], [1,2,3,4], 1, [1,2,3,4], 1], ->(i,j){ i.class == j.class }]).to eq({[1,2]=>3, 1=>2})
         end
-
         example "count the instances of randomly generated integers" do
           expect(( r = Random.new(0); tally[Array.new(50){ r.rand 10 }] )).to be_a Hash
           expect(( r = Random.new(0); tally[Array.new(50){ r.rand 10 }] )).to eq({5=>4, 0=>6, 3=>10, 7=>7, 9=>5, 2=>4, 4=>3, 6=>2, 8=>5, 1=>4})
@@ -887,7 +898,6 @@ describe MLL do
         example "elements with highest frequencies are given by #commonest" do
           skip "#commonest is yet to be implemented"
         end
-
         example "#tally is a discrete analog of #bincounts" do
           skip "#bincounts is yet to be implemented"
         end
@@ -899,7 +909,9 @@ describe MLL do
     # http://reference.wolfram.com/language/ref/Mean.html
     describe "#mean" do
 
-      describe "Basic Examples" do
+      # TODO examples to README.md
+
+      describe "Basic Examples:" do
 
         example "mean of numeric values" do
           expect(mean[[1.21, 3.4, 2.15, 4, 1.55]]).to eq 2.462
@@ -911,7 +923,7 @@ describe MLL do
 
       end
 
-      describe "Applications" do
+      describe "Applications:" do
 
         example "a 90-day moving mean" do
           skip "#moving_map is yet to be implemented"
@@ -919,7 +931,7 @@ describe MLL do
 
       end
 
-      describe "Properties & Relations" do
+      describe "Properties & Relations:" do
 
         example "#moving_average is a sequence of means" do
           skip "#moving_average is yet to be implemented"
@@ -931,6 +943,168 @@ describe MLL do
 
   end
 
+  # https://reference.wolfram.com/language/guide/GridsAndTables.html
+  describe "Grids & Tables" do
+
+    # https://reference.wolfram.com/language/ref/Grid.html
+    describe "#grid" do
+
+      describe "Details:" do
+
+        example "#normal[grid] extracts the list of lists that make up a grid" do
+          skip "#normal is yet to be implemented"
+        end
+        example "the lists do not all need to be the same length" do
+          expect(grid[[[1],[2,3]]].to_s).to eq "     \n 1   \n     \n 2 3 \n     \n"
+        end
+        # TODO SpanFromLeft SpanFromAbove SpanFromBoth
+        # TODO The following options can be given
+        # TODO Common settings for Frame
+        # TODO The spec(k) can have the following forms
+        # TODO With ItemSize->Automatic will break elements across multiple lines
+        # TODO "settings can be used for BaselinePosition" do
+
+      end
+
+      describe "Basic examples:" do
+
+        example "display elements in a grid" do
+          expect(grid[[%w{a b c}, %w{x y z}]]).to eq \
+            "       \n" \
+            " a b c \n" \
+            "       \n" \
+            " x y z \n" \
+            "       \n"
+        end
+        example "put a frame around every element" do
+          expect(grid[[%w{a b c}, %w{x y z}], frame: :all]).to eq \
+            "┏━┳━┳━┓\n" \
+            "┃a┃b┃c┃\n" \
+            "┣━╋━╋━┫\n" \
+            "┃x┃y┃z┃\n" \
+            "┗━┻━┻━┛\n"
+        end
+
+      end
+
+      describe "Scope:" do
+
+        example "create a grid with a single row" do
+          expect(grid[fold_list[range[5], times].to_a]).to eq \
+            "              \n" \
+            " 1 2 6 24 120 \n" \
+            "              \n"
+        end
+        example "put a frame around the whole grid" do
+          expect(grid[table[?x, [3], [7]], frame: true]).to eq \
+            "┏━━━━━━━━━━━━━┓\n" \
+            "┃x x x x x x x┃\n" \
+            "┃             ┃\n" \
+            "┃x x x x x x x┃\n" \
+            "┃             ┃\n" \
+            "┃x x x x x x x┃\n" \
+            "┗━━━━━━━━━━━━━┛\n"
+        end
+        example "put a frame around every element" do
+          expect(grid[table[?x, [3], [7]], frame: :all]).to eq \
+            "┏━┳━┳━┳━┳━┳━┳━┓\n" \
+            "┃x┃x┃x┃x┃x┃x┃x┃\n" \
+            "┣━╋━╋━╋━╋━╋━╋━┫\n" \
+            "┃x┃x┃x┃x┃x┃x┃x┃\n" \
+            "┣━╋━╋━╋━╋━╋━╋━┫\n" \
+            "┃x┃x┃x┃x┃x┃x┃x┃\n" \
+            "┗━┻━┻━┻━┻━┻━┻━┛\n"
+        end
+        # TODO Draw all the frames in red
+        # TODO Put a frame around the first row and column
+        # TODO Draw different frames with different styles
+        # TODO Put dividers at all horizontal positions
+        # TODO Put dividers at all vertical positions
+        # TODO Put dividers at the third horizontal and second vertical positions
+        # TODO Make the element 4 span the column to its right
+        # TODO Make it span three rows
+        # TODO Span throughout a 2×2 block
+        example "align contents to the left" do
+          expect(grid[[["a", "bbbb"], ["ccc", "d"]], frame: :all, alignment: :left]).to eq \
+            "┏━━━┳━━━━┓\n" \
+            "┃a  ┃bbbb┃\n" \
+            "┣━━━╋━━━━┫\n" \
+            "┃ccc┃d   ┃\n" \
+            "┗━━━┻━━━━┛\n"
+        end
+        example "align contents to the right" do
+          expect(grid[[["a", "bbbb"], ["ccc", "d"]], frame: :all, alignment: :right]).to eq \
+            "┏━━━┳━━━━┓\n" \
+            "┃  a┃bbbb┃\n" \
+            "┣━━━╋━━━━┫\n" \
+            "┃ccc┃   d┃\n" \
+            "┗━━━┻━━━━┛\n"
+        end
+        # TODO Draw the grid with a pink background
+        # TODO Alternating pink and yellow at successive horizontal positions
+        # TODO Alternating pink and yellow at successive vertical positions
+        # TODO Make the grid contents red
+        example "leave the same amount of space for all items" do
+          skip "#power is yet to be implemented"
+          expect(grid[table[power, [5, 5]], frame: :all, alignment: :right, itemsize: :all]).to eq \
+            "┏━━━┳━━━━┓\n" \
+            "┃  a┃bbbb┃\n" \
+            "┣━━━╋━━━━┫\n" \
+            "┃ccc┃   d┃\n" \
+            "┗━━━┻━━━━┛\n"
+        end
+        # TODO "set the horizontal spacing between items" do
+        # TODO "set the horizontal and vertical spacings" do
+        # TODO "grids can be nested" do
+
+      end
+
+      describe "Options:" do
+
+        # TODO "align elements around the center of the grid" do
+        # TODO "align numbers on the decimal point" do
+        # TODO draw the grid with a pink background
+        # TODO Pink and gray backgrounds for the first and second columns
+        # TODO An equivalent syntax
+        # TODO Pink and gray backgrounds for the first and second rows
+        # TODO Alternating pink and gray backgrounds
+        # TODO Alternating backgrounds with yellow superimposed in the first and last positions
+        # TODO Set the background for specific items
+        # TODO Set the background for a subregion of the grid
+        # TODO Draw all interior dividers
+        # TODO Draw a divider at every other horizontal position
+        # TODO Include the final position
+        # TODO Draw dividers with specified styles
+        # TODO "frame specific elements" do
+        # TODO "frame a region" do
+        # TODO "make each item a fixed number of character-widths wide" do
+        # TODO "ItemSize->All makes all items the same size" do
+        # TODO "prevent line-wrapping" do
+        # TODO "set one overall style for grid items" do
+        # TODO "style specific elements" do
+        # TODO "style a region" do
+        # TODO "insert no additional space between rows or columns" do
+        # TODO "specify spacing with numeric values" do
+        # TODO "use different spacings at the first vertical divider" do
+
+      end
+
+      describe "Properties & Relations:" do
+
+        # TODO "the elements of a Grid can be extracted with #[]" do
+
+      end
+
+      describe "Neat examples:" do
+
+        # TODO "a Sudoku grid" do
+
+      end
+
+    end
+
+  end
+
 end
 
 # TODO http://reference.wolfram.com/language/guide/HandlingArraysOfData.html

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mll
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 2.2.0
 platform: ruby
 authors:
 - Victor Maslov
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-07-18 00:00:00.000000000 Z
+date: 2015-10-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -46,7 +46,9 @@ extensions: []
 extra_rdoc_files: []
 files:
 - .rspec
+- .travis.yml
 - Gemfile
+- Gemfile.lock
 - README.md
 - Rakefile
 - lib/mll.rb