supa 0.3.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8368930840dc4d4f13caeebed1c39874729f171b
-  data.tar.gz: f43ae08a91fc09e14b3e8094c8441402971461a5
+  metadata.gz: dca557ba59684f5f970ada4fd9349cbf1f158133
+  data.tar.gz: 1bdc567595c7dd9d3d78413525d598326b4eb71e
 SHA512:
-  metadata.gz: 7440feb89f238add3e25ea2d0530827ab43bc58c8a23fffb0ae7e38348867d89f5159cadd7d5d29d10e72fdc6cc9fbdbe8863aecf3a5b76be77f5ed73cefa5dd
-  data.tar.gz: fee29a4bb5555ad0653fe08fe5cc1d7a4250b15100c11a8648fee5daf3ad79b748e9c583dce6676953691c73e55d4eeb411e4bdf033e482c58d72b498e3e1dbc
+  metadata.gz: a06d61f42e4d96488a0ae35babfa4bbddeb5a39ebf95d9e1f8b1e02c44636e6f6c9714b86e65c64d9d2e324bcb2ee24d690afd40cb3f8bd24dd7f7ce317fb680
+  data.tar.gz: 1bd11c1fd35d5ccf2935a60404622762ad3e239c4faa16776e9b35c63e9b447378c8215b7cf384a16a62f072d624ba15feff18dfd0c92bae29554eb5d1a27e41

data/README.md

@@ -256,6 +256,35 @@ ExampleRepresenter.new(example).to_hash
 
 ```
 
+### `attributes`
+
+It retrieves attributes from correspondingly named instance methods or hash keys when the represented object is a `Hash`.
+
+```ruby
+class ExampleRepresenter
+  include Supa::Representable
+
+  define do
+    attributes :first_name, :last_name, hide_when_empty: true
+  end
+end
+
+class Person
+  attr_accessor :first_name, :last_name
+end
+
+example = Person.new
+example.first_name = 'Heidi'
+example.last_name = 'Shepherd'
+
+ExampleRepresenter.new(example).to_hash
+
+  #=> {
+  #=>   first_name: 'Heidi',
+  #=    last_name: 'Shepherd'
+  #=> }
+```
+
 ### `virtual`
 
 Virtual is an attribute that doesn't exist in representing object and defind as `string`.

data/lib/supa.rb

@@ -2,6 +2,7 @@ require 'supa/version'
 require 'supa/representable'
 require 'supa/command'
 require 'supa/commands/attribute'
+require 'supa/commands/attributes'
 require 'supa/commands/virtual'
 require 'supa/commands/object'
 require 'supa/commands/namespace'

data/lib/supa/builder.rb

@@ -1,6 +1,6 @@
 module Supa
   class Builder
-    COMMANDS = %w(attribute virtual object namespace collection append).freeze
+    COMMANDS_WITH_DEFAULT_INTERFACE = %w(attribute virtual object namespace collection append).freeze
 
     def initialize(subject, representer:, tree:)
       @subject = subject
@@ -8,10 +8,10 @@ module Supa
       @tree = tree
     end
 
-    COMMANDS.each do |command|
+    COMMANDS_WITH_DEFAULT_INTERFACE.each do |command|
       klass = Supa::Commands.const_get(command.capitalize)
 
-      define_method(command) do |name, options = {}, &block|
+      define_method(command) do |name, **options, &block|
         klass.new(@subject,
           representer: @representer,
           tree: @tree,
@@ -21,6 +21,12 @@ module Supa
       end
     end
 
+    def attributes(*names, **options)
+      Supa::Commands::Attributes.new(
+        @subject, representer: @representer, tree: @tree, name: names, options: options
+      ).represent
+    end
+
     def to_hash
       @tree.to_hash
     end

data/lib/supa/command.rb

@@ -1,5 +1,7 @@
 module Supa
   class Command
+    UnsupportedModifier = Class.new(StandardError)
+
     def initialize(subject, representer:, tree:, name:, options: {}, &block)
       @subject = subject
       @representer = representer
@@ -16,8 +18,20 @@ module Supa
     private
 
     def value
-      return @representer.send(@options[:modifier], apply_render_flags(raw_value)) if @options[:modifier]
-      apply_render_flags(raw_value)
+      return @value if defined?(@value)
+      value = apply_render_flags(raw_value)
+      @value = modifier ? @representer.send(modifier, value) : value
+    end
+
+    def modifier
+      return @modifier if defined?(@modifier)
+
+      if @options.key?(:modifier) && !@options[:modifier].is_a?(Symbol)
+        raise UnsupportedModifier,
+          "Object #{@options[:modifier].inspect} is not a valid modifier. Please provide symbolized method name."
+      end
+
+      @modifier = @options[:modifier]
     end
 
     def apply_render_flags(val)

data/lib/supa/commands/attribute.rb

@@ -2,8 +2,16 @@ module Supa
   module Commands
     class Attribute < Supa::Command
       def represent
+        return if hide?
+
         @tree[@name] = value
       end
+
+      private
+
+      def hide?
+        value.nil? && hide_when_empty?
+      end
     end
   end
 end

data/lib/supa/commands/attributes.rb

@@ -0,0 +1,19 @@
+module Supa
+  module Commands
+    class Attributes < Supa::Command
+      def represent
+        names.each do |name|
+          Supa::Commands::Attribute.new(
+            @subject, representer: @representer, tree: @tree, name: name, options: @options
+          ).represent
+        end
+      end
+
+      private
+
+      def names
+        @name
+      end
+    end
+  end
+end

data/lib/supa/version.rb

@@ -1,3 +1,3 @@
 module Supa
-  VERSION = '0.3.0'.freeze
+  VERSION = '0.4.1'.freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: supa
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.1
 platform: ruby
 authors:
 - dasnotme
@@ -11,7 +11,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-01-26 00:00:00.000000000 Z
+date: 2017-03-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -167,6 +167,7 @@ files:
 - lib/supa/command.rb
 - lib/supa/commands/append.rb
 - lib/supa/commands/attribute.rb
+- lib/supa/commands/attributes.rb
 - lib/supa/commands/collection.rb
 - lib/supa/commands/namespace.rb
 - lib/supa/commands/object.rb
@@ -194,7 +195,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.6
+rubygems_version: 2.5.1
 signing_key: 
 specification_version: 4
 summary: Ruby object → JSON serialization.