rfc-web-link 0.0.0 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a7682f76ac7525d7b34cd49068dca16fc0f5f000a43172291a23544097b63a09
-  data.tar.gz: 0a49df14b408ab5f76d61152b381b81f8164849d66b74172d55f5954dc4eacab
+  metadata.gz: e5349bcccb250a2fb639bc10efcecb8313d1f27a9bc7f0c16fdde8ee38d59058
+  data.tar.gz: 3c47df4d22c978196942d28a03ef7cc3f1bdb28fd0937086661fe82e3e522c34
 SHA512:
-  metadata.gz: af490a377b861570077f79e2aca9fc4633e7e50d4956cf2ac89404ef3091882fa8ac736bc4a1b54ff5cb0bd9491da5d92fa46cd117275b49bce4be292004db44
-  data.tar.gz: c3f1e5d143c1ab1a4b8820321c828fdc54e0c2210f9c08f1733b6a67ed23bb3be7c78c5d915497cfe32ad06734dff808840a3c0b3f7b45ebfc1ebc428b8cc376
+  metadata.gz: 248afa0c4f87e8f4b57188dd43441238686e40e6379961e3e83ca3abb01e173d6095fdb838409c80e92ae15cf785b3fd119bc85b50f2ebdd8fb4dd905ea3708e
+  data.tar.gz: ec99e8ab113533799c1532ca5a69ae0c1fa44a9363f3f5158aac1e69bb7910c0b3e6ff40e1af0342dc48f777f1f6d96946bd9d80beb2f7a14e82607b56e144bb

data/README.adoc

@@ -3,6 +3,7 @@
 :figure-caption!:
 
 :data_link: link:https://alchemists.io/articles/ruby_data[Data]
+:enumerable_link: link:https://docs.ruby-lang.org/en/master/Enumerable.html[Enumerable]
 :rfc_8288_link: link:https://www.rfc-editor.org/info/rfc8288[RFC 8288]
 
 = RFC Web Link
@@ -22,7 +23,7 @@ toc::[]
 
 * Implements {rfc_8288_link}.
 * Parses web link headers into whole value objects for processing and/or inspection.
-* Allows explicit or implicit casting of whole value objects into a web links.
+* Provides explicit or implicit casting of whole value objects into a web links.
 
 == Requirements
 
@@ -66,14 +67,14 @@ The fastest way to get started is to create a new instance of the parser that yo
 
 [source,ruby]
 ----
-parser = RFC::Web::Link.new
+parser = RFC::Web::Link.new "https://demo.io"
 ----
 
 Then you can use the `parser` instance to parse HTTP headers and build lists you can interact with:
 
 [source,ruby]
 ----
-parser.call({"link" => "</articles>; rel=index"}, root_uri: "https://demo.io")
+parser.call({"link" => "</articles>; rel=index"})
 ----
 
 The above will yield the following set of links (in this case, only with a single link):
@@ -97,39 +98,67 @@ The above will yield the following set of links (in this case, only with a singl
 >
 ----
 
-As you can see, you get an immutable {data_link} whole value object for which you can directly access all attributes.
+As you can see, you get an immutable {data_link} (whole value) object for which you can directly access all attributes.
 
 === Root URI
 
-A root URI (`root_uri`) must be supplied in order to resolve all relative URIs as absolute URIs. Generally, the `root_uri` is your host (i.e. primary domain).
+A root URI (`root_uri`) must be supplied in order to resolve all relative URIs as absolute URIs. Generally, the `root_uri` is your host (i.e. primary domain). There are a few ways you can supply the root URI:
+
+*Initialization*
+
+The following sets the root URI globally so you only have to define it once:
+
+[source,ruby]
+----
+parser = RFC::Web::Link.new "https://demo.io"
+----
+
+*Call*
+
+The following sets the root URI per call.
+
+[source,ruby]
+----
+parser = RFC::Web::Link.new
+parser.call({"link" => "</articles>; rel=index"}, root_uri: "https://demo.io")
+----
+
+*Call (override)*
+
+The following sets the root URI globally but also allows you to override the global value with a custom value per call.
+
+[source,ruby]
+----
+parser = RFC::Web::Link.new "https://demo.io"
+
+parser.call({"link" => "</articles>; rel=index"}, root_uri: "https://alt.io")
+----
 
 === Delimiters
 
-When not used for delimiting link links and/or pairs (attributes), these need to in quotes when used as values for your attributes. Here's the breakdown:
+Each delimiter provides the following behavior:
+
+* *Semicolon* (`;`): Delimits each pair associated with a line.
+* *Comma* (`,`): Delimits each line of a link.
 
-* *Semicolon* (`;`): Used to delimit each pair associated with a line.
-* *Comma* (`,`): Used to delimit each line of a link.
+They must be quoted when not used as delimiters.
 
 === Attributes
 
-There are _six_ {rfc_8288_link} registered target attributes: anchor, hreflang, media, rel, title, and type. The key map between the specification and this implementation's `RFC::Web::Link::Models::Pair` model is shown below:
+There are six {rfc_8288_link} registered target attributes:
 
-[options="header"]
-|===
-| Specification | Implementation
-| anchor        | anchor
-| hreflang      | language
-| media         | media
-| rel           | relation
-| title         | title
-| type          | type
-|===
+* anchor
+* hreflang
+* media
+* rel
+* title
+* type
 
-You can think of `language` as an alias to `hreflang` and `relation` as an alias to `rel` for improved readability. Both work but the later are preferred. Each attribute is described in further detail below.
+Each is described in detail below.
 
-==== Anchor
+==== anchor
 
-An anchor is optional but, when supplied, can be a single string, quoted with special characters, a relative URI, or an absolute URI. Here's a few examples:
+Optional but, when supplied, can be a single string, quoted with special characters, a relative URI, or an absolute URI. Here's a few examples:
 
 * *Fragment*: `#footer`
 * *Quoted (special characters)*: `"#overview,body,footer"`
@@ -142,10 +171,8 @@ Relative URIs will automatically be expanded into an absolute URIs when parsed.
 
 [source,ruby]
 ----
-list = RFC::Web::Link.new.call(
-  {"link" => "</articles>; anchor=#footer"},
-  root_uri: "https://demo.io"
-)
+parser = RFC::Web::Link.new "https://demo.io"
+list = parser.call({"link" => "</articles>; anchor=#footer"})
 
 # #<data RFC::Web::Link::Models::List:0x000016f0
 #   links = [
@@ -173,10 +200,8 @@ list.to_s
 
 [source,ruby]
 ----
-list = RFC::Web::Link.new.call(
-  {"link" => %(</articles>; anchor="#overview,body,footer")},
-  root_uri: "https://demo.io"
-)
+parser = RFC::Web::Link.new "https://demo.io"
+list = parser.call({"link" => %(</articles>; anchor="#overview,body,footer")})
 
 # #<data RFC::Web::Link::Models::List:0x00001660
 #   links = [
@@ -204,10 +229,8 @@ list.to_s
 
 [source,ruby]
 ----
-list = RFC::Web::Link.new.call(
-  {"link" => "</articles>; anchor=/policies"},
-  root_uri: "https://demo.io"
-)
+parser = RFC::Web::Link.new "https://demo.io"
+list = parser.call({"link" => "</articles>; anchor=/policies"})
 
 # #<data RFC::Web::Link::Models::List:0x000017c0
 #   links = [
@@ -235,10 +258,8 @@ list.to_s
 
 [source,ruby]
 ----
-list = RFC::Web::Link.new.call(
-  {"link" => "</articles>; anchor=https://demo.io/about"},
-  root_uri: "https://demo.io"
-)
+parser = RFC::Web::Link.new "https://demo.io"
+list = parser.call({"link" => "</articles>; anchor=https://demo.io/about"})
 
 # #<data RFC::Web::Link::Models::List:0x00001890
 #   links = [
@@ -262,18 +283,16 @@ list.to_s
 # "<https://demo.io/articles>; anchor=https://demo.io/about"
 ----
 
-==== Language
+==== hreflang
 
-Language is optional but, when supplied, is a hint indicating the language of the associated link. This _does not_ override the value of the `content-language` header. Example:
+Optional but, when supplied, is a hint indicating the language of the associated link. This _does not_ override the value of the `content-language` header. Example:
 
 *Single*
 
 [source,ruby]
 ----
-list = RFC::Web::Link.new.call(
-  {"link" => "</articles>; hreflang=en"},
-  root_uri: "https://demo.io"
-)
+parser = RFC::Web::Link.new "https://demo.io"
+list = parser.call({"link" => "</articles>; hreflang=en"})
 
 # #<data RFC::Web::Link::Models::List:0x00000890
 #   links = [
@@ -301,10 +320,8 @@ list.to_s
 
 [source,ruby]
 ----
-list = RFC::Web::Link.new.call(
-  {"link" => "</articles>; hreflang=en; hreflang=de"},
-  root_uri: "https://demo.io"
-)
+parser = RFC::Web::Link.new "https://demo.io"
+list = parser.call({"link" => "</articles>; hreflang=en; hreflang=de"})
 
 # #<data RFC::Web::Link::Models::List:0x000016c0
 #   links = [
@@ -335,16 +352,14 @@ list.to_s
 # "<https://demo.io/articles>; hreflang=en; hreflang=de"
 ----
 
-==== Media
+==== media
 
-Media is optional but, when supplied, is a hint indicating the kind of media associated with the link. Example:
+Optional but, when supplied, is a hint indicating the kind of media associated with the link. Example:
 
 [source,ruby]
 ----
-list = RFC::Web::Link.new.call(
-  {"link" => "</articles>; media=print"},
-  root_uri: "https://demo.io"
-)
+parser = RFC::Web::Link.new "https://demo.io"
+list = parser.call({"link" => "</articles>; media=print"})
 
 # #<data RFC::Web::Link::Models::List:0x000017d0
 #   links = [
@@ -368,18 +383,16 @@ list.to_s
 # "<https://demo.io/articles>; media=print"
 ----
 
-==== Relation
+==== rel
 
-A relation is the only attribute that is required by the specification and should be the first one defined. Example:
+Required and must be first defined. Example:
 
 *Single*
 
 [source,ruby]
 ----
-list = RFC::Web::Link.new.call(
-  {"link" => "</articles>; relation=index"},
-  root_uri: "https://demo.io"
-)
+parser = RFC::Web::Link.new "https://demo.io"
+list = parser.call({"link" => "</articles>; rel=index"})
 
 # #<data RFC::Web::Link::Models::List:0x00000890
 #   links = [
@@ -388,7 +401,7 @@ list = RFC::Web::Link.new.call(
 #         #<data RFC::Web::Link::Models::Pair:0x000008d0
 #           delimiter = "=",
 #           encoding = nil,
-#           key = "relation",
+#           key = "rel",
 #           language = nil,
 #           value = "index"
 #         >
@@ -409,10 +422,8 @@ Short hand, for multiple relations, is supported as well. To use, each relation
 
 [source,ruby]
 ----
-list = RFC::Web::Link.new.call(
-  {"link" => %(</articles>; rel="one two three")},
-  root_uri: "https://demo.io"
-)
+parser = RFC::Web::Link.new "https://demo.io"
+list = parser.call({"link" => %(</articles>; rel="one two three")})
 
 # #<data RFC::Web::Link::Models::List:0x00000960
 #   links = [
@@ -462,9 +473,9 @@ list.to_s
 
 Notice that the original relation short hand of `"one two three"` produced three unique links for each relation which allows you to type less while still producing three distinct links.
 
-==== Title
+==== title
 
-A title is optional but, when supplied, allows you to provide a human readable label for the associated link. This includes being able to encode and decode the value based on the delimiter used. For example, notice the difference in delimiters used below:
+Optional but, when supplied, allows you to provide a human readable label for the associated link. This includes being able to encode and decode the value based on the delimiter used. For example, notice the difference in delimiters used below:
 
 * *Plain* (`=`): `title=Demo` (example)
 * *Encoded* (`*=`): `+title*=UTF-8'en'd%C3%A9j%C3%A0%20vu+` (example)
@@ -475,10 +486,8 @@ The title _must not_ appear more than once. If multiple occurrences are detected
 
 [source,ruby]
 ----
-list = RFC::Web::Link.new.call(
-  {"link" => "</articles>; title=Demo"},
-  root_uri: "https://demo.io"
-)
+parser = RFC::Web::Link.new "https://demo.io"
+list = parser.call({"link" => "</articles>; title=Demo"})
 
 # #<data RFC::Web::Link::Models::List:0x00000890
 #   links = [
@@ -506,10 +515,8 @@ list.to_s
 
 [source,ruby]
 ----
-list = RFC::Web::Link.new.call(
-  {"link" => "</articles>; title*=UTF-8'en'd%C3%A9j%C3%A0%20vu"},
-  root_uri: "https://demo.io"
-)
+parser = RFC::Web::Link.new "https://demo.io"
+list = parser.call({"link" => "</articles>; title*=UTF-8'en'd%C3%A9j%C3%A0%20vu"})
 
 # #<data RFC::Web::Link::Models::List:0x00000890
 #   links = [
@@ -533,16 +540,14 @@ list.to_s
 # "<https://demo.io/articles>; title*=UTF-8'en'd%C3%A9j%C3%A0%20vu"
 ----
 
-==== Type
+==== type
 
-Type is optional but, when supplied, is a hint indicating the MIME Type of the associated link. This _does not_ override the value of the `content-type` header. Example:
+Optional but, when supplied, is a hint indicating the MIME Type of the associated link. This _does not_ override the value of the `content-type` header. Example:
 
 [source,ruby]
 ----
-list = RFC::Web::Link.new.call(
-  {"link" => "</articles>; type=text/html"},
-  root_uri: "https://demo.io"
-)
+parser = RFC::Web::Link.new "https://demo.io"
+list = parser.call({"link" => "</articles>; type=text/html"})
 
 # #<data RFC::Web::Link::Models::List:0x00000890
 #   links = [
@@ -572,9 +577,10 @@ Extensions allow you to extend your implementation beyond the registered target
 
 [source,ruby]
 ----
-list = RFC::Web::Link.new.call(
-  {"link" => %(</articles>; hint="A demo."; errata="For demonstration only."; copyright=2025)},
-  root_uri: "https://demo.io"
+parser = RFC::Web::Link.new "https://demo.io"
+
+list = parser.call(
+  {"link" => %(</articles>; hint="A demo."; errata="For demonstration only."; copyright=2025)}
 )
 
 # #<data RFC::Web::Link::Models::List:0x00000980
@@ -617,10 +623,8 @@ You can also encode your extensions by using the `+*=+` delimiter. Example:
 
 [source,ruby]
 ----
-list = RFC::Web::Link.new.call(
-  {"link" => "</articles>; demo*=UTF-8'en'd%C3%A9j%C3%A0%20vu"},
-  root_uri: "https://demo.io"
-)
+parser = RFC::Web::Link.new "https://demo.io"
+list = parser.call({"link" => "</articles>; demo*=UTF-8'en'd%C3%A9j%C3%A0%20vu"})
 
 # #<data RFC::Web::Link::Models::List:0x00000ad0
 #   links = [
@@ -650,7 +654,7 @@ You've already seen all of the models (whole value objects) used in the examples
 
 ==== List
 
-This model encapsulates the list of links parsed from an HTTP link header or created by you. A list can be created multiple ways:
+This model has both {data_link} and {enumerable_link} behavior because it encapsulates the list of links parsed from an HTTP link header or created by you. A list can be created multiple ways:
 
 *All At Once*
 
@@ -679,23 +683,13 @@ list = RFC::Web::Link::Models::Link[uri: "https://demo.io"].add(pair)
 list = RFC::Web::Link::Models::List.new.add(link)
 ----
 
-Once you have a list, you can send the following messages (including {data_link} messages) along limited enumerable messages:
+Once you have a list, you can send the following messages including {data_link} and {enumerable_link} messages:
 
 [source,ruby]
 ----
 list.add line
-list.all?
-list.any?
 list.clear
-list.each
 list.empty?
-list.find
-list.include? line
-list.map
-list.none?
-list.one?
-list.reject
-list.select
 list.size
 list.to_s
 list.to_str
@@ -717,7 +711,7 @@ This model encapsulates a single HTTP link header. A link can be created multipl
 
 [source,ruby]
 ----
-list = RFC::Web::Link::Models::Link[
+link = RFC::Web::Link::Models::Link[
   uri: "https://demo.io",
   pairs: Set[
     RFC::Web::Link::Models::Pair[key: :title, value: "Demo"]
@@ -732,7 +726,7 @@ list = RFC::Web::Link::Models::Link[
 [source,ruby]
 ----
 pair = RFC::Web::Link::Models::Pair[key: :title, value: "Demo"]
-list = RFC::Web::Link::Models::Link[uri: "https://demo.io"].add(pair)
+link = RFC::Web::Link::Models::Link[uri: "https://demo.io"].add(pair)
 ----
 
 Once you have a link, you can then send the following messages (including {data_link} messages):
@@ -748,8 +742,11 @@ link.append :title,
             delimiter: "*=",
             encoding: "UTF-8",
             language: "en"
-link.has? :title
-link.has? "title"
+link.find_pair key: "title", value: "Demo"
+link.find_pair key: "title", value: /dem/i
+link.find_pair key: "title", delimiter: /\*=/, value: "Demo"
+link.pair? key: "title"
+link.pair? key: "title", value: "Demo"
 list.to_s
 list.to_str
 ----
@@ -818,12 +815,11 @@ As with `List` and `Link`, you have full access to all {data_link} messages and
 
 === Error Handling
 
-As per {rfc_8288_link}, this implementation is designed to safely ignore malformed web links. To illustrate, we'll start with an initialized parser and root URI:
+As per {rfc_8288_link}, this implementation is designed to safely ignore malformed web links. To illustrate, we'll start with an initialized parser:
 
 [source,ruby]
 ----
-parser = RFC::Web::Link.new
-root_uri = "https://demo.io"
+parser = RFC::Web::Link.new "https://demo.io"
 ----
 
 The following examples show the result of parsing different malformed URIs:
@@ -832,7 +828,7 @@ The following examples show the result of parsing different malformed URIs:
 
 [source,ruby]
 ----
-parser.call({"link" => nil}, root_uri:)
+parser.call({"link" => nil})
 
 # #<data RFC::Web::Link::Models::List:0x00000880
 #   links = []
@@ -843,7 +839,7 @@ parser.call({"link" => nil}, root_uri:)
 
 [source,ruby]
 ----
-parser.call({"link" => ""}, root_uri:)
+parser.call({"link" => ""})
 
 # #<data RFC::Web::Link::Models::List:0x00000880
 #   links = []
@@ -854,7 +850,7 @@ parser.call({"link" => ""}, root_uri:)
 
 [source,ruby]
 ----
-parser.call({"link" => "/articles; rel=index"}, root_uri:)
+parser.call({"link" => "/articles; rel=index"})
 
 # #<data RFC::Web::Link::Models::List:0x00000880
 #   links = []
@@ -865,7 +861,7 @@ parser.call({"link" => "/articles; rel=index"}, root_uri:)
 
 [source,ruby]
 ----
-parser.call({"link" => "</articles>"}, root_uri:)
+parser.call({"link" => "</articles>"})
 
 # #<data RFC::Web::Link::Models::List:0x00000880
 #   links = [
@@ -881,7 +877,7 @@ parser.call({"link" => "</articles>"}, root_uri:)
 
 [source,ruby]
 ----
-parser.call({"link" => "</articles>; rel"}, root_uri:)
+parser.call({"link" => "</articles>; rel"})
 
 # #<data RFC::Web::Link::Models::List:0x000008a0
 #   links = [

data/lib/rfc/web/link/decoder.rb

@@ -7,18 +7,18 @@ module RFC
     module Link
       # A HTTP header field decoder which adheres to RFC 8187.
       class Decoder
-        def initialize delimiter: "'", default_encoding: Encoding::UTF_8, client: URI
+        def initialize delimiter: "'", client: URI
           @delimiter = delimiter
-          @default_encoding = default_encoding
           @client = client
+          @quote = %(")
         end
 
         def call text
           value, encoding, language = parse text
 
           value = client.decode_uri_component(value)
-                        .force_encoding(encoding || default_encoding)
-                        .encode(default_encoding)
+                        .force_encoding(encoding || Encoding::UTF_8)
+                        .encode(Encoding::UTF_8)
 
           {value:, encoding:, language:}
         rescue ArgumentError, NoMethodError
@@ -27,10 +27,10 @@ module RFC
 
         private
 
-        attr_reader :delimiter, :default_encoding, :client
+        attr_reader :delimiter, :client, :quote
 
         def parse text
-          case String(text).split delimiter
+          case String(text).delete_prefix(quote).delete_suffix(quote).split delimiter
             in [value] then [value, nil, nil]
             in [encoding, language, value] then [value, encoding, language]
             else [nil, nil, nil]

data/lib/rfc/web/link/encoder.rb

@@ -3,27 +3,40 @@
 module RFC
   module Web
     module Link
-      # A HTTP header field encoder which adheres to RFC 8187.
+      # A HTTP header value encoder which adheres to RFC 8187.
       class Encoder
-        def initialize pattern: /[^0-9a-zA-Z!\#$&+\-.^_`|~]/
-          @pattern = pattern
+        def initialize ignored_characters: /\A[0-9a-zA-Z!\#$%&'*+\-.^_`|~]*\z/,
+                       ignored_keys: %w[type]
+          @ignored_characters = ignored_characters
+          @ignored_keys = ignored_keys
         end
 
-        def call(text) = text.match?(pattern) ? convert_characters(text).join : text
+        def call value, key: nil
+          text = String value
+
+          if text.match?(ignored_characters) || ignored_keys.include?(key) then text
+          elsif text.match? ignored_characters_and_spaces then text.dump
+          else convert_characters(text).join
+          end
+        end
 
         private
 
-        attr_reader :pattern
+        attr_reader :ignored_characters, :ignored_keys
 
         def convert_characters text
           text.each_char.map do |character|
-            next character unless character.match? pattern
+            next character if character.match? ignored_characters
 
             character.bytes
                      .map { format "%%%02X", it }
                      .join
           end
         end
+
+        def ignored_characters_and_spaces
+          @ignored_characters_and_spaces ||= Regexp.new ignored_characters.source.sub("]", "\\s]")
+        end
       end
     end
   end

data/lib/rfc/web/link/models/link.rb

@@ -26,7 +26,17 @@ module RFC
             self
           end
 
-          def has?(key) = pairs.any? { it.key == key.to_s }
+          def find_pair **attributes
+            pairs.find do |pair|
+              attributes.all? { |key, value| pair.public_send(key).match? value }
+            end
+          end
+
+          def pair? **attributes
+            pairs.any? do |pair|
+              attributes.all? { |key, value| pair.public_send(key).match? value }
+            end
+          end
 
           def to_s(delimiter: "; ") = "<#{uri}>; #{pairs.join delimiter}"
 

data/lib/rfc/web/link/models/list.rb

@@ -9,8 +9,9 @@ module RFC
         # Models a list of links.
         List = Data.define :links do
           extend Forwardable
+          include Enumerable
 
-          delegate %i[all? any? empty? find include? map none? one? size] => :links
+          delegate %i[empty? size] => :links
 
           def initialize links: Set.new
             super
@@ -26,11 +27,11 @@ module RFC
             self
           end
 
-          def each(&block) = block ? links.each(&block) : self
+          def each
+            return enum_for :each unless block_given?
 
-          def reject(&) = with links: Set[*links.reject(&)]
-
-          def select(&) = with links: Set[*links.select(&)]
+            links.each { yield it }
+          end
 
           def to_s(delimiter: ", ") = links.join delimiter
 

data/lib/rfc/web/link/models/pair.rb

@@ -12,15 +12,12 @@ module RFC
 
           def encoded? = delimiter == "*="
 
-          def to_s key_map: {"relation" => "rel", "language" => "hreflang"}.freeze,
-                   encoder: Encoder.new
-            transformed_key = key_map.fetch(key) { it }
-
+          def to_s encoder: Encoder.new
             if encoding
-              "#{transformed_key}#{delimiter}#{encoding}'#{language}'" \
+              "#{key}#{delimiter}#{encoding}'#{language}'" \
               "#{encoder.call value.encode(encoding)}"
             else
-              "#{transformed_key}#{delimiter}#{value}"
+              "#{key}#{delimiter}#{encoder.call value, key:}"
             end
           end
 

data/lib/rfc/web/link/parsers/header.rb

@@ -6,19 +6,20 @@ module RFC
       module Parsers
         # Parses a header link into a list of records.
         class Header
-          def initialize pattern: /link/i, list: List.new
+          def initialize root_uri = nil, pattern: /link/i, list: List.new
+            @root_uri = root_uri
             @pattern = pattern
             @list = list
           end
 
-          def call headers, root_uri:
+          def call headers, root_uri: nil
             text = headers.find { |key, value| break value if key.match? pattern }
-            list.call text, root_uri:
+            list.call text, root_uri: root_uri || self.root_uri
           end
 
           private
 
-          attr_reader :pattern, :list
+          attr_reader :root_uri, :pattern, :list
         end
       end
     end

data/lib/rfc/web/link/parsers/line.rb

@@ -6,8 +6,8 @@ module RFC
       module Parsers
         # Parses a header line into a link record.
         class Line
-          def initialize delimiter: /;\s*?/, pair: Pair.new, model: Models::Link
-            @delimiter = delimiter
+          def initialize patterns: PATTERNS, pair: Pair.new, model: Models::Link
+            @patterns = patterns
             @pair = pair
             @model = model
           end
@@ -21,7 +21,9 @@ module RFC
 
           private
 
-          attr_reader :delimiter, :pair, :model
+          attr_reader :patterns, :pair, :model
+
+          def instance_variables_to_inspect = %i[@pair @model]
 
           def process parts,
                       root_uri,
@@ -43,9 +45,17 @@ module RFC
           end
 
           def build_uri value, root_uri:
-            value.delete_prefix("<")
-                 .delete_suffix(">")
-                 .then { it.start_with?("/") ? "#{root_uri}#{it}" : it }
+            value.match(uri_pattern)[:value].then do |uri|
+              uri.start_with?("/") ? "#{root_uri}#{uri}" : uri
+            end
+          end
+
+          def uri_pattern
+            @uri_pattern ||= patterns.fetch :uri
+          end
+
+          def delimiter
+            @delimiter ||= patterns.fetch :line_delimiter
           end
         end
       end

data/lib/rfc/web/link/parsers/list.rb

@@ -8,37 +8,31 @@ module RFC
       module Parsers
         # Parses header links into a list of records.
         class List
-          RELATION_PATTERN = /
-            (?<prefix>rel=")  # Prefix.
-            .+                # One or more characters.
-            \s+?              # One or more spaces, lazy.
-            .+                # One or more characters.
-            (?<suffix>")      # Suffix.
-          /x
-
-          def initialize relation_pattern: RELATION_PATTERN, line: Line.new, list: Models::List.new
-            @scanner = StringScanner.new ""
-            @relation_pattern = relation_pattern
+          def initialize patterns: PATTERNS, line: Line.new, list: Models::List.new
+            @patterns = patterns
             @line = line
             @list = list
+            @scanner = StringScanner.new ""
             @comma = ","
             @quote = %(")
           end
 
           def call text, root_uri:
-            text = String text
+            match = String(text).match uri_pattern
             list.clear
 
-            return list unless text.start_with? "<"
+            return list unless match
 
-            scanner.string = text
+            scanner.string = match.string
 
             build_list root_uri
           end
 
           private
 
-          attr_reader :scanner, :relation_pattern, :line, :list, :comma, :quote
+          attr_reader :patterns, :line, :list, :scanner, :comma, :quote
+
+          def instance_variables_to_inspect = %i[@line @list]
 
           def build_list root_uri, buffer: +"", lines: []
             check scanner.getch, buffer, lines until scanner.eos?
@@ -65,19 +59,23 @@ module RFC
             buffer << %("#{scanner.pre_match[start..]}")
           end
 
-          # rubocop:todo Metrics/AbcSize
           def maybe_split_by_relation text, root_uri:
             match = text.match relation_pattern
 
             return list.add line.call(text, root_uri:) unless match
 
-            match.to_s
-                 .delete_prefix(match[:prefix])
-                 .delete_suffix(match[:suffix])
-                 .split
-                 .each { list.add line.call(text.sub(relation_pattern, "rel=#{it}"), root_uri:) }
+            match[:value].split.each do |value|
+              list.add line.call(text.sub(relation_pattern, "rel=#{value}"), root_uri:)
+            end
+          end
+
+          def uri_pattern
+            @uri_pattern ||= patterns.fetch :uri
+          end
+
+          def relation_pattern
+            @relation_pattern ||= patterns.fetch :relation
           end
-          # rubocop:enable Metrics/AbcSize
         end
       end
     end

data/lib/rfc/web/link/parsers/pair.rb

@@ -6,16 +6,14 @@ module RFC
       module Parsers
         # Parses a header key/value pair into a record.
         class Pair
-          def initialize split_pattern: /(?<target>=)|(?<extended>\*=)/,
-                         decoder: Decoder.new,
-                         model: Models::Pair
-            @split_pattern = split_pattern
+          def initialize patterns: PATTERNS, decoder: Decoder.new, model: Models::Pair
+            @patterns = patterns
             @decoder = decoder
             @model = model
           end
 
           def call text, root_uri:
-            key, delimiter, value = text.split split_pattern
+            key, delimiter, value = text.split delimiter_pattern
             key.strip!
 
             attributes = decoder.call value
@@ -28,7 +26,13 @@ module RFC
 
           private
 
-          attr_reader :split_pattern, :decoder, :model
+          attr_reader :patterns, :decoder, :model
+
+          def instance_variables_to_inspect = %i[@decoder @model]
+
+          def delimiter_pattern
+            @delimiter_pattern ||= patterns.fetch :pair_delimiter
+          end
         end
       end
     end

data/lib/rfc/web/link/parsers.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module RFC
+  module Web
+    module Link
+      module Parsers
+        PATTERNS = {
+          uri: /
+            <                 # Prefix.
+            (?<value>.+)      # Value named group.
+            >                 # Suffix.
+          /x,
+          relation: /
+            rel="             # Prefix.
+            (?<value>.+)      # Value named group.
+            "                 # Suffix.
+          /x,
+          line_delimiter: /
+            ;                 # Semicolon.
+            \s*?              # Optional spaces, lazy.
+          /x,
+          pair_delimiter: /
+            (?<target>=)      # Target named group.
+            |                 # Or.
+            (?<extended>\*=)  # Extended named group.
+          /x
+        }.freeze
+      end
+    end
+  end
+end

data/lib/rfc/web/link.rb

@@ -5,6 +5,7 @@ require "rfc/web/link/encoder"
 require "rfc/web/link/models/link"
 require "rfc/web/link/models/list"
 require "rfc/web/link/models/pair"
+require "rfc/web/link/parsers"
 require "rfc/web/link/parsers/header"
 require "rfc/web/link/parsers/line"
 require "rfc/web/link/parsers/list"
@@ -14,7 +15,7 @@ module RFC
   module Web
     # Main namespace.
     module Link
-      def self.new(**) = Parsers::Header.new(**)
+      def self.new(*, **) = Parsers::Header.new(*, **)
     end
   end
 end

data/rfc-web-link.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name = "rfc-web-link"
-  spec.version = "0.0.0"
+  spec.version = "0.1.0"
   spec.authors = ["Brooke Kuhlmann"]
   spec.email = ["brooke@alchemists.io"]
   spec.homepage = "https://alchemists.io/projects/rfc-web-link"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rfc-web-link
 version: !ruby/object:Gem::Version
-  version: 0.0.0
+  version: 0.1.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -51,6 +51,7 @@ files:
 - lib/rfc/web/link/models/link.rb
 - lib/rfc/web/link/models/list.rb
 - lib/rfc/web/link/models/pair.rb
+- lib/rfc/web/link/parsers.rb
 - lib/rfc/web/link/parsers/header.rb
 - lib/rfc/web/link/parsers/line.rb
 - lib/rfc/web/link/parsers/list.rb