strategic 1.0.1 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5d1b5e48f559fa9befbe74660a5894d73aa99e9acb9ab31daf6d592e50d5200e
-  data.tar.gz: b0064808d6119cd5e860762c82483d457c30c4a5d22b703060fbef323a781086
+  metadata.gz: 60db744a19fb4a7e6ac36c0fc5d36a6868a801d296c9331b4e865e087dd93c31
+  data.tar.gz: a88167c7f3a97fe47be46abef4ccd840597e237bc84812a1da586db501cc7868
 SHA512:
-  metadata.gz: 351e5f342baf23c732723b97e0040f85d65378bf4e5fdfcde2385a9b16870a303f638da34765569d0392180295997088e1f7730b3a970210ebdd22bb388b712a
-  data.tar.gz: b5b269f698ae134d412dc9d8ff5e16d397da76480c88f9b92e984079f5edbaed3002f409e71ac4686e010fbd0a0bdcc460b70a42a7c503ea95e2001b665dd7a5
+  metadata.gz: a0dd52c3176aa17bab03d9de1affdfbd8b90156278277ad3b2ade3a5d4401982a83208b5d04b54c9df39faf66845bd374f0eff9cd71cc6977382382fc7f4138a
+  data.tar.gz: 966b2e8d07234cf47e0d6da3c622628d777970d99f7c5b6725760b53f7958e013b206aa6eb287d1da2c30a869373648a004db528d40647b89422cf812a4e7a90

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Change Log
 
+## 1.1.0
+
+- Generate `strategy_name` attribute on `Strategic` class if it does not already exist like in the case of a Rails migration column
+- Automatically set `strategy_name` attribute when setting `strategy` attribute (either `strategy_name` attribute in Ruby or column in Rails)
+- Load `strategy` attribute from `strategy_name` attribute on `after_initialize` in Rails
+
 ## 1.0.1
 
 - Fix error "undefined method `new' for Strategic::Strategy:Module" that occurs when setting an empty string strategy (must return nil or default strategy)

data/README.md

