coder_decorator 1.0.3 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: bd01c6c455219c669861df754a058c8a01ad5815
-  data.tar.gz: caf592360fa166d310733957549d2615dd0e9d26
+  metadata.gz: a423e4cf25574fb8fc664fb87cfd4aeb6141db36
+  data.tar.gz: a7a5deaa59f369953372cc6503fb4ad2d0123a76
 SHA512:
-  metadata.gz: 732e3a464d8d76e90e0782714423403d4ed941dae69198a82a9d4010cdbbc8deffd9e0349dec58a79629d9c28eb54391f41fbf633ad4fca04a235830331002be
-  data.tar.gz: 593c66383229d8f924e1509de5d432876cc1578376eb391af1191f8eb75ee69c340beddb9340ac4cf2d7baede41f192d94cbd5c63492ceb113b1bb347a7fe085
+  metadata.gz: 7cea41ab6d8ce21c5e5ae102a840bc6322aedc8c9ebff76eeb7fbb0797c2a9c5282628cc3fa4af48ebcb7a12bca71a8d8e56739bc545848eeb0abf143c463a3c
+  data.tar.gz: 4e9a7ced2ee8742b3111a6ace93c60fdb8db2ad5bbab87c466b4ad1f289880223e18418208f1d639822d6f40777c1d3612011ff1536eec33f4a1b12d53656a56

data/lib/coder_decorator/builder.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+require 'coder_decorator/name_converter'
+module CoderDecorator
+  # It provides a convenient interface to build a coder by passing arguments
+  # instead of tediously initializing and wrapping, for example:
+  #
+  #     require 'coder_decorator/builder'
+  #     CoderDecorator::Builder.build(:marshal, :base64)
+  #
+  # is equivalent to:
+  #
+  #     require 'coder_decorator/coders/marshal'
+  #     require 'coder_decorator/coders/base64'
+  #     CoderDecorator::Coders::Marshal.new(CoderDecorator::Coders::Base64.new)
+  #
+  # To pass arguments to a coder, use array:
+  #
+  #     CoderDecorator::Builder.build(:marshal, [:base64, {strict: true}])
+  #
+  class Builder
+    # equivalent to +new(*coder_names).build+
+    def self.build(*coder_names)
+      new(*coder_names).build
+    end
+
+    # all coder names are listed as filenames under +lib/coder_decorator/coders+,
+    def initialize(*coder_names)
+      @coder_names = coder_names
+    end
+
+    def build
+      coder = nil
+      @coder_names.each do |coder_name|
+        case coder_name
+        when String, Symbol, Array
+          name, *arguments = Array(coder_name)
+          coder_class = NameConverter.new(name).constantize
+          coder = coder_class.new(coder, *arguments)
+        else
+          raise ArgumentError, "Each argument should be one of Symbol, String or Array instance, but #{coder_name.inspect} was given."
+        end
+      end
+      coder
+    end
+  end
+end

data/lib/coder_decorator/name_converter.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+module CoderDecorator
+  # It converts coder names into class name or constant, for example:
+  #
+  #     NameConverter.new('base64').to_class_name # => 'Base64'
+  #     NameConverter.new('base64').constantize # => Coders::Base64
+  #     NameConverter.new('json').to_class_name # => 'JSON'
+  #     NameConverter.new('json').to_class_name # => Coders::JSON
+  #
+  class NameConverter
+    def initialize(coder_name)
+      @coder_name = coder_name.to_s
+    end
+
+    def constantize
+      @constantize ||= begin
+        require_relative "coders/#{@coder_name}"
+        CoderDecorator.const_get("Coders::#{to_class_name}")
+      rescue LoadError
+        raise "The coder \"#{@coder_name}\" doesn't exist, use `CoderDecorator.coder_names` to see all available coders."
+      end
+    end
+
+    def to_class_name
+      case @coder_name
+      when 'hmac', 'json' then @coder_name.upcase
+      else @coder_name.to_s.split('_').map!(&:capitalize!).join
+      end
+    end
+  end
+end

data/lib/coder_decorator.rb

@@ -1,3 +1,11 @@
 # frozen_string_literal: true
-module CoderDecorator; end # :nodoc:
+module CoderDecorator # :nodoc:
+  def self.coder_names
+    @coder_names ||= begin
+      coder_names = Dir["#{__dir__}/coder_decorator/coders/*"].map! { |name| File.basename(name, '.rb') }
+      coder_names.delete('coder')
+      coder_names
+    end
+  end
+end
 Dir[File.join(__dir__, 'coder_decorator', '**', '*.rb')].each { |path| require path }

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: coder_decorator
 version: !ruby/object:Gem::Version
-  version: 1.0.3
+  version: 1.1.0
 platform: ruby
 authors:
 - Jian Weihang
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-03-09 00:00:00.000000000 Z
+date: 2017-03-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
@@ -59,6 +59,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - lib/coder_decorator.rb
+- lib/coder_decorator/builder.rb
 - lib/coder_decorator/coders/base64.rb
 - lib/coder_decorator/coders/cipher.rb
 - lib/coder_decorator/coders/coder.rb
@@ -69,6 +70,7 @@ files:
 - lib/coder_decorator/coders/rescue.rb
 - lib/coder_decorator/coders/zip.rb
 - lib/coder_decorator/errors.rb
+- lib/coder_decorator/name_converter.rb
 homepage: 
 licenses:
 - MIT