moosex 0.0.20 → 0.0.21

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 81a1d69a0ea74ca118361a16b549201215fd255e
-  data.tar.gz: 562b285c934e2e1a798c89b4ff02afd9af4c3754
+  metadata.gz: 2bc3f32eac599e2895f68118cdfab74c5e91f014
+  data.tar.gz: d5934a0cd121ba31c4f2e9596d7ec52873e9cd63
 SHA512:
-  metadata.gz: a68c128bb6fffdcb6c50eb174d486e963919e031c111ffe537f89a517fda547e62180abfcf96a096c310790b48fe5759e2cb2846745ef7267f94f30bf9fd5fbf
-  data.tar.gz: 31fa71baa921d302d7603197e6dca60c0f423064e9e2eccfcab0d47f3bf463a88a2343e28979c5ea89021a40d6815cda02b4218e31c7f317ed375b62006f45ad
+  metadata.gz: f09c0292f96d3754959c80646c88e658d6adddc58b4a3b2e642e9a5d32c4e80d11f09688f74b99607ad1b74293d121d49c8f3f9097404dc3d367e91d972b07d3
+  data.tar.gz: f82a77fd8af5315b2c7e6671df97f9870648a81c7ab4c8c732cd0d35cf35605fcbbc3c4ba2955da96a7907a01b69b10d7e0d6a9a0822f76fd5211c31d95c20c0

data/Changelog

@@ -1,3 +1,6 @@
+0.0.21 - 2014-02-16
+  - simplify plugins and add prepare method #80
+
 0.0.20 - 2014-02-16
   - add plugins Chained and ExpiredAttribute #76
   - remove experimental traits, add Expire  

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    moosex (0.0.20)
+    moosex (0.0.21)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -18,6 +18,7 @@ But the objetive of MooseX is different: this is a toolbox to create Classes bas
 - lazy attributes
 - roles / abstract classes / interfaces
 - traits / monads
+- plugins
 - parameterized roles
 - composable type check
 - events
@@ -589,7 +590,23 @@ sleep(3)
 page.session.valid?                # => false
 ```
 
-See plugin "ExpiredAttribute" for a more clean interface (without this ugly coerce)!
+If you want avoid the ugly coerce, you can specify one expired time using the method 'with'.
+
+```ruby
+requires 'moosex'
+requires 'moosex/traits'
+
+class MyHomePage
+  include MooseX
+  has session: {
+    is: :rw,
+    default: -> { {} },
+    traits: MooseX::Traits::Expires.with(3),
+  }
+end
+```
+
+See plugin "ExpiredAttribute" to see how you can specify one expire time and mix with lazy mechanism to auto build in case of not valid value.
 
 ##### Create your own trait
 
@@ -655,7 +672,7 @@ EmailMessage.new.
 
 ### Plugin ExpiredAttribute
 
-It is a easy way to apply the trait Expired in lazy attributes!
+It is a easy way to apply the trait Expired in lazy attributes, and auto build the attribute if it is not valid!
 
 ```ruby
 require 'moosex'
@@ -666,7 +683,7 @@ class MyClass
   
   has config: {
     is: :lazy,
-    clearer: true,   # mandatory
+    clearer: true,   # optional, if not specify, we will force the default clearer method
     expires: 60,     # seconds
   }
   
@@ -676,16 +693,17 @@ class MyClass
  end
 ```
 
-Instead force a coerce to a tuple, here we use a `expires` keyword. You need enable the clearer to read the configuration, in this case.
+You need enable the clearer to read the configuration, in this case.
 
 ### Build your own Plugin
 
-You should create one Class who accepts one parameter in the constructor (it is a reference for the MooseX::Attribute class) and one method 'process' who will be invoked against the argument hash ( in the constructor ). The reference for the attribute can be used to change the original behavoir and you must delete the used arguments from the hash (in process). See the file `lib/moosex/plugins.rb` for more examples.
+You should create one Class who accepts one parameter in the constructor (it is a reference for the MooseX::Attribute class) and one method 'process' who will be invoked against the argument hash ( in the constructor ), and another method prepare. The reference for the attribute can be used to change the original behavoir and you must delete the used arguments from the hash (in process). See the file `lib/moosex/plugins.rb` for more examples.
 
 ```ruby
 module MooseX
   module Plugins
     class Chained
+      def prepare(options); end
       def initialize(this)
         @this = this
       end

data/lib/moosex/attribute.rb

@@ -43,6 +43,16 @@ module MooseX
     end
 
     def init_internal_modifiers(options, plugins, klass)
+      plugins.sort.uniq.each do |plugin_klass|
+        begin         
+          plugin_klass.new(self).prepare(options)
+        rescue NameError => e
+          next
+        rescue => e
+          raise "Unexpected Error in #{klass} #{plugin_klass} #{@attr_symbol}: #{e}"  
+        end  
+      end
+
       @@LIST_OF_PARAMETERS.each do |tuple|
         parameter, k = tuple 
         @attribute_map[parameter] = k.new(self).process(options, @attr_symbol)
@@ -56,7 +66,7 @@ module MooseX
         rescue NameError => e
           next
         rescue => e
-          raise "Unexpected Error in #{klass} #{key} #{@attr_symbol}: #{e}"  
+          raise "Unexpected Error in #{klass} #{plugin_klass} #{@attr_symbol}: #{e}"  
         end  
       end
 

data/lib/moosex/plugins.rb

@@ -1,6 +1,10 @@
 module MooseX
   module Plugins
     class Chained
+      def prepare(options)
+
+      end
+      
       def initialize(this)
         @this = this
       end
@@ -21,38 +25,37 @@ module MooseX
       def initialize(this)
         @this = this
       end
+      
+      def prepare(options)
+        if(options[:expires])
+          options[:traits] ||= []
+          options[:traits].unshift( MooseX::Traits::Expires.with(options[:expires]) )
+        
+          unless options[:clearer]
+            options[:clearer] = true
+          end
+        end        
+      end
+      
       def process(options)
        expires = options.delete(:expires) || nil
 
        if expires
          lazy      = @this.attribute_map[:lazy]
          clearer   = @this.attribute_map[:clearer]
-         predicate = @this.attribute_map[:predicate]
          reader    = @this.attribute_map[:reader]
-         writter   = @this.attribute_map[:writter]
-
-         old_traits= @this.attribute_map[:traits]
-
-         @this.attribute_map[:traits]  = ->(this) do
-           MooseX::Traits::Expires.new([ old_traits.call(this), expires ])
-         end
 
          if reader && clearer && lazy
-           reader_proc = @this.generate_reader
+           reader_proc = @this.methods[reader]
            @this.methods[reader]  = ->(this) do
-             x = reader_proc.call(this)
-             unless x.valid?
+             value = reader_proc.call(this)
+             unless value.valid?
                this.__send__(clearer)
-               x = reader_proc.call(this)
+               value = reader_proc.call(this)
              end
-             x
+             value
            end
-         elsif reader
-            @this.methods[reader] = @this.generate_reader
          end
-         if writter
-           @this.methods[writter] = @this.generate_writter
-          end  
        end
 
        @this.attribute_map[:expires] = expires

data/lib/moosex/traits.rb

@@ -3,6 +3,17 @@ require 'delegate'
 module MooseX
   module Traits
     class Expires < SimpleDelegator
+      def self.with(expires)
+        expires2 = Class.new(MooseX::Traits::Expires)
+        expires2.class_eval do
+          define_method(:initialize) do |value|
+            super([ value, expires ])
+          end
+        end
+          
+        expires2
+      end
+      
       def initialize(args)
         value, expires   = args[0], args[1]
         @value   = value

data/lib/moosex/version.rb

@@ -1,3 +1,3 @@
 module MooseX
-  VERSION = "0.0.20"
+  VERSION = "0.0.21"
 end

data/moosex.gemspec

@@ -9,7 +9,7 @@ Gem::Specification.new do |spec|
   spec.authors       = ["Tiago Peczenyj"]
   spec.email         = ["tiago.peczenyj@gmail.com"]
   spec.summary       = %q{A postmodern object DSL for Ruby}
-  spec.description   = %q{MooseX is an extension of Ruby object DSL. The main goal of MooseX is to make Ruby Object Oriented programming easier, more consistent, and less tedious. With MooseX you can think more about what you want to do and less about the mechanics of OOP. It is a port of Moose/Moo from Perl to Ruby world, providing method delegation, type check, monads, lazy attributes, aspects and much more.}
+  spec.description   = %q{MooseX is an extension of Ruby object DSL. The main goal of MooseX is to make Ruby Object Oriented programming easier, more consistent, and less tedious. With MooseX you can think more about what you want to do and less about the mechanics of OOP. It is a port of Moose/Moo from Perl to Ruby world, providing method delegation, type check, traits, monads, plugins, lazy attributes, aspects and much more.}
   spec.homepage      = "http://github.com/peczenyj/MooseX"
   spec.license       = "MIT"
 

data/spec/plugin_spec.rb

@@ -144,8 +144,6 @@ module TestAddAttribute
     
     has config: {
       is: :lazy,
-      clearer: true,
-      predicate: true,
       expires: 4,      # seconds
     }
     

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: moosex
 version: !ruby/object:Gem::Version
-  version: 0.0.20
+  version: 0.0.21
 platform: ruby
 authors:
 - Tiago Peczenyj
@@ -84,7 +84,7 @@ description: MooseX is an extension of Ruby object DSL. The main goal of MooseX
   to make Ruby Object Oriented programming easier, more consistent, and less tedious.
   With MooseX you can think more about what you want to do and less about the mechanics
   of OOP. It is a port of Moose/Moo from Perl to Ruby world, providing method delegation,
-  type check, monads, lazy attributes, aspects and much more.
+  type check, traits, monads, plugins, lazy attributes, aspects and much more.
 email:
 - tiago.peczenyj@gmail.com
 executables: []