ruby-lambdas 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 19c424e1936c0b793d84a5401fe16e61ef506c0ce6b8973095bfe69877078748
-  data.tar.gz: 238ecf3f90787dd2094ed1c07018755f3f7b5c0f6ead52eac76d7d344a790441
+  metadata.gz: fdd09393827cb1cfa7166f4c9390c500b45cb6e374ea1e7fff85d6e8d1023444
+  data.tar.gz: ea9faa37417a2abf246d9049e40f09247faacf1908550e84b7bb98d3b342f404
 SHA512:
-  metadata.gz: 62eb3e3f36731b625d4629b24b6d6bed9b76643f8c6ae5e3ea8f3eb194a7b51e6170c062430bd82c4dda21fdcd404a49b0008238371a5239bdd0002c90c001f5
-  data.tar.gz: baf613b0646136602049d21c32de3bac40eb69893d015f9609c17f26b053fc6af67266eb65f8aede2565366fd88b7cd147a54885eb2c6ef7180987b6c5f0cc1d
+  metadata.gz: 72b50b42fcebeb42306809114066e946783bc6bfd33e23eea1acd256adc70634de56de2d9fe83bbd0a63c1116733c2db13a3887fa9163352176d8643c05ef62f
+  data.tar.gz: b06bea15c208280081a98fa62bb3d2d9521e41e94e359ba4d05bdad09ac0ff922fc5179a3215265e26c043d34df6964dabe53686d7e457f32838d7a1f2bbe4e4

data/README.md

@@ -9,7 +9,7 @@ TODO: Delete this and the text above, and describe your gem
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'ruby-lambdas', '~> 0.1.0', require: 'ruby/lambdas'
+gem 'ruby-lambdas', require: 'ruby/lambdas'
 ```
 
 And then execute:
@@ -30,6 +30,73 @@ Strings::Strip.call(" hello ") # => "hello"
 
 # Strings::Trim is an alias to the Strings::Strip function
 Strings::Trim.call(" hello ") # => "hello"
+
+# Other ways to call a lambda (function):
+Strings::Trim[" hello "]
+Strings::Trim.(" hello ")    # Syntactic sugar to hide “call”.
+Strings::Trim.===(" hello ") # This allows a proc object to be the target of a when clause in a case statement.
+Strings::Trim.yield(" hello ")
+```
+
+**Partial application (curried functions):**
+
+```ruby
+require "ruby/lambdas"
+
+# We call a function with fewer arguments than it expects and It returns a
+# function that takes the remaining arguments.
+# And this is called Partial Application of Functions. e.g:
+
+Strings::GSub.call(/[aeiou]/, "hello", "*")           # => "h*ll*"
+Strings::GSub.call(/[aeiou]/).call("hello", "*")      # => "h*ll*"
+Strings::GSub.call(/[aeiou]/).call("hello").call("*") # => "h*ll*"
+
+# Last example with an alternative syntax:
+Strings::GSub.(/[aeiou]/).("hello").("*") # => "h*ll*"
+
+# ---
+
+replace_vowels = Strings::GSub.call(/[aeiou]/)
+
+replace_vowels.call("_", "banana") # => "b_n_n_"
+
+# ---
+
+hide_vowels = replace_vowels.call("*")
+
+hide_vowels.call("hello") # => "h*ll*"
+```
+
+**Pipelines:**
+
+```ruby
+require "ruby/lambdas"
+
+###########################
+# RUBY_VERSION >= '2.6.0' #
+###########################
+
+value = ' I WILL be a url slug   '
+
+value
+  .then(&Strings::Strip)
+  .then(&Strings::Downcase)
+  .then(&Strings::GSub[' ', '-'])
+
+# => "i-will-be-a-url-slug"
+
+###########################
+# RUBY_VERSION >= '2.5.0' #
+###########################
+
+value = ' I WILL be a url slug   '
+
+value
+  .yield_self(&Strings::Strip)
+  .yield_self(&Strings::Downcase)
+  .yield_self(&Strings::GSub[' ', '-'])
+
+# => "i-will-be-a-url-slug"
 ```
 
 **Composing functions (`RUBY_VERSION >= '2.6.0'`):**
@@ -39,7 +106,7 @@ require "ruby/lambdas"
 Slugify =                       # Slugify =
   Strings::FromObject           #   Strings::String
     .>> Strings::Strip          #     >> Strings::Trim      \
-    .>> Strings::LowerCase      #     >> Strings::LowerCase \
+    .>> Strings::Downcase       #     >> Strings::LowerCase \
     .>> Strings::GSub[' ', '-'] #     >> Strings::ReplaceAll[' ', '-']
 
 # Reading the previous composition (Step by step)
@@ -64,7 +131,7 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/ruby-lambdas. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+Bug reports and pull requests are welcome on GitHub at https://github.com/serradura/ruby-lambdas. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
 
 ## License
 
@@ -72,4 +139,4 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Code of Conduct
 
-Everyone interacting in the RubyLambdas project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/ruby-lambdas/blob/master/CODE_OF_CONDUCT.md).
+Everyone interacting in the RubyLambdas project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/serradura/ruby-lambdas/blob/master/CODE_OF_CONDUCT.md).

data/lib/ruby/lambdas.rb

@@ -2,4 +2,5 @@ require "ruby/lambdas/version"
 
 module RubyLambdas
   require_relative "lambdas/strings"
+  require_relative "lambdas/objects"
 end

data/lib/ruby/lambdas/import.rb

@@ -0,0 +1,23 @@
+module RubyLambdas
+  class Import
+    def self.call(from:, to:)
+      to_export = from::ToExport
+
+      to_export.constants.each do |function_name|
+        function = to_export.const_get(function_name)
+
+        to.const_set(
+          function_name,
+          function.arity == 1 ? function : function.curry
+        )
+      end
+
+      return unless from.const_defined?(:ALIASES)
+
+      from::ALIASES.each do |name, new_names|
+        Array(new_names)
+          .each { |new_name| to.const_set(new_name, to.const_get(name)) }
+      end
+    end
+  end
+end

data/lib/ruby/lambdas/objects.rb

@@ -0,0 +1,6 @@
+module Objects
+  require_relative "import"
+  require_relative "objects/to_export"
+
+  RubyLambdas::Import.(from: RubyLambdas::Objects, to: self)
+end

data/lib/ruby/lambdas/objects/to_export.rb

@@ -0,0 +1,11 @@
+module RubyLambdas
+  module Objects
+    module ToExport
+      ToS = -> data { data.to_s }
+    end
+
+    ALIASES = {
+      ToS: :ToString
+    }.freeze
+  end
+end

data/lib/ruby/lambdas/strings.rb

@@ -1,21 +1,6 @@
 module Strings
+  require_relative "import"
   require_relative "strings/to_export"
 
-  RubyLambdas::Strings::ToExport.tap do |to_export|
-    to_export
-      .constants
-      .each do |function_name|
-        function = to_export.const_get(function_name)
-
-        const_set(
-          function_name,
-          function.arity == 1 ? function : function.curry
-        )
-      end
-  end
-
-  RubyLambdas::Strings::ALIASES
-    .each do |name, new_names|
-      Array(new_names).each { |new_name| const_set(new_name, const_get(name)) }
-    end
+  RubyLambdas::Import.(from: RubyLambdas::Strings, to: self)
 end

data/lib/ruby/lambdas/version.rb

@@ -1,3 +1,3 @@
 module RubyLambdas
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby-lambdas
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Rodrigo Serradura
@@ -69,6 +69,9 @@ files:
 - bin/console
 - bin/setup
 - lib/ruby/lambdas.rb
+- lib/ruby/lambdas/import.rb
+- lib/ruby/lambdas/objects.rb
+- lib/ruby/lambdas/objects/to_export.rb
 - lib/ruby/lambdas/strings.rb
 - lib/ruby/lambdas/strings/to_export.rb
 - lib/ruby/lambdas/version.rb