lotus-utils 0.3.3 → 0.3.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 629a22895276c357e5ee478c10eb6fd0c2c4ef4a
-  data.tar.gz: 185f59a1c22e690428f1675aa0ebb2a1553ad4ad
+  metadata.gz: 339681343526eb287d81d4f52ca29bda0550d8e7
+  data.tar.gz: 3e22d02c21a013f03cb1789e307e59054ba37ff1
 SHA512:
-  metadata.gz: a3e7907833d632771a62ccd573d72238ca7f454f28c84f440eb85b6cf6b49bb635214bc22d05431861ff163246ef82fea184c30b52132c54c8323e7d4eac157c
-  data.tar.gz: 589fd11dc42724192687b86d4848b378d90c7a14516fb69117667a7b021df56facd67f91ebbba7fb53fe492a2e010ee22bf6622910fa0a6bed61f83fb19befb7
+  metadata.gz: da44a5d936f554ae76be3c7c8195bd416268c5c0f81898df0c4959cc4aee3ab38180fa995943fac286ff464ebed477fb07307562330b0d086162b22fc4dbb41d
+  data.tar.gz: 6e835299ce217838cd487070b1ade2a5b7c8916af0eef233e76716257f99b258360faba93ca4ac8c29c84efc6dbccaf46db99d35b81891e00c76f92b39d62fc5

data/CHANGELOG.md

@@ -1,6 +1,14 @@
 # Lotus::Utils
 Ruby core extentions and class utilities for Lotus
 
+## v0.3.4 - 2015-01-30
+### Added
+- [Alfonso Uceda Pompa] Aliased `Lotus::Utils::Attributes#get` with `#[]`
+- [Simone Carletti] Introduced `Lotus::Utils::Callbacks::Chain#prepend` and `#append`
+
+### Deprecated
+- [Luca Guidi] Deprecated `Lotus::Utils::Callbacks::Chain#add` in favor of `#append`
+
 ## v0.3.3 - 2015-01-08
 ### Fixed
 - [Luca Guidi] Ensure to return the right offending object if a missing method is called with Utils::String and Hash (eg. `Utils::Hash.new(a: 1).all? {|_, v| v.foo }` blame `v` instead of `Hash`)

data/LICENSE.md

@@ -1,4 +1,4 @@
-Copyright (c) 2014 Luca Guidi
+Copyright © 2014-2015 Luca Guidi
 
 MIT License
 

data/README.md

