url_plumber 0.1.0 → 0.1.1

data/README.md

@@ -20,18 +20,22 @@ Or install it yourself as:
 
 ## Usage
 
-It's best to add a helper to your application to use `UrlPlumber` like this:
+`UrlPlumber` has two main functions: changing values inside a hash and reading values stored inside of hash objects.
+
+#### changing url parameters
+
+The easiest way to get start is somewhere along these lines:
 
 ```
-# url_plumber.rb
-module PlumberHelper
+# url_plumber_helper.rb
+module UrlPlumberHelper
   def plumb(key_path, value = nil)
-    return url_for (@plumber ||= ::UrlPlumber::Plumber.new(params)).plumb(key_path, value)
+    return url_for (@plumber ||= ::UrlPlumber::Plumber.new(params)).plumb(key_path => value)
   end
 end
 ```
 
-Then, in your view, you can use it like this:
+You can use it like this:
 
 ```
 # some_view.haml
@@ -44,6 +48,25 @@ Then, in your view, you can use it like this:
 = link_to 'Option B 2', plumb('filter.option_b', 2)
 ```
 
+#### reading url parameters
+
+```
+# url_plumber_helper.rb
+module UrlPlumberHelper
+  def url_inquirer(key_path)
+    return ::ActiveSupport::StringInquirer.new(@plumber ||= ::UrlPlumber::Plumber.new(params)).extract(key_path)
+  end
+end
+```
+
+You can use it like this:
+
+```
+# some_view.haml
+- unless url_inquirer("filter.free_text").blank?
+  = link_to 'clear search', root_path
+```
+
 Mix and match your plumber got you covert :)
 
 ## Contributing

data/lib/url_plumber/plumber.rb

@@ -8,6 +8,22 @@ module UrlPlumber
       @params = dup(params)
     end
 
+    def extract key_path
+      keys = key_path.to_s.split('.').map(&:to_sym)
+      key = keys[-1]
+
+      scope = params
+      keys[0..-2].each do |part|
+        scope = scope.fetch(part) { HashWithIndifferentAccess.new }
+      end
+
+      if scope.has_key?(key)
+        scope[key]
+      else
+        nil
+      end
+    end
+
     def plumb attributes = {}
       scope = dup(params)
       attributes.each do |key, value|

data/lib/url_plumber/version.rb

@@ -1,3 +1,3 @@
 module UrlPlumber
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

data/test/url_plumber_extract_test.rb

@@ -0,0 +1,27 @@
+require "test/unit"
+require "active_support/test_case"
+require "active_support/inflector"
+
+require "url_plumber"
+
+class UrlPlumberExtractTest < ActiveSupport::TestCase
+  test 'returns nil for key_paths that do not match' do
+    plumber = ::UrlPlumber::Plumber.new({ "foo" => 42 })
+    assert_nil plumber.extract("bar")
+  end
+
+  test 'returns nil for nested, unknown key_paths' do
+    plumber = ::UrlPlumber::Plumber.new({ "foo" => { "bar" => 12 } })
+    assert_nil plumber.extract("foo.x")
+  end
+
+  test 'returns value for known key_paths' do
+    plumber = ::UrlPlumber::Plumber.new({ "foo" => 42 })
+    assert_equal 42, plumber.extract("foo")
+  end
+
+  test 'returns value for known nested key_paths' do
+    plumber = ::UrlPlumber::Plumber.new({ "foo" => { "bar" => 12 } })
+    assert_equal 12, plumber.extract("foo.bar")
+  end
+end

data/test/{url_plumber_test.rb → url_plumber_plumb_test.rb}

@@ -4,7 +4,7 @@ require "active_support/inflector"
 
 require "url_plumber"
 
-class UrlPlumberTest < ActiveSupport::TestCase
+class UrlPlumberPlumbTest < ActiveSupport::TestCase
   test 'removes key from hash' do
     plumber = ::UrlPlumber::Plumber.new({ "foo" => 42 })
     assert_empty plumber.plumb("foo" => nil)

data/url_plumber.gemspec

@@ -20,4 +20,8 @@ Gem::Specification.new do |gem|
 
   gem.add_dependency 'activesupport', '>= 3.0.0'
   gem.add_development_dependency 'rake', '~> 10.0.3'
+
+  # signing key and certificate chain
+  gem.signing_key = 'gem-private_key.pem'
+  gem.cert_chain  = ['gem-public_cert.pem']
 end

metadata

@@ -2,14 +2,41 @@
 name: url_plumber
 version: !ruby/object:Gem::Version
   prerelease: 
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Raphael Randschau
 autorequire: 
 bindir: bin
