safety-pin 0.1.2 → 0.1.3

data/.rbenv-version

@@ -0,0 +1 @@
+jruby-1.7.0-rc2

data/README.md

@@ -24,22 +24,63 @@ Or install it yourself as:
 
 You can interact with the JCR using Ruby code in ways you would expect:
 
+### Getting Started
+
 ```ruby
 require 'safety-pin'
 include SafetyPin
 
+# Login to a JCR
+JCR.login(hostname: "http://localhost:4502", username: "admin", password: "admin")
+
+```
+
+### Navigating
+
+```ruby
 node = Node.find("/content") # returns node at path
 node.child("foo")            # returns child by name
 node.children                # returns array of children
+node.parent                  # returns parent node
+```
+
+### Properties
 
+```ruby
+node = Node.find("/content")
 node.properties                    # returns hash of unprotected properties
 node.properties = {"bar" => "baz"} # replaces unprotected properties
 
 node["foo"]         # returns value of property
 node["foo"] = "bar" # assigns value to property
+```
+
+### Saving to JCR
+
+```ruby
+node = Node.find("/content")
+node["foo"] = "Hello JCR"    # set value in session
+node.save                    # persisted changes to JCR
+
+node["foo"] = "baz"
+node["foo"]         # => "baz"
+node.refresh        # reloads node from JCR
+node["foo"]         # => "Hello JCR"
+```
+
+### Mass-assign Property Values
+
+```ruby
+node = Node.find("/content")
+node["foo"] # => "bar"
+node.children.first["foo"] # => "child foo"
+
+node.replace_property name: "foo", target: /.+/, replacement: "new value", recursive: true
+
+node["foo"] # => "new value"
+node.children.first["foo"] # => "new value"
 
-node.save    # saves changes to session
-node.refresh # reloads node from JCR
+node.save # persist all changes to JCR
 ```
 
 ## Interactive Shell

data/lib/safety_pin/jcr.rb

@@ -36,7 +36,7 @@ module SafetyPin
     end
 
     def self.dev_login
-      login(:hostname => "http://localhost:4502", :username => "admin", :password => "admin")
+      login(:hostname => "http://localhost:4502", :username => "admin", :password => "cq4me")
     end
   end
 end

data/lib/safety_pin/node.rb

@@ -360,18 +360,22 @@ module SafetyPin
       NodeBlueprint.new(:path => path.to_s, :properties => properties, :primary_type => primary_type)
     end
 
-    def replace_property(opts)
+    def replace_property(opts, &block)
       opts = {recursive: false}.merge(opts)
-      name = opts.fetch(:name)
-      target = opts.fetch(:target)
-      replacement = opts.fetch(:replacement)
+      name_pattern = opts.fetch(:name)
+      target_pattern = opts.fetch(:target)
+      replacement_block = block || lambda {|value| opts.fetch(:replacement) }
 
-      modified_nodes = []
-      if has_property(name) and self[name].match(target)
-        self[name] = replacement 
-        modified_nodes << self
+      modified = false
+      properties.each do |name, value|
+        if name.match(name_pattern) and value.match(target_pattern)
+          self[name] = replacement_block.call(value)
+          modified = true
+        end
       end
 
+      modified_nodes = []
+      modified_nodes << self if modified
       modified_nodes << children.map {|child_node| child_node.replace_property(opts) } if opts.fetch(:recursive)
 
       modified_nodes.flatten

data/lib/safety_pin/version.rb

@@ -1,3 +1,3 @@
 module SafetyPin
-  VERSION = "0.1.2"
+  VERSION = "0.1.3"
 end

data/spec/node_spec.rb

@@ -709,4 +709,56 @@ describe SafetyPin::Node do
       expect { SafetyPin::Node.find("/").parent }.to raise_error(SafetyPin::NodeError)
     end
   end
+
+  describe "#replace_property" do
+    let(:node) do
+      properties = {"bar" => "baz", "another" => "just for completeness", "barbell" => "for regex detail"}
+      blueprint = SafetyPin::NodeBlueprint.new(:path => "/content/foo", properties: properties)
+      SafetyPin::Node.create(blueprint)
+    end
+
+    it "requires a property name, a target regex/string, and a replacement value or block" do
+      expect { node.replace_property({})                         }.to raise_error(KeyError)
+      expect { node.replace_property(name: "bar")                }.to raise_error(KeyError)
+      expect { node.replace_property(name: "bar", target: /baz/) }.to raise_error(KeyError)
+      expect { node.replace_property(name: "bar", target: /baz/, replacement: "NOT BAZ") }.to_not raise_error
+      expect { node.replace_property(name: "bar", target: /baz/) {|value| "bob"} }.to_not raise_error
+    end
+
+    it "can take a regex property name" do
+      node.replace_property(name: /.+/, target: /.+/, replacement: "FOOFOO")
+      node.properties.values.each {|value| value.should == "FOOFOO" }
+    end
+
+    it "only replaces property values when the name matches" do
+      node.replace_property(name: /^bar.*/, target: /.+/, replacement: "FOOFOO")
+      node["bar"].should == "FOOFOO"
+      node["barbell"].should == "FOOFOO"
+      node["another"].should_not == "FOOFOO"
+    end
+
+    context "when given a block" do
+      it "yields the property value to the block and sets the property with the return of the block" do
+        node.replace_property(name: "bar", target: /.+/) {|value| value.upcase }
+        node["bar"].should == "BAZ"
+      end
+
+      it "ignores replacement value" do
+        node.replace_property(name: "bar", target: /.+/, replacement: "replacement value") {|value| value.upcase }
+        node["bar"].should == "BAZ"
+      end
+    end
+
+    it "returns modified nodes" do
+      node.replace_property(name: "bar", target: /.+/, replacement: "whatever").should have(1).item
+      node.replace_property(name: "asdf", target: /.+/, replacement: "whatever").should be_empty
+    end
+
+    it "does not save changes to JCR" do
+      node.replace_property(name: "bar", target: /.+/, replacement: "BAZ")
+      node["bar"].should == "BAZ"
+      node.reload
+      node["bar"].should_not == "BAZ"
+    end
+  end
 end

metadata

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: safety-pin
 version: !ruby/object:Gem::Version
-  version: 0.1.2
-  prerelease: 
+  prerelease:
+  version: 0.1.3
 platform: ruby
 authors:
 - Jordan Raine
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2013-05-08 00:00:00.000000000 Z
+date: 2013-05-13 00:00:00.000000000 Z
 dependencies: []
 description: An easy-to-use JCR connector for JRuby
 email:
@@ -19,6 +19,7 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- .rbenv-version
 - .rspec
 - .rvmrc
 - Gemfile
@@ -139,26 +140,28 @@ files:
 - spec/where_condition_spec.rb
 homepage: https://github.com/jnraine/safety-pin
 licenses: []
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
-      version: '0'
-required_rubygems_version: !ruby/object:Gem::Requirement
+      version: !binary |-
+        MA==
   none: false
+required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
-      version: '0'
+      version: !binary |-
+        MA==
+  none: false
 requirements: []
-rubyforge_project: 
-rubygems_version: 1.8.23
-signing_key: 
+rubyforge_project:
+rubygems_version: 1.8.24
+signing_key:
 specification_version: 3
 summary: JCR connector for JRuby
 test_files:
@@ -169,4 +172,3 @@ test_files:
 - spec/query_spec.rb
 - spec/spec_helper.rb
 - spec/where_condition_spec.rb
-has_rdoc: