immanence 0.0.1 → 0.0.2

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    NjE2MTIzMWJhMTcxMGNmNjQyNGE4MjlmNjY3YzI2NjA3NDE0YWFhNA==
+    MDcyOTJhNmQ0NTc5MDU4MjhkYTVmMGJiNTRmZjU5MWU4NTRmNzY3ZQ==
   data.tar.gz: !binary |-
-    NjU0OGM3ODk1MGI1MDcyZjk1ZjcyNmRlYzA0YWI5MTc2MzNkYWY5Mg==
+    MDJkZmNlNGQ1ZDQ5MDJiMjRhMTIxMjAyNTdmMGM0NWU0ZmYyN2RlOQ==
 !binary "U0hBNTEy":
   metadata.gz: !binary |-
-    MzVkZmUyOTgzNzU4Mzk4MzgxOWM2OGJhODhiMTM1NzI1NzU4MzNmMGE5ZjI5
-    N2NiN2I0ZWFkZDU2NzBlODI5NjUxZGU5NDNiOGQzYThhYzFkZWY5MzQzYzE1
-    ODYxYjdhMTQ5ODUxNDE5MWUwNGViYmE4NmRhODliOTY4NWY3MDU=
+    N2IzMTc4Mjg4Y2Y4MDM3MTBjYzYyOTA0MGI3NDZkN2RkOWE4NWFmYjcxNzNk
+    ZDFmMzQyNmUzYzQ0ZDQ2ZGIxYTE1MjliZDZiZjYyNGUwYjhiNDA3Mzg1Y2E1
+    MmIwODhhMzI2MTliZTgwYjE0NGU0MmNiNjNhZDNkZjQ0YzMxYjY=
   data.tar.gz: !binary |-
-    Y2EzN2EwMmMwYzhkNWY4ZjU0NzRjY2QxMjEwNGQ4YjllNzIwZDFjNzYzMmQ0
-    ZTc2ZDQ4MTYxZjczNmExOWEyYjE5MmE5NzE0OWJhMGM3Y2UxMjdiZTI2ZjBi
-    Y2QzOTc2ODdjNWM5ZDFmMDc4M2E0YmRlMDc1OTZlZWZkZWM0YTI=
+    NjE0MGRkN2I2NDhjZGRjNmU4YzM1ODVjNDYzMWIwNDAzNmUxN2M1NjliMjE2
+    MmNjYzNkMWQ5ZWE0ZTg0NzRkOTQyYmJhYTRhYmZkY2NkZjk3ZmQ3M2YwOTIx
+    ZDQwZDIzYmY2MTI2OWY1NDJlOGUyNTJjNTQwZDQ4NDc2NTJkNzU=

data/README.md

@@ -1 +1,26 @@
-> [...] when I stub my toe, it is because I do not have the proper set of architectural landing sites in place. That is, my architectural body has not assembled enough clues to connect itself properly to its surroundings. Sites of reversible destiny are designed to be as complex as our most innate mechanisms of our perception. It might take an hour to go from one room to another, and I might live there in a continual state of deja vu as I experience a repetition of slightly differing perceptions. Yet, I will be involved in a constant critique of my own experience. I will see. I will live. Perhaps for the first time. —Arakawa and Gins
+> [...] when I stub my toe, it is because I do not have the proper set of architectural landing sites in place.
+> That is, my architectural body has not assembled enough clues to connect itself properly to its surroundings.
+> Sites of reversible destiny are designed to be as complex as our most innate mechanisms of our perception.
+> It might take an hour to go from one room to another, and I might live there in a continual state of deja vu as I experience a repetition of slightly differing perceptions.
+> Yet, I will be involved in a constant critique of my own experience.
+> I will see.
+> I will live.
+> Perhaps for the first time.
+>
+> —Arakawa and Madeline Gins
+
+**Immanence** is a DSL for handling web requests in Ruby, built on top of Rack. To execute routes it calculates the [Levenshtein distance](http://en.wikipedia.org/wiki/Levenshtein_distance) between incoming requests and routes defined in the DSL then executes the most likely candidate. *Something will always be executed.* Objects are rendered by calling `>>` on `self` with the object to be rendered as the argument. Objects are serialized into JSON via Oj. Incoming JSON is automatically parsed and available in the `@request` object.
+
+This is less a useful piece of software and more of a stylistic exercise.
+
+```ruby
+class Application < Immanence::Control
+  route :get, "/fields/:id" do
+    self >> Field.find(@params[:id])
+  end
+
+  route :post, "/fields" do
+    self >> Field.create(@request.input)
+  end
+end
+```

data/lib/core_ext/kernel.rb

@@ -0,0 +1,5 @@
+# encoding: UTF-8
+
+module Kernel
+  alias_method :λ, :lambda
+end

data/lib/core_ext/object.rb

@@ -2,4 +2,8 @@ class Object
   def meta_def(method, &block)
     (class << self; self end).send(:define_method, method, &block)
   end
+
+  def let
+    yield self
+  end
 end

data/lib/immanence.rb

@@ -1,6 +1,9 @@
+# encoding: UTF-8
+
 require "rack"
 require "oj"
 
+require "core_ext/kernel"
 require "core_ext/hash"
 require "core_ext/object"
 
@@ -8,12 +11,10 @@ module Immanence
   class Request < Struct.new(:verb, :path, :input); end
 
   class Control
-    I =-> i { Oj.load(i) }
-    O =-> o { Oj.dump(o, mode: :compat) }
-
-    PROBLEM = "[...] from a problem to the accidents that condition and resolve it."
+    I = λ { |i| Oj.load(i) }
+    O = λ { |o| Oj.dump(o, mode: :compat) }
 
-    LEVENSHTEIN =-> a, b {
+    LEVENSHTEIN = λ { |a, b|
       mx = [(0..a.size).to_a]
 
       (1..b.size).each do |j|
@@ -42,6 +43,7 @@ module Immanence
         body = O[body]
 
         options.reverse_merge!({ status: 200 })
+
         headers.reverse_merge!({
           "Content-Type"      => "text/json",
           "Content-Length"    => ("#{body.size}" rescue "0")
@@ -54,34 +56,40 @@ module Immanence
         meta_def(conjugate(verb, path)) { instance_eval &blk }
       end
 
-      def conjugate(verb, path)
+      def call(e)
+        @request  = Request.new e["REQUEST_METHOD"].downcase, e["PATH_INFO"], I[e["rack.input"].read]
+        @params   = ascertain receiver, @request.path
+
+        send receiver
+      rescue => ε
+        # [...] from a problem to the accidents that condition and resolve it.
+        self >> { error: ε }
+      end
+
+    private
+
+      def conjugate(verb, path) # :nodoc:
         "immanent_#{verb}_#{path}"
       end
 
+      # @return [Hash] Hash of request parameters
       def ascertain(method, path)
-        method.to_s.gsub(/immanent_\w*_/, "").
-          split("/")[1..-1].
-          zip(path.split("/")[1..-1]).
-          map { |x, y|
-            { x[1..-1] => y } if x[0] == ":"
-          }.compact.
-          reduce({}, :merge).
-          deep_symbolize_keys
-      end
+        [method.to_s.gsub(/immanent_\w*_/, ""), path].
 
-      def receiver
-        methods.grep(/immanent_/).map { |method|
-          { method: method, score: LEVENSHTEIN[method, conjugate(@request.verb, @request.path)] }
-        }.min_by { |x| x[:score] }[:method]
-      end
+        map     { |path| path.split("/")[1..-1] }.
+        let     { |x, y| x.zip(y) }.
+        select  { |x, y| x[0] == ":" }.
+        map     { |x, y| { x[1..-1] => y } }.
 
-      def call(e)
-        @request  = Request.new e["REQUEST_METHOD"].downcase, e["PATH_INFO"], I[e["rack.input"].read]
-        @params   = ascertain receiver, @request.path
+        reduce({}, :merge).
+        deep_symbolize_keys
+      end
 
-        send receiver
-      rescue
-        self >> { error: PROBLEM }
+      # @return [String] most likely candidate method to invoke based on incoming route
+      def receiver
+        @receiver ||= methods.grep(/immanent_/).map { |method|
+          { method: method, Δ: LEVENSHTEIN[method, conjugate(@request.verb, @request.path)] }
+        }.min_by { |x| x[:Δ] }[:method]
       end
     end
   end

data/lib/immanence/version.rb

@@ -1,3 +1,3 @@
 module Immanence
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: immanence
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - dzucconi
@@ -93,6 +93,7 @@ files:
 - Rakefile
 - immanence.gemspec
 - lib/core_ext/hash.rb
+- lib/core_ext/kernel.rb
 - lib/core_ext/object.rb
 - lib/immanence.rb
 - lib/immanence/version.rb