protocol-url 0.13.0 → 0.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4a8be4027ad2b93f7707396fe9a53a47846b53e78cde0269be4fdd3dbdb448e3
-  data.tar.gz: 89ae574fc48ca43bcd0b224bdbe91ab0da1354869f6c8dbc87bdfbe9e6cd45b0
+  metadata.gz: 1d1384cd7ea74826bb5dc6e145fb09c9573c807fdac7d2297164317b6caf5645
+  data.tar.gz: 4d4b5100c8aca8008c3be18ad9f4b79139c00251f711283a90432179e292c941
 SHA512:
-  metadata.gz: fb21e1c877b41f75975183cacab2a9dbea71e09c5fa4e11f66767f713e50fe0c27b63f07b1daa83feb00309a41132703544620541c794c598ce1efc9c402a830
-  data.tar.gz: 7c0703c48866182719b0a12edee9b45447f2ce3233519058af33c171ddf729fa9f8615cb76ae0aaf8355383703e21937fa912e94eff05428c6007d62c4e763cd
+  metadata.gz: f284536c31a02466b10821c12bb1a4529a023d789cafbdfae10dd71d8f3049d78f0a0dbc03f8255f3ebdb0b7278eeccd38ca81baf480e116b6fe2a4b72a0bf22
+  data.tar.gz: 4ae5bb2749190910c76193b6c451b47b4bbcacaded41002cc54713dc219638e4966f4522f9df2e20a7f04e1e89ab2c09c6df1497bf849afe9a202fb7ad5ceacf

data/lib/protocol/url/absolute.rb

@@ -145,6 +145,13 @@ module Protocol
 				self.class.new(scheme, authority, path || @path, query, fragment)
 			end
 			
+			# Absolute URLs cannot be made relative without comparing their origins.
+			# @parameter base [Object] The ignored base URL or path.
+			# @returns [self] This absolute URL.
+			def relative_to(base)
+				return self
+			end
+			
 			# Convert the URL to an array representation.
 			#
 			# @returns [Array] An array of `[scheme, authority, path, query, fragment]`.

data/lib/protocol/url/path.rb

@@ -208,14 +208,18 @@ module Protocol
 			end
 			
 			# @parameter other [Object] The value to compare with this path.
-			# @returns [Boolean] Whether both paths have the same encoded representation.
+			# @returns [Boolean] Whether both values are the same.
 			def ==(other)
-				eql?(other)
+				if other.is_a?(String)
+					return encoded == other
+				else
+					return eql?(other)
+				end
 			end
 			
 			# Compare this path with another path using exact encoded string identity.
 			# @parameter other [Object] The value to compare with this path.
-			# @returns [Boolean] Whether both paths have equal encoded strings.
+			# @returns [Boolean] Whether both paths are the same.
 			def eql?(other)
 				other.is_a?(Path) && encoded.eql?(other.encoded)
 			end

data/lib/protocol/url/relative.rb

@@ -132,6 +132,23 @@ module Protocol
 				self.class.new(path || @path, query, fragment)
 			end
 			
+			# Express this URL relative to the given base path.
+			#
+			# Already-relative paths are returned unchanged. Query and fragment components
+			# are preserved when converting a root-relative path.
+			#
+			# @parameter base [Relative | Path | String] The base URL or path.
+			# @returns [Relative] The relative URL.
+			def relative_to(base)
+				return self unless @path.absolute?
+				
+				if base.is_a?(Relative)
+					base = base.path
+				end
+				
+				return self.class.new(@path.relative(base), @query, @fragment)
+			end
+			
 			# Normalize the encoded path and simplify its structure.
 			#
 			# This modifies the URL in-place by normalizing and simplifying the path component:

data/lib/protocol/url/version.rb

@@ -7,6 +7,6 @@
 module Protocol
 	# @namespace
 	module URL
-		VERSION = "0.13.0"
+		VERSION = "0.15.0"
 	end
 end

data/readme.md

@@ -34,6 +34,96 @@ bundle exec sus
 
 Please see the [project releases](https://socketry.github.io/protocol-url/releases/index) for all releases.
 
+### v0.15.0
+
+  - Add `Protocol::URL::Relative#relative_to` for expressing root-relative URLs relative to a base path.
+
+### v0.14.0
+
+  - Allow paths to compare with their encoded string representation.
+
+### v0.13.0
+
+  - Add conservative normalization of encoded URL paths.
+
+### v0.12.0
+
+  - Allow unfrozen relative and absolute URLs to replace their components.
+
+### v0.10.0
+
+  - Rename `Protocol::URL::FormData::Parser::CONTENT_TYPE` to `MEDIA_TYPE`.
+
+### v0.9.0
+
+  - Add `Protocol::URL::LimitError` for configured processing limits.
+
+### v0.8.0
+
+  - Use consistent limit naming for form data parser constraints.
+
+### v0.7.0
+
+  - Allow `Protocol::URL::FormData::Parser#parse` to populate a supplied result object.
+
+### v0.6.0
+
+  - Add `Protocol::URL::FormData::Parser` for incremental, limited parsing of `application/x-www-form-urlencoded` form data.
+  - Add `Protocol::URL::FormData::Nested` for consistently building nested form data while preserving absent and empty values.
+
+### v0.5.0
+
+  - Add `Protocol::URL::Encoding.decode_www_form` for decoding HTML form data where `+` represents a space.
+
+### v0.14.0
+
+  - Allow paths to compare with their encoded string representation.
+
+### v0.13.0
+
+  - Add conservative normalization of encoded URL paths.
+
+### v0.12.0
+
+  - Allow unfrozen relative and absolute URLs to replace their components.
+
+### v0.10.0
+
+  - Rename `Protocol::URL::FormData::Parser::CONTENT_TYPE` to `MEDIA_TYPE`.
+
+### v0.9.0
+
+  - Add `Protocol::URL::LimitError` for configured processing limits.
+
+### v0.8.0
+
+  - Use consistent limit naming for form data parser constraints.
+
+### v0.7.0
+
+  - Allow `Protocol::URL::FormData::Parser#parse` to populate a supplied result object.
+
+### v0.6.0
+
+  - Add `Protocol::URL::FormData::Parser` for incremental, limited parsing of `application/x-www-form-urlencoded` form data.
+  - Add `Protocol::URL::FormData::Nested` for consistently building nested form data while preserving absent and empty values.
+
+### v0.5.0
+
+  - Add `Protocol::URL::Encoding.decode_www_form` for decoding HTML form data where `+` represents a space.
+
+### 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.13.0
 
   - Add conservative normalization of encoded URL paths.

data/releases.md

@@ -1,5 +1,13 @@
 # Releases
 
+## v0.15.0
+
+  - Add `Protocol::URL::Relative#relative_to` for expressing root-relative URLs relative to a base path.
+
+## v0.14.0
+
+  - Allow paths to compare with their encoded string representation.
+
 ## v0.13.0
 
   - Add conservative normalization of encoded URL paths.

metadata

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