class Absolute

parameter　scheme　String

The URL scheme (e.g., "https", "http").

parameter　authority　String

The authority component (e.g., "example.com", "user@host:port").

parameter　path　String

The path component (defaults to "/").

parameter　query　String, nil

The query string.

parameter　fragment　String, nil

The fragment identifier.

def initialize(scheme, authority, path = "/", query = nil, fragment = nil)
	@scheme = scheme
	@authority = authority
	
	# Initialize the parent Relative class with the path component
	super(path, query, fragment)
end

attribute　String

The URL scheme.

attribute　String

The authority component.

returns　Boolean

True if a scheme is present and non-empty.

def scheme?
	@scheme and !@scheme.empty?
end

returns　Boolean

True if an authority is present and non-empty.

def authority?
	@authority and !@authority.empty?
end

base = Absolute.new("https", "example.com", "/documents/reports/")
relative = Relative.new("summary.pdf")
result = base + relative
result.to_s  # => "https://example.com/documents/reports/summary.pdf"

base = Absolute.new("https", "example.com", "/documents/reports/2024/")
relative = Relative.new("../../archive/")
result = base + relative
result.to_s  # => "https://example.com/documents/archive/"

parameter　other　String, Relative, Reference, Absolute

The reference to resolve.

returns　Absolute, String

The resolved absolute URL.

def +(other)
	case other
	when Absolute
		# If other is already absolute with a scheme, return it as-is:
		return other if other.scheme
		# Protocol-relative URL: inherit scheme from base:
		return Absolute.new(@scheme, other.authority, other.path, other.query, other.fragment)
	when Relative
		# Already a Relative, use directly.
	when String
		other = URL[other]
		# If parsing resulted in an Absolute URL, handle it:
		if other.is_a?(Absolute)
			return other if other.scheme
			# Protocol-relative URL: inherit scheme from base:
			return Absolute.new(@scheme, other.authority, other.path, other.query, other.fragment)
		end
	else
		raise ArgumentError, "Cannot combine Absolute URL with #{other.class}"
	end
	
	# RFC 3986 Section 5.3: Component Recomposition
	# At this point, other is a Relative URL
	
	# Check for special cases first:
	if other.path.empty?
		# Empty path - could be query-only or fragment-only reference:
		if other.query
			# Query replacement: use base path with new query:
			Absolute.new(@scheme, @authority, @path, other.query, other.fragment)
		else
			# Fragment-only: keep everything from base, just change fragment:
			Absolute.new(@scheme, @authority, @path, @query, other.fragment || @fragment)
		end
	else
		# Relative path: merge with base path:
		path = Path.expand(@path, other.path)
		Absolute.new(@scheme, @authority, path, other.query, other.fragment)
	end
end

def append(buffer = String.new)
	buffer << @scheme << ":" if @scheme
	buffer << "//" << @authority if @authority
	super(buffer)
end

url = Absolute.new("http", "example.com", "/page")
secure = url.with(scheme: "https")
secure.to_s  # => "https://example.com/page"

url = Absolute.new("https", "example.com", "/search", "query=ruby")
updated = url.with(query: "query=python")
updated.to_s  # => "https://example.com/search?query=python"

parameter　scheme　String, nil

The scheme to use (nil to remove scheme).

parameter　authority　String, nil

The authority to use (nil to remove authority).

parameter　path　String, nil

The path to merge with the current path.

parameter　query　String, nil

The query string to use.

parameter　fragment　String, nil

The fragment to use.

parameter　pop　Boolean

Whether to pop the last path component before merging.

returns　Absolute

A new Absolute URL with the modified components.

def with(scheme: @scheme, authority: @authority, path: nil, query: @query, fragment: @fragment, pop: true)
	self.class.new(scheme, authority, Path.expand(@path, path, pop), query, fragment)
end

returns　Array

An array of [scheme, authority, path, query, fragment].

def to_ary
	[@scheme, @authority, @path, @query, @fragment]
end

parameter　other　Absolute

The URL to compare with.

returns　Integer

-1, 0, or 1 based on component-wise comparison.

def <=>(other)
	to_ary <=> other.to_ary
end

returns　String

The formatted absolute URL string.

def to_s
	append
end