mll 2.4.1 → 2.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4578ca0a16a98bc1a8ab3336d073e3520b85cdc9
-  data.tar.gz: 78ef02a3c5081a97b4bf7fa7278d0da84d2e4f3a
+  metadata.gz: 7eaa6d43148b9cdf889647a63e9e8661629d776c
+  data.tar.gz: 53ad8127bbbc75b201bf98c316042281fdb97390
 SHA512:
-  metadata.gz: b24b4691ada481ae2150e7f073b5e77f151d38d823a76743dc4bfcd1b0e52b55da52e61b5fdb9855108a6b2e9de3d04a563e9a9b8f1309ae414c88aac267d8db
-  data.tar.gz: 4972ad59f90b6cddfd2c000144960a8850571682661037aed329923c21da3325450be4032586816b7462fa10c5f3fbd240d4a7dbd3463876883042b233adf0ce
+  metadata.gz: 622ac74b5373d2ef998ac01d1f834aeba929ae7a368a5f49b5ca1143ec07ce9dfaf8143486539859d7f79e4931c94e930828d6c3eeea518f36d2b26b9c6f77c4
+  data.tar.gz: c84783d82d35568dc977fe689483c173afaa9d3159053454796f1a9b06cc80cdb3d89259fd875af4677755e9de43961d7ba87ae1cf4b0f4e7ff0b0f5f590c084

data/.travis.yml

@@ -1,20 +1,25 @@
 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
+  - 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
+# jdk:
+#   - openjdk7
+#   - oraclejdk7
+#   - oraclejdk8
+#   - openjdk6
 os:
   - linux
   - osx

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    mll (2.4.1)
+    mll (2.5.0)
 
 GEM
   remote: https://rubygems.org/
@@ -25,6 +25,9 @@ PLATFORMS
   ruby
 
 DEPENDENCIES
-  bundler (~> 1.7.0)
+  bundler (~> 1.12.0)
   mll!
   rspec (~> 3.3.0)
+
+BUNDLED WITH
+   1.12.3

data/README.md

@@ -1,5 +1,6 @@
-# MLL (Mathematica Language Library)
+# MLL (Wolfram Mathematica Language Library)
 
