witness 2.0.0

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/Gemfile

@@ -0,0 +1,12 @@
+source "http://rubygems.org"
+
+gem "activesupport", ">= 3.0.0"
+gem "sigil", ">= 1.0.0"
+gem "rack"
+
+group :development do
+  gem "rspec", "~> 2.1.0"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.5.1"
+  gem "rcov", ">= 0"
+end

data/Gemfile.lock

@@ -0,0 +1,37 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activesupport (3.0.3)
+    diff-lcs (1.1.2)
+    git (1.2.5)
+    i18n (0.5.0)
+    jeweler (1.5.1)
+      bundler (~> 1.0.0)
+      git (>= 1.2.5)
+      rake
+    rack (1.2.1)
+    rake (0.8.7)
+    rcov (0.9.9)
+    rspec (2.1.0)
+      rspec-core (~> 2.1.0)
+      rspec-expectations (~> 2.1.0)
+      rspec-mocks (~> 2.1.0)
+    rspec-core (2.1.0)
+    rspec-expectations (2.1.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.1.0)
+    sigil (1.0.0)
+      activesupport (>= 3.0.0)
+      i18n
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activesupport (>= 3.0.0)
+  bundler (~> 1.0.0)
+  jeweler (~> 1.5.1)
+  rack
+  rcov
+  rspec (~> 2.1.0)
+  sigil (>= 1.0.0)

data/Rakefile

@@ -0,0 +1,49 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "witness"
+  gem.homepage = "http://github.com/steveh/witness"
+  gem.license = "MIT"
+  gem.summary = "Witness"
+  gem.description = "Witness"
+  gem.email = "steve@seven.net.nz"
+  gem.authors = ["Steve Hoeksema"]
+  # Include your dependencies below. Runtime dependencies are required when using your gem,
+  # and development dependencies are only needed for development (ie running rake tasks, tests, etc)
+  gem.add_development_dependency 'rspec', '>= 2.1.0'
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "witness #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/TODO

@@ -0,0 +1,11 @@
+# def self.request(params)
+#   raise Error, "Provided params must be a Hash" unless params.kind_of?(Hash)
+#   raise Error, "Provided params not set" if params.empty?
+# end
+#
+# def self.witness(params, key, slice_slug)
+#   raise Error, "Provided params must be a Hash" unless params.kind_of?(Hash)
+#   raise Error, "Provided params not set" if params.empty?
+#   raise Error, "Key not set" if key.blank?
+#   raise Error, "Expected slice slug not set" if slice_slug.blank?
+# end

data/VERSION

@@ -0,0 +1 @@
+2.0.0

data/lib/witness/base.rb

@@ -0,0 +1,89 @@
+module Witness
+  class Base
+    VALID_TYPES = [:string, :integer, :symbol]
+
+    class_inheritable_accessor :actions, :presence, :columns
+
+    self.actions  ||= []
+    self.columns  ||= {}
+    self.presence ||= {}
+
+    def self.action(*action_names)
+      [*action_names].each do |action_name|
+        self.actions << action_name.to_sym
+
+        class_eval <<-end_eval
+          def self.#{action_name.to_sym}(provided_params)
+            command = "#{action_name}".to_sym
+            construct(provided_params.update(:command => command))
+          end
+        end_eval
+      end
+    end
+
+    def self.column(column, *attr_names)
+      configuration = { :type => :string, :name => column.to_s.humanize }
+      configuration.update(attr_names.extract_options!)
+
+      self.columns[column] = configuration
+
+      attr_accessor column
+    end
+
+    def self.validates_presence_of(*attr_names)
+      configuration = { :on => self.actions }
+      configuration.update(attr_names.extract_options!)
+
+      [*configuration[:on]].each do |on|
+        self.presence[on] ||= []
+
+        [*attr_names].each do |attr_name|
+          self.presence[on] << attr_name
+        end
+      end
+    end
+
+    protected :initialize
+
+    private
+
+      def self.construct(provided_params)
+        command = provided_params[:command]
+
+        result = new
+
+        self.columns.each do |column, configuration|
+          if provided_params[column] == nil || provided_params[column] == ""
+            if self.presence[command] && self.presence[command].include?(column)
+              raise Witness::Error, "#{configuration[:name]} not set"
+            end
+          else
+            value = case configuration[:type]
+              when :string
+                provided_params[column].to_s
+              when :integer
+                provided_params[column].to_i
+              when :symbol
+                provided_params[column].to_sym
+              when :boolean
+                case provided_params[column]
+                  when true, "true", 1, "1"
+                    true
+                  when false, "false", 0, "0"
+                    false
+                  else
+                    raise Witness::Error, "#{configuration[:name]} not valid: #{provided_params[column].inspect}"
+                end
+              else
+                provided_params[column]
+            end
+
+            result.send("#{column.to_s}=", value)
+          end
+        end
+
+        result
+      end
+
+  end
+end

