u-attributes 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 17e36e9053fd612a0fdec9ff0d9dd65ffa5b6b5c42cca0cff4855e3547171738
-  data.tar.gz: 35f893fa0563d725d386ba98fb65506effaef632ce68a60e144a26671bbd979e
+  metadata.gz: e6458bbe7cd9f3f3ce857b69273aec70bf9697594c4f2ee0ca898c441d0d7f1f
+  data.tar.gz: f71576f85de2c6a03ea50401a6b2e791ed79ec393d061c5653e52076bcaee23a
 SHA512:
-  metadata.gz: 69293580d1bde6527d6861cac123adbfe7ad4ace46dc57830a3e4dc980b8052f551c077a73851e1fae08c363915ae2b0544f5dd89ec11913f4ab2734c93b3e06
-  data.tar.gz: 8f6c9176e8b2b2f6371a4ec2ccf3b8e7475832b16c1050ee908304e3f3e4502492818bfbc1faa8cd0ffcec8dd26a158a72063fbe8ee128a9ffc1d1db205d11e7
+  metadata.gz: c26e67d45e58f7b381e4b1a250a1d284eb05dc6455baae21cecff5ca54b5de864360c2d4f889ecab318d3b5d406ee39a1011608a1e3983dddf0106f5d849c10e
+  data.tar.gz: 9ff97e16e741127e9311ce0baf74deac64a24bc9d964e5f32f17d3a03e27fcbc32ded8efa3ce367caaec2032adc5327ea13bb341e7be3c8939f542283cd7725c

data/Gemfile

@@ -2,5 +2,5 @@ source "https://rubygems.org"
 
 gem 'simplecov', require: false, group: :test
 
-# Specify your gem's dependencies in micro-attributes.gemspec
+# Specify your gem's dependencies in u-attributes.gemspec
 gemspec

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    u-attributes (0.7.0)
+    u-attributes (0.8.0)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -80,6 +80,32 @@ person = Person.new('name' => 'John', age: 20)
 
 puts person.name # John
 puts person.age  # 20
