active_module 0.1.3 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 67a15729498969e40f9d98768361af65053734b1250a016ba6fd5a4e9a865255
-  data.tar.gz: f45cbf9dee684f2642c2191d3968fecc7dd9f5b8507339972b478b3a901facbb
+  metadata.gz: 31dff5b0baa89fa4624fc7b974f5261d483cdaf48f7b7fe9a5d1f0a7f256d7fa
+  data.tar.gz: fbb6655e9de6c118ee99e199ed4ce78441cd55d151d839f7bf0040fa48519df5
 SHA512:
-  metadata.gz: 7f904500067b63fa236787e405e4e04a012b55a82c89da3e8276cd3249d9cb566c461d1e17b9e21dafc46a02a45a4b9d0bc45ea5a052bb071a700646d111474c
-  data.tar.gz: 856d1a37309c9a142cf300342707c71dbc91526e6ea221a339544497323afbd2229a59e62e2ca73ca674ed9cab62bb95f7638af001de5ecc6bcfb475009c5418
+  metadata.gz: 0ed009054605141713db46f3d768dc044f42d5bc8ac479ae8004408eaa9ad4657694d661299ba600868975bf7f254da00315d64564d1dfcd96a942ad6622dada
+  data.tar.gz: 4053a0f71c9b2b8db76c1f7637a989646c7b8ad531fa5da680c9795e61ec967fe9db13c74b566350039c13cdaf16d1a0c80f58e04944650e5e2c2f78d73a017f

data/README.md

@@ -19,7 +19,7 @@ You can find examples of these in [Usage -> Examples :](#Examples)
 
 ## Installation
 
-Add to your gemfile:
+Add to your gemfile - and if you are using rails - that's all you need:
 
 ```ruby
 gem 'active_module', "~>0.1"
@@ -109,6 +109,20 @@ my_ar_object.module_field = "MyClass::MyModule1"
 my_ar_object.module_field #=> MyARObject::MyClass::MyModule::Module
 ```
 
+### Comparing modules with strings and symbols
+
+In order to compare modules with Strings or Symbols you'll have to use the `ActiveModule::Comparison`
+refinement. This refinement adds the method `Module#=~` to the `Module` class, but this change is
+only available within the namespace that includes the refinement.
+
+```ruby
+module YourClassOrModuleThatWantsToCompare
+  using ActiveModule::Comparison
+  def method_that_compares
+    my_ar_object.module_field =~ :MyModule1
+  end
+end
+
 ## Examples
 
 ### Strategy Pattern (composition-based polymorphism)

data/lib/active_module/comparison.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module ActiveModule
+  module Comparison
+    refine ::Module do
+      using ActiveModule::ModuleRefinement
+
+      def =~(other)
+        case other
+        when nil
+          false
+        when ::Module
+          super(other)
+        when ::String
+          (@possible_names ||= possible_names).include?(other)
+        when ::Symbol
+          (@possible_names ||= possible_names).include?(other.to_s)
+        else
+          false
+        end
+      end
+    end
+
+    using self
+
+    def self.compare(module1, module2)
+      module1 =~ module2
+    end
+  end
+end

data/lib/active_module/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ActiveModule
-  VERSION = "0.1.3"
+  VERSION = "0.1.5"
 end

data/lib/active_module.rb

@@ -4,6 +4,7 @@ require_relative "active_module/version"
 require_relative "active_module/base"
 require_relative "active_module/invalid_module_value"
 require_relative "active_module/register"
+require_relative "active_module/comparison"
 require "active_module/railtie" if defined?(Rails::Railtie)
 
 module ActiveModule

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: active_module
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.5
 platform: ruby
 authors:
 - Pedro Rolo
@@ -58,6 +58,7 @@ files:
 - Rakefile
 - lib/active_module.rb
 - lib/active_module/base.rb
+- lib/active_module/comparison.rb
 - lib/active_module/invalid_module_value.rb
 - lib/active_module/module_refinement.rb
 - lib/active_module/modules_index.rb
@@ -65,7 +66,8 @@ files:
 - lib/active_module/register.rb
 - lib/active_module/version.rb
 homepage: https://github.com/pedrorolo/active_module
-licenses: []
+licenses:
+- MIT
 metadata:
   homepage_uri: https://github.com/pedrorolo/active_module
   source_code_uri: https://github.com/pedrorolo/active_module