data/lib/witness/error.rb

@@ -0,0 +1,6 @@
+module Witness
+
+  class Error < StandardError
+  end
+
+end

data/lib/witness.rb

@@ -0,0 +1,23 @@
+require "active_support/core_ext/class/inheritable_attributes"
+require "uri"
+require "rack/utils"
+require "sigil"
+
+require "witness/base"
+require "witness/error"
+
+module Witness
+
+  def self.update_url(url, new_params)
+    uri = URI.parse(url)
+    query = uri.query
+    params = Rack::Utils.parse_nested_query(query).symbolize_keys
+    uri.path = "/" if uri.path == ""
+    uri.scheme = "http" if uri.scheme.nil?
+    uri.query = params.update(new_params).to_query
+    uri.to_s
+  rescue
+    nil
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,11 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'witness'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+end

data/spec/support/sample_base.rb

@@ -0,0 +1,15 @@
+class SampleBase < Witness::Base
+
+  action :generate, :receive
+
+  column :first_name
+  column :last_name, :type => :string, :name => "Person last name"
+  column :age, :type => :integer
+  column :base_type, :type => :symbol
+  column :data, :type => nil
+
+  validates_presence_of :first_name, :age
+  validates_presence_of :last_name, :on => :generate
+  validates_presence_of :base_type, :on => :receive
+
+end

data/spec/support/sample_verification_request.rb

@@ -0,0 +1,29 @@
+class SampleVerificationRequest < Witness::Base
+
+  action :generate, :receive
+
+  column :cas_host, :name => "CAS host"
+  column :slice_slug, :name => "Slice"
+  column :secure_area_id, :type => :integer, :name => "Secure Area ID"
+  column :request_url, :name => "Request URL"
+  column :receive_contact_url, :name => "Receive Contact URL"
+  column :receive_login_url, :name => "Receive Login URL"
+
+  validates_presence_of :slice_slug, :secure_area_id, :request_url, :receive_contact_url, :receive_login_url
+  validates_presence_of :cas_host, :on => :generate
+
+  def url
+    Witness.update_url("http://#{cas_host}/cas/contact/witness", params)
+  end
+
+  def params
+    {
+      :slice_slug => slice_slug,
+      :secure_area_id => secure_area_id,
+      :request_url => request_url,
+      :receive_contact_url => receive_contact_url,
+      :receive_login_url => receive_login_url,
+    }.reject { |k, v| v.nil? }
+  end
+
+end

data/spec/support/sample_verification_response.rb

@@ -0,0 +1,62 @@
+class SampleVerificationResponse < Witness::Base
+
+  action :generate, :receive
+
+  column :slice_slug, :name => "Slice"
+  column :secure_area_id, :type => :integer, :name => "Secure Area ID"
+  column :request_url, :name => "Request URL"
+  column :receive_contact_url, :name => "Receive Contact URL"
+  column :contact_id, :type => :integer, :name => "Contact ID"
+  column :authorized, :type => :boolean, :name => "Authorization"
+  column :key
+
+  validates_presence_of :slice_slug, :request_url, :contact_id, :key
+  validates_presence_of :receive_contact_url, :on => :generate
+
+  attr_accessor :signature
+
+  def url
+    Witness.update_url(receive_contact_url, params)
+  end
+
+  def secure_params
+    {
+      :slice_slug => slice_slug,
+      :contact_id => contact_id,
+      :secure_area_id => secure_area_id,
+      :authorized => authorized,
+      :request_url => request_url,
+      :signature => signature,
+    }.reject { |k, v| v.nil? }
+  end
+
+  def params
+    _params = secure_params
+    sigil = Sigil::Base.new(_params, key)
+    _params.update(:signature => sigil.signature).reject { |k, v| v.nil? }
+  end
+
+  def self.construct(provided_params)
+    response = super(provided_params)
+
+    command = provided_params[:command]
+
+    if command == :receive
+      if provided_params[:signature].blank?
+        raise Witness::Error, "Signature not set"
+      end
+
+      sigil = Sigil::Base.new(response.secure_params, response.key)
+
+      verified = sigil.verify(provided_params[:signature])
+
+      if !verified
+        raise Witness::Error, "Signature does not match"
+      end
+
+    end
+
+    response
+  end
+
+end

