tiny_lb 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ba4513ade0c9715de901d8a44807571054f739b5b68b785aa14d8172f84dd904
+  data.tar.gz: 44e6e084eb21c352ad149a46f178e352ac81e4863e68cb58050cab5d864691f0
+SHA512:
+  metadata.gz: 00414a12c119fe0832345c95699b4029e48796310c890d8ac69a165e6cf78d13a74ccf04923454747a6d570055cce9e57a15dc2012ca83c7f7c075f0d1575c0d
+  data.tar.gz: e765052ef4fa81bc6c91f9468e2151f0639548f7c1146c276700a62179d6a0c9197687ff6c178df2837fa00b18a78fe693ff51369b2802c4463fccf62fc9cbf3

data/lib/tiny_lb.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+# tiny_lb is an in-process load balancer. it works by acting as a proxy,
+# forwarding method calls to one of several downstream services based
+# on a user-provided strategy.
+#
+# use it in the following way:
+#   1. define your services; they should share a common public interface
+#   2. define a strategy; a strategy is any object that responds to a call to #tiny_lb, and returns 
+#   3. assemble the load balancer.
+#   4. use the load balancer as if it were one of your services.
+#
+# usage:
+#   class ProdSvc
+#     def do_work(payload)
+#       "prod svc handled: #{payload}"
+#     end
+#   end
+#
+#   class ExpSvc
+#     def do_work(payload)
+#       "exp svc handled: #{payload}"
+#     end
+#   end
+#
+#   class Rollout
+#     def initialize(percentage:)
+#       @percentage = percentage
+#     end
+#
+#     def tiny_lb(services)
+#       # services are ordered. services[0] is the primary, services[1]
+#       # is the new service being rolled out to.
+#       rand(1..100) <= @percentage ? services[1] : services[0]
+#     end
+#   end
+#
+#   services = [ProdSvc.new, ExpSvc.new]
+#   strategy = Rollout.new(percentage: 10) # 10% of traffic to ExpSvc
+#
+#   lb = TinyLb.new(services: services, strategy: strategy)
+#
+#   10.times do
+#     puts lb.do_work("my task")
+#   end
+#
+#   # output might look like this:
+#   #
+#   # prod svc handled: my task
+#   # prod svc handled: my task
+#   # exp svc handled: my task
+#   # prod svc handled: my task
+#   # prod svc handled: my task
+#   # prod svc handled: my task
+#   # prod svc handled: my task
+#   # prod svc handled: my task
+#   # prod svc handled: my task
+#   # prod svc handled: my task
+
+class TinyLb
+  def initialize(services:, strategy:)
+    @services = services
+    @strategy = strategy
+  end
+
+  def method_missing(method_name, *args, &block)
+    dest_svc = @strategy.tiny_lb(@services)
+    raise NoMethodError, "undefined method `#{method_name}' for an instance of #{dest_svc.class}" unless dest_svc.respond_to?(method_name)
+
+    dest_svc.public_send(method_name, *args, &block)
+  end
+end

metadata

@@ -0,0 +1,40 @@
+--- !ruby/object:Gem::Specification
+name: tiny_lb
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Jeff Lunt
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: an in-process load balancer
+email: jefflunt@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/tiny_lb.rb
+homepage: https://github.com/jefflunt/tiny_lb
+licenses:
+- MIT
+metadata: {}
+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: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: an in-process load balancer
+test_files: []