SafetyPin

Interact with a JCR Content Repository using the Ruby code you love.

Originally made to turn long, manually node editing tasks into fast, script-able moments.

Installation

This gem requires JRuby to run

Add this line to your application's Gemfile:

gem 'safety-pin'

And then execute:

$ bundle

Or install it yourself as:

$ gem install safety-pin

Usage

You can interact with the JCR using Ruby code in ways you would expect:

Getting Started

require 'safety-pin'
include SafetyPin

# Login to a JCR
JCR.(hostname: "http://localhost:4502", username: "admin", password: "admin")


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

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

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

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 # persist all changes to JCR

Interactive Shell

You can open an IRB with SafetyPin included and connected to a JCR instance:

$ rbenv global jruby-1.7.0-rc1 # make sure to use JRuby
$ gem install safety-pin
$ safety-pin -h http://localhost:4502
Username: # type username
Password: # type password
>> Node.find("/content")
=> #<SafetyPin::Node:0x146ccf3e>
>> # type whatever

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request