protocol-url 0.16.0 → 0.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 19ab80e6eb5272f7866b22b006ff4803adefdaa8913f35a81c8f1b79b0e60de6
-  data.tar.gz: 525c3a31f539f9250dab7a33e069785132ae7d86e0e1789e02dc1e9c0447d4c1
+  metadata.gz: '049540a7791381da861b94d6ed8e6b3e0ad751d3b176106f1c50a029aba36e32'
+  data.tar.gz: d6431de11836accc4318f01066b3c2431b9f26e349b46e77fcf9108da80cfb5e
 SHA512:
-  metadata.gz: 272e4b1d19ae57a938e2407b77f5d2f2f8df65df57bd7651459ccb104c8d52e4d8a765a8d4a4462ea2f0b365bbd2b6bde6dfe4b77ad005caf6f3ff2910757e77
-  data.tar.gz: 7c73a1a644c936e64c41d5c9c578dbee3b08eb9b1e735bc57ffe32b7193ef7edd43a28504ac9b8e600f1904365621059b4a2dd9f7398c81c897da925e7741a18
+  metadata.gz: 27cee8571add43c57a7b0c2255d7f6a40566d1b44fe49b8ed73a7b06c50ef2d9d259eb951c0ffae7bce3c77f026fb193924f7eb003c85bfc61250661c2ed6135
+  data.tar.gz: ec74d61c74a06b318b9ff1b9ebcedb261bb90e0f80293b8def6e8d22efeef30db04ebc873e5546f746556312cd45cbeaa6c487893021c0b773a27990a3efd3d5

data/lib/protocol/url/absolute.rb

@@ -114,7 +114,8 @@ module Protocol
 			end
 			
 			# Append the absolute URL to the given buffer.
-			def append(buffer = String.new)
+			# @parameter explicit [Boolean] Ignored because absolute URLs are already lexically identifiable.
+			def append(buffer = String.new, explicit: false)
 				buffer << @scheme << ":" if @scheme
 				buffer << "//" << @authority if @authority
 				super(buffer)
@@ -169,9 +170,10 @@ module Protocol
 			
 			# Convert the URL to its string representation.
 			#
+			# @parameter explicit [Boolean] Ignored because absolute URLs are already lexically identifiable.
 			# @returns [String] The formatted absolute URL string.
-			def to_s
-				append
+			def to_s(explicit: false)
+				append(explicit: explicit)
 			end
 		end
 	end

data/lib/protocol/url/reference.rb

@@ -162,8 +162,9 @@ module Protocol
 			# Append the reference to the given buffer.
 			# Encodes the fragment; the path already retains its encoded structure.
 			# Query strings are passed through as-is (they contain = and & which are valid syntax).
-			def append(buffer = String.new)
-				buffer << @path.encoded
+			# @parameter explicit [Boolean] Whether the result should be lexically identifiable as a URL in a mixed grammar.
+			def append(buffer = String.new, explicit: false)
+				append_path(buffer, explicit: explicit)
 				
 				if @query and !@query.empty?
 					buffer << "?" << @query

data/lib/protocol/url/relative.rb

@@ -175,8 +175,9 @@ module Protocol
 			
 			# Append the relative URL to the given buffer.
 			# The path, query, and fragment are expected to already be properly encoded.
-			def append(buffer = String.new)
-				buffer << @path.encoded
+			# @parameter explicit [Boolean] Whether the result should be lexically identifiable as a URL in a mixed grammar.
+			def append(buffer = String.new, explicit: false)
+				append_path(buffer, explicit: explicit)
 				
 				if @query and !@query.empty?
 					buffer << "?" << @query
@@ -236,10 +237,13 @@ module Protocol
 			end
 			
 			# Convert the URL to its string representation.
+			# When explicit, same-directory references start with `./` so they can be
+			# distinguished from non-URL values in a mixed grammar.
 			#
+			# @parameter explicit [Boolean] Whether the result should be lexically identifiable as a URL in a mixed grammar.
 			# @returns [String] The formatted URL string.
-			def to_s
-				append
+			def to_s(explicit: false)
+				append(explicit: explicit)
 			end
 			
 			# Convert the URL to a JSON-compatible representation.
@@ -263,6 +267,16 @@ module Protocol
 				"#<#{self.class} #{to_s}>"
 			end
 			
+			# Append the path, optionally identifying a relative URL explicitly.
+			private def append_path(buffer, explicit: false)
+				if explicit && @path.relative?
+					path = @path.encoded
+					buffer << "./" unless path.start_with?("./", "../")
+				end
+				
+				buffer << @path.encoded
+			end
+			
 		end
 	end
 end

data/lib/protocol/url/version.rb

@@ -7,6 +7,6 @@
 module Protocol
 	# @namespace
 	module URL
-		VERSION = "0.16.0"
+		VERSION = "0.18.0"
 	end
 end

data/readme.md

@@ -34,6 +34,86 @@ bundle exec sus
 
 Please see the [project releases](https://socketry.github.io/protocol-url/releases/index) for all releases.
 
+### v0.18.0
+
+  - Support explicit URL serialization for mixed grammars, and remove explicit prefixes from relative path calculation.
+
+### v0.17.0
+
+  - Add optional explicit `./` prefixes when generating same-directory relative URLs.
+
+### v0.16.0
+
+  - Preserve directory and file semantics when generating relative URL paths.
+
+### 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.17.0
+
+  - Add optional explicit `./` prefixes when generating same-directory relative URLs.
+
+### v0.16.0
+
+  - Preserve directory and file semantics when generating relative URL paths.
+
+### 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.16.0
 
   - Preserve directory and file semantics when generating relative URL paths.

data/releases.md

@@ -1,5 +1,13 @@
 # Releases
 
+## v0.18.0
+
+  - Support explicit URL serialization for mixed grammars, and remove explicit prefixes from relative path calculation.
+
+## v0.17.0
+
+  - Add optional explicit `./` prefixes when generating same-directory relative URLs.
+
 ## v0.16.0
 
   - Preserve directory and file semantics when generating relative URL paths.

metadata

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