build-uri 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 875ee954e27285ed02e09319a4522ff214f0a79c
+  data.tar.gz: 7abb5ce2d4cac8a351a2b97825e09d7c8cb6bb8d
+SHA512:
+  metadata.gz: 6867609819a69023dc1ecd8eda6a3ff87b55feac5a7ce46eeeb201ade4ee4df67c7c7bb56a30a23f2d88ed0fa6adcdee822ec5fcf2bfc19bede0c236668c6201
+  data.tar.gz: 91424aff5e447387a4e21742c568b72dcd55fa30492edf802fc1972b60040cc949b77b8cf8dc08464dda0d376d41d1cafd4f31d5c79dfd99d25b7bbec6bea5dc

data/.gitignore

@@ -0,0 +1,23 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+.rspec_status

data/.rspec

@@ -0,0 +1,5 @@
+--color
+--format documentation
+--backtrace
+--warnings
+--require spec_helper

data/.travis.yml

@@ -0,0 +1,19 @@
+language: ruby
+sudo: false
+dist: trusty
+cache: bundler
+rvm:
+  - 2.1
+  - 2.2
+  - 2.3
+  - 2.4
+  - ruby-head
+  - jruby-head
+matrix:
+  allow_failures:
+    - rvm: "ruby-head"
+    - rvm: "jruby-head"
+addons:
+  apt:
+    packages:
+      - graphviz

data/Gemfile

@@ -0,0 +1,14 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in build-dependency.gemspec
+gemspec
+
+group :development do
+	gem 'guard'
+	gem 'guard-rspec'
+end
+
+group :test do
+	gem 'simplecov'
+	gem 'coveralls', require: false
+end

data/Guardfile

@@ -0,0 +1,9 @@
+
+directories %w(lib spec)
+clearing :on
+
+guard :rspec, cmd: "bundle exec rspec" do
+	watch(%r{^spec/.+_spec\.rb$})
+	watch(%r{^lib/(.+)\.rb$}) { |m| "spec/#{m[1]}_spec.rb" }
+	watch("spec/spec_helper.rb") { "spec" }
+end

data/README.md

