start_her 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 89af5e5e0b4dece5596bbb0acd862628bb473bf5
+  data.tar.gz: cb1717a5d3d44ec220c86a128eccb1a082d6b2d0
+SHA512:
+  metadata.gz: 812cd8c890e422de9c379118717c8f17e6fb9258a28c26d4b7edcafc2fcc6b96e042c25baad0a7e331ffe14a4071c137fb590945b7ebde3656376ade30a82466
+  data.tar.gz: e410c7c43dea121c02e1456779480c8a9224d694b5f1b6067568f861b009c838a5561997305ebccee9b72149dc3a3c77c76ef79d1c6dad03cf346f9f18f08979

data/.gitignore

@@ -0,0 +1,19 @@
+# See https://help.github.com/articles/ignoring-files for more about ignoring files.
+#
+# If you find yourself ignoring temporary files generated by your text editor
+# or operating system, you probably want to add a global ignore instead:
+#   git config --global core.excludesfile '~/.gitignore_global'
+
+# Ignore bundler config.
+/.bundle
+
+# Ignore the default SQLite database.
+/db/*.sqlite3
+/db/*.sqlite3-journal
+
+# Ignore all logfiles and tempfiles.
+/log/*.log
+/tmp
+/public
+/storage
+/pkg

data/.rubocop.yml

@@ -0,0 +1,485 @@
+# https://github.com/bbatsov/rubocop/tree/master/config
+# => default.yml
+# => disabled.yml
+# => enabled.yml
+
+# This is the default configuration file. Enabling and disabling is configured
+# in separate files. This file adds all other parameters apart from Enabled.
+
+# inherit_from:
+#   - enabled.yml
+#   - disabled.yml
+
+# Common configuration.
+AllCops:
+  # Include gemspec and Rakefile
+  Include:
+    - '**/*.gemspec'
+    - '**/Rakefile'
+  Exclude:
+    - 'db/**/*'
+    - 'bin/**/*'
+    - 'vendor/**/*'
+  # By default, the rails cops are not run. Override in project or home
+  # directory .rubocop.yml files, or by giving the -R/--rails option.
+  RunRailsCops: true
+
+# Indent private/protected/public as deep as method definitions
+AccessModifierIndentation:
+  EnforcedStyle: indent
+  SupportedStyles:
+    - outdent
+    - indent
+
+# Align the elements of a hash literal if they span more than one line.
+AlignHash:
+  # Alignment of entries using hash rocket as separator. Valid values are:
+  #
+  # key - left alignment of keys
+  #   'a' => 2
+  #   'bb' => 3
+  # separator - alignment of hash rockets, keys are right aligned
+  #    'a' => 2
+  #   'bb' => 3
+  # table - left alignment of keys, hash rockets, and values
+  #   'a'  => 2
+  #   'bb' => 3
+  EnforcedHashRocketStyle: key
+  # Alignment of entries using colon as separator. Valid values are:
+  #
+  # key - left alignment of keys
+  #   a: 0
+  #   bb: 1
+  # separator - alignment of colons, keys are right aligned
+  #    a: 0
+  #   bb: 1
+  # table - left alignment of keys and values
+  #   a:  0
+  #   bb: 1
+  EnforcedColonStyle: key
+  # Select whether hashes that are the last argument in a method call should be
+  # inspected? Valid values are:
+  #
+  # always_inspect - Inspect both implicit and explicit hashes.
+  #   Registers and offence for:
+  #     function(a: 1,
+  #       b: 2)
+  #   Registers an offence for:
+  #     function({a: 1,
+  #       b: 2})
+  # always_ignore - Ignore both implicit and explicit hashes.
+  #   Accepts:
+  #     function(a: 1,
+  #       b: 2)
+  #   Accepts:
+  #     function({a: 1,
+  #       b: 2})
+  # ignore_implicit - Ingore only implicit hashes.
+  #   Accepts:
+  #     function(a: 1,
+  #       b: 2)
+  #   Registers an offence for:
+  #     function({a: 1,
+  #       b: 2})
+  # ignore_explicit - Ingore only explicit hashes.
+  #   Accepts:
+  #     function({a: 1,
+  #       b: 2})
+  #   Registers an offence for:
+  #     function(a: 1,
+  #       b: 2)
+  EnforcedLastArgumentHashStyle: always_inspect
+  SupportedLastArgumentHashStyles:
+    - always_inspect
+    - always_ignore
+    - ignore_implicit
+    - ignore_explicit
+
+AlignParameters:
+  # Alignment of parameters in multi-line method calls.
+  #
+  # The `with_first_parameter` style aligns the following lines along the same column
+  # as the first parameter.
+  #
+  #     method_call(a,
+  #                 b)
+  #
+  # The `with_fixed_indentation` style alignes the following lines with one
+  # level of indenation relative to the start of the line with the method call.
+  #
+  #     method_call(a,
+  #       b)
+  EnforcedStyle: with_first_parameter
+  SupportedStyles:
+    - with_first_parameter
+    - with_fixed_indentation
+
+# Allow safe assignment in conditions.
+AssignmentInCondition:
+  AllowSafeAssignment: true
+
+AmbiguousOperator:
+  Enabled: false
+
+BlockNesting:
+  Max: 3
+
+BracesAroundHashParameters:
+  EnforcedStyle: no_braces
+  SupportedStyles:
+    - braces
+    - no_braces
+
+# Indentation of `when`.
+CaseIndentation:
+  IndentWhenRelativeTo: case
+  SupportedStyles:
+    - case
+    - end
+  IndentOneStep: false
+
+ClassAndModuleChildren:
+  # Checks the style of children definitions at classes and modules.
+  #
+  # Basically there are two different styles:
+  #
+  # `nested` - have each child on a separat line
+  #   class Foo
+  #     class Bar
+  #     end
+  #   end
+  #
+  # `compact` - combine definitions as much as possible
+  #   class Foo::Bar
+  #   end
+  #
+  # The compact style is only forced, for classes / modules with one child.
+  EnforcedStyle: nested
+  SupportedStyles:
+    - nested
+    - compact
+
+ClassLength:
+  CountComments: false  # count full line comments?
+  Max: 100
+
+# Align with the style guide.
+CollectionMethods:
+  PreferredMethods:
+    collect: 'map'
+    collect!: 'map!'
+    inject: 'reduce'
+    detect: 'find'
+    find_all: 'select'
+
+# Checks formatting of special comments
+CommentAnnotation:
+  Keywords:
+    - TODO
+    - FIXME
+    - OPTIMIZE
+    - HACK
+    - REVIEW
+
+# Avoid complex methods.
+CyclomaticComplexity:
+  Max: 6
+
+# Multi-line method chaining should be done with leading dots.
+DotPosition:
+  EnforcedStyle: leading
+  SupportedStyles:
+    - leading
+    - trailing
+
+# Use empty lines between defs.
+EmptyLineBetweenDefs:
+  # If true, this parameter means that single line method definitions don't
+  # need an empty line between them.
+  AllowAdjacentOneLineDefs: false
+
+# Align ends correctly.
+EndAlignment:
+  # The value `keyword` means that `end` should be aligned with the matching
+  # keyword (if, while, etc.).
+  # The value `variable` means that in assignments, `end` should be aligned
+  # with the start of the variable on the left hand side of `=`. In all other
+  # situations, `end` should still be aligned with the keyword.
+  AlignWith: keyword
+  SupportedStyles:
+    - keyword
+    - variable
+
+FileName:
+  Exclude:
+    - Rakefile
+    - Gemfile
+    - Capfile
+
+# Checks use of for or each in multiline loops.
+For:
+  EnforcedStyle: each
+  SupportedStyles:
+    - for
+    - each
+
+# Enforce the method used for string formatting.
+FormatString:
+  EnforcedStyle: format
+  SupportedStyles:
+    - format
+    - sprintf
+    - percent
+
+# Built-in global variables are allowed by default.
+GlobalVars:
+  AllowedVariables: []
+
+HashSyntax:
+  EnforcedStyle: ruby19
+  SupportedStyles:
+    - ruby19
+    - hash_rockets
+
+IfUnlessModifier:
+  MaxLineLength: 99
+
+# Checks the indentation of the first key in a hash literal.
+IndentHash:
+  # The value `special_inside_parentheses` means that hash literals with braces
+  # that have their opening brace on the same line as a surrounding opening
+  # round parenthesis, shall have their first key indented relative to the
+  # first position inside the parenthesis.
+  # The value `consistent` means that the indentation of the first key shall
+  # always be relative to the first position of the line where the opening
+  # brace is.
+  EnforcedStyle: special_inside_parentheses
+  SupportedStyles:
+    - special_inside_parentheses
+    - consistent
+
+LambdaCall:
+  EnforcedStyle: call
+  SupportedStyles:
+    - call
+    - braces
+
+LineLength:
+  Max: 99
+
+MethodDefParentheses:
+  EnforcedStyle: require_parentheses
+  SupportedStyles:
+    - require_parentheses
+    - require_no_parentheses
+
+MethodLength:
+  CountComments: false  # count full line comments?
+  Max: 16
+
+MethodName:
+  EnforcedStyle: snake_case
+  SupportedStyles:
+    - snake_case
+    - camelCase
+
+NumericLiterals:
+  MinDigits: 5
+
+ParameterLists:
+  Max: 5
+  CountKeywordArgs: true
+
+# Allow safe assignment in conditions.
+ParenthesesAroundCondition:
+  AllowSafeAssignment: true
+
+PercentLiteralDelimiters:
+  PreferredDelimiters:
+    '%':  ()
+    '%i': ()
+    '%q': ()
+    '%Q': ()
+    '%r': '{}'
+    '%s': ()
+    '%w': ()
+    '%W': ()
+    '%x': ()
+
+PredicateName:
+  NamePrefixBlacklist:
+    - is_
+    - has_
+    - have_
+
+RaiseArgs:
+  EnforcedStyle: exploded
+  SupportedStyles:
+    - compact # raise Exception.new(msg)
+    - exploded # raise Exception, msg
+
+
+RedundantReturn:
+  # When true allows code like `return x, y`.
+  AllowMultipleReturnValues: false
+
+RedundantSelf:
+  Description: "Don't use self where it's not needed."
+  Enabled: false
+
+RegexpLiteral:
+  # The maximum number of (escaped) slashes that a slash-delimited regexp is
+  # allowed to have. If there are more slashes, a %r regexp shall be used.
+  MaxSlashes: 1
+  Enabled: false
+
+Semicolon:
+  # Allow ; to separate several expressions on the same line.
+  AllowAsExpressionSeparator: false
+
+SignalException:
+  EnforcedStyle: semantic
+  SupportedStyles:
+    - only_raise
+    - only_fail
+    - semantic
+
+
+SingleLineBlockParams:
+  Methods:
+    - reduce:
+        - a
+        - e
+    - inject:
+        - a
+        - e
+
+SingleLineMethods:
+  AllowIfMethodIsEmpty: true
+
+StringLiterals:
+  EnforcedStyle: single_quotes
+  SupportedStyles:
+    - single_quotes
+    - double_quotes
+
+SpaceAroundEqualsInParameterDefault:
+  EnforcedStyle: space
+  SupportedStyles:
+    - space
+    - no_space
+
+SpaceBeforeBlockBraces:
+  EnforcedStyle: space
+  SupportedStyles:
+    - space
+    - no_space
+
+SpaceInsideBlockBraces:
+  EnforcedStyle: space
+  SupportedStyles:
+    - space
+    - no_space
+  # Valid values are: space, no_space
+  EnforcedStyleForEmptyBraces: no_space
+  # Space between { and |. Overrides EnforcedStyle if there is a conflict.
+  SpaceBeforeBlockParameters: true
+
+SpaceInsideHashLiteralBraces:
+  EnforcedStyle: space
+  EnforcedStyleForEmptyBraces: no_space
+  SupportedStyles:
+    - space
+    - no_space
+
+TrailingComma:
+  EnforcedStyleForMultiline: no_comma
+  SupportedStyles:
+    - comma
+    - no_comma
+
+# TrivialAccessors doesn't require exact name matches and doesn't allow
+# predicated methods by default.
+TrivialAccessors:
+  ExactNameMatch: false
+  AllowPredicates: false
+  Whitelist:
+    - to_ary
+    - to_a
+    - to_c
+    - to_enum
+    - to_h
+    - to_hash
+    - to_i
+    - to_int
+    - to_io
+    - to_open
+    - to_path
+    - to_proc
+    - to_r
+    - to_regexp
+    - to_str
+    - to_s
+    - to_sym
+
+VariableName:
+  EnforcedStyle: snake_case
+  SupportedStyles:
+    - snake_case
+    - camelCase
+
+WhileUntilModifier:
+  MaxLineLength: 79
+
+WordArray:
+  MinSize: 0
+
+Documentation:
+  Enabled: false
+
+# Compact name spaces
+ClassAndModuleChildren:
+  Enabled: false
+
+AlignParameters:
+  Enabled: false
+
+# Unrecognize fail/raise args with custom erors
+RaiseArgs:
+  EnforcedStyle: compact
+
+##################### Rails ##################################
+
+ActionFilter:
+  EnforcedStyle: action
+  SupportedStyles:
+    - action
+    - filter
+  Include:
+    - app/controllers/*.rb
+
+DefaultScope:
+  Include:
+    - app/models/*.rb
+
+HasAndBelongsToMany:
+  Include:
+    - app/models/*.rb
+
+ReadWriteAttribute:
+  Include:
+    - app/models/*.rb
+
+ScopeArgs:
+  Include:
+    - app/models/*.rb
+
+Validation:
+  Include:
+    - app/models/*.rb
+
+Encoding:
+  Enabled: false
+
+HasAndBelongsToMany:
+  Enabled: false

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,67 @@
+PATH
+  remote: .
+  specs:
+    start_her (0.0.1)
+      gemsupport (~> 0.4)
+      logstash-logger (~> 0.15)
+      msgpack (~> 0.7)
+      redis (~> 3.2)
+      redis-namespace (~> 1.5)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.1.0)
+    astrolabe (1.3.1)
+      parser (~> 2.2)
+    coderay (1.1.0)
+    diff-lcs (1.2.5)
+    gemsupport (0.4.1)
+    logstash-event (1.2.02)
+    logstash-logger (0.15.1)
+      logstash-event (~> 1.2)
+      stud
+    method_source (0.8.2)
+    msgpack (0.7.0)
+    parser (2.2.3.0)
+      ast (>= 1.1, < 3.0)
+    powerpack (0.1.1)
+    pry (0.10.3)
+      coderay (~> 1.1.0)
+      method_source (~> 0.8.1)
+      slop (~> 3.4)
+    rainbow (2.0.0)
+    redis (3.2.1)
+    redis-namespace (1.5.2)
+      redis (~> 3.0, >= 3.0.4)
+    rspec (3.3.0)
+      rspec-core (~> 3.3.0)
+      rspec-expectations (~> 3.3.0)
+      rspec-mocks (~> 3.3.0)
+    rspec-core (3.3.2)
+      rspec-support (~> 3.3.0)
+    rspec-expectations (3.3.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.3.0)
+    rspec-mocks (3.3.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.3.0)
+    rspec-support (3.3.0)
+    rubocop (0.29.1)
+      astrolabe (~> 1.3)
+      parser (>= 2.2.0.1, < 3.0)
+      powerpack (~> 0.1)
+      rainbow (>= 1.99.1, < 3.0)
+      ruby-progressbar (~> 1.4)
+    ruby-progressbar (1.7.5)
+    slop (3.6.0)
+    stud (0.0.22)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  pry (~> 0.10)
+  rspec (~> 3.3)
+  rubocop (~> 0.29)
+  start_her!

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2015 PredicSis (MIT)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,68 @@
+[![Circle CI](https://circleci.com/gh/PredicSis/start_her/tree/master.svg?style=shield)](https://circleci.com/gh/PredicSis/start_her/tree/master)
+
+# StartHer
+Microservices common stuff. Implement redis subscription and logging strategy.
+
+## Requirements
+
+- Ruby >= 2.2
+- Redis >= 2.8
+
+## Installation
+
+```ruby
+gem 'start_her'
+```
+
+## Configuration
+
+```ruby
+require 'start_her'
+
+StartHer.configure do |config|
+  config.redis = {
+    url: 'redis://localhost:6379',
+    namespace: 'namespace'
+    db: 1
+  }
+  config.logger = StartHer::Logger.instance # default
+  config.logstash_url = 'redis://localhost:6379' # if using default logger in production
+end
+```
+
+## Usage
+
+```bash
+bundle exec starther ./lib/path/to/subscriber.rb
+```
+
+**Note**: You need to put your `subscriber.rb` file into the `lib` directory.
+
+## Subscriber class
+
+```ruby
+class Subscriber
+  include StartHer::Subscriber
+
+  subscriber_options channels: ['channel_one', 'channel_two']
+  subscriber_error do |error|
+    # do something with error
+  end
+
+  def process_message(channel, message)
+    # your custom stuff here
+  end
+end
+```
+
+## LICENSE
+
+MIT
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (git checkout -b my-new-feature)
+3. Commit your changes (git commit -am 'Add some feature')
+4. Push to the branch (git push origin my-new-feature)
+5. Create new Pull Request

data/bin/starther

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+
+begin
+  # use `bundle install --standalone' to get this...
+  require_relative '../bundle/bundler/setup'
+rescue LoadError
+  # fall back to regular bundler if the developer hasn't bundled standalone
+  require 'bundler'
+  Bundler.setup
+end
+
+require_relative '../lib/start_her'
+
+$stdout.sync = true
+load ARGV.last
+Object.const_get(ARGV.last.split('lib/').last.split('.rb').first.camelize).run!

data/circle.yml

@@ -0,0 +1,9 @@
+machine:
+  ruby:
+    version: 2.2.2
+
+test:
+  pre:
+    - bundle exec rubocop
+  override:
+    - bundle exec rspec

data/lib/start_her.rb

@@ -0,0 +1,32 @@
+require 'forwardable'
+require 'gemsupport'
+require 'start_her/configuration'
+require 'start_her/logger'
+require 'start_her/retry_policies'
+
+module StartHer
+  module_function
+
+  extend SingleForwardable
+
+  attr_accessor :config
+
+  def config
+    @config ||= Configuration.new
+  end
+  delegate logger: :config
+
+  def configure
+    yield config
+  end
+
+  def env
+    (ENV['RACK_ENV'] || ENV['RAILS_ENV'] || 'development').tap do |e|
+      fail 'Invalid environment name' unless %w(development test staging production).include?(e)
+    end
+  end
+
+  # Safe loading for stuff that needs MailHer#config
+  autoload :RedisClient, 'start_her/redis_client'
+  autoload :Subscriber, 'start_her/subscriber'
+end

data/lib/start_her/configuration.rb

@@ -0,0 +1,15 @@
+module StartHer
+  class Configuration
+    attr_accessor :redis, :logstash_url
+    attr_writer :logger
+
+    def initialize
+      @redis = {}
+      @logstash_url = ''
+    end
+
+    def logger
+      @logger ||= StartHer::Logger.instance
+    end
+  end
+end

data/lib/start_her/logger.rb

@@ -0,0 +1,32 @@
+require 'logstash-logger'
+
+module StartHer
+  module Logger
+    module_function
+
+    def instance
+      send(StartHer.env)
+    end
+
+    def development
+      LogStashLogger.new(type: :multi_delegator, outputs: [
+        { type: :stdout },
+        { type: :file, path: 'log/development.log', sync: true }
+      ], formatter: ::Logger::Formatter)
+    end
+
+    def production
+      LogStashLogger.new(
+        type: :redis, url: StartHer.config.logstash_url, sync: true).tap do |logger|
+        logger.level = ::Logger::INFO
+      end
+    end
+    class << self
+      alias_method :staging, :production
+    end
+
+    def test
+      LogStashLogger.new(type: :stdout, formatter: ::Logger::Formatter)
+    end
+  end
+end

data/lib/start_her/redis_client.rb

@@ -0,0 +1,35 @@
+require 'redis'
+require 'redis-namespace'
+require 'msgpack'
+
+module StartHer
+  module RedisClient
+    include StartHer::RetryPolicies
+
+    MQ_DEFAULTS = StartHer.config.redis
+
+    private
+
+    def client(options = {})
+      options = client_opts(options)
+      client = ::Redis.new(options)
+
+      if (namespace = options[:namespace])
+        ::Redis::Namespace.new(namespace, redis: client)
+      else
+        client
+      end
+    end
+
+    def client_opts(options)
+      MQ_DEFAULTS.merge(options).dup.tap do |opts|
+        if opts[:network_timeout]
+          opts[:timeout] = opts[:network_timeout]
+          opts.delete(:network_timeout)
+        end
+
+        opts[:driver] = opts[:driver] || 'ruby'
+      end
+    end
+  end
+end

data/lib/start_her/retry_policies.rb

@@ -0,0 +1,27 @@
+module StartHer
+  module RetryPolicies
+    # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
+    def exponential_backoff(opts = {}, *exception_classes)
+      options = { elapsed_time_secs: 600, multiplier: 2 }
+      options.merge!(opts)
+
+      time = 0.2
+      started_at = Time.now.utc
+
+      begin
+        yield
+      rescue *exception_classes => ex
+        raise ex if (Time.now.utc - started_at) >= options[:elapsed_time_secs]
+        sleep(time)
+
+        time *= options[:multiplier]
+        if (Time.now.utc - started_at) + time >= options[:elapsed_time_secs]
+          time = options[:elapsed_time_secs] - (Time.now.utc - started_at)
+        end
+
+        retry
+      end
+    end
+    # rubocop:enable Metrics/AbcSize,Metrics/MethodLength
+  end
+end

data/lib/start_her/subscriber.rb

@@ -0,0 +1,62 @@
+module StartHer
+  module Subscriber
+    include StartHer::RedisClient
+
+    DEFAULT_OPTS = { channels: ['*'] }
+    DEFAULT_ERROR_BLOCK = lambda do |e|
+      StartHer.logger.error e
+    end
+
+    def self.included(base)
+      base.extend(ClassMethods)
+    end
+
+    module ClassMethods
+      attr_accessor :subscriber_options_hash, :subscriber_error_block
+
+      def run!
+        new.tap do |instance|
+          instance.psubscribe(subscriber_options_hash[:channels]) do |channel, message|
+            begin
+              instance.process_message(channel, message)
+            rescue => e
+              if block_given?
+                subscriber_error_block.call(e)
+              else
+                DEFAULT_ERROR_BLOCK.call(e)
+              end
+            end
+          end
+        end
+      end
+
+      def subscriber_error(&block)
+        self.subscriber_error_block = block
+      end
+
+      def subscriber_options(opts = {})
+        self.subscriber_options_hash = DEFAULT_OPTS.merge(opts)
+      end
+    end
+
+    # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
+    def psubscribe(channels, &block)
+      exponential_backoff({}, ::Redis::BaseConnectionError) do
+        client.psubscribe(*channels) do |on|
+          on.psubscribe do |channel, _|
+            StartHer.logger.info "PSuscribe on #{channel}"
+          end
+
+          on.pmessage do |_pattern, channel, message|
+            chan = channel.include?(':') ? channel.split(':').last : channel
+            block.call(chan, MessagePack.unpack(message))
+          end
+        end
+      end
+    rescue => e
+      StartHer.logger.error e
+      raise e
+    end
+    # rubocop:enable Metrics/AbcSize,Metrics/MethodLength
+  end
+end

data/lib/start_her/version.rb

@@ -0,0 +1,3 @@
+module StartHer
+  VERSION = '0.0.1'
+end

data/spec/spec_helper.rb

@@ -0,0 +1,14 @@
+require 'start_her'
+
+ENV['RACK_ENV'] ||= 'test'
+
+ROOT_SPEC = File.join(File.dirname(__FILE__), '../')
+Dir[File.join(ROOT_SPEC, 'spec', 'support', '**', '*.rb')].each { |f| require f }
+
+RSpec.configure do |config|
+  config.include Gemsupport::Error
+
+  config.order = 'random'
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+end

data/spec/start_her/redis_client_spec.rb

@@ -0,0 +1,37 @@
+require 'spec_helper'
+
+module StartHer
+  describe RedisClient do
+    class RedisClientTest
+      include RedisClient
+    end
+
+    subject { RedisClientTest.new }
+
+    describe '#client' do
+      context 'with all options' do
+        let(:options) { { namespace: 'namespace:', db: 1, url: 'redis://localhost:6379' } }
+
+        it 'instanciates a Redis::Namespace client' do
+          expect(subject.send(:client, options)).to be_an_instance_of Redis::Namespace
+        end
+      end
+
+      context 'without namespace' do
+        let(:options) { { db: 1, url: 'redis://localhost:6379' } }
+
+        it 'instanciates a Redis client' do
+          expect(subject.send(:client, options)).to be_an_instance_of Redis
+        end
+      end
+
+      context 'without any options' do
+        let(:options) { {} }
+
+        it 'instanciates a Redis client' do
+          expect(subject.send(:client, options)).to be_an_instance_of Redis
+        end
+      end
+    end
+  end
+end

data/spec/start_her/retry_policies_spec.rb

@@ -0,0 +1,45 @@
+require 'spec_helper'
+
+module StartHer
+  describe RetryPolicies do
+    describe '#exponential_backoff' do
+      let(:dummy_class) { Class.new.extend(RetryPolicies) }
+      let(:options) { { elapsed_time_secs: 1, multiplier: 2 } }
+
+      it 'updates time with defined policy' do
+        retries_time = []
+        started_at = Time.now.utc
+        CustomHelpers.suppress(RuntimeError) do
+          dummy_class.exponential_backoff(options, RuntimeError) do
+            retries_time << CustomHelpers.truncate_float(Time.now.utc - started_at, 1)
+            fail RuntimeError.new('The error')
+          end
+        end
+        expect(retries_time).to contain_exactly(0.0, 0.2, 0.6, 1.0)
+      end
+
+      context 'when retry policy ends' do
+        let(:options) { { elapsed_time_secs: 0.4, multiplier: 2 } }
+        let(:exponential_backoff) do
+          lambda do |options|
+            dummy_class.exponential_backoff(options, RuntimeError) do
+              fail RuntimeError.new('The tested error')
+            end
+          end
+        end
+
+        it 'stops at elapsed time' do
+          started_at = Time.now.utc
+          CustomHelpers.suppress(RuntimeError) do
+            exponential_backoff.call(options)
+          end
+          expect((Time.now.utc - started_at).round(2)).to eq(options[:elapsed_time_secs])
+        end
+
+        it 'raises an error' do
+          expect { exponential_backoff.call(options) }.to raise_error(RuntimeError)
+        end
+      end
+    end
+  end
+end

data/spec/start_her/subscriber_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+
+module StartHer
+  describe Subscriber do
+    let(:channels) { ['channel'] }
+
+    class TestSubscriber
+      include Subscriber
+
+      subscriber_options channels: ['channel']
+
+      def process_message(_channel, _message)
+      end
+    end
+
+    describe '.run!' do
+      it 'subscribes to channels' do
+        expect_any_instance_of(Subscriber).to receive(:psubscribe).with(channels)
+        TestSubscriber.run!
+      end
+    end
+  end
+end

data/spec/start_her_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+
+describe StartHer do
+  describe '.env' do
+    it 'returns the current environment' do
+      expect(StartHer.env).to eq('test')
+    end
+
+    context 'when env is invalid' do
+      before { ENV['RACK_ENV'] = 'trololo' }
+      after { ENV['RACK_ENV'] = 'test' }
+
+      it 'raises an error' do
+        expect { StartHer.env }.to raise_error(RuntimeError, 'Invalid environment name')
+      end
+    end
+  end
+
+  describe '.config' do
+    it 'returns an option Hash' do
+      expect(StartHer.config).to be_an_instance_of(StartHer::Configuration)
+    end
+  end
+
+  describe '.logger' do
+    it 'returns an instance of logger' do
+      expect(StartHer.logger).to be_a(LogStashLogger)
+    end
+  end
+end

data/spec/support/custom_helpers.rb

@@ -0,0 +1,10 @@
+module CustomHelpers
+  include Gemsupport::Error
+
+  module_function
+
+  # truncate_float(0.987654, 2) => 0.97
+  def truncate_float(value, precision)
+    (value * 10**precision).floor / (10**precision).to_f
+  end
+end

data/start_her.gemspec

@@ -0,0 +1,39 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'start_her/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'start_her'
+  spec.version       = StartHer::VERSION
+  spec.authors       = %w(abourquin mdouchement)
+  spec.email         = %w(armand.bourquin@predicsis.com marc.douchement@predicsis.com)
+  spec.summary       = 'StartHer'
+  spec.description   = 'Micro-service starter'
+  spec.homepage      = 'https://github.com/PredicSis/start_her'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = ['starther']
+  spec.test_files    = spec.files.grep(%(r{^(test|spec|features)/}))
+  spec.require_paths = ['lib']
+
+  spec.required_ruby_version = '>= 2.0'
+
+  # Redis
+  spec.add_dependency 'redis', '~> 3.2'
+  spec.add_dependency 'redis-namespace', '~> 1.5'
+  spec.add_dependency 'msgpack', '~> 0.7'
+
+  # Logs
+  spec.add_dependency 'logstash-logger', '~> 0.15'
+
+  # Helper
+  spec.add_dependency 'gemsupport', '~> 0.4'
+
+  # Rspec
+  spec.add_development_dependency 'rspec', '~> 3.3'
+  spec.add_development_dependency 'rubocop', '~> 0.29'
+  spec.add_development_dependency 'pry', '~> 0.10'
+end

metadata

@@ -0,0 +1,182 @@
+--- !ruby/object:Gem::Specification
+name: start_her
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- abourquin
+- mdouchement
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-11-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: redis
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: redis-namespace
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: msgpack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: logstash-logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.15'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.15'
+- !ruby/object:Gem::Dependency
+  name: gemsupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.29'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.29'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+description: Micro-service starter
+email:
+- armand.bourquin@predicsis.com
+- marc.douchement@predicsis.com
+executables:
+- starther
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rubocop.yml"
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- bin/starther
+- circle.yml
+- lib/start_her.rb
+- lib/start_her/configuration.rb
+- lib/start_her/logger.rb
+- lib/start_her/redis_client.rb
+- lib/start_her/retry_policies.rb
+- lib/start_her/subscriber.rb
+- lib/start_her/version.rb
+- spec/spec_helper.rb
+- spec/start_her/redis_client_spec.rb
+- spec/start_her/retry_policies_spec.rb
+- spec/start_her/subscriber_spec.rb
+- spec/start_her_spec.rb
+- spec/support/custom_helpers.rb
+- start_her.gemspec
+homepage: https://github.com/PredicSis/start_her
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: StartHer
+test_files: []
+has_rdoc: