creative_rails_utilities 0.4.4 → 0.4.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: da8068ff68669af009b9d001ca3309828b2738f6
-  data.tar.gz: 05ce3d57ff7b16fd5d725cf93910c60b72a1079d
+  metadata.gz: b64a37df9c84fef7bc29b96d589b9f475459ee59
+  data.tar.gz: 3ccfd498f0d7dcebfa4c896b859c5991dd93e1be
 SHA512:
-  metadata.gz: a215145db575639703d62321060a8996d5d9e82ce1a8875bc3a230192fb1de281fcd36fc259bf29383846226107c4c274148e5595835fbc34f335e4f59e0630a
-  data.tar.gz: cc0f9c257f44d171405902ddaa4d90b9a2db40e87c2ea15cdfb73609e8fdd1af3209a8f80c45849ea01d31e77ee67fa5828a6aa826389393dd4076a31af9bc44
+  metadata.gz: 3815e20f599be7cb52c502a898ecc5fc675cb80c39c736888cc48e5ae8e7aef70cb5e24f37e34028636d65ddebff3de8b7e9fbf68d27128861016c00db652d71
+  data.tar.gz: 372130b0d9e8070ef4005e63b604f6854d89d09315399d6f8ab1f5aab5df84daa68b9e97954989ce0f96bec5361288c8f22a01f110996d185bd90a0ec57b0f5b

data/CHANGELOG.md

@@ -8,6 +8,11 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 -
 ```
 
+## [0.4.5] - 2016-12-05
+### Added
+- URI#merge
+- String#to_query_hash
+
 ## [0.4.4] - 2016-07-18
 ### Added
 - URI#build

data/README.md

@@ -105,7 +105,7 @@ some_hash.fast_sort_keys #=> some_sorted_hash
 ```
 
 ```ruby
-# get a portion even when deleting with zero
+# basically serves as safe division. Get a portion even when deleting with zero
 # whole.safe_per(part)
 100.safe_per(50) #=> 2.0
 3.12.safe_per(2.6) #=> 1.2
@@ -173,6 +173,12 @@ string #=> "1..." instead of "  1..."
 "y".to_bool #=> true
 ```
 
+```rb
+# Convert query string into a hash
+"test=true&apples=yup".to_query_hash
+#=> {"test" => "true", "apples" => "yup"}
+```
+
 ##### URI
 
 ```ruby
@@ -187,6 +193,16 @@ URI.build(scheme: "https", domain: "example.com", path: "/some/path", query: {te
 #=> "https://example.com/some/path?fake=false&test=true"
 ```
 
+```rb
+# URI.merge(uri="", new_query="", replace=false), NB, also accepts hash type new_query argument!
+# merge new query parameters into an existing uri string
+
+URI.merge("http://domain.com?test=true", "test=absolutely&apples=yup") # => "http://domain.com?apples=yup&test=absolutely"
+
+# use the replace trigger to replace the old query parameters with the new ones entirely
+URI.merge("http://domain.com?test=true", {apples: "yup"}, true) #=> "http://domain.com?apples=yup"
+```
+
 #### View Helpers
 Rails-only (via railtie) view helpers have been added, they are automagically loaded and usable upon gem inclusion.
 

data/lib/creative_rails_utilities/string.rb

@@ -27,4 +27,19 @@ class String
     raise(ArgumentError.new "could not interpret '#{self}' as boolean.")
   end
 
+  # convert an URI query string into a symbol hash, does not support array query records (yet)
+  def to_query_hash
+    raise ArgumentError.new("Looks like unsupported array query is used, sorry!") if self.to_s[/\[\]\=/].present?
+
+    query_hash = split("&").reduce({}) do |mem, i|
+      key = i.split("=").first
+      value = i.split("=").second
+
+      mem[key.to_s] = value.to_s
+      mem
+    end
+
+    return query_hash
+  end
+
 end

data/lib/creative_rails_utilities/uri.rb

@@ -11,4 +11,24 @@ module URI
   end
 
   module_function :build
+
+  # use this to merge new query parameters into well-formed URI strings, pass averride as true to replace the query portion with the new one entirely
+  def merge(uri="", new_query="", replace=false)
+    parsed_uri = URI(uri)
+    raise ArgumentError.new(":uri argument is not a well-formed uri string!") if parsed_uri.host.blank?
+
+    query = !new_query.is_a?(String) ? (new_query.try(:to_query).presence || new_query.to_s) : new_query.to_s
+
+    base_uri_options = {scheme: parsed_uri.scheme, domain: parsed_uri.host, path: parsed_uri.path, query: query, fragment: parsed_uri.fragment}
+
+    if !replace
+      query = parsed_uri.query.to_s.to_query_hash.merge(query.to_s.to_query_hash).to_query
+    end
+
+    new_uri = URI.build(**base_uri_options.merge(query: query))
+
+    return new_uri
+  end
+
+  module_function :merge
 end

data/lib/creative_rails_utilities/version.rb

@@ -1,3 +1,3 @@
 module CreativeRailsUtilities
-  VERSION = "0.4.4"
+  VERSION = "0.4.5"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: creative_rails_utilities
 version: !ruby/object:Gem::Version
-  version: 0.4.4
+  version: 0.4.5
 platform: ruby
 authors:
 - Creative
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-07-18 00:00:00.000000000 Z
+date: 2016-12-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport