protocol-url 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: efcdbe6f1de1ec7c6bdadf70824bdd62e0b351c768896e52c34234e982a3527d
-  data.tar.gz: 3687c0ff3fe5723b3df989d929326062120307e199b801395faf7026dd49606b
+  metadata.gz: 12a81d3a05c932207c77a583df784431d7120f3f1f9ee68c9ea593a47c666831
+  data.tar.gz: 3307c15e0d16d4907259cd186c0483d46d78358e0b1bfee99e3cf3186a1c74d2
 SHA512:
-  metadata.gz: cb62cd371a93e7fadf9b51823382d06034365301470336733c3870798c29839a5c8d550706dc1e69fb5de964d442192299f1f8fdd351df836b8852bc0e730fd9
-  data.tar.gz: e4bee5e0cf8ee2aac01942418e0045cd233b0a901535891933bc274eff4bb9c0fff9edb2164eedbd99dda633a68fd91ce45dc823dabb5f5516d5818752301587
+  metadata.gz: 8e948fff9470b6676b5b28638af7fdc64eaa31e3565c980071a539eadbf3651b8c10037ed1bcec70b43360a30fbb595f14bf965898e6ab4f1b4e8baf1e942491
+  data.tar.gz: 86de1d30699c4c3f7c85878ca3c0edf45da61991593d4600bfc83be2b667525ccc8bb01ea5a51ddf82248045933b49a3ef8879947100a5ac88d67d94a2947786

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/version.rb

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

data/readme.md

@@ -34,6 +34,10 @@ 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.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,9 @@
 # Releases
 
+## 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.3.0
 platform: ruby
 authors:
 - Samuel Williams