@@ -0,0 +1,81 @@
+# Build::URI
+
+`Build::URI` provides unform handling of file paths (`Build::URI::Relative`), URIs (`Build::URI::Absolute`) and triples (`Build::URI::Triple`).
+
+[![Build Status](https://secure.travis-ci.org/ioquatix/build-uri.svg)](http://travis-ci.org/ioquatix/build-uri)
+[![Code Climate](https://codeclimate.com/github/ioquatix/build-uri.svg)](https://codeclimate.com/github/ioquatix/build-uri)
+[![Coverage Status](https://coveralls.io/repos/ioquatix/build-uri/badge.svg)](https://coveralls.io/r/ioquatix/build-uri)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+	gem 'build-uri'
+
+And then execute:
+
+	$ bundle
+
+Or install it yourself as:
+
+	$ gem install build-uri
+
+## Usage
+
+To parse an input:
+
+```ruby
+uri = Build::URI[value]
+```
+
+Is it a local file?
+
+```ruby
+if uri.local?
+	File.read(uri.to_path)
+else
+	# ... curl
+end
+```
+
+Concatenate paths:
+
+```ruby
+root = Build::URI["http://www.google.com/search?q=awesome"]
+path = Build::URI["/login"]
+
+(root + path).to_s
+# => "http://www.google.com/login?q=awesome"
+```
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+## License
+
+Released under the MIT license.
+
+Copyright, 2017, by [Samuel G. D. Williams](http://www.codeotaku.com/samuel-williams).
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,8 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec) do |task|
+	task.rspec_opts = ["--require", "simplecov"] if ENV['COVERAGE']
+end
+
+task :default => :spec

data/build-uri.gemspec

@@ -0,0 +1,21 @@
+# coding: utf-8
+require_relative 'lib/build/uri/version'
+
+Gem::Specification.new do |spec|
+	spec.name          = "build-uri"
+	spec.version       = Build::URI::VERSION
+	spec.authors       = ["Samuel Williams"]
+	spec.email         = ["samuel.williams@oriontransfer.co.nz"]
+	spec.summary       = %q{Handle absolute URIs, triples and file paths uniformly.}
+	spec.homepage      = ""
+	spec.license       = "MIT"
+
+	spec.files         = `git ls-files -z`.split("\x0")
+	spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+	spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+	spec.require_paths = ["lib"]
+	
+	spec.add_development_dependency "bundler", "~> 1.3"
+	spec.add_development_dependency "rspec", "~> 3.4.0"
+	spec.add_development_dependency "rake"
+end

data/lib/build/uri.rb

@@ -0,0 +1,25 @@
+# Copyright, 2017, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require_relative 'uri/version'
+
+require_relative 'uri/absolute'
+require_relative 'uri/relative'
+require_relative 'uri/parser'

data/lib/build/uri/absolute.rb

@@ -0,0 +1,87 @@
+# Copyright, 2017, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require_relative 'base'
+
+module Build
+	module URI
+		class Absolute < Struct.new(:scheme, :userinfo, :host, :path, :query, :fragment)
+			include Base
+			
+			# A subset of RFC2396 specifically relevant to path based URIs. We are not interested in generic URIs such as mailto.
+			PARSER = %r{\A
+				((?<scheme>[^:\/?\#]+):)
+				(\/\/
+					((?<userinfo>[^\/?\#]+)@)?
+					(?<host>[^\/?\#]*)
+				)
+				(?<path>[^?\#]*)
+				(\?(?<query>[^\#]*))?
+				(\#(?<fragment>.*))?
+			\z}x.freeze
+			
+			def absolute?
+				true
+			end
+			
+			def local?
+				false
+			end
+			
+			def to_s
+				buffer = String.new
+				
+				if scheme
+					buffer << scheme << ':'
+				end
+				
+				if host
+					buffer << '//'
+					
+					if userinfo
+						buffer << userinfo << '@'
+					end
+					
+					buffer << host
+				end
+				
+				if path
+					buffer << path
+				end
+				
+				if query
+					buffer << '?' << query
+				end
+				
+				if fragment
+					buffer << '#' << fragment
+				end
+				
+				return buffer
+			end
+			
+			def self.parse(string)
+				if match = PARSER.match(string)
+					self.new(*match.values_at(*self.members)).freeze
+				end
+			end
+		end
+	end
+end

data/lib/build/uri/base.rb

@@ -0,0 +1,70 @@
+# Copyright, 2017, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+module Build
+	module URI
+		SEPARATOR = '/'.freeze
+		
+		module Base
+			# @attr directory [Boolean] If true, we consider every path to represent a directory, even if there is no trailing slash. If false, basename of self will be ignored when joining.
+			def merge(other, directory: true)
+				if self.path.nil? || other.absolute?
+					return other
+				else
+					clone = self.dup
+					
+					if other.path.start_with?(SEPARATOR)
+						clone.path = other.path
+					elsif directory
+						# We try to avoid ending up with more than one slash:
+						if self.path.end_with?(SEPARATOR)
+							clone.path = [self.path, other.path].join
+						else
+							clone.path = [self.path, other.path].join(SEPARATOR)
+						end
+					else
+						# The basename of a non-directory path is ignored when merged.
+						dirname, _, basename = self.path.rpartition(SEPARATOR)
+						
+						clone.path = [dirname, other.path].join(SEPARATOR)
+					end
+					
+					return clone.freeze
+				end
+			end
+			
+			def + other
+				merge(URI[other])
+			end
+			
+			def dirname
+				clone = self.dup
+				
+				clone.path = self.path.rpartition(SEPARATOR).first
+				
+				return clone
+			end
+			
+			def basename
+				clone.path = self.path.rpartition(SEPARATOR).last
+			end
+		end
+	end
+end

data/lib/build/uri/parser.rb

@@ -0,0 +1,46 @@
+# Copyright, 2017, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require 'uri'
+
+require_relative 'absolute'
+require_relative 'relative'
+require_relative 'triplet'
+
+module Build
+	module URI
+		def self.parse(string)
+			Absolute.parse(string) || Triplet.parse(string) || Relative.new(string)
+		end
+		
+		EMPTY = Relative.new(nil).freeze
+		
+		def self.[](value)
+			case value
+			when Base
+				return value
+			when NilClass
+				return EMPTY
+			else
+				self.parse(value.to_s)
+			end
+		end
+	end
+end

data/lib/build/uri/relative.rb

@@ -0,0 +1,42 @@
+# Copyright, 2017, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+module Build
+	module URI
+		class Relative < Struct.new(:path)
+			include Base
+			
+			def absolute?
+				false
+			end
+			
+			def local?
+				true
+			end
+			
+			alias to_s path
+			
+			def to_path
+				# TODO Convert SEPARATOR to File::SEPARATOR?
+				@path
+			end
+		end
+	end
+end

data/lib/build/uri/triplet.rb

@@ -0,0 +1,55 @@
+# Copyright, 2017, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+module Build
+	module URI
+		class Triplet < Struct.new(:userinfo, :host, :path)
+			include Base
+			
+			PARSER = %r{\A
+				(?:(?<userinfo>.+)@)?
+				(?<host>[\w.-]+)
+				:(?<path>.*)
+			\z}x.freeze
+			
+			def local?
+				false
+			end
+			
+			def to_s
+				buffer = String.new
+				
+				if userinfo
+					buffer << userinfo << '@'
+				end
+				
+				buffer << host << ':' << path
+				
+				return buffer
+			end
+			
+			def self.parse(string)
+				if match = PARSER.match(string)
+					self.new(*match.values_at(*self.members))
+				end
+			end
+		end
+	end
+end

data/lib/build/uri/version.rb

@@ -0,0 +1,25 @@
+# Copyright, 2017, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+module Build
+	module URI
+		VERSION = "1.0.0"
+	end
+end

data/spec/build/uri/absolute_spec.rb

@@ -0,0 +1,31 @@
+# Copyright, 2017, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+RSpec.describe Build::URI::Absolute do
+	describe "two absolute uris" do
+		subject {Build::URI.parse("http://localhost/a/b") + Build::URI.parse("http://localhost/c/d")}
+		
+		shared_examples "valid absolute"
+		
+		it "should result in other absolute url when concatenated" do
+			is_expected.to be == Build::URI.parse("http://localhost/c/d")
+		end
+	end
+end

data/spec/build/uri/parser_spec.rb

@@ -0,0 +1,56 @@
+# Copyright, 2017, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+RSpec.shared_context "parse uri" do |uri|
+	subject {Build::URI[uri]}
+	
+	it "should parse" do
+		is_expected.to_not be_nil
+	end
+	
+	it "should be homoiconic" do
+		expect(subject.to_s).to be == uri
+	end
+	
+	it "shouldn't reparse uri" do
+		expect(Build::URI[subject]).to be_equal subject
+	end
+end
+
+RSpec.describe "git@github.com:ioquatix/build-uri" do
+	include_context "parse uri", description
+	include_examples "valid triplet"
+end
+
+RSpec.describe "http://www.google.com/search?q=doot" do
+	include_context "parse uri", description
+	include_examples "valid absolute"
+end
+
+RSpec.describe "/" do
+	include_context "parse uri", description
+	include_examples "valid relative"
+end
+
+RSpec.describe "foo/bar" do
+	include_context "parse uri", description
+	include_examples "valid relative"
+end
+

data/spec/build/uri/relative_spec.rb

@@ -0,0 +1,82 @@
+# Copyright, 2017, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+RSpec.describe Build::URI::Base do
+	let(:a) {Build::URI.parse("/a")}
+	let(:b) {Build::URI.parse("b")}
+	
+	describe '#merge(directory: false)' do
+		subject {a.merge(b, directory: false)}
+		
+		it "should merge ignoring basename" do
+			is_expected.to be == Build::URI.parse("/b")
+		end
+	end
+
+	describe '#merge(directory: true)' do
+		subject {a.merge(b, directory: true)}
+		
+		it "should merge including basename" do
+			is_expected.to be == Build::URI.parse("/a/b")
+		end
+	end
+end
+
+RSpec.describe Build::URI::Relative do
+	describe "two relative paths" do
+		subject {Build::URI.parse("a/b") + Build::URI.parse("c/d")}
+		
+		shared_examples "valid relative"
+		
+		it "should concatenate paths" do
+			is_expected.to be == Build::URI.parse("a/b/c/d")
+		end
+	end
+	
+	describe "two absolute paths" do
+		subject {Build::URI.parse("/a/b") + Build::URI.parse("/c/d")}
+		
+		shared_examples "valid relative"
+		
+		it "should be other absolute path when concatenated" do
+			is_expected.to be == Build::URI.parse("/c/d")
+		end
+	end
+	
+	describe "absolute uri and relative path" do
+		subject {Build::URI.parse("http://localhost/a/b") + Build::URI.parse("c/d")}
+		
+		shared_examples "valid absolute"
+		
+		it "should concatenate paths" do
+			is_expected.to be == Build::URI.parse("http://localhost/a/b/c/d")
+		end
+	end
+	
+	describe "absolute uri and absolute path" do
+		subject {Build::URI.parse("http://localhost/a/b") + Build::URI.parse("/c/d")}
+		
+		shared_examples "valid absolute"
+		
+		it "should be other absolute path when concatenated" do
+			is_expected.to be == Build::URI.parse("http://localhost/c/d")
+		end
+	end
+end

data/spec/build/uri/triplet_spec.rb

@@ -0,0 +1,41 @@
+# Copyright, 2017, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+RSpec.describe Build::URI::Triplet do
+	describe "absolute triplet and relative path" do
+		subject {Build::URI.parse("git@github.com:ioquatix") + Build::URI.parse("build-uri")}
+		
+		shared_examples "valid triplet"
+		
+		it "should concatenate paths" do
+			is_expected.to be == Build::URI.parse("git@github.com:ioquatix/build-uri")
+		end
+	end
+	
+	describe "absolute triplet and absolute path" do
+		subject {Build::URI.parse("git@github.com:ioquatix") + Build::URI.parse("/forked/build-uri")}
+		
+		shared_examples "valid triplet"
+		
+		it "should concatenate paths" do
+			is_expected.to be == Build::URI.parse("git@github.com:/forked/build-uri")
+		end
+	end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,47 @@
+
+if ENV['COVERAGE']
+	begin
+		require 'simplecov'
+		
+		SimpleCov.start do
+			add_filter "/spec/"
+		end
+		
+		if ENV['TRAVIS']
+			require 'coveralls'
+			Coveralls.wear!
+		end
+	rescue LoadError
+		warn "Could not load simplecov: #{$!}"
+	end
+end
+
+require "bundler/setup"
+require "build/uri"
+
+RSpec.shared_examples "valid triplet" do
+	it "should be valid triplet" do
+		is_expected.to be_kind_of Build::URI::Triplet
+	end
+end
+
+RSpec.shared_examples "valid absolute" do
+	it "should be valid absolute" do
+		is_expected.to be_kind_of Build::URI::Absolute
+	end
+end
+
+RSpec.shared_examples "valid relative" do
+	it "sohuld be a valid relative" do
+		is_expected.to be_kind_of Build::URI::Relative
+	end
+end
+
+RSpec.configure do |config|
+	# Enable flags like --only-failures and --next-failure
+	config.example_status_persistence_file_path = ".rspec_status"
+
+	config.expect_with :rspec do |c|
+		c.syntax = :expect
+	end
+end

metadata

@@ -0,0 +1,111 @@
+--- !ruby/object:Gem::Specification
+name: build-uri
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Samuel Williams
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-04-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.4.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.4.0
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email:
+- samuel.williams@oriontransfer.co.nz
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- Guardfile
+- README.md
+- Rakefile
+- build-uri.gemspec
+- lib/build/uri.rb
+- lib/build/uri/absolute.rb
+- lib/build/uri/base.rb
+- lib/build/uri/parser.rb
+- lib/build/uri/relative.rb
+- lib/build/uri/triplet.rb
+- lib/build/uri/version.rb
+- spec/build/uri/absolute_spec.rb
+- spec/build/uri/parser_spec.rb
+- spec/build/uri/relative_spec.rb
+- spec/build/uri/triplet_spec.rb
+- spec/spec_helper.rb
+homepage: ''
+licenses:
+- MIT
+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.6.10
+signing_key: 
+specification_version: 4
+summary: Handle absolute URIs, triples and file paths uniformly.
+test_files:
+- spec/build/uri/absolute_spec.rb
+- spec/build/uri/parser_spec.rb
+- spec/build/uri/relative_spec.rb
+- spec/build/uri/triplet_spec.rb
+- spec/spec_helper.rb