data/spec/witness/base_spec.rb

@@ -0,0 +1,94 @@
+require "spec_helper"
+
+describe Witness::Base do
+
+  it "should not allow initialization" do
+    SampleBase.new.should raise_error
+  end
+
+  describe "action definition" do
+
+    it "should respond to a defined call" do
+      SampleBase.generate({ :first_name => "First", :last_name => "Last", :age => "42" })
+    end
+
+    it "should not respond to an undefined defined call" do
+      lambda { SampleBase.banana({}) }.should raise_error(NoMethodError)
+    end
+
+  end
+
+  describe "column definition" do
+
+    it "should define a default name" do
+      SampleBase.columns[:first_name][:name].should == "First name"
+    end
+
+    it "should allow override names" do
+      SampleBase.columns[:last_name][:name].should == "Person last name"
+    end
+
+    it "should define a default type" do
+      SampleBase.columns[:first_name][:type].should == :string
+    end
+
+    it "should allow string types" do
+      SampleBase.columns[:last_name][:type].should == :string
+    end
+
+    it "should allow integer types" do
+      SampleBase.columns[:age][:type].should == :integer
+    end
+
+    it "should allow symbol types" do
+      SampleBase.columns[:base_type][:type].should == :symbol
+    end
+
+  end
+
+  describe "validates presence of" do
+
+    it "should raise an error for a nil param" do
+      lambda { SampleBase.generate({ :first_name => nil }) }.should raise_error(Witness::Error, /name not set/)
+    end
+
+    it "should raise an error for an empty param" do
+      lambda { SampleBase.generate({ :first_name => "" }) }.should raise_error(Witness::Error, /name not set/)
+    end
+
+    it "should not raise an error for a set param" do
+      lambda { SampleBase.generate({ :first_name => "First", :last_name => "Last", :age => "42" }) }.should_not raise_error
+    end
+
+    it "should not raise an error for a zero param" do
+      lambda { SampleBase.generate({ :first_name => "First", :last_name => "Last", :age => "0" }) }.should_not raise_error
+    end
+
+    it "should respect :on setting" do
+      lambda { SampleBase.receive({ :first_name => "First", :base_type => "contact", :age => "42" }) }.should_not raise_error
+    end
+
+  end
+
+  describe "type casting" do
+
+    before do
+      @data = "flibby"
+      @result = SampleBase.receive({ :first_name => "First", :last_name => "Last", :age => "42", :base_type => "contact", :data => @data })
+    end
+
+    it "should cast integers" do
+      @result.age.should == 42
+    end
+
+    it "should cast symbols" do
+      @result.base_type.should == :contact
+    end
+
+    it "should leave alone" do
+      @result.data.should == @data
+    end
+
+  end
+
+end

data/spec/witness/sample_verification_request_spec.rb

@@ -0,0 +1,130 @@
+require "spec_helper"
+
+describe SampleVerificationRequest do
+
+  it "should not allow initialization" do
+     SampleVerificationRequest.new.should raise_error
+  end
+
+  describe "generate" do
+
+    before do
+      @valid_generate_params = {
+        :cas_host => "cas.local",
+        :slice_slug => "banana",
+        :secure_area_id => 42,
+        :request_url => "http://www.example.com/secure",
+        :receive_contact_url => "http://www.example.com/receive?cat=meow",
+        :receive_login_url => "http://www.example.com/login?cat=meow",
+      }
+
+      @valid_params = @valid_generate_params.dup
+      @valid_params.delete(:cas_host)
+    end
+
+    describe "initialization" do
+
+      it "should generate" do
+        SampleVerificationRequest.generate(@valid_generate_params)
+      end
+
+      it "should raise an error if cas host is not set" do
+        @valid_generate_params.delete(:cas_host)
+        lambda { SampleVerificationRequest.generate(@valid_generate_params) }.should raise_error(Witness::Error, /CAS host not set/)
+      end
+
+      it "should raise an error if Slice slug is not set" do
+        @valid_generate_params.delete(:slice_slug)
+        lambda { SampleVerificationRequest.generate(@valid_generate_params) }.should raise_error(Witness::Error, /Slice not set/)
+      end
+
+      it "should raise an error if Secure Area ID is not set" do
+        @valid_generate_params.delete(:secure_area_id)
+        lambda { SampleVerificationRequest.generate(@valid_generate_params) }.should raise_error(Witness::Error, /Secure Area ID not set/)
+      end
+
+      it "should raise an error if Request URL is not set" do
+        @valid_generate_params.delete(:request_url)
+        lambda { SampleVerificationRequest.generate(@valid_generate_params) }.should raise_error(Witness::Error, /Request URL not set/)
+      end
+
+      it "should raise an error if Receive Contact URL is not set" do
+        @valid_generate_params.delete(:receive_contact_url)
+        lambda { SampleVerificationRequest.generate(@valid_generate_params) }.should raise_error(Witness::Error, /Receive Contact URL not set/)
+      end
+
+      it "should raise an error if Receive Login URL is not set" do
+        @valid_generate_params.delete(:receive_login_url)
+        lambda { SampleVerificationRequest.generate(@valid_generate_params) }.should raise_error(Witness::Error, /Receive Login URL not set/)
+      end
+
+    end
+
+    describe "parameters" do
+
+      it "should generate parameters" do
+        request = SampleVerificationRequest.generate(@valid_generate_params)
+        request.params.should == @valid_params
+      end
+
+    end
+
+    describe "url" do
+
+      it "should generate a url" do
+        request = SampleVerificationRequest.generate(@valid_generate_params)
+        request.url.should == "http://cas.local/cas/contact/witness?receive_contact_url=http%3A%2F%2Fwww.example.com%2Freceive%3Fcat%3Dmeow&receive_login_url=http%3A%2F%2Fwww.example.com%2Flogin%3Fcat%3Dmeow&request_url=http%3A%2F%2Fwww.example.com%2Fsecure&secure_area_id=42&slice_slug=banana"
+      end
+
+    end
+
+  end
+
+  describe "receive" do
+
+    before do
+      @valid_generate_params = {
+        :slice_slug => "banana",
+        :secure_area_id => 42,
+        :request_url => "http://www.example.com/secure",
+        :receive_contact_url => "http://www.example.com/receive?cat=meow",
+        :receive_login_url => "http://www.example.com/login?cat=meow",
+      }
+    end
+
+    describe "initialization" do
+
+      it "should generate" do
+        SampleVerificationRequest.receive(@valid_generate_params)
+      end
+
+      it "should raise an error if Slice slug is not set" do
+        @valid_generate_params.delete(:slice_slug)
+        lambda { SampleVerificationRequest.receive(@valid_generate_params) }.should raise_error(Witness::Error, /Slice not set/)
+      end
+
+      it "should raise an error if Secure Area ID is not set" do
+        @valid_generate_params.delete(:secure_area_id)
+        lambda { SampleVerificationRequest.receive(@valid_generate_params) }.should raise_error(Witness::Error, /Secure Area ID not set/)
+      end
+
+      it "should raise an error if Request URL is not set" do
+        @valid_generate_params.delete(:request_url)
+        lambda { SampleVerificationRequest.receive(@valid_generate_params) }.should raise_error(Witness::Error, /Request URL not set/)
+      end
+
+      it "should raise an error if Receive Contact URL is not set" do
+        @valid_generate_params.delete(:receive_contact_url)
+        lambda { SampleVerificationRequest.receive(@valid_generate_params) }.should raise_error(Witness::Error, /Receive Contact URL not set/)
+      end
+
+      it "should raise an error if Receive Login URL is not set" do
+        @valid_generate_params.delete(:receive_login_url)
+        lambda { SampleVerificationRequest.receive(@valid_generate_params) }.should raise_error(Witness::Error, /Receive Login URL not set/)
+      end
+
+    end
+
+  end
+
+end

data/spec/witness/sample_verification_response_spec.rb

@@ -0,0 +1,168 @@
+require "spec_helper"
+
+describe SampleVerificationResponse do
+
+  it "should not allow initialization" do
+     SampleVerificationResponse.new.should raise_error
+  end
+
+  describe "generate" do
+
+    before do
+      @valid_generate_params = {
+        :slice_slug => "banana",
+        :secure_area_id => 42,
+        :request_url => "http://www.example.com/secure",
+        :receive_contact_url => "http://www.example.com/receive?cat=meow",
+        :receive_login_url => "http://www.example.com/login?cat=meow",
+        :contact_id => 1234,
+        :authorized => true,
+        :key => "deadbeef",
+      }
+
+      @valid_params = @valid_generate_params.dup
+      @valid_params.delete(:key)
+      @valid_params.delete(:receive_contact_url)
+      @valid_params.delete(:receive_login_url)
+      @valid_params[:signature] = "ffb581dbdf4d72f2c3c4d61af2fbaaa6fbcf66af"
+    end
+
+    describe "initialization" do
+
+      it "should generate" do
+        SampleVerificationResponse.generate(@valid_generate_params)
+      end
+
+      it "should raise an error if Slice slug is not set" do
+        @valid_generate_params.delete(:slice_slug)
+        lambda { SampleVerificationResponse.generate(@valid_generate_params) }.should raise_error(Witness::Error, /Slice not set/)
+      end
+
+      it "should raise an error if Request URL is not set" do
+        @valid_generate_params.delete(:request_url)
+        lambda { SampleVerificationResponse.generate(@valid_generate_params) }.should raise_error(Witness::Error, /Request URL not set/)
+      end
+
+      it "should raise an error if Receive Contact URL is not set" do
+        @valid_generate_params.delete(:receive_contact_url)
+        lambda { SampleVerificationResponse.generate(@valid_generate_params) }.should raise_error(Witness::Error, /Receive Contact URL not set/)
+      end
+
+      it "should raise an error if Contact ID is not set" do
+        @valid_generate_params.delete(:contact_id)
+        lambda { SampleVerificationResponse.generate(@valid_generate_params) }.should raise_error(Witness::Error, /Contact ID not set/)
+      end
+
+      it "should raise an error if Key is not set" do
+        @valid_generate_params.delete(:key)
+        lambda { SampleVerificationResponse.generate(@valid_generate_params) }.should raise_error(Witness::Error, /Key not set/)
+      end
+
+      it "should recognise true authorizations" do
+        @valid_generate_params[:authorized] = true
+        response = SampleVerificationResponse.generate(@valid_generate_params)
+        response.authorized.should == true
+
+        @valid_generate_params[:authorized] = "true"
+        response = SampleVerificationResponse.generate(@valid_generate_params)
+        response.authorized.should == true
+
+        @valid_generate_params[:authorized] = 1
+        response = SampleVerificationResponse.generate(@valid_generate_params)
+        response.authorized.should == true
+
+        @valid_generate_params[:authorized] = "1"
+        response = SampleVerificationResponse.generate(@valid_generate_params)
+        response.authorized.should == true
+      end
+
+      it "should recognise false authorizations" do
+        @valid_generate_params[:authorized] = false
+        response = SampleVerificationResponse.generate(@valid_generate_params)
+        response.authorized.should == false
+
+        @valid_generate_params[:authorized] = "false"
+        response = SampleVerificationResponse.generate(@valid_generate_params)
+        response.authorized.should == false
+
+        @valid_generate_params[:authorized] = 0
+        response = SampleVerificationResponse.generate(@valid_generate_params)
+        response.authorized.should == false
+
+        @valid_generate_params[:authorized] = "0"
+        response = SampleVerificationResponse.generate(@valid_generate_params)
+        response.authorized.should == false
+      end
+
+      it "should deny invalid authorizations" do
+        @valid_generate_params[:authorized] = "meow"
+        lambda { SampleVerificationResponse.generate(@valid_generate_params) }.should raise_error(Witness::Error, /Authorization not valid/)
+      end
+
+    end
+
+    describe "parameters" do
+
+      it "should generate parameters" do
+        request = SampleVerificationResponse.generate(@valid_generate_params)
+        request.params.should == @valid_params
+      end
+
+    end
+
+    describe "url" do
+
+      it "should generate a url" do
+        request = SampleVerificationResponse.generate(@valid_generate_params)
+        request.url.should == "http://www.example.com/receive?authorized=true&cat=meow&contact_id=1234&request_url=http%3A%2F%2Fwww.example.com%2Fsecure&secure_area_id=42&signature=ffb581dbdf4d72f2c3c4d61af2fbaaa6fbcf66af&slice_slug=banana"
+      end
+
+    end
+
+  end
+
+  describe "receive" do
+
+    before do
+      @valid_generate_params = {
+        :slice_slug => "banana",
+        :secure_area_id => 42,
+        :request_url => "http://www.example.com/secure",
+        :contact_id => 1234,
+        :authorized => true,
+        :key => "deadbeef",
+        :signature => "ffb581dbdf4d72f2c3c4d61af2fbaaa6fbcf66af",
+      }
+    end
+
+    describe "initialization" do
+
+      it "should generate" do
+        SampleVerificationResponse.receive(@valid_generate_params)
+      end
+
+      it "should raise an error if Slice slug is not set" do
+        @valid_generate_params.delete(:slice_slug)
+        lambda { SampleVerificationResponse.receive(@valid_generate_params) }.should raise_error(Witness::Error, /Slice not set/)
+      end
+
+      it "should raise an error if Request URL is not set" do
+        @valid_generate_params.delete(:request_url)
+        lambda { SampleVerificationResponse.receive(@valid_generate_params) }.should raise_error(Witness::Error, /Request URL not set/)
+      end
+
+      it "should raise an error if Signature is not set" do
+        @valid_generate_params.delete(:signature)
+        lambda { SampleVerificationResponse.receive(@valid_generate_params) }.should raise_error(Witness::Error, /Signature not set/)
+      end
+
+      it "should raise an error if Signature does not match" do
+        @valid_generate_params[:signature] = "incorrect"
+        lambda { SampleVerificationResponse.receive(@valid_generate_params) }.should raise_error(Witness::Error, /Signature does not match/)
+      end
+
+    end
+
+  end
+
+end

data/spec/witness_spec.rb

@@ -0,0 +1,51 @@
+require "spec_helper"
+
+describe Witness do
+
+  describe "update url" do
+
+    it "should update a basic url" do
+      url = "http://www.example.com/index?colour=black"
+      params = { :noise => "meow", "animal" => :cat }
+
+      Witness.update_url(url, params).should == "http://www.example.com/index?animal=cat&colour=black&noise=meow"
+    end
+
+    it "should update a url with arrays" do
+      url = "http://www.example.com/index?colour[]=black&colour[]=white&cutlery[knife]=1&cutlery[fork]=1"
+      params = { :noise => "meow", "animal" => :cat, :cutlery => { :spoon => 1 } }
+
+      Witness.update_url(url, params).should == "http://www.example.com/index?animal=cat&colour[]=black&colour[]=white&cutlery[spoon]=1&noise=meow"
+    end
+
+    it "should update a url wihout a trailing slash" do
+      url = "http://www.example.com"
+      params = { :noise => "meow" }
+
+      Witness.update_url(url, params).should == "http://www.example.com/?noise=meow"
+    end
+
+    it "should update a url with a trailing ?" do
+      url = "http://www.example.com/?"
+      params = { :noise => "meow" }
+
+      Witness.update_url(url, params).should == "http://www.example.com/?noise=meow"
+    end
+
+    it "should update a url without http" do
+      url = "www.example.com/?"
+      params = { :noise => "meow" }
+
+      Witness.update_url(url, params).should == "http:www.example.com/?noise=meow"
+    end
+
+    it "should rescue with nil given invalid parameters" do
+      url = "www.example.com/?"
+      params = ["cat"]
+
+      Witness.update_url(url, params).should == nil
+    end
+
+  end
+
+end

data/witness.gemspec