@@ -1,4 +1,4 @@
-# Strategic 1.0.1
+# Strategic 1.1.0
 ## Painless Strategy Pattern in Ruby and Rails
 [![Gem Version](https://badge.fury.io/rb/strategic.svg)](http://badge.fury.io/rb/strategic)
 [![rspec](https://github.com/AndyObtiva/strategic/actions/workflows/ruby.yml/badge.svg)](https://github.com/AndyObtiva/strategic/actions/workflows/ruby.yml)
@@ -28,7 +28,7 @@ code (Open/Closed Principle).
 externalizing all logic concerning algorithmic variations into separate strategy
 classes that are easy to find, maintain and extend while honoring the Open/Closed Principle and avoiding conditionals.
 
-In summary, if you make a class called `TaxCalculator` strategic by including the `Strategic` mixin module, now you are able to drop strategies under the `tax_calculator` directory sitting next to the class (e.g. `tax_calculator/us_strategy.rb`, `tax_calculator/canada_strategy.rb`) while gaining extra [API](#api) methods to grab strategy names to present in a user interface (`.strategy_names`), set a strategy (`#strategy=(strategy_name)`), and/or instantiate `TaxCalculator` directly with a strategy from the get-go (`.new_with_strategy(strategy_name, *initialize_args)`). Finally, you can simply invoke strategy methods on the main strategic model (e.g. `tax_calculator.tax_for(39.78)`).
+In summary, if you make a class called `TaxCalculator` strategic by including the `Strategic` mixin module, now you are able to drop strategies under the `tax_calculator` directory sitting next to the class (e.g. `tax_calculator/us_strategy.rb`, `tax_calculator/canada_strategy.rb`) while gaining extra [API](#api) methods to grab strategy names to present in a user interface (`.strategy_names`), set a strategy (`#strategy=(strategy_name)` or `#strategy_name=(strategy_name)`), and/or instantiate `TaxCalculator` directly with a strategy from the get-go (`.new_with_strategy(strategy_name, *initialize_args)`). Finally, you can simply invoke strategy methods on the main strategic model (e.g. `tax_calculator.tax_for(39.78)`).
 
 ### Example
 
@@ -86,6 +86,12 @@ tax_calculator.strategy = 'us'
 tax_calculator = TaxCalculator.new_with_strategy('us', args)
 ```
 
+4b. Alternatively in Rails, instantiate or create an ActiveRecord model with `strategy_name` column attribute included in args (you may generate migration for `strategy_name` column via `rails g migration add_strategy_name_to_resources strategy_name:string`):
+
+```ruby
+tax_calculator = TaxCalculator.create(args) # args include strategy_name
+```
+
 5. Invoke the strategy implemented method:
 
 ```ruby
@@ -116,7 +122,7 @@ If no strategy is selected and you try to invoke a method that belongs to strate
 Add the following to bundler's `Gemfile`.
 
 ```ruby
-gem 'strategic', '~> 1.0.1'
+gem 'strategic', '~> 1.1.0'
 ```
 
 ### Option 2: Manual
@@ -124,7 +130,7 @@ gem 'strategic', '~> 1.0.1'
 Or manually install and require library.
 
 ```bash
-gem install strategic -v1.0.1
+gem install strategic -v1.1.0
 ```
 
 ```ruby
@@ -141,6 +147,7 @@ Steps:
  - Includes the `Strategic::Strategy` module
  - Has a class name that ends with `Strategy` suffix (e.g. `NewCustomerStrategy`)
 4. Set strategy on strategic model using `strategy=` attribute writer method or instantiate with `new_with_strategy` class method, which takes a strategy name string (any case), strategy class, or mirror object (having a class matching strategy name minus the word `Strategy`) (note: you can call `::strategy_names` class method to obtain available strategy names or `::stratgies` to obtain available strategy classes)
+5. Alternatively in Rails, create migration `rails g migration add_strategy_name_to_resources strategy_name:string` and set strategy via `strategy_name` column, storing in database. On load of the model, the right strategy is automatically loaded based on `strategy_name` column.
 6. Invoke strategy method needed
 
 ## API

data/lib/strategic.rb

@@ -23,6 +23,31 @@ module Strategic
   def self.included(klass)
     klass.extend(ClassMethods)
     klass.require_strategies
+    rails_mode = klass.respond_to?(:column_names) && klass.column_names.include?('strategy_name')
+    if rails_mode
+      klass.include(ExtraRailsMethods)
+      klass.after_initialize :reload_strategy
+    else
+      klass.include(ExtraRubyMethods)
+    end
+  end
+  
+  module ExtraRailsMethods
+    def strategy_name=(string)
+      self['strategy_name'] = string
+      strategy_class = self.class.strategy_class_for(string)
+      @strategy = strategy_class&.new(self)
+    end
+  end
+  
+  module ExtraRubyMethods
+    attr_reader :strategy_name
+    
+    def strategy_name=(string)
+      @strategy_name = string
+      strategy_class = self.class.strategy_class_for(string)
+      @strategy = strategy_class&.new(self)
+    end
   end
 
   module ClassMethods
@@ -109,13 +134,18 @@ module Strategic
   end
   
   def strategy=(string_or_class_or_object)
-    @strategy = self.class.strategy_class_for(string_or_class_or_object)&.new(self)
+    strategy_class = self.class.strategy_class_for(string_or_class_or_object)
+    self.strategy_name = strategy_class&.strategy_name
   end
       
   def strategy
     @strategy
   end
-
+  
+  def reload_strategy
+    self.strategy = strategy_name
+  end
+  
   def method_missing(method_name, *args, &block)
     if strategy&.respond_to?(method_name, *args, &block)
       strategy.send(method_name, *args, &block)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: strategic
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.1.0
 platform: ruby
 authors:
 - Andy Maleh