+[![Join the chat at https://gitter.im/Nakilon/mll](https://badges.gitter.im/Nakilon/mll.svg)](https://gitter.im/Nakilon/mll?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)  
 [![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)
 
@@ -120,174 +121,3 @@ or
 or
 
     rake    # to implicitly run 'rake todo'
-
-### TODO (this section is filled automatically by `rake todo` task -- do not remove)
-
-#### lib/mll.rb
-
-```
-module MLL
-  class << self
-    def dimensions
-      lambda do |list, limit = nil|
-        enumerator = Enumerator.new do |e|
-          while list.all?{ |i| i.respond_to? :each } &&
-            # TODO refactor into depth-first yielding
-    def nest_while
-      # TODO finish me
-    def fold_list
-      lambda do |x, list, f = nil|
-        # TODO use Ruby#inject ?
-    def map
-      # TODO validate depths
-      # TODO break on passing all depths
-    def table
-      lambda do |f, *args|
-        [].tap do |result|
-          }]].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 negative spacings?
-        # TODO smth with this #.all?
-        # TODO https://reference.wolfram.com/language/ref/Alignment.html
-    def riffle
-      lambda do |*args|
-        case args.size
-          when 3
-            Enumerator.new do |e|
-              args[0].each_with_index do |x, i|
-                # TODO make it not destructive
-  # TODO not sure if we need any other kind of Listability except of #range[[Array]]
-  # TODO #power[]
-```
-
-#### spec/_spec.rb
-
-```
-# TODO move Properties & Relations to some separate contexts maybe
-# TODO @fraggedICE wishes using Rational -- would also allow implementing more examples
-# TODO elegantly get rid of repetitive type checks
-# 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
-# TODO check if we check for ArgumentError without being sure we raise it
-describe MLL do
-  describe "List Manipulation" do
-    describe "Constructing Lists" do
-      describe "#table" do
-        describe "Scope:" do
-          # TODO: "Make a triangular array:"
-      describe "#range" do
-        # TODO take from docs more examples that involve other functions
-    describe "Rearranging & Restructuring Lists" do
-      describe "#riffle" do
-        describe "Scope:" do
-          example "intersperse two lists" do
-            # TODO check how it works for list2.size == list1.size + 1 in Mathematica
-    describe "Applying Functions to Lists" do
-      describe "#fold_list" do
-        describe "Applications:" 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:" do
-          example "levels n1 though n2" do
-            expect(map[[1,[2,[3,[4,[5,6]]]]], [2,4], ->(i){ [i] }].
-              # TODO smth _<>
-          # TODO "Level corresponds to the whole expression"
-          # TODO currying "Map[f][expr] is equivalent to Map[f,expr]"
-        describe "Scope:" do
-          # TODO "Map on all levels, starting at level" ant other about Infinity
-        describe "Properties & Relations:" do
-          # TODO #mapall
-          # TODO #mapthread ?
-          # TODO #mapindexed ?
-          # TODO "negative levels"
-    describe "Elements of Lists" do
-      # TODO #rest
-    # TODO http://reference.wolfram.com/language/guide/RearrangingAndRestructuringLists.html
-    # TODO http://reference.wolfram.com/language/guide/MathematicalAndCountingOperationsOnLists.html
-  describe "Functional Programming" do
-    describe "Iteratively Applying Functions" 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
-          # TODO "always compare all values generated" do
-          # TODO "compare the last two values generated" do
-          # TODO "start comparisons after 4 iterations, and compare using the 4 last values" do
-          # TODO "start comparisons after 4 iterations, and compare using the 6 last values" do
-          # TODO example "stop after at most 4 iterations, even if the test is still true" do
-        describe "Generalizations & Extensions:" do
-          # TODO "return the last value for which the condition was still true" do
-        describe "Applications:" 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 "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/Rakefile

@@ -1,34 +1,26 @@
 require "bundler/gem_tasks"
+
+task :default => %w{ spec todo }
+
 require "rspec/core/rake_task"
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.verbose = false
+end
 
-desc "Append TODO-list to README.md"
+desc "Generate TODO.md"
 task :todo do |t|
-  fail unless File.exist? "README.md"
-  File.open("README.md", "r+") do |readme_file|
-    # begin readme_file.gets end until $_[/^## TODO/]
-    readme_file.gets "### TODO"
-    readme_file.gets
+  File.open("TODO.md", "w") do |readme_file|
     %w{ lib/mll.rb spec/_spec.rb }.each do |file|
-      readme_file.puts "", "#### #{file}", "", "```"
+      readme_file.puts "#### #{file}\n\n```"
       stack = []
       File.foreach(file) do |line|
         next unless shift = /\S/ =~ line
-        depth = shift / 2
-        stack[depth] = line
-        if line[/^\s*# TODO/]
-          readme_file.puts stack.take(depth + 1).compact
-          stack.clear
-        end
+        next unless (stack[depth = shift / 2] = line)[/^\s*# TODO/]
+        readme_file.puts stack.take(depth + 1).compact
+        stack.clear
       end
-      readme_file.puts "```"
+      readme_file.puts "```\n\n"
     end
-    readme_file.truncate readme_file.pos
   end
-  puts `md5 README.md`
+  # puts `md5 TODO.md`
 end
-
-RSpec::Core::RakeTask.new(:spec) do |t|
-  t.verbose = false
-end
-
-task :default => %w{ spec todo }

data/TODO.md

@@ -0,0 +1,169 @@
+#### lib/mll.rb
+
+```
+module MLL
+  class << self
+    def dimensions
+      lambda do |list, limit = nil|
+        enumerator = Enumerator.new do |e|
+          while list.all?{ |i| i.respond_to? :each } &&
+            # TODO refactor into depth-first yielding
+    def nest_while
+      # TODO finish me
+    def fold_list
+      lambda do |x, list, f = nil|
+        # TODO use Ruby#inject ?
+    def map
+      # TODO validate depths
+      # TODO break on passing all depths
+    def table
+      lambda do |f, *args|
+        [].tap do |result|
+          }]].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 negative spacings?
+        # TODO smth with this #.all?
+        # TODO https://reference.wolfram.com/language/ref/Alignment.html
+    def riffle
+      lambda do |*args|
+        case args.size
+          when 3
+            Enumerator.new do |e|
+              args[0].each_with_index do |x, i|
+                # TODO make it not destructive
+  # TODO not sure if we need any other kind of Listability except of #range[[Array]]
+  # TODO #power[]
+```
+
+#### spec/_spec.rb
+
+```
+# TODO move Properties & Relations to some separate contexts maybe
+# TODO @fraggedICE wishes using Rational -- would also allow implementing more examples
+# TODO elegantly get rid of repetitive type checks
+# 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
+# TODO check if we check for ArgumentError without being sure we raise it
+describe MLL do
+  describe "List Manipulation" do
+    describe "Constructing Lists" do
+      describe "#table" do
+        describe "Scope:" do
+          # TODO: "Make a triangular array:"
+      describe "#range" do
+        # TODO take from docs more examples that involve other functions
+    describe "Rearranging & Restructuring Lists" do
+      describe "#riffle" do
+        describe "Scope:" do
+          example "intersperse two lists" do
+            # TODO check how it works for list2.size == list1.size + 1 in Mathematica
+    describe "Applying Functions to Lists" do
+      describe "#fold_list" do
+        describe "Applications:" 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:" do
+          example "levels n1 though n2" do
+            expect(map[[1,[2,[3,[4,[5,6]]]]], [2,4], ->(i){ [i] }].
+              # TODO smth _<>
+          # TODO "Level corresponds to the whole expression"
+          # TODO currying "Map[f][expr] is equivalent to Map[f,expr]"
+        describe "Scope:" do
+          # TODO "Map on all levels, starting at level" ant other about Infinity
+        describe "Properties & Relations:" do
+          # TODO #mapall
+          # TODO #mapthread ?
+          # TODO #mapindexed ?
+          # TODO "negative levels"
+    describe "Elements of Lists" do
+      # TODO #rest
+    # TODO http://reference.wolfram.com/language/guide/RearrangingAndRestructuringLists.html
+    # TODO http://reference.wolfram.com/language/guide/MathematicalAndCountingOperationsOnLists.html
+  describe "Functional Programming" do
+    describe "Iteratively Applying Functions" 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
+          # TODO "always compare all values generated" do
+          # TODO "compare the last two values generated" do
+          # TODO "start comparisons after 4 iterations, and compare using the 4 last values" do
+          # TODO "start comparisons after 4 iterations, and compare using the 6 last values" do
+          # TODO example "stop after at most 4 iterations, even if the test is still true" do
+        describe "Generalizations & Extensions:" do
+          # TODO "return the last value for which the condition was still true" do
+        describe "Applications:" 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 "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/core_ext.rb

@@ -4,4 +4,7 @@ class Array
   def most
     MLL::most[self]
   end
+  def rest
+    MLL::rest[self]
+  end
 end

data/lib/mll.rb

@@ -1,6 +1,6 @@
 module MLL
 
-  VERSION = "2.4.1"
+  VERSION = "2.5.0"
 
   class << self
 
@@ -212,6 +212,19 @@ module MLL
       end
     end
 
+    def rest
+      lambda do |list|
+        Enumerator.new do |e|
+          begin
+            enum = list.to_enum.tap &:next
+            loop{ e << enum.next }
+          rescue StopIteration
+            next
+          end
+        end
+      end
+    end
+
   end
 
   def self.define_listable_function name, &block

data/mll.gemspec

@@ -13,7 +13,7 @@ Gem::Specification.new do |spec|
   spec.test_files    = ["spec/"]
   # spec.require_paths = ["lib"]
 
-  spec.add_development_dependency "bundler", "~> 1.7.0"
+  spec.add_development_dependency "bundler", "~> 1.12.0"
   # spec.add_development_dependency "rake", "~> 10.0"
   spec.add_development_dependency "rspec", "~> 3.3.0"
 

data/spec/_spec.rb

@@ -822,7 +822,37 @@ describe MLL do
 
       end
 
-      # TODO #rest
+      # https://reference.wolfram.com/language/ref/Rest.html
+      describe "#rest" do
+
+        describe "Basic Examples:" do
+
+          example "???" do
+            expect(rest[[1,2,3,4]]).to be_a Enumerator
+            expect(rest[[1,2,3,4]].to_a).to eq [2,3,4]
+          end
+
+        end
+
+        describe "Applications:" do
+
+          example "nest the operation of finding the rest of a list" do
+            expect(nest_list[[1,2,3,4,5], 3, rest]).to be_a Enumerator
+            expect(nest_list[[1,2,3,4,5], 3, rest].map(&:to_a)).to eq [[1,2,3,4,5], [2,3,4,5], [3,4,5], [4,5]]
+          end
+
+        end
+
+        describe "Properties & Relations:" do
+
+          example "#rest is equivalent to Array#drop(1)" do
+            expect(rest[[1,2,3,4]]).to be_a Enumerator
+            expect(rest[[1,2,3,4]].to_a).to eq [1,2,3,4].drop 1
+          end
+
+        end
+
+      end
 
       # https://reference.wolfram.com/language/ref/Dimensions.html
       describe "#dimensions" do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mll
 version: !ruby/object:Gem::Version
-  version: 2.4.1
+  version: 2.5.0
 platform: ruby
 authors:
 - Victor Maslov
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-05-07 00:00:00.000000000 Z
+date: 2016-06-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 1.7.0
+        version: 1.12.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 1.7.0
+        version: 1.12.0
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -51,6 +51,7 @@ files:
 - Gemfile.lock
 - README.md
 - Rakefile
+- TODO.md
 - core_ext.rb
 - lib/mll.rb
 - mll.gemspec