compose_url 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4f02e1ca714b06f3162a64ccc1aad00263342ae5
+  data.tar.gz: a02d63d16c71d7519c1379fb986cf9f1003a0e1e
+SHA512:
+  metadata.gz: 60b15d22131abe5877144faaffdae86a8f8fac04820aef93d299f39429bf616e804cf4bbdc7d031cc26dbba6ccb88df9d6f7ee5ac6f0653b63f9d5eb394bcf20
+  data.tar.gz: 94d78cbcfaefd8baf1e98e18fe153507f4feee202cccae8baf122dbdfe7f8ab9fa86769e7ce762218a3e0aa53d2adc8bf8c8e6be1692c2c3846fd048a117dc3f

data/lib/compose_url.rb

@@ -0,0 +1,66 @@
+require 'cgi'
+require 'uri'
+
+class ComposeURL
+  attr_accessor :params
+
+  def initialize(baseurl, params={})
+    @url = baseurl
+    @params = params
+  end
+
+  def add_param(k, v)
+    @params[k] = v
+  end
+
+  def remove_param(k)
+    @params.delete(k)
+  end
+
+  def url
+    validate_url(build_url)
+  end
+
+  def to_s
+    url
+  end
+
+  private
+
+  # todo: is this a valid key?
+  def validate_key(k)
+    raise ComposeURLError.new('Invalid key') unless k == escape(k) # key shouldn't require escaping, or should it?
+    escape(k)
+  end
+
+  # todo: is this a valid value?
+  def validate_value(v)
+    escape(v)
+  end
+
+  def validate_url(url)
+    raise ComposeURLError.new('Resulting URL is invalid') unless url =~ /\A#{URI::regexp}\z/
+    url
+  end
+
+  def params_string
+    @params.map { |k,v|
+      "#{validate_key(k)}=#{validate_value(v)}"
+    }.join('&')
+  end
+
+  def escape(s)
+    CGI.escape(s)
+  end
+
+  def build_url
+    @params.length == 0 ? "#{@url}" : "#{@url}?#{params_string}"
+  end
+
+  # todo: support arrays
+  # todo: support hash
+end
+
+class ComposeURLError < StandardError
+  # todo: custom error handling
+end

metadata

@@ -0,0 +1,45 @@
+--- !ruby/object:Gem::Specification
+name: compose_url
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Ryan Burnette
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-12-01 00:00:00.000000000 Z
+dependencies: []
+description: A Ruby class that helps you compose a URL string with query parameters
+  without all the fuss.
+email: ryan.burnette@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/compose_url.rb
+homepage: https://github.com/ryanburnette/compose_url
+licenses:
+- Apache2
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Helps you compose a URL.
+test_files: []