@@ -61,4 +61,4 @@ __Lotus::Utils__ uses [Semantic Versioning 2.0.0](http://semver.org)
 
 ## Copyright
 
-Copyright 2014 Luca Guidi – Released under MIT License
+Copyright © 2014-2015 Luca Guidi – Released under MIT License

data/lib/lotus/utils/attributes.rb

@@ -48,19 +48,30 @@ module Lotus
       #
       #   attributes.get(:a)  # => 1
       #   attributes.get('a') # => 1
+      #   attributes[:a]      # => 1
+      #   attributes['a']     # => 1
       #
       #   attributes.get(:b)  # => 2
       #   attributes.get('b') # => 2
+      #   attributes[:b]      # => 2
+      #   attributes['b']     # => 2
       #
       #   attributes.get(23)   # => "foo"
       #   attributes.get('23') # => "foo"
+      #   attributes[23]       # => "foo"
+      #   attributes[23]       # => "foo"
       #
       #   attributes.get(:unknown)  # => nil
       #   attributes.get('unknown') # => nil
+      #   attributes[:unknown]      # => nil
+      #   attributes['unknown']     # => nil
       def get(attribute)
         @attributes[attribute.to_s]
       end
 
+      # @since 0.3.4
+      alias_method :[], :get
+
       # Set the given value for the given attribute
       #
       # @param attribute [#to_s] a String or any object that implements #to_s

data/lib/lotus/utils/callbacks.rb

@@ -1,3 +1,5 @@
+require 'lotus/utils/deprecation'
+
 module Lotus
   module Utils
     # Before and After callbacks
@@ -19,21 +21,71 @@ module Lotus
           @chain = Array.new
         end
 
-        # Adds the given callbacks to the chain
+        # Appends the given callbacks to the end of the chain.
         #
-        # @param callbacks [Array] one or multiple callbacks to add
-        # @param blk [Proc] an optional block to be added
+        # @param callbacks [Array] one or multiple callbacks to append
+        # @param block [Proc] an optional block to be appended
         #
         # @return [void]
         #
         # @raise [RuntimeError] if the object was previously frozen
         #
+        # @see #prepend
         # @see #run
         # @see Lotus::Utils::Callbacks::Callback
         # @see Lotus::Utils::Callbacks::MethodCallback
         # @see Lotus::Utils::Callbacks::Chain#freeze
         #
+        # @since 0.3.4
+        #
+        # @example
+        #   require 'lotus/utils/callbacks'
+        #
+        #   chain = Lotus::Utils::Callbacks::Chain.new
+        #
+        #   # Append a Proc to be used as a callback, it will be wrapped by `Callback`
+        #   # The optional argument(s) correspond to the one passed when invoked the chain with `run`.
+        #   chain.append { Authenticator.authenticate! }
+        #   chain.append { |params| ArticleRepository.find(params[:id]) }
+        #
+        #   # Append a Symbol as a reference to a method name that will be used as a callback.
+        #   # It will wrapped by `MethodCallback`
+        #   # If the #notificate method accepts some argument(s) they should be passed when `run` is invoked.
+        #   chain.append :notificate
+        def append(*callbacks, &block)
+          callables(callbacks, block).each do |c|
+            @chain.push(c)
+          end
+
+          @chain.uniq!
+        end
+
         # @since 0.1.0
+        # @deprecated Use Lotus::Utils::Callbacks::Chain#append as it has the
+        #   same effect, but it's more consistent with the new API.
+        #
+        # @see Lotus::Utils::Callbacks::Chain#append
+        def add(*callbacks, &blk)
+          Utils::Deprecation.new("Lotus::Utils::Callbacks::Chain#add is deprecated, use #append instead.")
+          append(*callbacks, &blk)
+        end
+
+        # Prepends the given callbacks to the beginning of the chain.
+        #
+        # @param callbacks [Array] one or multiple callbacks to add
+        # @param block [Proc] an optional block to be added
+        #
+        # @return [void]
+        #
+        # @raise [RuntimeError] if the object was previously frozen
+        #
+        # @see #append
+        # @see #run
+        # @see Lotus::Utils::Callbacks::Callback
+        # @see Lotus::Utils::Callbacks::MethodCallback
+        # @see Lotus::Utils::Callbacks::Chain#freeze
+        #
+        # @since 0.3.4
         #
         # @example
         #   require 'lotus/utils/callbacks'
@@ -42,17 +94,16 @@ module Lotus
         #
         #   # Add a Proc to be used as a callback, it will be wrapped by `Callback`
         #   # The optional argument(s) correspond to the one passed when invoked the chain with `run`.
-        #   chain.add { Authenticator.authenticate! }
-        #   chain.add {|params| ArticleRepository.find(params[:id]) }
+        #   chain.prepend { Authenticator.authenticate! }
+        #   chain.prepend { |params| ArticleRepository.find(params[:id]) }
         #
         #   # Add a Symbol as a reference to a method name that will be used as a callback.
         #   # It will wrapped by `MethodCallback`
         #   # If the #notificate method accepts some argument(s) they should be passed when `run` is invoked.
-        #   chain.add :notificate
-        def add(*callbacks, &blk)
-          callbacks.push blk if block_given?
-          callbacks.each do |c|
-            @chain.push Factory.fabricate(c)
+        #   chain.prepend :notificate
+        def prepend(*callbacks, &block)
+          callables(callbacks, block).each do |c|
+            @chain.unshift(c)
           end
 
           @chain.uniq!
@@ -128,6 +179,15 @@ module Lotus
           super
           @chain.freeze
         end
+
+
+        private
+
+        def callables(callbacks, block)
+          callbacks.push(block) if block
+          callbacks.map { |c| Factory.fabricate(c) }
+        end
+
       end
 
       # Callback factory

data/lib/lotus/utils/version.rb

@@ -3,6 +3,6 @@ module Lotus
     # Defines the version
     #
     # @since 0.1.0
-    VERSION = '0.3.3'.freeze
+    VERSION = '0.3.4'.freeze
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lotus-utils
 version: !ruby/object:Gem::Version
-  version: 0.3.3
+  version: 0.3.4
 platform: ruby
 authors:
 - Luca Guidi
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-01-08 00:00:00.000000000 Z
+date: 2015-01-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler