protocol-url 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: efcdbe6f1de1ec7c6bdadf70824bdd62e0b351c768896e52c34234e982a3527d
-  data.tar.gz: 3687c0ff3fe5723b3df989d929326062120307e199b801395faf7026dd49606b
+  metadata.gz: ff6accb882e5c993ee454290f6d282d67df6b4d13ee01bdd24b042ea764ee03c
+  data.tar.gz: abc0495ee011bccd902d3f60bebcf4d8231e3559b14305fe5594d62df285eeae
 SHA512:
-  metadata.gz: cb62cd371a93e7fadf9b51823382d06034365301470336733c3870798c29839a5c8d550706dc1e69fb5de964d442192299f1f8fdd351df836b8852bc0e730fd9
-  data.tar.gz: e4bee5e0cf8ee2aac01942418e0045cd233b0a901535891933bc274eff4bb9c0fff9edb2164eedbd99dda633a68fd91ce45dc823dabb5f5516d5818752301587
+  metadata.gz: 1a1852872d62c65b0d78f8cd698deaaca69ceea65b79fb2e9d04b0b1b347cf6555ba41c27b0c836e2b963981f0c9be9a8feeec55622cdede7018a01321d7bca6
+  data.tar.gz: 4c6a01694dda0e059d944e5155f365c27c00c244e8e5ea7310288b875f2f307e4ef0c610dd8ea906e30fd5338d13f33fb1d2b83dcd5c076d57e34a60eb515b3b

data/lib/protocol/url/path.rb

@@ -119,6 +119,45 @@ module Protocol
 				return join(simplify(components))
 			end
 			
+			# Calculate the relative path from one absolute path to another.
+			#
+			# This is useful for generating relative URLs from one location to another,
+			# such as creating page-specific import maps or relative links.
+			#
+			# @parameter target [String] The destination path (where you want to go).
+			# @parameter from [String] The source path (where you are starting from).
+			# @returns [String] The relative path from `from` to `target`.
+			#
+			# @example Calculate relative path between pages.
+			# 	Path.relative("/_components/app.js", "/foo/bar/")
+			# 	# => "../../_components/app.js"
+			#
+			# @example Calculate relative path in same directory.
+			# 	Path.relative("/docs/guide.html", "/docs/index.html")
+			# 	# => "guide.html"
+			def self.relative(target, from)
+				target_components = split(target)
+				from_components = split(from)
+				
+				# Remove the last component from 'from' to get the directory
+				from_components = from_components[0...-1] if from_components.size > 0
+				
+				# Find the common prefix
+				common_length = 0
+				[target_components.size, from_components.size].min.times do |i|
+					break if target_components[i] != from_components[i]
+					common_length = i + 1
+				end
+				
+				# Calculate how many levels to go up
+				up_levels = from_components.size - common_length
+				
+				# Build the relative path components
+				relative_components = [".."] * up_levels + target_components[common_length..-1]
+				
+				return join(relative_components)
+			end
+			
 			# Convert a URL path to a local file system path using the platform's file separator.
 			#
 			# This method splits the URL path on `/` characters, unescapes each component using

data/lib/protocol/url/reference.rb

@@ -95,14 +95,6 @@ module Protocol
 				[@path, @query, @fragment, @parameters]
 			end
 			
-			# Compare two references.
-			#
-			# @parameter other [Reference] The other reference to compare.
-			# @returns [Integer] -1, 0, 1 if the reference is less than, equal to, or greater than the other reference.
-			def <=> other
-				to_ary <=> other.to_ary
-			end
-			
 			# @returns [Boolean] Whether the reference has parameters.
 			def parameters?
 				@parameters and !@parameters.empty?

data/lib/protocol/url/relative.rb

@@ -135,14 +135,38 @@ module Protocol
 				[@path, @query, @fragment]
 			end
 			
+			def hash
+				to_ary.hash
+			end
+			
+			def equal?(other)
+				to_ary == other.to_ary
+			end
+			
 			def <=>(other)
 				to_ary <=> other.to_ary
 			end
 			
+			def ==(other)
+				to_ary == other.to_ary
+			end
+			
+			def ===(other)
+				to_s === other
+			end
+			
 			def to_s
 				append
 			end
 			
+			def as_json(...)
+				to_s
+			end
+			
+			def to_json(...)
+				as_json.to_json(...)
+			end
+			
 			def inspect
 				"#<#{self.class} #{to_s}>"
 			end

data/lib/protocol/url/version.rb

@@ -7,6 +7,6 @@
 module Protocol
 	# @namespace
 	module URL
-		VERSION = "0.2.0"
+		VERSION = "0.4.0"
 	end
 end

data/readme.md

@@ -34,6 +34,22 @@ This project is best served by a collaborative and respectful environment. Treat
 
 Please see the [project releases](https://github.com/socketry/protocol-urlreleases/index) for all releases.
 
+### v0.4.0
+
+  - Add comparison methods to `Protocol::URL::Relative` (and by inheritance to `Protocol::URL::Absolute`):
+      - `#==` for structural equality comparison (compares path, query, fragment components).
+      - `#===` for string equality comparison (enables case statement matching).
+      - `#<=>` for ordering and sorting.
+      - `#hash` for hash key support.
+      - `#equal?` for component-based equality checking.
+  - Add JSON serialization support to `Protocol::URL::Relative`:
+      - `#as_json` returns the string representation.
+      - `#to_json` returns a JSON-encoded string.
+
+### v0.3.0
+
+  - Add `relative(target, from)` for computing relative paths between URLs.
+
 ### v0.2.0
 
   - Move `Protocol::URL::PATTERN` to `protocol/url/pattern.rb` so it can be shared more easily.

data/releases.md

@@ -1,5 +1,21 @@
 # Releases
 
+## v0.4.0
+
+  - Add comparison methods to `Protocol::URL::Relative` (and by inheritance to `Protocol::URL::Absolute`):
+      - `#==` for structural equality comparison (compares path, query, fragment components).
+      - `#===` for string equality comparison (enables case statement matching).
+      - `#<=>` for ordering and sorting.
+      - `#hash` for hash key support.
+      - `#equal?` for component-based equality checking.
+  - Add JSON serialization support to `Protocol::URL::Relative`:
+      - `#as_json` returns the string representation.
+      - `#to_json` returns a JSON-encoded string.
+
+## v0.3.0
+
+  - Add `relative(target, from)` for computing relative paths between URLs.
+
 ## v0.2.0
 
   - Move `Protocol::URL::PATTERN` to `protocol/url/pattern.rb` so it can be shared more easily.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: protocol-url
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Samuel Williams