xrb 0.11.2 → 0.12.0

data/lib/xrb/uri.rb

@@ -1,100 +0,0 @@
-# frozen_string_literal: true
-
-# Released under the MIT License.
-# Copyright, 2017-2024, by Samuel Williams.
-
-module XRB
-	# This class is superceeded by `XRB::Reference`.
-	class URI
-		def initialize(path, query_string, fragment, parameters)
-			@path = path
-			@query_string = query_string
-			@fragment = fragment
-			@parameters = parameters
-		end
-		
-		# The path component of the URI, e.g. /foo/bar/index.html
-		attr :path
-		
-		# The un-parsed query string of the URI, e.g. 'x=10&y=20'
-		attr :query_string
-		
-		# A fragment identifier, the part after the '#'
-		attr :fragment
-		
-		# User supplied parameters that will be appended to the query part.
-		attr :parameters
-		
-		def append(buffer)
-			if @query_string
-				buffer << escape_path(@path) << "?" << query_string
-				buffer << "&" << query_parameters if @parameters
-			else
-				buffer << escape_path(@path)
-				buffer << "?" << query_parameters if @parameters
-			end
-			
-			if @fragment
-				buffer << "#" << escape(@fragment)
-			end
-			
-			return buffer
-		end
-		
-		def to_str
-			append(String.new)
-		end
-		
-		alias to_s to_str
-		
-		private
-		
-		# According to https://tools.ietf.org/html/rfc3986#section-3.3, we escape non-pchar.
-		NON_PCHAR = /([^a-zA-Z0-9_\-\.~!$&'()*+,;=:@\/]+)/.freeze
-		
-		def escape_path(path)
-			encoding = path.encoding
-			path.b.gsub(NON_PCHAR) do |m|
-				"%" + m.unpack("H2" * m.bytesize).join("%").upcase
-			end.force_encoding(encoding)
-		end
-		
-		# Escapes a generic string, using percent encoding.
-		def escape(string)
-			encoding = string.encoding
-			string.b.gsub(/([^a-zA-Z0-9_.\-]+)/) do |m|
-				"%" + m.unpack("H2" * m.bytesize).join("%").upcase
-			end.force_encoding(encoding)
-		end
-		
-		def query_parameters
-			build_nested_query(@parameters)
-		end
-		
-		def build_nested_query(value, prefix = nil)
-			case value
-			when Array
-				value.map { |v|
-					build_nested_query(v, "#{prefix}[]")
-				}.join("&")
-			when Hash
-				value.map { |k, v|
-					build_nested_query(v, prefix ? "#{prefix}[#{escape(k.to_s)}]" : escape(k.to_s))
-				}.reject(&:empty?).join("&")
-			when nil
-				prefix
-			else
-				raise ArgumentError, "value must be a Hash" if prefix.nil?
-				"#{prefix}=#{escape(value.to_s)}"
-			end
-		end
-	end
-	
-	# Generate a URI from a path and user parameters. The path may contain a `#fragment` or `?query=parameters`.
-	def self.URI(path = "", parameters = nil)
-		base, fragment = path.split("#", 2)
-		path, query_string = base.split("?", 2)
-		
-		URI.new(path, query_string, fragment, parameters)
-	end
-end