dh_easy-router 0.0.6

data/lib/dh_easy/router.rb

@@ -0,0 +1,14 @@
+require 'yaml'
+require 'dh_easy/core'
+require 'dh_easy/config'
+require 'dh_easy_override/core'
+require 'dh_easy/router/version'
+require 'dh_easy/router/plugin'
+require 'dh_easy/router/parser'
+require 'dh_easy/router/seeder'
+require 'dh_easy/router/finisher'
+
+module DhEasy
+  module Router
+  end
+end

data/lib/dh_easy/router/finisher.rb

@@ -0,0 +1,38 @@
+module DhEasy
+  module Router
+    # Finisher router designed to execute all finisher classes.
+    class Finisher
+      include DhEasy::Router::Plugin::Router
+
+      # Execute the finisher class with options as described by router
+      #   configuration and calling class's instance `finish` method.
+      #
+      # @param [Hash] opts ({}) Finisher initializer options (see
+      #   DhEasy::Core::Plugin::Finisher).
+      #
+      # @raise [ArgumentError] `opts[:context]` is `nil`.
+      # @raise [ArgumentError] `page_type` doesn't exists within routes.
+      # @raise [NameError] A class with name equal to route's `class` attribute
+      #   doesn't exists.
+      #
+      # @note Requires the route class to implement `finish` instance method.
+      def route opts = {}
+        context = opts[:context]
+        if opts[:context].nil?
+          raise ArgumentError.new('Must send a context to the finisher.')
+        end
+
+        class_name = nil
+        config['finisher']['routes'].each do |item|
+          # Validate class name
+          executor_class = get_class item['class']
+          if executor_class.nil?
+            raise NameError.new("Class \"#{item['class']}\" doesn't exists, check your ae_easy config file.")
+          end
+
+          executor_class.new(opts).finish
+        end
+      end
+    end
+  end
+end

data/lib/dh_easy/router/parser.rb

@@ -0,0 +1,48 @@
+module DhEasy
+  module Router
+    # Parser router designed to look over page_type for route to the right
+    #   parser class.
+    class Parser
+      include DhEasy::Router::Plugin::Router
+
+      # Execute the parser class with options as described by router
+      #   configuration filtering by `page_type` and calling class's instance
+      #   `parse` method.
+      #
+      # @param [Hash] opts ({}) Parser initializer options (see
+      #   DhEasy::Core::Plugin::Parser).
+      #
+      # @raise [ArgumentError] `opts[:context]` is `nil`.
+      # @raise [ArgumentError] `page_type` doesn't exists within routes.
+      # @raise [NameError] A class with name equal to route's `class` attribute
+      #   doesn't exists.
+      #
+      # @note Requires the route class to implement `parse` instance method.
+      def route opts = {}
+        context = opts[:context]
+        if context.nil?
+          raise ArgumentError.new('Must send a context to the parser.')
+        end
+
+        page_type = context.page['page_type'].strip.downcase
+        class_name = nil
+        config['parser']['routes'].each do |item|
+          # Look for page type
+          next if item['page_type'].strip.downcase != page_type
+
+          # Validate class name
+          executor_class = get_class item['class']
+          if executor_class.nil?
+            raise NameError.new("Class \"#{item['class']}\" doesn't exists, check your dh_easy config file.")
+          end
+
+          executor_class.new(opts).parse
+          return
+        end
+
+        # Page type is not routed, raise an error.
+        raise ArgumentError.new("Page type \"#{page_type}\" is not routed, check your dh_easy config file.")
+      end
+    end
+  end
+end

data/lib/dh_easy/router/plugin.rb

@@ -0,0 +1,8 @@
+require 'dh_easy/router/plugin/router'
+
+module DhEasy
+  module Router
+    module Plugin
+    end
+  end
+end

data/lib/dh_easy/router/plugin/router.rb

@@ -0,0 +1,74 @@
+module DhEasy
+  module Router
+    module Plugin
+      # Base router providing the basic functionalities from a router.
+      module Router
+        include DhEasy::Core::Plugin::InitializeHook
+
+        # Local configuration (see DhEasy::Core::Config).
+        attr_reader :local_config
+
+        # Hook to initialize router configuration.
+        #
+        # @param [Hash] opts ({}) Configuration options.
+        # @option opts [DhEasy::Config::Local,nil] :config (nil) Configuration to
+        #   use.
+        # @option opts [String] :config_file_path (nil) Configuration file to
+        #   load when no +:config+ was provided (see
+        #   DhEasy::Core::Config#file_path for default file).
+        # @option opts [Boolean] :force (false) Will reload configuration file
+        #   when `true`.
+        #
+        # @note `opts[:config]` will be prioritize over
+        #   `opts[:config_file_path]` and `opts[:force]`.
+        def initialize_hook_router_plugin_router opts = {}
+          opts = {
+            config: nil,
+            config_file_path: nil,
+            force: false
+          }.merge opts
+          @local_config = opts[:config]
+          @local_config ||= DhEasy::Config::Local.new(
+            file_path: opts[:config_file_path],
+            force: opts[:force]
+          )
+        end
+
+        # Initialize router and hooks.
+        #
+        # @param [Hash] opts ({}) Configuration options.
+        #
+        # @see #initialize_hook_router_plugin_router
+        def initialize opts = {}
+          initialize_hooks opts
+        end
+
+        # Router configuration.
+        #
+        # @return [Hash]
+        def config
+          local_config['router']
+        end
+
+        # Validates when a class name exists
+        #
+        # @param [String] name Class name to validate.
+        #
+        # @return [Boolean] `true` when exists, else `false`.
+        def class_defined? name
+          Object.const_defined? name
+        end
+
+        # Get a class from a class name.
+        #
+        # @param [String] name Class name to validate.
+        #
+        # @return [Class,nil] `nil` when class doesn't exists.
+        def get_class name
+          return nil unless class_defined? name
+          Object.const_get name
+        end
+      end
+    end
+  end
+end

