inflect 0.5.0 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0540c58850a8378d104c597d1082d334f153f907
-  data.tar.gz: 712d8e922f27c6f994dec37ea4542f69976002a7
+  metadata.gz: 255046c5af958b2b850542fe3f257856598dbdd3
+  data.tar.gz: 24f592fa8da795e93d1d5dbc03b8c412519a82ca
 SHA512:
-  metadata.gz: d5f79a0bd635f982577ae422d231b8a6af308fa736642522b7d7eae91114128a24d17505ffbfc698e3ee2c253db08f9cc291f8f094fe724c563289197b76046d
-  data.tar.gz: c7ef59e1152a2660d74047ca0e28919e9e113287e6ebe1d609089f8452db669e2e09c115d94c1639e586b8e07e7d193d6dc575414b90b5b940f0be3e245e74ab
+  metadata.gz: 06ae10b731c6f821cb5fecc08b154c723883aba705a298b9dff376062a8da8528d6bb89add35eaef3ad4b8a1da193891e88a20fc13d073ff9084109736c3b2b5
+  data.tar.gz: ce790b83f577d02190fa5773dc2e185f7ebcc93db0bebec0ed77c7d7149a00c0b71645027084e5919e6eb9759d3c7b732a2efdb2fed375d9c5fd2001bc8b411b

data/README.md

@@ -30,11 +30,9 @@ Generate your Service:
 
     $ inflect generate:service Weather
 
-IMPORTANT: service name must be in CamelCase, example:
+IMPORTANT: service name must be in CamelCase.
 
-    $ inflect generate:service MyWeatherService
-
-Implement at least the WeatherService#handle method:
+All the actions that you declare in the array must have its corresponding method.
 
 ```ruby
 class WeatherService < Inflect::AbstractService

data/lib/inflect/abstract_service.rb

@@ -1,5 +1,6 @@
 require 'singleton'
 require 'inflect/responsive'
+require 'inflect/service_provider_methods'
 
 module Inflect
   # Acts as an specification or standard required for a Service
@@ -10,6 +11,7 @@ module Inflect
     include Comparable
     include Singleton
     include Responsive
+    include ServiceProviderMethods
 
     # A +words+ Array constant with the key +words+ of the Service.
     # @example Array for New York Times service
@@ -26,7 +28,7 @@ module Inflect
     end
 
     # Implement Comparable in order to be sortable.
-    def <=> (other_service)
+    def <=>(other_service)
       priority <=> other_service.priority
     end
 
@@ -39,19 +41,13 @@ module Inflect
       action_defined(request.action)
     end
 
-    # The +default+ is the method called when there is no action parameter inside
-    # the words query array.
-    def default
-      no_method_error
-    end
-
     # Returns a Hash with retrieved data by routing from the request
     # to the method specified by the request's action attribute.
     # @param Inflect::Request
     # @return Inflect::Response
     def handle(request)
       if action_defined(request.action) && !action_implemented(request.action)
-        no_method_error
+        no_method_error request
       else
         if request.arguments.empty?
           send request.action
@@ -88,10 +84,12 @@ module Inflect
 
     # Method fired when users don't implement the method corresponding
     # to the actions they define in the +words+ array.
-    def no_method_error
-      message = "#{self.class} declared the action #{request.action}
-             in #{self.words} but the method is missing, for more
-             information see Inflect::AbstractService class."
+    def no_method_error(request)
+      if request.action.eql? :default
+        message = "No default action declared for #{self.class}, the default method must be implemented if you want #{self.class} to respond to #{self.words}."
+      else
+        message = "#{self.class} declared the action #{request.action} in #{self.words} but the method is missing, for more information see Inflect::AbstractService class."
+      end
       raise NoMethodError.new message
     end
   end

data/lib/inflect/configuration.rb

@@ -12,6 +12,7 @@ module Inflect
   # Method that allows configuration via block.
   def self.configure
     yield configuration if block_given?
+    reload if configuration.services_path_changed
   end
 
   # The class in charge of centralizing the application's
@@ -23,10 +24,18 @@ module Inflect
     # Location of the locale file.
     attr_accessor :locale_path
 
+    # Default service path
+    attr_accessor :default_path
+
 
     def initialize
-      @services_path = File.join('lib', 'services')
+      @default_path = File.join('lib', 'services')
+      @services_path = @services_path || default_path
       @locale_path   = File.join(File.dirname(__FILE__), 'locale/en.yml')
     end
+
+    def services_path_changed
+      !services_path.eql? default_path
+    end
   end
 end

data/lib/inflect/director.rb

@@ -1,20 +1,11 @@
-require 'inflect/loader'
-require 'inflect/configuration'
 require 'inflect/request'
+require 'inflect/service_provider_methods'
 
 module Inflect
   # The class in charge of managing the access
   # and selection of the services.
   class Director
-    # List of the services loaded successfully sorted by priority.
-    attr_reader :services
-
-    # @param services_path [String]
-    def initialize(services_path = nil)
-      @services = Loader.services(
-        services_path || Inflect.configuration.services_path
-      )
-    end
+    include ServiceProviderMethods
 
     # Finds the first Service that is able
     # to handle the request and lets him do
@@ -30,6 +21,10 @@ module Inflect
       end
     end
 
+    def reload
+      service_provider.reload
+    end
+
     private
 
     def select_service(request)

data/lib/inflect/service_provider.rb

@@ -0,0 +1,28 @@
+require 'inflect/loader'
+require 'inflect/configuration'
+
+module Inflect
+  # The class in charge of providing common access to available services across
+  # all the application.
+  class ServiceProvider
+    include Singleton
+
+    # Access available services.
+    attr_reader :services
+
+    # Load all services on provider instantiation.
+    def initialize
+      @services = load
+    end
+
+    def reload
+      @services = load
+    end
+
+    private
+
+    def load
+      Loader.services(Inflect.configuration.services_path)
+    end
+  end
+end

data/lib/inflect/service_provider_methods.rb

@@ -0,0 +1,23 @@
+require 'inflect/service_provider'
+require 'pry'
+
+module Inflect
+  module ServiceProviderMethods
+    def self.included(base)
+      base.send :include, InstanceMethods
+    end
+
+    module InstanceMethods
+      # Provide the Service Provider as a virtual attribute.
+      def service_provider
+        Inflect::ServiceProvider.instance
+      end
+
+      # Access available services through a virtual attribute.
+      # @return [Enumerable[AbstractService]]
+      def services
+        service_provider.services
+      end
+    end
+  end
+end

data/lib/inflect/version.rb

@@ -1,3 +1,3 @@
 module Inflect
-  VERSION = "0.5.0"
+  VERSION = "0.5.1"
 end

data/lib/inflect.rb

@@ -13,11 +13,16 @@ module Inflect
       director.handle(words)
     end
 
+    def reload
+      director.reload
+    end
+
     private
+
     # Method that returns the Director instance reference.
     # @return [Inflect::Director]
     def director
-      @@director ||= Director.new(self.configuration.services_path)
+      @@director ||= Director.new
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: inflect
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.5.1
 platform: ruby
 authors:
 - Santiago Figueiras
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-09-05 00:00:00.000000000 Z
+date: 2016-09-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -113,8 +113,9 @@ files:
 - lib/inflect/request.rb
 - lib/inflect/response.rb
 - lib/inflect/responsive.rb
+- lib/inflect/service_provider.rb
+- lib/inflect/service_provider_methods.rb
 - lib/inflect/version.rb
-- lib/services/random_service.rb
 homepage: https://github.com/InflectProject/inflect
 licenses:
 - MIT

data/lib/services/random_service.rb

@@ -1,27 +0,0 @@
-class RandomService < Inflect::AbstractService
-  # A WORDS Array constant with the key words of the Service,
-  # the first word of the array represents the keyword for the
-  # service, the second represents the action (method), and all the rest are
-  # the arguments to that action.
-  # @example Array for New York Times service
-  #   words = %W[NEWS TODAY NEW\ YORK\ TIMES]
-  #
-  # This would mean that the service would handle request with the
-  # keyword NEWS, in it's #today method with the arguments "new york times".
-
-  # In case there are modules that provide similar contents the
-  # one with most PRIORITY is picked.
-  # Float::Infinity is the lowest priority.
-  def initialize
-    @priority = 1
-    @words    = %W[RANDOM].freeze
-  end
-
-  # This method is the only one needed for Inflect to work.
-  # Implements how the service responds to a request that has no
-  # action attribute.
-  # @return Inflect::Response
-  def default
-    super
-  end
-end