ramda-ruby 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 92c254b35426d8cb7d3e26e8a20a65dd0194a795
-  data.tar.gz: 49381b27473b09231633674595c3893ef9105600
+  metadata.gz: c368ef74f40f78f3e1d67b6663e30e664fedcadb
+  data.tar.gz: 0c811702973651568960f00b3308b727bd839895
 SHA512:
-  metadata.gz: b3bb80690881e350816705eb9d91b91d507d633ae395ee904f37acbf8e90cbf2c2d8a2575a7805fb0be8009c7fab069e05eb2aa373883a9d6d350c2a6ef3d7b3
-  data.tar.gz: b6c9c51bd4a2ff317673d28ce65f0e1f5e1e3f06d62362a48ae04d429819012a6747ca12f5b2477678b1f7e6ae0d1f5e49e1333a8069ff8373081bd418207091
+  metadata.gz: 5bc8bf53712b35c48a2eaf056cf166cfd1a7ec8b3b84ef1eed944dfa9f5e75d48834b28d14c3fc0e6a23d2521e3c586f257e7ab100e39e729b846d8c925f4043
+  data.tar.gz: 2536d9295955f1f80f1f86254d6a7969b4d02b5ed7e3a55c810a7fff45d89660211536c184e60d267eceaa4c9b6cefdc01757f4dfda527a7af51e2f5d83db589

data/CHANGELOG.md

@@ -1,3 +1,21 @@
+Not Released
+---------------
+
+Release 0.1.1
+---------------
+
+Breaking changes: index_of, last_index_of return nil instead of -1 if element can't be found
+
+Added:
+
+* find_index
+* find_last
+* find_last_index
+* for_each
+* modulo
+* repeat
+* where
+
 Release 0.1.0
 ---------------
 Added functions from Ramda Js v0.1.0

data/README.md

@@ -36,27 +36,12 @@ And then require:
 require 'ramda'
 ```
 
-## Philosophy of [Ramda](http://ramdajs.com)
-
-* Ramda emphasizes a purer functional style.
-  Immutability and side-effect free functions are at the heart of its design philosophy.
-  This can help you get the job done with simple, elegant code.
-
-* Ramda functions are automatically curried.
-  This allows you to easily build up new functions from old ones simply by not supplying the final parameters.
-
-* The parameters to Ramda functions are arranged to make it convenient for currying.
-  The data to be operated on is generally supplied last.
-
-
 ## Documentation
 
-This gem tries to follow the same versions as Ramda Js.
+Currently the gem doesn't have own documentation but it tries to follow specification from [Ramda Js](http://ramdajs.com/docs/)
 
-Currently the gem doesn't have own documentation but it tries to follow specification from [Ramda Js](http://ramdajs.com/docs/):
-
-* each release contains [functions](docs/FUNCTIONS.md) from the relevant Ramda Js release
-* each release includes more functions which i found pretty useful
+* each release includes [functions](docs/FUNCTIONS.md) from the relevant [Ramda Js](http://ramdajs.com) release
+* each release includes more functions which i found pretty useful but they are from upcoming releases
 
 You could use [Ramda Js](http://ramdajs.com/docs/) as a source of documentation.
 
@@ -64,7 +49,18 @@ Ruby scpecific examples can be found in [tests](spec/ramda).
 
 ## Usage
 
-TODO: Write usage instructions here
+```ruby
+  R = Ramda
+
+  players = [
+    { name: 'Andrey', score: 100 },
+    { name: 'Ivan', score: 200 },
+    { name: 'Masha', score: 150 }
+  ]
+
+  best_player = R.pipe(R.sort_by(R.prop(:score)), R.reverse, R.head, R.prop(:name))
+  best_player.call(players) # Ivan
+```
 
 ## Development
 

data/ROADMAP.md

@@ -1,14 +1,83 @@
-###  Add all specs from https://github.com/ramda/ramda/tree/master/test ###
+###  Add documentation
 
-###  Add documentation ###
-
-* Get in touch with Ramdajs authors
 * Find out suitable documentation format
 
-### Add CHANGELOG.md ###
+#### release 0.1.1
+
+* find_index
+* find_last
+* find_last_index
+* for_each
+* modulo
+* repeat
+* where
+
+#### release 0.1.4
+
+last
+partition
+slice
+
+### release 0.2.0
+
+binary
+keys_in
+path
+unary
+uniq_with
+values_in
+
+### release 0.2.2
+
+insert
+remove
+
+### release 0.2.3
+
+times
+
+### release 0.3.0
+
+ap
+chain
+empty
+from_pairs
+is
+length
+math_mod
+of
+unnest
+zip_obj
+
+### release 0.4.0
+
+construct_n
+to_pairs
+to_pairs_in
+
+### release 0.4.2
+
+converge
+
+### release 0.5.0
+
+curry_n
+
+### release 0.6.0
+
+__
+bind
+cond
+prop_or
+trim
 
-### Performance Tests ###
+### release 0.7.0
 
-* find out amout of memory which gem uses
+apply
+has
+has_in
+lift
+lift_n
+path_eq
+replace
 
-### Prepare 0.1.0 Release ###

data/docs/FUNCTIONS.md

@@ -27,6 +27,9 @@
 * equals
 * filter
 * find
+* find_index
+* find_last
+* find_last_index
 * flatten
 * flip
 * group_by

data/lib/ramda.rb

@@ -8,6 +8,7 @@ require 'ramda/math'
 require 'ramda/object'
 require 'ramda/relation'
 require 'ramda/string'
+require 'ramda/type'
 
 # Ramda library implementation, source: http://ramdajs.com/
 # rubocop:disable Metrics/ModuleLength
@@ -40,7 +41,11 @@ module Ramda
                  :drop,
                  :filter,
                  :find,
+                 :find_index,
+                 :find_last,
+                 :find_last_index,
                  :flatten,
+                 :for_each,
                  :group_by,
                  :head,
                  :index_of,
@@ -56,6 +61,7 @@ module Ramda
                  :reduce,
                  :reduce_right,
                  :reject,
+                 :repeat,
                  :reverse,
                  :tail,
                  :take,
@@ -69,6 +75,7 @@ module Ramda
                  :all_pass,
                  :and,
                  :any_pass,
+                 # :complement,
                  :if_else,
                  :is_empty,
                  :not,
@@ -79,6 +86,7 @@ module Ramda
                  :dec,
                  :divide,
                  :inc,
+                 :modulo,
                  :multiply,
                  :product,
                  :subtract,
@@ -97,7 +105,8 @@ module Ramda
                  :project,
                  :prop,
                  :props,
-                 :values
+                 :values,
+                 :where
 
   def_delegators Ramda::Relation,
                  :count_by,
@@ -122,4 +131,7 @@ module Ramda
                  :split,
                  :to_lower,
                  :to_upper
+
+  def_delegators Ramda::Type,
+                 :is_nil
 end

data/lib/ramda/list.rb

@@ -105,6 +105,34 @@ module Ramda
       xs.find(&f)
     end
 
+    # Returns the index of the first element of the list which matches the predicate,
+    # or nil if no element matches.
+    #
+    # (a -> Boolean) -> [a] -> Number | NilClass
+    #
+    curried_method(:find_index) do |fn, xs|
+      xs.index(&fn)
+    end
+
+    # Returns the last element of the list which matches the predicate,
+    # or nil if no element matches.
+    #
+    # (a -> Boolean) -> [a] -> a | NilClass
+    #
+    curried_method(:find_last) do |fn, xs|
+      index = xs.rindex(&fn)
+      xs[index] unless index.nil?
+    end
+
+    # Returns the index of the last element of the list which matches the
+    # predicate, or nil if no element matches.
+    #
+    # (a -> Boolean) -> [a] -> Number | NilClass
+    #
+    curried_method(:find_last_index) do |fn, xs|
+      xs.rindex(&fn)
+    end
+
     # Returns a new list by pulling every item out of it (and all its sub-arrays)
     # and putting them in a new array, depth-first.
     #
@@ -112,6 +140,15 @@ module Ramda
     #
     curried_method(:flatten, &:flatten)
 
+    # Iterate over an input list, calling a provided function fn for each element
+    # in the list.
+    #
+    # (a -> *) -> [a] -> [a]
+    #
+    curried_method(:for_each) do |fn, xs|
+      xs.each(&fn)
+    end
+
     # Splits a list into sub-lists stored in an object, based on the result of
     # calling a String-returning function on each element, and grouping the
     # results according to values returned.
@@ -138,12 +175,12 @@ module Ramda
     end
 
     # Returns the position of the first occurrence of an item in an array,
-    # or -1 if the item is not included in the array.
+    # or nil if the item is not included in the array.
     #
-    # a -> [a] -> Number
+    # a -> [a] -> Number | NilClass
     #
     curried_method(:index_of) do |x, xs|
-      xs.index(x) || -1
+      xs.index(x)
     end
 
     # Returns a string made by inserting the separator between each element and
@@ -156,12 +193,12 @@ module Ramda
     end
 
     # Returns the position of the last occurrence of an item in an array,
-    # or -1 if the item is not included in the array.
+    # or nil if the item is not included in the array.
     #
-    # a -> [a] -> Number
+    # a -> [a] -> Number | NilClass
     #
     curried_method(:last_index_of) do |x, xs|
-      xs.rindex(x) || -1
+      xs.rindex(x)
     end
 
     # Returns the number of elements in the array by returning list.length
@@ -287,6 +324,14 @@ module Ramda
       end
     end
 
+    # Returns a fixed list of size n containing a specified identical value.
+    #
+    # a -> n -> [a]
+    #
+    curried_method(:repeat) do |a, n|
+      Array.new(n, a)
+    end
+
     # Returns a copy of the list, sorted according to the comparator function,
     # which should accept two values at a time and return a negative number
     # if the first value is smaller, a positive number if it's larger, and

data/lib/ramda/logic.rb

@@ -17,6 +17,20 @@ module Ramda
       predicates.any? { |predicate| predicate.call(obj) }
     end
 
+    # Takes a function f and returns a function g such that if called with
+    # the same arguments when f returns a "truthy" value, g returns false
+    # and when f returns a "falsy" value g returns true.
+    #
+    # R.complement may be applied to any functor
+    #
+    # (*... -> *) -> (*... -> Boolean)
+    #
+    curried_method(:complement) do |fn|
+      ::Ramda::Internal::FunctionWithArity.new.call(fn.arity) do |*args|
+        !fn.call(*args)
+      end.curry
+    end
+
     # Creates a function that will process either the onTrue or the onFalse
     # function depending upon the result of the condition predicate.
     #

data/lib/ramda/math.rb

@@ -37,6 +37,14 @@ module Ramda
       a + 1
     end
 
+    # Divides the first parameter by the second and returns the remainder.
+    #
+    # Number -> Number -> Number
+    #
+    curried_method(:modulo) do |a, divider|
+      a % divider
+    end
+
     # Multiplies two numbers. Equivalent to a * b but curried.
     #
     # Number -> Number -> Number

data/lib/ramda/object.rb

@@ -125,5 +125,20 @@ module Ramda
     # {k: v} -> [v]
     #
     curried_method(:values, &:values)
+
+    # Takes a spec object and a test object; returns true if the test satisfies
+    # the spec. Each of the spec's own properties must be a predicate function.
+    # Each predicate is applied to the value of the corresponding property of
+    # the test object. where returns true if all the predicates return true,
+    # false otherwise.
+    #
+    # where is well suited to declaratively expressing constraints for other
+    # functions such as filter and find.
+    #
+    # {String: (* -> Boolean)} -> {String: *} -> Boolean
+    #
+    curried_method(:where) do |spec, test|
+      spec.all? { |k, v| v.call(test[k]) }
+    end
   end
 end

data/lib/ramda/type.rb

@@ -0,0 +1,11 @@
+require_relative 'internal/curried_method'
+
+module Ramda
+  # Type functions
+  module Type
+    extend ::Ramda::Internal::CurriedMethod
+
+    # Checks if the input value is nil.
+    curried_method(:is_nil, &:nil?)
+  end
+end

data/lib/ramda/version.rb

@@ -1,3 +1,3 @@
 module Ramda
-  VERSION = '0.1.0'.freeze
+  VERSION = '0.1.1'.freeze
 end

data/spec/ramda/list_spec.rb

@@ -113,6 +113,30 @@ describe Ramda::List do
     end
   end
 
+  context '#find_index' do
+    it 'from docs' do
+      xs = [{ a: 1 }, { a: 2 }, { a: 3 }]
+      expect(R.find_index(R.prop_eq(:a, 2)).call(xs)).to eq(1)
+      expect(R.find_index(R.prop_eq(:a, 4)).call(xs)).to be_nil
+    end
+  end
+
+  context '#find_last' do
+    it 'from docs' do
+      xs = [{ a: 1, b: 0 }, { a: 1, b: 1 }]
+      expect(r.find_last(R.prop_eq(:a, 1)).call(xs)).to eq(a: 1, b: 1)
+      expect(r.find_last(R.prop_eq(:a, 4)).call(xs)).to be_nil
+    end
+  end
+
+  context '#find_last_index' do
+    it 'from docs' do
+      xs = [{ a: 1, b: 0 }, { a: 1, b: 1 }]
+      expect(r.find_last_index(R.prop_eq(:a, 1)).call(xs)).to eq(1)
+      expect(r.find_last_index(R.prop_eq(:a, 4)).call(xs)).to be_nil
+    end
+  end
+
   context '#flatten' do
     it 'from docs' do
       expect(r.flatten([1, 2, [3, 4], 5, [6, [7, 8, [9, [10, 11], 12]]]]))
@@ -120,6 +144,16 @@ describe Ramda::List do
     end
   end
 
+  context '#for_each' do
+    it 'from docs' do
+      counter = 0
+      fn = ->(a) { counter += a }
+
+      expect(r.for_each(fn, [1, 2, 3])).to eq([1, 2, 3])
+      expect(counter).to eq(6)
+    end
+  end
+
   context '#group_by' do
     it 'from docs' do
       by_grade = lambda do |student|
@@ -172,7 +206,7 @@ describe Ramda::List do
     it 'from docs' do
       expect(r.index_of(3, [1, 2, 3, 4])).to be(2)
       expect(r.index_of(1, [1, 2, 3, 4])).to be(0)
-      expect(r.index_of(10, [1, 2, 3, 4])).to be(-1)
+      expect(r.index_of(10, [1, 2, 3, 4])).to be(nil)
     end
   end
 
@@ -190,7 +224,7 @@ describe Ramda::List do
   context '#last_index_of' do
     it 'from docs' do
       expect(r.last_index_of(3, [-1, 3, 3, 0, 1, 2, 3, 4])).to be(6)
-      expect(r.last_index_of(10, [1, 2, 3, 4])).to be(-1)
+      expect(r.last_index_of(10, [1, 2, 3, 4])).to be_nil
     end
   end
 
@@ -300,6 +334,17 @@ describe Ramda::List do
     end
   end
 
+  context '#repeat' do
+    it 'from docs' do
+      expect(r.repeat('hi', 5)).to eq(['hi', 'hi', 'hi', 'hi', 'hi'])
+
+      obj = {}
+      repeated_objs = R.repeat(obj, 5)
+      expect(repeated_objs).to eq([obj, obj, obj, obj, obj])
+      expect(repeated_objs[0]).to be(repeated_objs[1])
+    end
+  end
+
   context '#sort' do
     it 'from docs' do
       diff = ->(a, b) { a - b }

data/spec/ramda/logic_spec.rb

@@ -30,6 +30,16 @@ describe Ramda::Logic do
     expect(is_black_card.call(rank: 'Q', suit: 'diamond')).to be_falsey
   end
 
+  xcontext '#complement' do
+    it 'from docs' do
+      # is_not_nil = R.complement(R.is_nil)
+      # expect(R.is_nil(nil)).to be_truthy
+      # expect(is_not_nil(nil)).to be_falsey
+      # expect(R.is_nil(7)).to be_falsey
+      # expect(is_not_nil(7)).to be_truthy
+    end
+  end
+
   context '#if_else' do
     it 'from docs' do
       inc_count = R.if_else(

data/spec/ramda/math_spec.rb

@@ -35,6 +35,15 @@ describe Ramda::Math do
     end
   end
 
+  context '#modulo' do
+    it 'from docs' do
+      expect(r.modulo(0, 3)).to be(0)
+      expect(r.modulo(42, 2)).to be(0)
+      expect(r.modulo(21, 2)).to be(1)
+      expect(r.modulo(17, 3)).to be(2)
+    end
+  end
+
   context '#multipy' do
     it 'from docs' do
       triple = r.multiply(3)

data/spec/ramda/object_spec.rb

@@ -114,4 +114,19 @@ describe Ramda::Object do
       expect(r.values(a: 1, b: 2, c: 3)).to eq([1, 2, 3])
     end
   end
+
+  context '#where' do
+    it 'from docs' do
+      pred = R.where(a: R.equals('foo'),
+                     # b: R.complement(R.equals('bar')),
+                     x: R.lt(10),
+                     y: R.gt(20))
+
+      expect(pred.call(a: 'foo', b: 'xxx', x: 11, y: 19)).to be_truthy
+      expect(pred.call(a: 'xxx', b: 'xxx', x: 11, y: 19)).to be_falsey
+      # expect(pred.call(a: 'foo', b: 'bar', x: 11, y: 19)).to be_falsey
+      expect(pred.call(a: 'foo', b: 'xxx', x: 10, y: 19)).to be_falsey
+      expect(pred.call(a: 'foo', b: 'xxx', x: 11, y: 20)).to be_falsey
+    end
+  end
 end

data/spec/ramda_spec.rb

@@ -18,6 +18,7 @@ describe Ramda do
   r(:assoc)
   r(:clone)
   r(:comparator)
+  # r(:complement)
   r(:compose)
   r(:concat)
   r(:construct)
@@ -36,8 +37,12 @@ describe Ramda do
   r(:equals)
   r(:filter)
   r(:find)
+  r(:find_index)
+  r(:find_last)
+  r(:find_last_index)
   r(:flatten)
   r(:flip)
+  r(:for_each)
   r(:group_by)
   r(:gt)
   r(:gte)
@@ -49,6 +54,7 @@ describe Ramda do
   r(:intersection)
   r(:invoker)
   r(:is_empty)
+  r(:is_nil)
   r(:join)
   r(:keys)
   r(:last_index_of)
@@ -61,6 +67,7 @@ describe Ramda do
   r(:memoize)
   r(:merge)
   r(:min)
+  r(:modulo)
   r(:multiply)
   r(:n_ary)
   r(:not)
@@ -82,6 +89,7 @@ describe Ramda do
   r(:reduce)
   r(:reduce_right)
   r(:reject)
+  r(:repeat)
   r(:reverse)
   r(:sort)
   r(:sort_by)
@@ -99,6 +107,7 @@ describe Ramda do
   r(:uniq)
   r(:use_with)
   r(:values)
+  r(:where)
   r(:xprod)
   r(:zip)
   r(:zip_with)

metadata

@@ -1,16 +1,16 @@
 --- !ruby/object:Gem::Specification
 name: ramda-ruby
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Vadim Lazebny
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-06-17 00:00:00.000000000 Z
+date: 2017-06-18 00:00:00.000000000 Z
 dependencies: []
-description: A gem for porting RamdaJs tools for Ruby.
+description: Ruby version of Ramda Js library.
 email:
 - vadim.lazebny@gmail.com
 executables: []
@@ -37,6 +37,7 @@ files:
 - lib/ramda/object.rb
 - lib/ramda/relation.rb
 - lib/ramda/string.rb
+- lib/ramda/type.rb
 - lib/ramda/version.rb
 - spec/ramda/function_spec.rb
 - spec/ramda/internal/curried_method_spec.rb
@@ -71,7 +72,7 @@ rubyforge_project:
 rubygems_version: 2.6.6
 signing_key: 
 specification_version: 4
-summary: RamdaJs implementation for Ruby.
+summary: Ruby version of Ramda Js library.
 test_files:
 - spec/ramda_spec.rb
 - spec/ramda/math_spec.rb