data/lib/dh_easy/router/seeder.rb

@@ -0,0 +1,38 @@
+module DhEasy
+  module Router
+    # Seeder router designed to execute all seeders classes.
+    class Seeder
+      include DhEasy::Router::Plugin::Router
+
+      # Execute the seeder class with options as described by router
+      #   configuration and calling class's instance `seed` method.
+      #
+      # @param [Hash] opts ({}) Seeder initializer options (see
+      #   DhEasy::Core::Plugin::Seeder).
+      #
+      # @raise [ArgumentError] `opts[:context]` is `nil`.
+      # @raise [ArgumentError] `page_type` doesn't exists within routes.
+      # @raise [NameError] A class with name equal to route's `class` attribute
+      #   doesn't exists.
+      #
+      # @note Requires the route class to implement `seed` instance method.
+      def route opts = {}
+        context = opts[:context]
+        if opts[:context].nil?
+          raise ArgumentError.new('Must send a context to the seeder.')
+        end
+
+        class_name = nil
+        config['seeder']['routes'].each do |item|
+          # Validate class name
+          executor_class = get_class item['class']
+          if executor_class.nil?
+            raise NameError.new("Class \"#{item['class']}\" doesn't exists, check your dh_easy config file.")
+          end
+
+          executor_class.new(opts).seed
+        end
+      end
+    end
+  end
+end

data/lib/dh_easy/router/version.rb

@@ -0,0 +1,6 @@
+module DhEasy
+  module Router
+    # Gem version
+    VERSION = "0.0.6"
+  end
+end

data/lib/dh_easy_override/core.rb

@@ -0,0 +1,6 @@
+require 'dh_easy/core/plugin'
+
+module DhEasy
+  module Core
+  end
+end

data/lib/dh_easy_override/core/plugin.rb

@@ -0,0 +1,10 @@
+require 'dh_easy/core/plugin/seeder_behavior'
+require 'dh_easy/core/plugin/parser_behavior'
+require 'dh_easy/core/plugin/finisher_behavior'
+
+module DhEasy
+  module Core
+    module Plugin
+    end
+  end
+end

data/lib/dh_easy_override/core/plugin/finisher_behavior.rb

@@ -0,0 +1,11 @@
+module DhEasy
+  module Core
+    module Plugin
+      module FinisherBehavior
+        def finish
+          raise NotImplementedError.new('Must implement "finish" method.')
+        end
+      end
+    end
+  end
+end

data/lib/dh_easy_override/core/plugin/parser_behavior.rb

@@ -0,0 +1,11 @@
+module DhEasy
+  module Core
+    module Plugin
+      module ParserBehavior
+        def parse
+          raise NotImplementedError.new('Must implement "parse" method.')
+        end
+      end
+    end
+  end
+end

data/lib/dh_easy_override/core/plugin/seeder_behavior.rb

@@ -0,0 +1,11 @@
+module DhEasy
+  module Core
+    module Plugin
+      module SeederBehavior
+        def seed
+          raise NotImplementedError.new('Must implement "seed" method.')
+        end
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,220 @@
+--- !ruby/object:Gem::Specification
+name: dh_easy-router
+version: !ruby/object:Gem::Version
+  version: 0.0.6
+platform: ruby
+authors:
+- Eduardo Rosales
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-12-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: dh_easy-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: dh_easy-config
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov-console
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: timecop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: DataHen Easy toolkit router module allow an easier class integration,
+  useful on advance implementations.
+email:
+- eduardo@datahen.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- ".yardopts"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- dh_easy-router.gemspec
+- doc/DhEasy.html
+- doc/DhEasy/Core.html
+- doc/DhEasy/Core/Plugin.html
+- doc/DhEasy/Core/Plugin/FinisherBehavior.html
+- doc/DhEasy/Core/Plugin/ParserBehavior.html
+- doc/DhEasy/Core/Plugin/SeederBehavior.html
+- doc/DhEasy/Router.html
+- doc/DhEasy/Router/Finisher.html
+- doc/DhEasy/Router/Parser.html
+- doc/DhEasy/Router/Plugin.html
+- doc/DhEasy/Router/Plugin/Router.html
+- doc/DhEasy/Router/Seeder.html
+- doc/_index.html
+- doc/class_list.html
+- doc/css/common.css
+- doc/css/full_list.css
+- doc/css/style.css
+- doc/file.README.html
+- doc/file_list.html
+- doc/frames.html
+- doc/index.html
+- doc/js/app.js
+- doc/js/full_list.js
+- doc/js/jquery.js
+- doc/method_list.html
+- doc/top-level-namespace.html
+- lib/dh_easy/router.rb
+- lib/dh_easy/router/finisher.rb
+- lib/dh_easy/router/parser.rb
+- lib/dh_easy/router/plugin.rb
+- lib/dh_easy/router/plugin/router.rb
+- lib/dh_easy/router/seeder.rb
+- lib/dh_easy/router/version.rb
+- lib/dh_easy_override/core.rb
+- lib/dh_easy_override/core/plugin.rb
+- lib/dh_easy_override/core/plugin/finisher_behavior.rb
+- lib/dh_easy_override/core/plugin/parser_behavior.rb
+- lib/dh_easy_override/core/plugin/seeder_behavior.rb
+homepage: https://datahen.com
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://datahen.com
+  source_code_uri: https://github.com/DataHenOfficial/dh_easy-router
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.2.2
+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: DataHen Easy toolkit router module
+test_files: []