-cert_chain: []
-date: 2013-02-05 00:00:00.000000000 Z
+cert_chain:
+- !binary |-
+  LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSURMakNDQWhhZ0F3SUJB
+  Z0lCQURBTkJna3Foa2lHOXcwQkFRVUZBREE5TVJJd0VBWURWUVFEREFsdWFX
+  TnYKYkdGcE9EWXhFakFRQmdvSmtpYUprL0lzWkFFWkZnSnRaVEVUTUJFR0Nn
+  bVNKb21UOGl4a0FSa1dBMk52YlRBZQpGdzB4TXpBeU1EVXlNRFExTWpaYUZ3
+  MHhOREF5TURVeU1EUTFNalphTUQweEVqQVFCZ05WQkFNTUNXNXBZMjlzCllX
+  azROakVTTUJBR0NnbVNKb21UOGl4a0FSa1dBbTFsTVJNd0VRWUtDWkltaVpQ
+  eUxHUUJHUllEWTI5dE1JSUIKSWpBTkJna3Foa2lHOXcwQkFRRUZBQU9DQVE4
+  QU1JSUJDZ0tDQVFFQW9lSHIwbTMvY1Q1Z1dURzU2Z3duMjA1agpibGZERXl3
+  cWZIc3FDcnExZjNZS0NHSEdPY0JmUkZaQlRxeG5WU0dRZGdUa0lCNFYzb3A4
+  V2xmTFR3QlIxUC82CkxDZGlSd2RObG9IeEoyaGh6MVBZTDYzKzZuVTZDb0ZW
+  NDZIdUxSL0dST3lhRGlhclpDQm9la0Z6a0RFbDVUdzEKcUVQZmJHQ0dibDND
+  VWZkc1NCWWhNcW0zSEp4bmFOWnQ3dGNFdE9EYUF6Yi8zNkdvU1lLWmhiWG9B
+  dHBvbUJENAplTmk5ZFRNYjc2N3FYTDNtRm9FOUgrNWpkVjlsdVgzQ1huV3dx
+  WS91N3U4b29udHN5b0hsQWhvYW45bExScjZNCjdKalFyUXN6dm94SlplN3NS
+  RFhidUN1anJ4cVQxVkh4QkF3YnFHL1RFS3NkQWZpaWRZd0ZBZlBRZ1dWRkR3
+  SUQKQVFBQm96a3dOekFKQmdOVkhSTUVBakFBTUIwR0ExVWREZ1FXQkJTMEx6
+  RUp2eVNwR0tFT3JqTHpDWlloejZLSwpkekFMQmdOVkhROEVCQU1DQkxBd0RR
+  WUpLb1pJaHZjTkFRRUZCUUFEZ2dFQkFGVjFZRm5XRE5WL1luS2JTY2loCkhB
+  M2hYK1NLTTdkQ0lZUjNqOFFORVRqNi9lNXN5czN0dHNNaTJSZ3VVNHNzQlBx
+  cE9TUWJYR01UZEpOMi9SZkkKZFE0bG9nSS92T2RlWkd0cDBsL1lmdjNPZ2pM
+  aitGS3k5L2R3MGMxY1BhNFJaS3gvckhUcFYrTXlIWlR3THVybgpxUldEdkVh
+  eGR4UkhHTk1wTHhUdWtqcFBaOElyc2VZZkROOXVERzNGV1M3NmdyMmhhL2FP
+  d0lnZHFtQWkzRUhMCmNwUW0wNG9VNDAzZkdKMWxIZ1ZFeHdxNUhVTWV1TElI
+  b3QybzdxaE9Wb1Y0dXQvYVVXWlVGK013R3VtNU5GUlYKQXJnN0RwRjJWSnBx
+  dDg2d1RkQ1prQnBNcktodFlVRkp1ay8zckdHSEd6Z213cXlCQ0dmWDZDMXN5
+  cmNoa09QUApRT1k9Ci0tLS0tRU5EIENFUlRJRklDQVRFLS0tLS0K
+date: 2013-02-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   version_requirements: !ruby/object:Gem::Requirement
@@ -58,7 +85,8 @@ files:
 - lib/url_plumber.rb
 - lib/url_plumber/plumber.rb
 - lib/url_plumber/version.rb
-- test/url_plumber_test.rb
+- test/url_plumber_extract_test.rb
+- test/url_plumber_plumb_test.rb
 - url_plumber.gemspec
 homepage: https://github.com/nicolai86/url_plumber
 licenses:
@@ -86,5 +114,6 @@ signing_key:
 specification_version: 3
 summary: modify parts of a hash using a key_path
 test_files:
-- test/url_plumber_test.rb
+- test/url_plumber_extract_test.rb
+- test/url_plumber_plumb_test.rb
 has_rdoc: