strategic 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 60db744a19fb4a7e6ac36c0fc5d36a6868a801d296c9331b4e865e087dd93c31
-  data.tar.gz: a88167c7f3a97fe47be46abef4ccd840597e237bc84812a1da586db501cc7868
+  metadata.gz: d76d0987f4534352de4fb52f025547a0ef37cad16a9452f1fd78da71606a3bae
+  data.tar.gz: 389a399d74c94352cf2165a8975b0b8d5886c782d08614c8b674ae0bd329c2a3
 SHA512:
-  metadata.gz: a0dd52c3176aa17bab03d9de1affdfbd8b90156278277ad3b2ade3a5d4401982a83208b5d04b54c9df39faf66845bd374f0eff9cd71cc6977382382fc7f4138a
-  data.tar.gz: 966b2e8d07234cf47e0d6da3c622628d777970d99f7c5b6725760b53f7958e013b206aa6eb287d1da2c30a869373648a004db528d40647b89422cf812a4e7a90
+  metadata.gz: 5aa4d886c61f6daf162ac9a7dbd19635fb20cb0c9c9cef437998d8496e0e75f4c0381a7abe2c887ba794398ca4522489702cfa644cd18d180bb9cf95813a8725
+  data.tar.gz: 2243df9a574cbf09d708f16ef5d6c2bbc2d621e1932c50e68b081402ad19c49ab341dfdd07b5fd5461cbe1ad0ed17cf1898546d62e09b4e254b4ed3d9fbf8d89

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Change Log
 
+## 1.2.0
+
+- `default_strategy` default value will be `'default'`, assuming a `model_namespace/default_strategy.rb` file with `DefaultStrategy` class
+- `new_with_default_strategy` class method (instantiating with `'default'` strategy if not configured or `default_strategy` class method value if configured)
+
 ## 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

data/README.md

@@ -1,4 +1,4 @@
-# Strategic 1.1.0
+# Strategic 1.2.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)` 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)`).
+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 (`.new(*initialize_args)`), with default strategy (`.new_with_default_strategy(*initialize_args)`), or 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
 
@@ -98,9 +98,9 @@ tax_calculator = TaxCalculator.create(args) # args include strategy_name
 tax = tax_calculator.tax_for(39.78)
 ```
 
-Default strategy for a strategy name that has no strategy class is `nil`
+Default strategy for a strategy name that has no strategy class is `nil` unless `DefaultStrategy` class exists under the model class namespace or `default_strategy` class attribute is set.
 
-You may set a default strategy on a strategic model via class method `default_strategy`
+This is how to set a default strategy on a strategic model via class method `default_strategy`:
 
 ```ruby
 class TaxCalculator
@@ -122,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.1.0'
+gem 'strategic', '~> 1.2.0'
 ```
 
 ### Option 2: Manual
@@ -130,7 +130,7 @@ gem 'strategic', '~> 1.1.0'
 Or manually install and require library.
 
 ```bash
-gem install strategic -v1.1.0
+gem install strategic -v1.2.0
 ```
 
 ```ruby
@@ -142,7 +142,7 @@ require 'strategic'
 Steps:
 1. Have the original class you'd like to strategize include `Strategic` (e.g. `def TaxCalculator; include Strategic; end`
 2. Create a directory matching the class underscored file name minus the '.rb' extension (e.g. `tax_calculator/`)
-3. Create a strategy class under that directory (e.g. `tax_calculator/us_strategy.rb`), which:
+3. Create a strategy class under that directory (e.g. `tax_calculator/us_strategy.rb`) (default is assumed as `tax_calculator/default_strategy.rb` unless customized with `default_strategy` class method):
  - Lives under the original class namespace
  - Includes the `Strategic::Strategy` module
  - Has a class name that ends with `Strategy` suffix (e.g. `NewCustomerStrategy`)
@@ -158,7 +158,8 @@ Steps:
 
 These methods can be delcared in a strategic model class body.
 
-- `::default_strategy`: sets default strategy as a strategy name string (e.g. 'us' selects UsStrategy) or alternatively a class/object if you have a mirror hierarchy for the strategy hierarchy
+- `::default_strategy(strategy_name)`: sets default strategy as a strategy name string (e.g. 'us' selects UsStrategy) or alternatively a class/object if you have a mirror hierarchy for the strategy hierarchy
+- `::default_strategy`: returns default strategy (default: `'default'` as in `DefaultStrategy`)
 - `::strategy_matcher`: custom matcher for all strategies (e.g. `strategy_matcher {|string| string.start_with?('C') && string.end_with?('o')}`)
 
 #### Class Methods
@@ -166,6 +167,7 @@ These methods can be delcared in a strategic model class body.
 - `::strategy_names`: returns list of strategy names (strings) discovered by convention (nested under a namespace matching the superclass name)
 - `::strategies`: returns list of strategies discovered by convention (nested under a namespace matching the superclass name)
 - `::new_with_strategy(string_or_class_or_object, *args, &block)`: instantiates a strategy based on a string/class/object and strategy constructor args
+- `::new_with_default_strategy(*args, &block)`: instantiates with default strategy
 - `::strategy_class_for(string_or_class_or_object)`: selects a strategy class based on a string (e.g. 'us' selects UsStrategy) or alternatively a class/object if you have a mirror hierarchy for the strategy hierarchy
 
 #### Instance Methods

data/lib/strategic.rb

@@ -30,6 +30,7 @@ module Strategic
     else
       klass.include(ExtraRubyMethods)
     end
+    klass.default_strategy 'default'
   end
   
   module ExtraRailsMethods
@@ -111,6 +112,12 @@ module Strategic
       end
     end
 
+    def new_with_default_strategy(*args, &block)
+      new(*args, &block).tap do |model|
+        model.strategy = nil
+      end
+    end
+
     def new_with_strategy(string_or_class_or_object, *args, &block)
       new(*args, &block).tap do |model|
         model.strategy = string_or_class_or_object

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: strategic
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Andy Maleh
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-09-14 00:00:00.000000000 Z
+date: 2022-01-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -122,6 +122,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 0.8.1
+- !ruby/object:Gem::Dependency
+  name: rake-tui
+  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: |
   if/case conditionals can get really hairy in highly sophisticated business domains.
   Domain model inheritance can help remedy the problem, but you don't want to dump all
@@ -167,7 +181,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.22
+rubygems_version: 3.3.1
 signing_key:
 specification_version: 4
 summary: Painless Strategy Pattern for Ruby and Rails