@@ -0,0 +1,88 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{witness}
+  s.version = "2.0.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Steve Hoeksema"]
+  s.date = %q{2010-12-08}
+  s.description = %q{Witness}
+  s.email = %q{steve@seven.net.nz}
+  s.extra_rdoc_files = [
+    "TODO"
+  ]
+  s.files = [
+    ".document",
+    "Gemfile",
+    "Gemfile.lock",
+    "Rakefile",
+    "TODO",
+    "VERSION",
+    "lib/witness.rb",
+    "lib/witness/base.rb",
+    "lib/witness/error.rb",
+    "spec/spec_helper.rb",
+    "spec/support/sample_base.rb",
+    "spec/support/sample_verification_request.rb",
+    "spec/support/sample_verification_response.rb",
+    "spec/witness/base_spec.rb",
+    "spec/witness/sample_verification_request_spec.rb",
+    "spec/witness/sample_verification_response_spec.rb",
+    "spec/witness_spec.rb",
+    "witness.gemspec"
+  ]
+  s.homepage = %q{http://github.com/steveh/witness}
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Witness}
+  s.test_files = [
+    "spec/spec_helper.rb",
+    "spec/support/sample_base.rb",
+    "spec/support/sample_verification_request.rb",
+    "spec/support/sample_verification_response.rb",
+    "spec/witness/base_spec.rb",
+    "spec/witness/sample_verification_request_spec.rb",
+    "spec/witness/sample_verification_response_spec.rb",
+    "spec/witness_spec.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<activesupport>, [">= 3.0.0"])
+      s.add_runtime_dependency(%q<sigil>, [">= 1.0.0"])
+      s.add_runtime_dependency(%q<rack>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, ["~> 2.1.0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.5.1"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, [">= 2.1.0"])
+    else
+      s.add_dependency(%q<activesupport>, [">= 3.0.0"])
+      s.add_dependency(%q<sigil>, [">= 1.0.0"])
+      s.add_dependency(%q<rack>, [">= 0"])
+      s.add_dependency(%q<rspec>, ["~> 2.1.0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.5.1"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+      s.add_dependency(%q<rspec>, [">= 2.1.0"])
+    end
+  else
+    s.add_dependency(%q<activesupport>, [">= 3.0.0"])
+    s.add_dependency(%q<sigil>, [">= 1.0.0"])
+    s.add_dependency(%q<rack>, [">= 0"])
+    s.add_dependency(%q<rspec>, ["~> 2.1.0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.5.1"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+    s.add_dependency(%q<rspec>, [">= 2.1.0"])
+  end
+end
+

metadata

@@ -0,0 +1,204 @@
+--- !ruby/object:Gem::Specification 
+name: witness
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 2
+  - 0
+  - 0
+  version: 2.0.0
+platform: ruby
+authors: 
+- Steve Hoeksema
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-12-08 00:00:00 +13:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 3
+        - 0
+        - 0
+        version: 3.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: sigil
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rack
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  prerelease: false
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 1
+        - 0
+        version: 2.1.0
+  type: :development
+  prerelease: false
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: bundler
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: jeweler
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 5
+        - 1
+        version: 1.5.1
+  type: :development
+  prerelease: false
+  version_requirements: *id006
+- !ruby/object:Gem::Dependency 
+  name: rcov
+  requirement: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  prerelease: false
+  version_requirements: *id007
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  requirement: &id008 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 1
+        - 0
+        version: 2.1.0
+  type: :development
+  prerelease: false
+  version_requirements: *id008
+description: Witness
+email: steve@seven.net.nz
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- TODO
+files: 
+- .document
+- Gemfile
+- Gemfile.lock
+- Rakefile
+- TODO
+- VERSION
+- lib/witness.rb
+- lib/witness/base.rb
+- lib/witness/error.rb
+- spec/spec_helper.rb
+- spec/support/sample_base.rb
+- spec/support/sample_verification_request.rb
+- spec/support/sample_verification_response.rb
+- spec/witness/base_spec.rb
+- spec/witness/sample_verification_request_spec.rb
+- spec/witness/sample_verification_response_spec.rb
+- spec/witness_spec.rb
+- witness.gemspec
+has_rdoc: true
+homepage: http://github.com/steveh/witness
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 447726333830718148
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Witness
+test_files: 
+- spec/spec_helper.rb
+- spec/support/sample_base.rb
+- spec/support/sample_verification_request.rb
+- spec/support/sample_verification_response.rb
+- spec/witness/base_spec.rb
+- spec/witness/sample_verification_request_spec.rb
+- spec/witness/sample_verification_response_spec.rb
+- spec/witness_spec.rb