startback 0.11.4 → 0.11.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 929e1ab2d7ab916eadc828ecf2d1695c14c9a43d117198457e03c70c8b479ba4
-  data.tar.gz: 2f3d212acd31e00b1910aca3c3c1154a5e8a130962aeb002c184c6a70da17ab2
+  metadata.gz: fa9e440ddba682a1c59c98a5635b0febafe08222e9cee2de68d3262c6da6d8d4
+  data.tar.gz: '09a4748015aa374687c4016341d7f6a699d80718da7f9b4a6449294d69cf7897'
 SHA512:
-  metadata.gz: 90d448f505406727db9cd5c1db1d2fdb14b5df6ed546566ae9f3db4e573dbe43e43968f5885c9602c5ca198ceb8a7801aca769e499ef4d10acaaf2be318f779f
-  data.tar.gz: 01b21d439cc5b7d1c8ff218620b7eec13a8496919c941863df25d8d01f4d2c6d11b727a6c4269015ef61d1d8063ebe1487909c3b238c84c06c5211eccc568423
+  metadata.gz: 6f832ba94f865dfd66c372fcf19623c68f43c76019623fd49da96e88fa2c7355bc78916ae98f3ae32de7e4deb0f08d9ade5d7eb2b3fa9f9bebb5544c0de698d4
+  data.tar.gz: 6ec4e88b7f2bc2ffd58d6e0cddb5bfffc5411149b71a97d1a51e7195105bd907568b45afec40f47916c17dbc45dfe81a5e6432781fa821dbdb2b1ba47f614c86

data/lib/startback/event/agent.rb

@@ -0,0 +1,8 @@
+module Startback
+  class Event
+    class Agent
+      include Support::OperationRunner
+
+    end # class Agent
+  end # class Event
+end # module Starback

data/lib/startback/event/engine.rb

@@ -0,0 +1,100 @@
+require 'rack'
+require 'webrick'
+require 'startback'
+module Startback
+  class Event
+    #
+    # This class runs an infinite loop using ServerEngine.
+    # It is intended to be used to run jobs that listen to
+    # a Startback Bus instance without having the main process
+    # terminating immediately.
+    #
+    # The Engine automatically runs a Webrick small webapp
+    # with a /healthcheck webservice. The class can be extended
+    # and method `on_health_check` overriden to run specific
+    # checks.
+    #
+    # This class goes hand in hand with the `startback:engine`
+    # docker image.
+    #
+    # Example:
+    #
+    #     # Dockerfile
+    #     FROM enspirit/startback:engine-0.11
+    #
+    #     # engine.rb
+    #     require 'startback/event/engine'
+    #     Startback::Event::Engine.run
+    #
+    class Engine
+
+      DEFAULT_OPTIONS = {
+        daemonize: false,
+        worker_type: 'process',
+        workers: 1
+      }
+
+      def initialize
+        require 'serverengine'
+      end
+
+      def on_health_check
+        "Ok"
+      end
+
+      def run(options = {})
+        options = DEFAULT_OPTIONS.merge(options)
+        health = Engine.build_health_check(self)
+        worker = Engine.build_worker(health)
+        se = ServerEngine.create(nil, worker, options)
+        se.run
+        se
+      end
+
+      class << self
+        def run(*args, &bl)
+          new.run(*args, &bl)
+        end
+
+        def build_health_check(engine)
+          Rack::Builder.new do
+            map '/health-check' do
+              health = Startback::Web::HealthCheck.new {
+                engine.on_health_check
+              }
+              run(health)
+            end
+          end
+        end
+
+        def build_worker(health)
+          Module.new do
+            include Support::Env
+
+            def initialize
+              @stop_flag = ServerEngine::BlockingFlag.new
+            end
+
+            define_method(:health) do
+              health
+            end
+
+            def run
+              until @stop_flag.set?
+                Rack::Handler::WEBrick.run(health, {
+                  :Port => env('STARTBACK_ENGINE_PORT', '3000').to_i,
+                  :Host => env('STARTBACK_ENGINE_LISTEN', '0.0.0.0')
+                })
+              end
+            end
+
+            def stop
+              @stop_flag.set!
+              Rack::Handler::WEBrick.shutdown
+            end
+          end
+        end
+      end # class << self
+    end # class Engine
+  end # class Event
+end # module Startback

data/lib/startback/event.rb

@@ -41,3 +41,5 @@ module Startback
 
   end # class Event
 end # module Startback
+require_relative 'event/agent'
+require_relative 'event/engine'

data/lib/startback/support/env.rb

@@ -0,0 +1,41 @@
+module Startback
+  module Support
+    # This method provides the `env` and `env!` methods that
+    # help querying environment variables easily.
+    module Env
+
+      # Returns an environment variable or raise an error if
+      # not set.
+      #
+      # The result is always a String with no leading/trailing
+      # spaces.
+      #
+      # If a block is given, the environment variable is yield
+      # and the result of the block returned.
+      def env!(key, default = nil, &bl)
+        v = ENV[key].to_s.strip
+        raise Startback::Error, "Missing ENV var `#{key}`" if v.empty?
+
+        env(key, default, &bl)
+      end
+      module_function :env!
+
+      # Returns an environment variable or the default value
+      # passed as second argument.
+      #
+      # The result is always a String with no leading/trailing
+      # spaces.
+      #
+      # If a block is given, the environment variable is yield
+      # and the result of the block returned.
+      def env(key, default = nil, &bl)
+        v = ENV[key].to_s.strip
+        v = v.empty? ? default : v
+        v = bl.call(v) if bl && v
+        v
+      end
+      module_function :env
+
+    end # module Env
+  end # module Support
+end # module Startback

data/lib/startback/support/robustness.rb

@@ -43,7 +43,7 @@ module Startback
           @@default_logger ||= begin
             l = ::Logger.new(STDOUT)
             l.formatter = LogFormatter.new
-            l.warn(op: "#{self}", op_data: { msg: "Using default logger", trace: caller })
+            l.warn(op: "#{self}", op_data: { msg: "Using default logger to STDOUT" })
             @@default_logger = l
           end
           @@default_logger

data/lib/startback/support.rb

@@ -14,6 +14,7 @@ module Startback
 
   end # module Support
 end # module Startback
+require_relative 'support/env'
 require_relative 'support/log_formatter'
 require_relative 'support/logger'
 require_relative 'support/robustness'

data/lib/startback/version.rb

@@ -2,7 +2,7 @@ module Startback
   module Version
     MAJOR = 0
     MINOR = 11
-    TINY  = 4
+    TINY  = 5
   end
   VERSION = "#{Version::MAJOR}.#{Version::MINOR}.#{Version::TINY}"
 end

data/spec/unit/support/test_env.rb

@@ -0,0 +1,75 @@
+require 'spec_helper'
+module Startback
+  module Support
+    describe Env do
+      include Env
+
+      before do
+        ENV['FOO'] = 'BAR'
+        ENV['FOOL'] = ''
+        ENV['FOOLISH'] = ' BAR '
+      end
+
+      after do
+        ENV.delete('FOO')
+        ENV.delete('FOOL')
+      end
+
+      describe "env" do
+        it 'returns an env variable' do
+          expect(env('FOO')).to eql('BAR')
+        end
+
+        it 'returns nil otherwise' do
+          expect(env('BAR')).to be_nil
+        end
+
+        it 'strips the value' do
+          expect(env('FOOLISH')).to eql('BAR')
+        end
+
+        it 'yields the block if any' do
+          expect(env('FOO'){|x| x.downcase }).to eql('bar')
+        end
+
+        it 'support a default value' do
+          expect(env('BAR', 'BAZ')).to eql('BAZ')
+        end
+
+        it 'yields the block with the default if any' do
+          expect(env('BAR', 'BAZ'){|x| x.downcase }).to eql('baz')
+        end
+
+        it 'returns nil when empty' do
+          expect(env('FOOL')).to be_nil
+        end
+
+        it 'yields the block with the default if empty' do
+          expect(env('FOOL', 'BAZ'){|x| x.downcase }).to eql('baz')
+        end
+      end
+
+      describe "env!" do
+        it 'returns an env variable' do
+          expect(env!('FOO')).to eql('BAR')
+        end
+
+        it 'strips the value' do
+          expect(env!('FOOLISH')).to eql('BAR')
+        end
+
+        it 'raise otherwise' do
+          expect{ env!('BAR') }.to raise_error(Startback::Errors::Error, /BAR/)
+        end
+
+        it 'raise on empty' do
+          expect{ env!('FOOL') }.to raise_error(Startback::Errors::Error, /FOOL/)
+        end
+
+        it 'yields the block if any' do
+          expect(env('FOO'){|x| x.downcase }).to eql('bar')
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: startback
 version: !ruby/object:Gem::Version
-  version: 0.11.4
+  version: 0.11.5
 platform: ruby
 authors:
 - Bernard Lambeau
@@ -398,6 +398,8 @@ files:
 - lib/startback/context/middleware.rb
 - lib/startback/errors.rb
 - lib/startback/event.rb
+- lib/startback/event/agent.rb
+- lib/startback/event/engine.rb
 - lib/startback/ext.rb
 - lib/startback/ext/date_time.rb
 - lib/startback/ext/time.rb
@@ -405,6 +407,7 @@ files:
 - lib/startback/operation/error_operation.rb
 - lib/startback/operation/multi_operation.rb
 - lib/startback/support.rb
+- lib/startback/support/env.rb
 - lib/startback/support/fake_logger.rb
 - lib/startback/support/hooks.rb
 - lib/startback/support/log_formatter.rb
@@ -439,6 +442,7 @@ files:
 - spec/unit/support/hooks/test_before_hook.rb
 - spec/unit/support/operation_runner/test_around_run.rb
 - spec/unit/support/operation_runner/test_before_after_call.rb
+- spec/unit/support/test_env.rb
 - spec/unit/support/test_robusteness.rb
 - spec/unit/support/test_transaction_manager.rb
 - spec/unit/test_event.rb