+
+#--------------#
+# #attribute() #
+#--------------#
+#
+# Use the #attribute() method with a valid attribute name to get its value
+
+puts person.attribute(:name) # John
+puts person.attribute('age') # 20
+puts person.attribute('foo') # nil
+
+#
+# If you pass a block, it will be executed only if the attribute is valid.
+
+person.attribute(:name) { |value| puts value } # John
+person.attribute('age') { |value| puts value } # 20
+person.attribute('foo') { |value| puts value } # !! Nothing happened, because of the attribute not exists.
+
+#--------------#
+# #attribute() #
+#--------------#
+#
+# Works like the #attribute() method, but will raise an exception when the attribute not exist.
+
+puts person.attribute!('foo')                   # NameError (undefined attribute `foo)
+person.attribute!('foo') { |value| puts value } # NameError (undefined attribute `foo)
 ```
 
 ### How to define multiple attributes?
@@ -249,7 +275,7 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/micro-attributes. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+Bug reports and pull requests are welcome on GitHub at https://github.com/serradura/u-attributes. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
 
 ## License
 
@@ -257,4 +283,4 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Code of Conduct
 
-Everyone interacting in the Micro::Attributes project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/micro-attributes/blob/master/CODE_OF_CONDUCT.md).
+Everyone interacting in the Micro::Attributes project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/serradura/u-attributes/blob/master/CODE_OF_CONDUCT.md).

data/lib/micro/attributes/{utils.rb → attributes_utils.rb}

@@ -2,7 +2,7 @@
 
 module Micro
   module Attributes
-    module Utils
+    module AttributesUtils
       ARGUMENT_ERROR_MSG = 'argument must be a Hash'
 
       def self.hash_argument!(arg)

data/lib/micro/attributes/macros.rb

@@ -44,8 +44,8 @@ module Micro
 
       def attributes_data(arg)
         __attributes_data.merge(
-          Utils.hash_argument!(arg)
-               .each_with_object({}) { |(key, val), memo| memo[key.to_s] = val }
+          AttributesUtils.hash_argument!(arg)
+                         .each_with_object({}) { |(key, val), memo| memo[key.to_s] = val }
         )
       end
 
@@ -59,8 +59,8 @@ module Micro
           raise ArgumentError, 'wrong number of arguments (given 0, expected 1 or more)'
         end
       end
-
       private_constant :ForSubclasses
     end
+    private_constant :Macros
   end
 end

data/lib/micro/attributes/to_initialize.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Micro
+  module Attributes
+    module ToInitialize
+      def self.included(base)
+        base.send(:include, ::Micro::Attributes)
+      end
+
+      def initialize(arg)
+        self.attributes = arg
+      end
+
+      def with_attribute(key, val)
+        self.class.new(attributes.merge(key => val))
+      end
+
+      def with_attributes(arg)
+        self.class.new(attributes.merge(arg))
+      end
+    end
+
+    private_constant :ToInitialize
+  end
+end

data/lib/micro/attributes/version.rb

@@ -2,6 +2,6 @@
 
 module Micro
   module Attributes
-    VERSION = "0.7.0"
+    VERSION = "0.8.0"
   end
 end

data/lib/micro/attributes.rb

@@ -1,13 +1,14 @@
 # frozen_string_literal: true
 
 require "micro/attributes/version"
-require "micro/attributes/utils"
+require "micro/attributes/attributes_utils"
 require "micro/attributes/macros"
+require "micro/attributes/to_initialize"
 
 module Micro
   module Attributes
     def self.included(base)
-      base.extend Macros
+      base.extend(::Micro::Attributes.const_get(:Macros))
 
       base.class_eval do
         private_class_method :__attribute
@@ -22,41 +23,20 @@ module Micro
           subclass.attribute(value.nil? ? name : {name => value})
         end
 
-        subclass.extend Macros.const_get(:ForSubclasses)
+        subclass.extend ::Micro::Attributes.const_get('Macros::ForSubclasses')
       end
     end
 
     def self.to_initialize
-      @to_initialize ||= Module.new do
-        def self.included(base)
-          base.send(:include, Micro::Attributes)
-
-          base.class_eval(<<-RUBY)
-            def initialize(arg)
-              self.attributes = arg
-            end
-
-            def with_attribute(key, val)
-              self.class.new(attributes.merge(key => val))
-            end
-
-            def with_attributes(arg)
-              self.class.new(attributes.merge(arg))
-            end
-          RUBY
-        end
-      end
-    end
-
-    def attribute?(name)
-      self.class.attribute?(name)
+      @to_initialize ||= ::Micro::Attributes.const_get(:ToInitialize)
     end
 
     def attributes=(arg)
-      self.class.attributes_data(Utils.hash_argument!(arg)).each do |name, value|
+      self.class.attributes_data(AttributesUtils.hash_argument!(arg)).each do |name, value|
         instance_variable_set("@#{name}", value) if attribute?(name)
       end
     end
+    protected :attributes=
 
     def attributes
       state = self.class.attributes.each_with_object({}) do |name, memo|
@@ -66,6 +46,22 @@ module Micro
       self.class.attributes_data(state)
     end
 
-    protected :attributes=
+    def attribute?(name)
+      self.class.attribute?(name)
+    end
+
+    def attribute(name)
+      return unless attribute?(name)
+
+      value = public_send(name)
+
+      block_given? ? yield(value) : value
+    end
+
+    def attribute!(name, &block)
+      attribute(name) { |name| return block ? block[name] : name }
+
+      raise NameError, "undefined attribute `#{name}"
+    end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: u-attributes
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Rodrigo Serradura
@@ -57,11 +57,12 @@ files:
 - bin/console
 - bin/setup
 - lib/micro/attributes.rb
+- lib/micro/attributes/attributes_utils.rb
 - lib/micro/attributes/macros.rb
-- lib/micro/attributes/utils.rb
+- lib/micro/attributes/to_initialize.rb
 - lib/micro/attributes/version.rb
 - lib/u-attributes.rb
-- micro-attributes.gemspec
+- u-attributes.gemspec
 homepage: https://github.com/serradura/u-attributes
 licenses:
 - MIT