trick 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 88acc4d816f3bcdc12e42e2bbd3c8b1b5a37dc9f
-  data.tar.gz: fa1e3652dae7dd7f2c0fb616057f3fc6afcb89bd
+  metadata.gz: 7356be74713ef841a26e2eea69ac8acb185ea1a9
+  data.tar.gz: a820f66c59f7acdd02c7cafc2d2920bac5529243
 SHA512:
-  metadata.gz: 50760fb36b1c2f8a3fb97ca4a889a4f3c3f8e02d43640998b207e2bd024d2ccadaaa693972be4a7df0b8551428cc7a362f94fb7c7812bb4dbef156d4fe6d46cd
-  data.tar.gz: 8ac9b519dcfb04b6c5ac2e8aa36f0876fb4dfea2758ec47bbc20a7df403ce275c654b81020a26138fe7eb53a7f9f5e9f9fc9833157f17d254936a73742fadcb6
+  metadata.gz: 57509be46dc4f257ce85cb95fdc76fb732297fbad3b820cbfc277616287a68cfc9ea44b12f672c6d952496abd83d9ace21bfaa372549c5350d655dc56b5d6c69
+  data.tar.gz: 2a2c9b580ae20850080cbd6500fa03b6ff3b66c6bc6fdeec79ea15027a533d0fd048b2cc8efa3b264e4da9bac547383abc8c0a4379ecb49177f04946d3d5f6d3

data/README.md

@@ -20,33 +20,65 @@ Or install it yourself as:
 
 ## Usage
 
-### Turn something into a proc
+### 1. Turn something into a proc
+
 ```ruby
-module Letter
-  extend Trick::Proclike
+Point = Struct.new :coords do
+  extend Trick::Value
 
-  def call(x)
-    "Letter #{x}"
+  def radius
+    Math.sqrt(coords[0]**2 + coords[1]**2)
   end
 end
 
-Letter.("A") # => "Letter A"
-[B", "C"].map(&Letter) # => ["Letter B", "Letter C"]
+# create a list with proclike factory
+points = [[3, 4], [8, 6]].map(&Point)
+points.map(&:radius) # => [5, 10]
 
-class RoundedNum
-  extend Trick::Factory
+module NormalizedDistance
+  extend Trick::Function
 
-  attr_reader :value
+  # main function method
+  def call(divisor, point)
+    point.radius / divisor * (inc_order? ? 10 : 100)
+  end
 
-  def initialize(number)
-    @value = number.round
+  # use private methods in your function
+  private def inc_order?
+    point.coords[1] > point.coords[0]
   end
 end
 
-RoundedNum.(3.333).value # => 3
-[5.75, 0.99].map(&RoundedNum).map(&:value) # => [6, 1]
+# map points with curried function
+NormalizedDistance[5] # => curried proc
+points.map(&NormalizedDistance[5]) # => [10, 200]
 ```
 
+#### 1.1 Currying
+
+```ruby
+# class currying:
+class Sum
+  extend Trick::Value
+
+  attr_reader :sum
+
+  def initialize(a, b)
+    @sum = a + b
+  end
+end
+
+Sum[41] # => curried proc
+Sum[1, 2].sum # => 3
+
+# struct currying:
+A = Struct.new :x, :y do
+  extend Trick::Value
+end
+
+A[1] # => curried proc
+A[1, 2] # => struct A[1, 2]
+```
 
 
 ## Contributing

data/lib/trick/function.rb

@@ -0,0 +1,25 @@
+module Trick
+  module Function
+    # TODO:
+    #  `module_function` does not work here, would we use it instead of
+    #  `extend`?
+    def self.extended(base)
+      base.extend base
+    end
+
+    def to_proc
+      method(:call).to_proc
+    end
+
+    def curry(arity = nil)
+      to_proc.curry(arity)
+    end
+
+    def [](*args, &block)
+      curry[*args, &block]
+    end
+
+    def call(*)
+    end
+  end
+end

data/lib/trick/value.rb

@@ -0,0 +1,29 @@
+require "trick/function"
+
+module Trick
+  module Value
+    def self.extended(base)
+      if base.superclass == Struct
+        base.define_singleton_method(:[]) do |*args, &block|
+          curry(base.members.count)[*args, &block]
+        end
+      end
+    end
+
+    def to_proc
+      method(:new).to_proc
+    end
+
+    def curry(arity = nil)
+      to_proc.curry(arity || instance_method(:initialize).arity)
+    end
+
+    def [](*args, &block)
+      curry[*args, &block]
+    end
+
+    def call(*args)
+      new(*args)
+    end
+  end
+end

data/lib/trick/version.rb

@@ -1,3 +1,3 @@
 module Trick
-  VERSION = "0.0.2"
+  VERSION = "0.0.3"
 end

data/spec/function_spec.rb

@@ -0,0 +1,47 @@
+require "trick/function"
+
+RSpec.describe Trick::Function do
+  def args
+    [:a, "b", 1, nil, [], {}]
+  end
+
+  describe "::to_proc" do
+    it "returns a Proc" do
+      expect(ABC.to_proc).to be_a Proc
+    end
+
+    it "returns callable with arguments" do
+      expect(ABC.to_proc.call(*args)).to eq ABC.call(*args)
+    end
+
+    it "applies as a block" do
+      expect(
+        ["A", "B", "C"].map(&Letter)
+      ).to eq ["Letter A", "Letter B", "Letter C"]
+    end
+
+    it "applies curried proc as a block" do
+      expect(points.map(&NormalizedDistance[5])).to eq [10, 200]
+    end
+  end
+
+  describe "::curry" do
+    it "returns a curried Proc" do
+      expect(Clean["mop"]).to be_a Proc
+    end
+
+    it "returns a result of curried Proc's applying" do
+      expect(Clean["mop"].("hall")).to eq "Clean hall with mop"
+    end
+  end
+
+  describe "::call" do
+    it { expect(ABC).to respond_to(:call) }
+
+    it "accepts any arguments" do
+      expect { ABC.call(*args) }.not_to raise_error
+    end
+
+    it { expect(ABC.call).to eq nil }
+  end
+end

data/spec/spec_helper.rb

@@ -1,3 +1,5 @@
+Dir["./spec/support/**/*.rb"].each { |f| require f }
+
 # This file was generated by the `rspec --init` command. Conventionally, all
 # specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
 # The generated `.rspec` file contains `--require spec_helper` which will cause

data/spec/support/entities.rb

@@ -0,0 +1,75 @@
+require "trick/function"
+require "trick/value"
+
+module ABC
+  extend Trick::Function
+end
+
+module Letter
+  extend Trick::Function
+
+  def call(x)
+    "Letter #{x}"
+  end
+end
+
+module Clean
+  extend Trick::Function
+
+  def call(tool, room)
+    "Clean #{room} with #{tool}"
+  end
+end
+
+
+A = Struct.new :x, :y do
+  extend Trick::Value
+end
+
+class RoundedNum
+  extend Trick::Value
+
+  attr_reader :value
+
+  def initialize(number)
+    @value = number.round
+  end
+end
+
+class Sum
+  extend Trick::Value
+
+  attr_reader :sum
+
+  def initialize(a, b)
+    @sum = a + b
+  end
+end
+
+
+# README
+Point = Struct.new :coords do
+  extend Trick::Value
+
+  def radius
+    Math.sqrt(coords[0]**2 + coords[1]**2)
+  end
+end
+
+def points
+  @points ||= [[3, 4], [8, 6]].map(&Point)
+end
+
+module NormalizedDistance
+  extend Trick::Function
+
+  # main function method
+  def call(divisor, point)
+    point.radius / divisor * (inc_order?(point) ? 10 : 100)
+  end
+
+  # use private methods in your function
+  private def inc_order?(point)
+    point.coords[1] > point.coords[0]
+  end
+end

data/spec/value_spec.rb

@@ -0,0 +1,58 @@
+require "trick/value"
+
+RSpec.describe Trick::Value do
+  describe "::to_proc" do
+    it "acts as a constructor of a class" do
+      expect(
+        [5.75, 0.99].map(&RoundedNum).map(&:value)
+      ).to eq [6, 1]
+    end
+
+    it "constructs instances", :readme do
+      expect(points).to eq [Point.new([3, 4]), Point.new([8, 6])]
+    end
+
+    it "constructs instances with ability to pass messages to them", :readme do
+      expect(points.map(&:radius)).to eq [5, 10]
+    end
+  end
+
+  describe "::curry" do
+    context "Struct" do
+      it "returns a struct class", :readme do
+        expect(A[1]).to be_a Proc
+      end
+
+      it "returns a result of instantiating a struct" do
+        expect(A[1, 2]).to eq A[1, 2]
+      end
+    end
+
+    context "class", :readme do
+      it "returns a curried Proc" do
+        expect(Sum[41]).to be_a Proc
+      end
+
+      it "returns a result of curried Proc's applying" do
+        expect(Sum[1, 2].sum).to eq 3
+      end
+    end
+  end
+
+  describe "::call" do
+    it "returns new instance of a class" do
+      expect(A.(10, 17)).to be_a A
+    end
+
+    it "creates an instance with passed values" do
+      a = A.(1, 2)
+
+      expect(a.x).to eq 1
+      expect(a.y).to eq 2
+    end
+
+    it "creates an instance with passed value" do
+      expect(RoundedNum.(3.333).value).to eq 3
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: trick
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - Dmitry Novikov
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-02-15 00:00:00.000000000 Z
+date: 2015-02-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -66,12 +66,13 @@ files:
 - README.md
 - Rakefile
 - lib/trick.rb
-- lib/trick/factory.rb
-- lib/trick/proclike.rb
+- lib/trick/function.rb
+- lib/trick/value.rb
 - lib/trick/version.rb
-- spec/factory_spec.rb
-- spec/proclike_spec.rb
+- spec/function_spec.rb
 - spec/spec_helper.rb
+- spec/support/entities.rb
+- spec/value_spec.rb
 - trick.gemspec
 homepage: ''
 licenses:
@@ -98,6 +99,7 @@ signing_key:
 specification_version: 4
 summary: Ruby syntax enhancements.
 test_files:
-- spec/factory_spec.rb
-- spec/proclike_spec.rb
+- spec/function_spec.rb
 - spec/spec_helper.rb
+- spec/support/entities.rb
+- spec/value_spec.rb

data/lib/trick/factory.rb

@@ -1,11 +0,0 @@
-require "trick/proclike"
-
-module Trick
-  module Factory
-    include Trick::Proclike
-
-    def call(*args)
-      new(*args)
-    end
-  end
-end

data/lib/trick/proclike.rb

@@ -1,11 +0,0 @@
-module Trick
-  module Proclike
-    def to_proc
-      method(:call).to_proc
-    end
-
-    def call(*args)
-      self
-    end
-  end
-end

data/spec/factory_spec.rb

@@ -1,42 +0,0 @@
-require "trick/factory"
-
-RSpec.describe Trick::Factory do
-  A = Struct.new :x, :y do
-    extend Trick::Factory
-  end
-
-  class RoundedNum
-    extend Trick::Factory
-
-    attr_reader :value
-
-    def initialize(number)
-      @value = number.round
-    end
-  end
-
-  describe "::to_proc" do
-    it "acts as a constructor of a class", :readme do
-      expect(
-        [5.75, 0.99].map(&RoundedNum).map(&:value)
-      ).to eq [6, 1]
-    end
-  end
-
-  describe "::call" do
-    it "returns new instance of a class" do
-      expect(A.(10, 17)).to be_a A
-    end
-
-    it "creates an instance with passed values" do
-      a = A.(1, 2)
-
-      expect(a.x).to eq 1
-      expect(a.y).to eq 2
-    end
-
-    it "creates an instance with passed value", :readme do
-      expect(RoundedNum.(3.333).value).to eq 3
-    end
-  end
-end

data/spec/proclike_spec.rb

@@ -1,47 +0,0 @@
-require "trick/proclike"
-
-RSpec.describe Trick::Proclike do
-  module ABC
-    extend Trick::Proclike
-  end
-
-  module Letter
-    extend Trick::Proclike
-
-    def self.call(x)
-      "Letter #{x}"
-    end
-  end
-
-  def args
-    [:a, "b", 1, nil, [], {}]
-  end
-
-  subject { ABC }
-
-  describe "::to_proc" do
-    it "returns a Proc" do
-      expect(ABC.to_proc).to be_a Proc
-    end
-
-    it "returns callable with arguments" do
-      expect(ABC.to_proc.call(*args)).to eq ABC.call(*args)
-    end
-
-    it "applies as a block", :readme do
-      expect(
-        ["B", "C"].map(&Letter)
-      ).to eq ["Letter B", "Letter C"]
-    end
-  end
-
-  describe "::call" do
-    it { is_expected.to respond_to(:call) }
-
-    it "accepts any arguments" do
-      expect { ABC.call(*args) }.not_to raise_error
-    end
-
-    it { expect(ABC.call).to eq ABC }
-  end
-end