protocol-url 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 85a50d979d385fbef9e8defa4e94f98832aca156dc86f79352a4b62673f30e2e
-  data.tar.gz: 71ea54c2460fc94773c13c8cc334f66fef89974efd71bd89537487f0833b844e
+  metadata.gz: 12a81d3a05c932207c77a583df784431d7120f3f1f9ee68c9ea593a47c666831
+  data.tar.gz: 3307c15e0d16d4907259cd186c0483d46d78358e0b1bfee99e3cf3186a1c74d2
 SHA512:
-  metadata.gz: '0903cee8e33682b465b633a7bbdb2b34e52800b476cf550a06c2fec5cc328532cfd1dac820cfafe31a76500982f92cbbd566af9168ede9cd1e6ccdd9d9b72887'
-  data.tar.gz: 7c12517bafaa34bae712abacfe299231a858a12d9f9b37dd188f3275e20008bf116fab85bb53843a55834978866365444d210b93d51ea2e05b7a2d2a9a35ae1a
+  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/pattern.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2025, by Samuel Williams.
+
+module Protocol
+	module URL
+		# RFC 3986 URI pattern with named capture groups.
+		# Matches: [scheme:][//authority][path][?query][#fragment]
+		# Rejects strings containing whitespace or control characters (matching standard URI behavior).
+		PATTERN = %r{
+			\A
+			(?:(?<scheme>[a-z][a-z0-9+.-]*):)?      # scheme (optional)
+			(?://(?<authority>[^/?#\s]*))?          # authority (optional, without //, no whitespace)
+			(?<path>[^?#\s]*)                       # path (no whitespace)
+			(?:\?(?<query>[^#\s]*))?                # query (optional, no whitespace)
+			(?:\#(?<fragment>[^\s]*))?              # fragment (optional, no whitespace)
+			\z
+		}ix
+	end
+end

data/lib/protocol/url/reference.rb

@@ -3,6 +3,7 @@
 # Released under the MIT License.
 # Copyright, 2025, by Samuel Williams.
 
+require_relative "pattern"
 require_relative "encoding"
 require_relative "relative"
 

data/lib/protocol/url/version.rb

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

data/lib/protocol/url.rb

@@ -4,6 +4,7 @@
 # Copyright, 2025, by Samuel Williams.
 
 require_relative "url/version"
+require_relative "url/pattern"
 require_relative "url/encoding"
 require_relative "url/reference"
 require_relative "url/relative"
@@ -11,20 +12,6 @@ require_relative "url/absolute"
 
 module Protocol
 	module URL
-		# RFC 3986 URI pattern with named capture groups.
-		# Matches: [scheme:][//authority][path][?query][#fragment]
-		# Rejects strings containing whitespace or control characters (matching standard URI behavior).
-		PATTERN = %r{
-			\A
-			(?:(?<scheme>[a-z][a-z0-9+.-]*):)?      # scheme (optional)
-			(?://(?<authority>[^/?#\s]*))?          # authority (optional, without //, no whitespace)
-			(?<path>[^?#\s]*)                       # path (no whitespace)
-			(?:\?(?<query>[^#\s]*))?                # query (optional, no whitespace)
-			(?:\#(?<fragment>[^\s]*))?              # fragment (optional, no whitespace)
-			\z
-		}ix
-		private_constant :PATTERN
-		
 		# Coerce a value into an appropriate URL type (Absolute or Relative).
 		#
 		# @parameter value [String, Absolute, Relative, nil] The value to coerce.

data/readme.md

@@ -34,6 +34,14 @@ 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.
+
 ### v0.1.0
 
   - Initial implementation.

data/releases.md

@@ -1,5 +1,13 @@
 # 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.
+
 ## v0.1.0
 
   - Initial implementation.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: protocol-url
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -46,6 +46,7 @@ files:
 - lib/protocol/url/absolute.rb
 - lib/protocol/url/encoding.rb
 - lib/protocol/url/path.rb
+- lib/protocol/url/pattern.rb
 - lib/protocol/url/reference.rb
 - lib/protocol/url/relative.rb
 - lib/protocol/url/version.rb