betterobject 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8c0a48f6ca647b2e04d0da3ae2684874d64053e1
-  data.tar.gz: 8f47dec33142fc3c804e5f2577744668d2e68b63
+  metadata.gz: 7e64300a8b23a073a27bb1cd2cd3856764339c2b
+  data.tar.gz: 555bf34df4bd8cadaabe5a4ca15e412f8acbfa13
 SHA512:
-  metadata.gz: 6d572278169c31ae29c5ffc5e2f270ed7c74cbd6a8b3c404dd913bf5b75a5a4c3d77dd1ae484eca241a9cda56b8906d12b6a5d28455a56f8a1ec33b29c54fdec
-  data.tar.gz: b6be73de85b765e1b7d1ecc6e3cdb9b5b0d9fe8fa35270313810240616b4c33996e057489327c6b4ce6bbef782499fbe6ba148578a8da2ba1ad584ded42372e1
+  metadata.gz: 23e5d3d8f0957161b629e489ff6195e0efb48a0c6ac71413eb6f363df0bd3b6b90293488bb512865d6d241f8bd50c0aa39309cf5345e4b8bb566dc6e9ab182d6
+  data.tar.gz: f9e7501bfcba7cfe9470c341e0ee1e10117fa857cf60e0d3f2018309d8cc2923520edd0bb23bb0a23d4cb1e87cb3f2a32695eb51e0408c9b6725749bdebd3765

data/README.md

@@ -315,6 +315,7 @@ you must provide code to remove your methods.
 * `:define_presence_of`
 * `:in?`
 * `:include_many?`
+* `:include_any?`
 * `:to_literal`
 * `:pluralize`
 * `:parent`
@@ -327,6 +328,8 @@ you must provide code to remove your methods.
 * `:many_at`
 * `:delete_many_at`
 * `:tripleize`
+* `:dup_safe`
+* `:cvar`
 
 
 
@@ -724,16 +727,47 @@ Object.better_install :include_many?
 [1,2,3,[4,5],[6,7],8].include_many? [4,5],[6,7],1      # false ... same as:  .include_many? 4,5 ... see note below:
 [1,2,3,[4,5],[6,7],8].include_many? 1,[4,5],[6,7]      # true  ... see note below:
 "This is a test string".include_many? "test", "string" # true
-``` 
+```
 
 Note that it is best to encapsulate the list inside an array, particularly if your elements are arrays.
 If the first item in the list is an array, then its contents will be the only thing tested.
 
+### Generators :include_any?
+
+This works just like `:include:many?` except instead of all items needing to be included, any item included will return true.  
+
+### Generators :dup_safe
+
+It is interesting to note that you can't duplicate an Integer instance. Calling `#dup` will raise an exception.
+In the event that an instance cannot be duplicated, `self` is instead returned.
+
+### Generators :cvar
+
+Class variables (not the `@@name` ilk) can be tricky to access from an instance.
+This method creates and accesses class variables on the class or the instance of that class.
+See the example below:
+
+```ruby
+Object.better_install :cvar
+
+7.cvar!(:fred,"yaba daba doo!")
+2.cvar :fred        # returns "yaba daba doo!"
+9.class.cvar :fred  # returns "yaba daba doo!"
+55.class.cvar!(:fred,"Wilma?")
+100.cvar :fred      # returns "Wilma?"
+```
 
 ## Change Log
 
+### Version 1.2.0
+1. Changed `:better_install_as!` to class method
+2. Added generator `:cvar`
+3. Added generator `:include_any?`
+4. Added generator `:dup_safe`
+
 ### Version 1.1.0
 1. Update documentation
+2. Added method `:better_install_as!`
 2. Added generator `:delete_many_at`
 3. Added generator `:many_at`
 4. Added generator `:tripleize`

data/lib/betterobject.rb

@@ -1,15 +1,6 @@
 require "betterobject/version"
 require "generators.rb"
 
-### ::TODO::   :required ... prevent uninstall forever
-### :::  Array ... needs a delete_many_at(*prm)  ... 1,5,7,3  or an array  setfu need this!!!
-### :::            also, a delete_many(*prm)  ... deletes a bunch of stuff based on value
-### :::  Generator clone ???  another way to tag things .... or provide alternate names
-### :::  Generator drop ??? removes generator completely
-### :::  drop after permanent install? nah  ... not sure if I want drop either
-### :::  Object.better_install! :generator   ...  cannot be uninstalled  **** I like this!!! 
-
-
 class Object
   ###
   ###  The following are standard class methods
@@ -245,7 +236,7 @@ class Object
     true
   end
   
-  def better_install_as!(old_sym, new_sym)  
+  def self.better_install_as!(old_sym, new_sym)  
     better_be_object
     better_be_defined(old_sym)
     better_be_different(old_sym, new_sym)   

data/lib/betterobject/version.rb

@@ -1,3 +1,3 @@
 module Betterobject
-  VERSION = "1.1.0"
+  VERSION = "1.2.0"
 end

data/lib/generators.rb

@@ -494,4 +494,58 @@ CODE
 @@better_object_valid_methods[:include_many?] = hash
 
 
+#
+#  Generator  include_any?
+#
+hash = {}
+hash[:type] = :instance
+hash[:explain] = "calls include? to check for multiple items"
+hash[:code] = <<'CODE'
+  def BO_METH_NAME(*items)
+    items = items.first if items.first.kind_of? Array
+    items.each do |item|
+      return true if self.include? item
+    end
+    false
+  end
+CODE
+@@better_object_valid_methods[:include_any?] = hash
+
+
+#
+#  Generator  cvar
+#
+hash = {}
+hash[:type] = :both
+hash[:explain] = "cvar reads and writes class variables from instance or class"
+hash[:code] = <<'CODE'
+  def BO_METH_NAME(sym)
+    self.class.instance_variable_get("@#{sym}".to_sym)
+  end
+  def BO_METH_NAME!(sym,dat)
+    self.class.instance_variable_set("@#{sym}".to_sym,dat)
+  end
+  def self.BO_METH_NAME(sym)
+    instance_variable_get("@#{sym}".to_sym)
+  end
+  def self.BO_METH_NAME!(sym,dat)
+    instance_variable_set("@#{sym}".to_sym,dat)
+  end
+CODE
+@@better_object_valid_methods[:cvar] = hash
+
+
+#
+#  Generator  dup_safe
+#
+hash = {}
+hash[:type] = :instance
+hash[:explain] = "dup if possible else self"
+hash[:code] = <<'CODE'
+  def BO_METH_NAME
+    dup rescue self
+  end
+CODE
+@@better_object_valid_methods[:dup_safe] = hash
+
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: betterobject
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Bryan Colvin
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-01-04 00:00:00.000000000 Z
+date: 2018-01-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler