jstp 0.5.7 → 1.0.2

data/lib/jstp/version.rb

@@ -1,4 +1,4 @@
 # -*- encoding : utf-8 -*-
 module JSTP
-  VERSION = "0.5.7"
+  VERSION = "1.0.2"
 end

data/lib/reader/jstp/dispatch.rb

@@ -0,0 +1,36 @@
+# http://www.youtube.com/watch?v=pXPzZezGu8k
+module Reader
+  module JSTP
+    class Dispatch < Discoverer::Pattern
+      def hash the_hash
+        the_hash.each do |key, value|
+          @source[key] = value
+        end
+        
+        @source
+      end
+
+      # Actually, is JSON
+      def string the_string
+        Oj.load(the_string).each do |key, value|
+          @source[key] = value
+        end
+
+        @source
+      end
+
+      def array the_array
+        @source.method = the_array.first if the_array.first
+        @source.resource = the_array[1] if the_array[1]
+        @source.body = the_array[2] if the_array[2]
+        if the_array[3]
+          the_array[3].each do |key, value|
+            @source[key] = value
+          end
+        end 
+
+        @source
+      end
+    end
+  end
+end

data/lib/reader/jstp/engine.rb

@@ -0,0 +1,66 @@
+module Reader
+  module JSTP
+    class Engine
+      def initialize source
+        @config = ::JSTP::Configuration.instance
+        @source = source
+      end
+
+      # Start the server with the websocket strategy
+      def websocket
+        EM.run do
+          EM::WebSocket
+            .start host: "0.0.0.0", port: @config.port.inbound do |server|
+            
+            server.onopen do
+              @source.clients[UUID.new.generate] = server
+              if @source.respond_to? :open
+                @source.open server, @source.clients.key(server)
+              end
+            end
+
+            server.onmessage do |message|
+              begin
+                @message = ::JSTP::Dispatch.new message
+                @source.dispatch(@message, server)
+              rescue Exception => exception
+                log_exception exception, @message
+              end
+            end
+
+            server.onclose do 
+              if @source.respond_to? :close
+                @source.close server, @source.clients.key(server)
+              end
+            end
+          end
+        end
+      end
+
+      # Start the server with the TCP strategy
+      def tcp
+        @server = TCPServer.open @config.port.inbound
+        loop {
+          Thread.start(@server.accept) { |client|
+            begin 
+              @source.clients[UUID.new.generate] = client
+              @message = ::JSTP::Dispatch.new client.gets
+              @source.dispatch @message, client
+              client.close
+            rescue Exception => exception
+              log_exception exception, @message
+              client.close
+            end
+          }
+        }
+      end
+
+      private
+        def log_exception exception, message
+          @config.logger.error "#{exception.class}: #{exception.message}"
+          @config.logger.debug exception.backtrace.to_s
+          @config.logger.debug Oj.dump message if message
+        end
+    end
+  end
+end

data/lib/writer/jstp/dispatch.rb

@@ -0,0 +1,95 @@
+module Writer
+  module JSTP
+    class Dispatch < Discoverer::Pattern
+
+      def initialize source
+        super source
+        @config = ::JSTP::Configuration.instance
+      end
+
+      # Dispatch this applying the websocket strategy
+      def websocket port = nil
+        host = @source["resource"].first
+        path = @source["resource"][1..-1].join('/')
+        if port.nil?
+          connection_uri = "ws://#{host}:#{@config.port.outbound}/#{path}"
+        else
+          connection_uri = "ws://#{host}:#{port}/#{path}"
+        end
+
+        begin 
+          ws = EM::WebSocketClient.connect connection_uri
+          ws.callback do 
+            ws.send_msg @source.to.json
+            @config.logger.debug @source.to_s
+            ws.close_connection_after_writing
+          end
+        rescue RuntimeError => e
+          EM.run do
+            ws = EM::WebSocketClient.connect connection_uri
+
+            ws.callback do 
+              ws.send_msg @source.to.json
+              @config.logger.debug @source.to_s
+              ws.close_connection_after_writing
+            end
+
+            ws.disconnect do 
+              EM::stop_event_loop
+            end
+          end
+        end
+      end
+
+      # Dispatch thid applying the TCP strategy
+      def tcp port = nil
+        if port.nil?
+          client = TCPSocket.open @source["resource"].first, @config.port.outbound
+        else
+          client = TCPSocket.open @source["resource"].first, port
+        end
+
+        client.puts @source.to.json
+        @config.logger.debug @source.to_s
+        client.close
+      end
+
+      def json
+        Oj.dump @source
+      end
+
+      def string 
+        response = "#{@source.method} #{@source.resource.join('/')} #{@source.protocol.join('/')}\n"
+        @source.each do |key, value|
+          unless key == "method" || key == "resource" || key == "protocol" || key == "body"
+            if value.is_a? Array
+              response += "#{key}: #{value.join('/')}\n"
+            else
+              response += "#{key}: #{value}\n"
+            end
+          end
+        end
+
+        unless @source.body.nil?
+          response += "\n"
+          if @source.body.is_a? Hash
+            @source.body.each do |key, value|
+              response += "#{key}: #{Oj.dump(value)}\n"
+            end
+          else
+            response += Oj.dump @source.body
+          end
+        end
+        response
+      end
+
+      def short
+        unless @source.body
+          "#{@source.method} #{@source.resource.join('/')}"
+        else
+          "#{@source.method} #{@source.resource.join('/')}?#{Oj.dump(@source.body)}"
+        end
+      end
+    end
+  end
+end

data/samples/api-1.5/modular_style.rb

@@ -0,0 +1,22 @@
+class MyEngine < JSTP::Engine
+
+  strategy.inbound :websocket
+  port.inbound 44444
+  logger Logger.new $stdout
+
+  resource :user do 
+    get do
+    end
+
+    post do
+    end
+
+    resource :source do
+      get do
+      end
+    end
+  end
+
+end
+
+MyEngine.run

data/samples/api-1.5/references.rb

@@ -0,0 +1,12 @@
+resource :Useful do 
+  delete do 
+    # Do something
+  end
+end
+
+resource :Node do 
+  put do 
+    get 'other.host/Node', data: "this goes in the body"
+    delete Useful, id: "this goes to self"
+  end
+end

data/samples/api-1.5/sinatra_style.rb

@@ -0,0 +1,18 @@
+strategy.inbound :websocket
+port.inbound 44444
+logger Logger.new $stdout
+
+resource :user do 
+  get do
+  end
+
+  post do
+  end
+
+  resource :source do
+    get do
+    end
+  end
+end
+
+# It runs automatically

data/samples/api-2.0/a_la_rack.rb

@@ -0,0 +1,22 @@
+resource :User do 
+  get do 
+    # Something
+  end
+
+  delete do 
+    # Something
+  end
+
+  resource :Rating do 
+    put do 
+    end
+  end
+end
+
+resource :Article do 
+  get do 
+    # Something with article
+  end
+
+  resource User # Includes User here. Along with Rating within
+end

data/samples/api-2.0/clearer_sample.rb

@@ -0,0 +1,12 @@
+class Article < JSTP::Resource
+  def get
+  end
+end
+
+class Blog < JSTP::Resource
+  resource Article # Declaratively set Article as a resource within Blog
+end
+
+Blog.new # Starts Blog as the engine
+
+# The JSTP::Resource class its a combination of Engine and Controller

data/samples/api-2.0/middleware.rb

@@ -0,0 +1,23 @@
+class TokenEmptier < JSTP::Resource
+  get do 
+    original.token = [] # Not useful, just first thing to cross mind
+  end
+
+  all do # Same as def all
+    puts "This will be printed everytime" 
+  end
+end
+
+class App < JSTP::Resource
+  use TokenEmptier
+
+  get do 
+    # => "This will be printed everytime" 
+    # from TokenEmptier#all
+    puts token # => nil
+  end
+end
+
+App.new
+
+# Nice, huh?

data/samples/api-2.0/references.rb

@@ -0,0 +1,11 @@
+resource :Boat do 
+  get do
+    # Something
+  end
+end
+
+resource :Dock do 
+  put do 
+    get Boat, "cool other data"
+  end
+end

data/samples/diff.rb

@@ -0,0 +1,12 @@
+JSTP.config do |c|
+  c.strategy inbound: :websocket
+  c.port inbound: 44444, outbound: 33333
+end
+
+class Diff < JSTP::Engine
+  class Proxy < JSTP::Controller
+    def put
+      dispatch(:get, "localhost/User/7").to.tcp
+    end
+  end
+end

data/samples/hooks.rb

@@ -0,0 +1,9 @@
+class Eng < JSTP::Engine
+  def open client, token
+    # A new client has connected and this gets executed
+  end
+
+  def close client, token
+    # A client has disconnected and this gets executed 
+  end
+end

data/samples/micro.rb

@@ -0,0 +1,6 @@
+class Eng < JSTP::Engine
+  class User < JSTP::Controller
+    def get
+    end
+  end
+end

data/samples/new_api.rb

@@ -0,0 +1,62 @@
+# {
+#   "protocol": ["JSTP", "0.1"],
+#   "method": "GET",
+#   "resource": ["localhost", "User", "4"],
+#   "timestamp": 1536345124,
+#   "token": ["8ugw324", "34fqwer"],
+#   "X-Server": "EventMachine",
+#   "referer": ["google.com", "search"]
+#   "body": {
+#     "name": "Xavier"
+#   }
+# }
+
+class Localhost < JSTP::Engine
+  class User < JSTP::Controller
+    def get
+      protocol # => ["JSTP", "0.1"]
+      method # => "GET"
+      resource # => ["localhost", "User", "4"]
+      query # => ["4"]
+      timestamp # => 1536345124
+      referer # => ["google.com", "search"]
+      token # => ["8ugw324", "34fqwer"]
+      headers # => {"token" => ..., timestamp => ..., "X-Server" => ...}
+      body # => {"name" => "Xavier"}
+      original # => {"protocol" => ..., method" => "GET", "resource" => ...}
+
+      dispatch(
+        :post, 
+        "remote.host/Login/success", 
+        { "message" => "Login successful for user #{body['name']}" },
+        { "X-Greet" => "Hello" }
+      ).to.websocket
+      # => {
+      #   "protocol": ["JSTP", "0.1"],
+      #   "method": "POST",
+      #   "resource": ["remote.host", "Login", "success"],
+      #   "timestamp": 1536358924,
+      #   "token": ["8ugw324", "34fqwer"],
+      #   "X-Greet": "Hello",
+      #   "body": {
+      #     "message": "Login successful for user Xavier"
+      #   }
+      # }
+
+      original.to_s 
+      # => 
+      # GET localhost/User/4
+      # timestamp: 1536345124
+      # token: 8ugw324/34fqwer
+      # X-Server: EventMachine
+      # referer: google.com/search
+      #
+      # name: Xavier
+
+      original.to.short
+      # => GET localhost/User/4?name:Xavier
+    end
+  end
+end
+
+Localhost.new

data/samples/websocket.rb

@@ -0,0 +1,11 @@
+JSTP.config do |config|
+  config.strategy inbound: :websocket
+end
+
+class WebS < JSTP::Engine
+  class Article < JSTP::Controller
+    def post
+      puts body
+    end
+  end
+end