beret 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6490a904f8d44b4742981355f88f276ffc6b15cf
-  data.tar.gz: 2f242277dc37205dfe6ea83831dd37e472fd5ff5
+  metadata.gz: 1273b083d974c464f726e6510178f8eaeddcf1cc
+  data.tar.gz: f35313f862feeaa8f5e1cffa5a034c8cc419a854
 SHA512:
-  metadata.gz: 73920e909c96e1aecca8d5b1f5c7611ad8a2495e78a578f2a9dd7825ac8f7104f979af9464f9ee37c52a17397ce1ecc3d87d3cc083d34e3f6c6bff653a0a56ad
-  data.tar.gz: 6dc79c0ce717b81d84b67c23530de3ab3121cd2d296c638be8664e346c8d6f1ab3b97a653363bd161057fa75cc92bd1c635984913962353ba94a710468dd1a18
+  metadata.gz: 399c3832571dd080b208d3fcdf610dbfbe530e5d089ad33a35580707cb0ff6bb1fb66e2778c1dbde0135e4fc17ecc74c161b4cbbb5cf70a726b99416a19d789f
+  data.tar.gz: 55eca025ae4b0bc64034eebec3be716b30b18dd9718100fd90792321656c98e682d0a61a8c664c9af9c57bf57e77d399dc79c46e61aa159ce45a1d2cc99cd40b

data/README.md

@@ -31,17 +31,33 @@ ck_json = "[{\"content\":{\"text\":\"This is some text.\"},\"type\":\"redactor\"
 beret = Beret.new(ck_json)
 
 # Finding values
-beret.find(:photo_id) # => [<Beret::Result value="42">, <Beret::Result value="144">]
-beret.find(:photo_id, in: [:image]) # => [<Beret::Result value="42">]
-beret.find(:photo_id, in: [:avatar]) # => [<Beret::Result value="144">]
+beret.find(:photo_id) # => [<Beret::SearchResult value="42">, <Beret::SearchResult value="144">]
+beret.find(:photo_id, in: [:image]) # => [<Beret::SearchResult value="42">]
+beret.find(:photo_id, in: [:avatar]) # => [<Beret::SearchResult value="144">]
 beret.find(:photo_id, in: [:some_other_block_type]) # => []
 
+# Using SearchResult objects
+result = beret.find(:photo_id).first
+result.value # => "42"
+result.field_name # => "photo_id"
+result.block # => <Beret::Block>
+result.block.attributes # => { "photo_id" => "42" }
+result.block.type # => "image"
+result.block.parent # => <Beret::Block>
+
 # In-place updating
-beret.update(:photo_id, in: [:image]) do |value|
+beret.update(:photo_id, in: [:image]) do |value, block|
   # Transform the value any way you'd like here.
   # In this example, we convert a plain old ID to a SGID
   Image.find(value).to_sgid
 end
 
-# Retrieving JSON
+beret.update(:photo_id, in: [:image]) do |value, block|
+  # You can also replace the contents of an entire block with
+  # Beret::Block#update_content
+  image = Image.find(value)
+  block.update_content(image.to_json)
+end
+
+# Retrieving JSON (useful for saving or returning the net result of an in-place update)
 beret.to_json

data/lib/beret/block.rb

@@ -19,6 +19,10 @@ module Beret
       @attributes[field_name.to_s] = value
     end
 
+    def update_content(new_content)
+      @attributes = Hash(new_content)
+    end
+
     def type
       block_json[type_key]
     end

data/lib/beret/block_set.rb

@@ -13,7 +13,7 @@ module Beret
       results = find(field_name, options)
 
       results.each do |result|
-        new_value = yield result.value
+        new_value = yield result.value, result.block
         result.block.update_attribute(field_name, new_value)
       end
     end

data/lib/beret/version.rb

@@ -2,7 +2,7 @@ module Beret
 
   VERSION = [
     0,    # major
-    3,    # minor
+    4,    # minor
     0     # patch
   ].join('.')
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: beret
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Lawson Kurtz (Viget)
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-10-23 00:00:00.000000000 Z
+date: 2015-10-26 00:00:00.000000000 Z
 dependencies: []
 description: Easily work with Colonel Kurtz-generated JSON data in your Ruby application
 email: