soa 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ffacb34e53562c873c007709b598e657b61b4a496de67275e710eaad794bcc3e
+  data.tar.gz: a06e86233a87f78175a05725edb444dee9cff6d99f72b95a5d280d91f0ab70ce
+SHA512:
+  metadata.gz: f1c64c554ff114962f0bb32af99f02e4b8815752b0d5465ba4f25f84e314413e39f62674724bb4fe6e07d1c6377c52f0c93cac857e48362c668fd014147cf22a
+  data.tar.gz: e38c3c9a7f7047b3b7e1317a8dd3f4e2541edc8989b4d29c63460fd77f6e2ad4458f1b55ac31d8f0126bcd875ac85e62cfb8f09ba857fa4065292a7c4fa6062a

data/.gitignore

@@ -0,0 +1,8 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/Gemfile

@@ -0,0 +1,8 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in soa.gemspec
+gemspec
+
+gem "pry"

data/Gemfile.lock

@@ -0,0 +1,26 @@
+PATH
+  remote: .
+  specs:
+    soa (1.0.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    coderay (1.1.2)
+    method_source (0.9.0)
+    pry (0.11.3)
+      coderay (~> 1.1.0)
+      method_source (~> 0.9.0)
+    rake (10.5.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.16)
+  pry
+  rake (~> 10.0)
+  soa!
+
+BUNDLED WITH
+   1.16.3

data/README.md

@@ -0,0 +1,77 @@
+# SOA
+
+A lot of Ruby and Rails developers can see writing on walls that tells them
+small, focused services are the future. Here is a quote from a well-known
+Ruby thoughtleader, promoting them on the popular microservice platform
+called Twitter dot com:
+
+> Microservices are great for turning method calls in to distributed computing
+> problems
+ - [Aaron Patterson](https://twitter.com/tenderlove) on [Aug. 9,
+   2018](https://twitter.com/tenderlove/status/1027591532847816704)
+
+I've helped teams maintain old, slow, and confusing monolithic applications and
+it's taught me one thing: monolithic codebases become more complex over
+time. As a result, many companies have decided to build non-monolithic
+applications instead (these are called "services"; the better, more modern ones
+are called "microservices"). Applications built with services are initially
+much more difficult to create and operate, but they also tend to die sooner,
+which is the best known way to reduce code complexity.
+
+But how do you write services and microservices in a monolithic language like
+Ruby? Up until now, writing services required JavaScript and AWS Lambda. But
+because I prefer to write Ruby and sometimes I work offline (AWS can't be
+used offline yet), I wrote the SOA gem.
+
+The SOA gem is a drop-in replacement for Ruby's built-in method dispatch system.
+You can continue to call legacy methods like you always have alongside new
+service invocations registered with the SOA gem. It's the perfect companion for
+teams looking to make a more gradual transition to a services architecture
+without rewriting their entire years-old system in JavaScript and AWS Lambda.
+
+## Installation
+
+To install SOA, we use the command line command `gem` which communicates with
+the RubyGems.org microservice to download the necessary files:
+
+```
+gem install soa
+```
+
+And then, in your code, you can activate "SOA mode" in your Ruby interpreter
+like this
+
+``` ruby
+require "soa"
+```
+
+[Note that the SOA gem is only tested with C-Ruby. If you want to write services
+with JRuby, you'll need to wait for the release of a SOAP gem.]
+
+Once required, the SOA gem will prepare your Ruby runtime to run services and
+yes microservices instead using our easy-to-use DSL.
+
+## Usage
+
+To create a new microservice, we use the `service` method and specify a route
+path like so:
+
+``` ruby
+require "soa"
+
+service "/api/user/:id" do |id|
+  User.find(id)
+end
+```
+
+In order to invoke a SOA microservice, we just `call_service` with the URL. The
+service is then looked up from the SOA Service Registry, the params are parsed,
+the service is invoked, and the results are returned.
+
+``` ruby
+user = call_service "/api/user/45"
+puts user.id # => 45
+```
+
+It would barely be any easier to just define and call a legacy monolithic Ruby
+method!

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "soa"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/soa/version.rb

@@ -0,0 +1,3 @@
+class SOA
+  VERSION = "1.0.0"
+end

data/lib/soa.rb

@@ -0,0 +1,50 @@
+require "soa/version"
+
+class SOA
+  ServiceCall = Struct.new(:route, :service, :args)
+
+  def self.register(route, blk)
+    @services ||= {}
+    @services[route] = blk
+  end
+
+  def self.invoke(url)
+    service_call = service_lookup(url)
+    service_call.service.call(*service_call.args)
+  end
+
+  private
+
+  def self.service_lookup(url)
+    route, service = @services.find { |(route, _)|
+      parse_params(route, url).all? { |(route_component, url_component)|
+        route_component == url_component || route_component.start_with?(":")
+      }
+    }
+
+    return ServiceCall.new(route, service, parse_args(route, url))
+  end
+
+  def self.parse_params(route, url)
+    route.split("/").zip(url.split("/"))
+  end
+
+  def self.parse_args(route, url)
+    parse_params(route, url).select { |(route_component, _)|
+      route_component.start_with?(":")
+    }.map { |(_, url_component)|
+      url_component
+    }
+  end
+
+end
+
+module Kernel
+  def service(route, &blk)
+    Soa.register(route, blk)
+  end
+
+  def call_service(url, *args)
+    Soa.invoke(url, *args)
+  end
+end

data/soa.gemspec

@@ -0,0 +1,26 @@
+
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "soa/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "soa"
+  spec.version       = SOA::VERSION
+  spec.authors       = ["Justin Searls"]
+  spec.email         = ["searls@gmail.com"]
+
+  spec.summary       = %q{Helps you migrate from monolithic Ruby to services}
+  spec.homepage      = "https://github.com/searls/soa"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.16"
+  spec.add_development_dependency "rake", "~> 10.0"
+end

data/test.rb

@@ -0,0 +1,8 @@
+require "soa"
+
+service "/api/user/:id" do |id|
+  puts "finding user #{id}"
+end
+
+call_service "/api/user/45" # => puts "finding user 45"
+

metadata

@@ -0,0 +1,82 @@
+--- !ruby/object:Gem::Specification
+name: soa
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Justin Searls
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2018-08-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+description: 
+email:
+- searls@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/soa.rb
+- lib/soa/version.rb
+- soa.gemspec
+- test.rb
+homepage: https://github.com/searls/soa
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.6
+signing_key: 
+specification_version: 4
+summary: Helps you migrate from monolithic Ruby to services
+test_files: []