micromicro 4.0.0 → 5.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c4ed4ff8b2b7284cd01096982ef345571ffb1de9c10e5943b725976aa6778674
-  data.tar.gz: 9275bb41d54398977ea98439e76b0adab839ffa38869a2ecbe63468fed0dc376
+  metadata.gz: 1e785f62dd853af203f0529138dae1538c09e6a3940370f7b939b552e8c0fbe1
+  data.tar.gz: 2c356c5616b6ca146d362c1c2ce3299e935371cf7005f5c7cfcbe93125b0fa5b
 SHA512:
-  metadata.gz: 0e87a9b3275b7c212e485459a520ea3b7a687550450f42ff5ade89069e1fc610d64e9c918eec27c1a88be8807f14f652351c81150a3028884b37a050db7c0f70
-  data.tar.gz: 50278fa0b0130004d98b5851dc4530f19c6888028266538bd0d05e43820ff3b3d64af6aadc937e1497cce158a134553c1605857e342cc2511e67450c1314411d
+  metadata.gz: 615ad86af5e5da61652aec270f5927b131982388e92d9dae7b519d30a9d59a565819db13ed877770b1c1da54457940f9f6b03170eabf48a1ca0f41b9378b257e
+  data.tar.gz: 2676e978a705fd3af691ca6eaca603d1a50efc2def0947abe1a06b8dc0e85aef10b3ae5ee74930d60a10af21cd22cdb6b3c98c8db43861081de745d24352e42e

data/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## 5.0.1 / 2024-01-01
+
+- Use rubygems/release-gem action (#81) (ab39770)
+- RuboCop: Style/WordArray (227a223)
+- RuboCop: Style/StringLiteralsInInterpolation (f5c350c)
+- RuboCop: Style/SymbolArray (6ccd949)
+- RuboCop: Performance/StringIdentifierArgument (477e25a)
+- Add `source_code_uri` to metadata (b3f49cf)
+
+## 5.0.0 / 2023-12-11
+
+- Remove upper version constraint (#79) (86f09d8)
+- Miscellaneous cleanup (#78) (4023177)
+  - **Breaking change:** remove `Collectible` module (`next_all` and `prev_all`
+    no longer mixed in to various collection classes)
+  - reduce reliance on ActiveSupport
+- Address RuboCop Performance warnings (#77) (2d5d0c2)
+- RuboCop formatting fixes (#76) (9ab491e)
+- RuboCop: Single quotes within interpolated string (#75) (37f66c0)
+- RuboCop: `Style/StringLiterals` (#74) (918b58a)
+- Address RuboCop `Style/StringLiterals` warnings' (#73) (3fb3cf4)
+- Add IRB config file (#72) (1ce9fab)
+- Update project files (#71) (85a5dd4)
+- Remove CodeClimate references (#70) (0b86c34)
+- RuboCop: `Style/PerlBackrefs` (a360af0)
+- RuboCop: `Lint/RedundantDirGlobSort` (15c8aca)
+- RuboCop: `Style/RedundantRegexpArgument` (8c93eb7)
+- RuboCop: `Style/RedundantFreeze` (feaee51)
+- **Breaking change:** Set minimum supported Ruby to 3.0 (f39dbef)
+- **Breaking change:** Update development Ruby to v3.0.6 (6869e22)
+
 ## 4.0.0 / 2023-03-14
 
 - Parse HTML with `Nokogiri::HTML5::Document.parse` (330a2d1, 0de40d7)

data/README.md

@@ -5,14 +5,12 @@
 [![Gem](https://img.shields.io/gem/v/micromicro.svg?logo=rubygems&style=for-the-badge)](https://rubygems.org/gems/micromicro)
 [![Downloads](https://img.shields.io/gem/dt/micromicro.svg?logo=rubygems&style=for-the-badge)](https://rubygems.org/gems/micromicro)
 [![Build](https://img.shields.io/github/actions/workflow/status/jgarber623/micromicro/ci.yml?branch=main&logo=github&style=for-the-badge)](https://github.com/jgarber623/micromicro/actions/workflows/ci.yml)
-[![Maintainability](https://img.shields.io/codeclimate/maintainability/jgarber623/micromicro.svg?logo=code-climate&style=for-the-badge)](https://codeclimate.com/github/jgarber623/micromicro)
-[![Coverage](https://img.shields.io/codeclimate/c/jgarber623/micromicro.svg?logo=code-climate&style=for-the-badge)](https://codeclimate.com/github/jgarber623/micromicro/code)
 
 ## Key Features
 
 - Parses microformats2-encoded HTML documents according to the [microformats2 parsing specification](https://microformats.org/wiki/microformats2-parsing)
 - Passes all microformats2 tests from [the official test suite](https://github.com/microformats/tests)¹
-- Supports Ruby 2.7 and newer
+- Supports Ruby 3.0 and newer
 
 **Note:** MicroMicro **does not** parse [Classic Microformats](https://microformats.org/wiki/Main_Page#Classic_Microformats) (referred to in [the parsing specification](https://microformats.org/wiki/microformats2-parsing#note_backward_compatibility_details) as "backcompat root classes" and "backcompat properties" and in vocabulary specifications in the "Parser Compatibility" sections [e.g. [h-entry](https://microformats.org/wiki/h-entry#Parser_Compatibility)]). To parse documents marked up with Classic Microformats, consider using [the official microformats-ruby parser](https://github.com/microformats/microformats-ruby).
 
@@ -20,7 +18,7 @@
 
 ## Installation
 
-Before installing and using MicroMicro, you'll want to have [Ruby](https://www.ruby-lang.org) 2.7 (or newer) installed. If you're using [Bundler](https://bundler.io) to manage gem dependencies, add MicroMicro to your project's Gemfile:
+Before installing and using MicroMicro, you'll want to have [Ruby](https://www.ruby-lang.org) 3.0 (or newer) installed. If you're using [Bundler](https://bundler.io) to manage gem dependencies, add MicroMicro to your project's Gemfile:
 
 ```ruby
 gem 'micromicro'
@@ -50,10 +48,6 @@ doc.to_h
 
 See [USAGE.md](https://github.com/jgarber623/micromicro/blob/main/USAGE.md) for detailed examples of MicroMicro's features. Additional structured documentation is available on [RubyDoc.info](https://rubydoc.info/gems/micromicro).
 
-## Contributing
-
-Interested in helping improve MicroMicro? Awesome! Your help is greatly appreciated. See [CONTRIBUTING.md](https://github.com/jgarber623/micromicro/blob/main/CONTRIBUTING.md) for details.
-
 ## Acknowledgments
 
 MicroMicro wouldn't exist without the hard work of everyone involved in the [microformats](https://microformats.org) community. Additionally, the comprehensive [microformats test suite](https://github.com/microformats/tests) was invaluable in the development of this Ruby gem.

data/lib/micro_micro/collections/base_collection.rb

@@ -18,7 +18,7 @@ module MicroMicro
       #
       # :nocov:
       def inspect
-        "#<#{self.class}:#{format('%#0x', object_id)} " \
+        "#<#{self.class}:#{format("%#0x", object_id)} " \
           "count: #{count}, " \
           "members: #{members.inspect}>"
       end

data/lib/micro_micro/collections/items_collection.rb

@@ -58,7 +58,7 @@ module MicroMicro
       #
       # @return [Array<String>]
       def types
-        @types ||= flat_map(&:types).uniq.sort
+        @types ||= Set[*flat_map(&:types)].to_a.sort
       end
 
       # Recursively search this collection for {MicroMicro::Item}s matching the
@@ -70,10 +70,10 @@ module MicroMicro
       # either a String or an Array of Strings.
       #
       # @example Search using a Hash with a String value
-      #   MicroMicro.parse(markup, url).items.where(types: 'h-card')
+      #   MicroMicro.parse(markup, url).items.where(types: "h-card")
       #
       # @example Search using a Hash with an Array value
-      #   MicroMicro.parse(markup, url).items.where(types: ['h-card', 'h-entry'])
+      #   MicroMicro.parse(markup, url).items.where(types: ["h-card", "h-entry"])
       #
       # When passing a block, each {MicroMicro::Item} in this collection is
       # yielded to the block and the returned collection will include
@@ -82,7 +82,7 @@ module MicroMicro
       #
       # @example Search using a block
       #   MicroMicro.parse(markup, url).items.where do |item|
-      #     item.properties.names.include?('email')
+      #     item.properties.names.include?("email")
       #   end
       #
       # @param args [Hash{Symbol => String, Array<String>}]

data/lib/micro_micro/collections/properties_collection.rb

@@ -37,7 +37,7 @@ module MicroMicro
       #
       # @return [Array<String>]
       def names
-        @names ||= map(&:name).uniq.sort
+        @names ||= Set[*map(&:name)].to_a.sort
       end
 
       # A collection of plain text {MicroMicro::Property}s parsed from the node.
@@ -91,7 +91,7 @@ module MicroMicro
       #
       # @return [Array<String, Hash>]
       def values
-        @values ||= map(&:value).uniq
+        @values ||= Set[*map(&:value)].to_a
       end
 
       # Search this collection for {MicroMicro::Property}s matching the given
@@ -103,10 +103,10 @@ module MicroMicro
       # either a String or an Array of Strings.
       #
       # @example Search using a Hash with a String value
-      #   MicroMicro.parse(markup, url).properties.where(name: 'url')
+      #   MicroMicro.parse(markup, url).properties.where(name: "url")
       #
       # @example Search using a Hash with an Array value
-      #   MicroMicro.parse(markup, url).properties.where(name: ['name', 'url'])
+      #   MicroMicro.parse(markup, url).properties.where(name: ["name", "url"])
       #
       # When passing a block, each {MicroMicro::Property} in this collection
       # is yielded to the block and the returned collection will include

data/lib/micro_micro/collections/relationships_collection.rb

@@ -38,9 +38,10 @@ module MicroMicro
       #
       # @return [Hash{Symbol => Array<String>}]
       def group_by_rel
-        each_with_object(Hash.new { |hash, key| hash[key] = Set.new }) do |member, hash|
-          member.rels.each { |rel| hash[rel.to_sym] << member.href }
-        end.transform_values(&:to_a)
+        obj = Hash.new { |hash, key| hash[key] = Set.new }
+
+        each_with_object(obj) { |member, hash| member.rels.each { |rel| hash[rel.to_sym] << member.href } }
+          .transform_values(&:to_a)
       end
 
       # Return a Hash of this collection's {MicroMicro::Relationship}s grouped
@@ -61,7 +62,7 @@ module MicroMicro
       #
       # @return [Array<String>]
       def rels
-        @rels ||= flat_map(&:rels).uniq.sort
+        @rels ||= Set[*flat_map(&:rels)].to_a.sort
       end
 
       # Retrieve an Array of this collection's unique {MicroMicro::Relationship}
@@ -71,7 +72,7 @@ module MicroMicro
       #
       # @return [Array<String>]
       def urls
-        @urls ||= map(&:href).uniq.sort
+        @urls ||= Set[*map(&:href)].to_a.sort
       end
 
       # Search this collection for {MicroMicro::Relationship}s matching the
@@ -83,10 +84,10 @@ module MicroMicro
       # values may be either a String or an Array of Strings.
       #
       # @example Search using a Hash with a String value
-      #   MicroMicro.parse(markup, url).relationships.where(rels: 'webmention')
+      #   MicroMicro.parse(markup, url).relationships.where(rels: "webmention")
       #
       # @example Search using a Hash with an Array value
-      #   MicroMicro.parse(markup, url).relationships.where(rels: ['me', 'webmention'])
+      #   MicroMicro.parse(markup, url).relationships.where(rels: ["me", "webmention"])
       #
       # When passing a block, each {MicroMicro::Relationship} in this collection
       # is yielded to the block and the returned collection will include

data/lib/micro_micro/document.rb

@@ -5,10 +5,10 @@ module MicroMicro
     # Parse a string of HTML for microformats2-encoded data.
     #
     # @example Parse a String of markup
-    #   MicroMicro::Document.new('<a href="/" class="h-card" rel="me">Jason Garber</a>', 'https://sixtwothree.org')
+    #   MicroMicro::Document.new(%(<a href="/" class="h-card" rel="me">Jason Garber</a>), "https://sixtwothree.org")
     #
     # @example Parse a String of markup from a URL
-    #   url = 'https://tantek.com'
+    #   url = "https://tantek.com"
     #   markup = Net::HTTP.get(URI.parse(url))
     #
     #   doc = MicroMicro::Document.new(markup, url)
@@ -23,7 +23,7 @@ module MicroMicro
     #
     # :nocov:
     def inspect
-      "#<#{self.class}:#{format('%#0x', object_id)} " \
+      "#<#{self.class}:#{format("%#0x", object_id)} " \
         "items: #{items.inspect}, " \
         "relationships: #{relationships.inspect}>"
     end
@@ -57,7 +57,7 @@ module MicroMicro
       {
         items: items.to_a,
         rels: relationships.group_by_rel,
-        'rel-urls': relationships.group_by_url
+        "rel-urls": relationships.group_by_url
       }
     end
 

data/lib/micro_micro/helpers.rb

@@ -2,7 +2,7 @@
 
 module MicroMicro
   module Helpers
-    IGNORED_NODE_NAMES = %w[script style template].freeze
+    IGNORED_NODE_NAMES = ["script", "style", "template"].freeze
 
     private_constant :IGNORED_NODE_NAMES
 
@@ -10,9 +10,9 @@ module MicroMicro
     # @param attributes_map [Hash{String => Array}]
     # @return [String, nil]
     def self.attribute_value_from(node, attributes_map)
-      attributes_map.filter_map do |attribute, names|
-        node[attribute] if names.include?(node.name) && node[attribute]
-      end.first
+      attributes_map
+        .filter_map { |attribute, names| node[attribute] if names.include?(node.name) && node[attribute] }
+        .first
     end
 
     # @param node [Nokogiri::XML::Element]
@@ -54,7 +54,7 @@ module MicroMicro
     # @param node [Nokogiri::XML::Element]
     # @return [Array<String>]
     def self.root_class_names_from(node)
-      node.classes.grep(/^h(?:-[0-9a-z]+)?(?:-[a-z]+)+$/).uniq.sort
+      Set[*node.classes.grep(/^h(?:-[0-9a-z]+)?(?:-[a-z]+)+$/)].to_a.sort
     end
 
     # @see https://microformats.org/wiki/microformats2-parsing#parse_an_element_for_properties
@@ -79,7 +79,7 @@ module MicroMicro
     # @param node [Nokogiri::XML::Element]
     # @return [Boolean]
     def self.value_class_node?(node)
-      node.classes.include?('value')
+      node.classes.include?("value")
     end
 
     # @see https://microformats.org/wiki/value-class-pattern#Parsing_value_from_a_title_attribute
@@ -88,7 +88,7 @@ module MicroMicro
     # @param node [Nokogiri::XML::Element]
     # @return [Boolean]
     def self.value_title_node?(node)
-      node.classes.include?('value-title')
+      node.classes.include?("value-title")
     end
   end
 end

data/lib/micro_micro/implied_property.rb

@@ -3,9 +3,9 @@
 module MicroMicro
   class ImpliedProperty < Property
     IMPLIED_PROPERTY_PARSERS_MAP = {
-      'name'  => Parsers::ImpliedNamePropertyParser,
-      'photo' => Parsers::ImpliedPhotoPropertyParser,
-      'url'   => Parsers::ImpliedUrlPropertyParser
+      "name"  => Parsers::ImpliedNamePropertyParser,
+      "photo" => Parsers::ImpliedPhotoPropertyParser,
+      "url"   => Parsers::ImpliedUrlPropertyParser
     }.freeze
 
     private_constant :IMPLIED_PROPERTY_PARSERS_MAP

data/lib/micro_micro/item.rb

@@ -2,8 +2,6 @@
 
 module MicroMicro
   class Item
-    include Collectible
-
     class ItemNodeSearch
       attr_reader :node_set
 
@@ -30,6 +28,11 @@ module MicroMicro
 
     private_constant :ItemNodeSearch
 
+    # The {MicroMicro::ItemsCollection} to which this {MicroMicro::Item} belongs.
+    #
+    # @return [MicroMicro::PropertiesCollection]
+    attr_accessor :collection
+
     # Extract {MicroMicro::Item}s from a context.
     #
     # @param context [Nokogiri::HTML5::Document, Nokogiri::XML::NodeSet, Nokogiri::XML::Element]
@@ -74,7 +77,7 @@ module MicroMicro
     #
     # @return [String, nil]
     def id
-      @id ||= node['id']&.strip
+      @id ||= node["id"]&.strip
     end
 
     # Does this {MicroMicro::Item} have an +id+ attribute value?
@@ -88,7 +91,7 @@ module MicroMicro
     #
     # :nocov:
     def inspect
-      "#<#{self.class}:#{format('%#0x', object_id)} " \
+      "#<#{self.class}:#{format("%#0x", object_id)} " \
         "types: #{types.inspect}, " \
         "properties: #{properties.count}, " \
         "children: #{children.count}>"
@@ -140,7 +143,7 @@ module MicroMicro
 
     # @return [MicroMicro::ImpliedProperty]
     def implied_name
-      @implied_name ||= ImpliedProperty.new(node, 'p-name')
+      @implied_name ||= ImpliedProperty.new(node, "p-name")
     end
 
     # @return [Boolean]
@@ -150,7 +153,7 @@ module MicroMicro
 
     # @return [MicroMicro::ImpliedProperty]
     def implied_photo
-      @implied_photo ||= ImpliedProperty.new(node, 'u-photo')
+      @implied_photo ||= ImpliedProperty.new(node, "u-photo")
     end
 
     # @return [Boolean]
@@ -160,7 +163,7 @@ module MicroMicro
 
     # @return [MicroMicro::ImpliedProperty]
     def implied_url
-      @implied_url ||= ImpliedProperty.new(node, 'u-url')
+      @implied_url ||= ImpliedProperty.new(node, "u-url")
     end
 
     # @return [Boolean]
@@ -170,7 +173,7 @@ module MicroMicro
 
     # @return [Boolean]
     def imply_name?
-      properties.names.none?('name') &&
+      properties.names.none?("name") &&
         properties.none?(&:embedded_markup_property?) &&
         properties.none?(&:plain_text_property?) &&
         !nested_items?
@@ -178,14 +181,14 @@ module MicroMicro
 
     # @return [Boolean]
     def imply_photo?
-      properties.names.none?('photo') &&
+      properties.names.none?("photo") &&
         properties.reject(&:implied?).none?(&:url_property?) &&
         !nested_items?
     end
 
     # @return [Boolean]
     def imply_url?
-      properties.names.none?('url') &&
+      properties.names.none?("url") &&
         properties.reject(&:implied?).none?(&:url_property?) &&
         !nested_items?
     end

data/lib/micro_micro/parsers/base_implied_property_parser.rb

@@ -14,9 +14,10 @@ module MicroMicro
       def candidate_node
         @candidate_node ||=
           candidate_nodes.find do |node|
-            self.class::HTML_ELEMENTS_MAP.filter_map do |name, attribute|
-              node if name == node.name && node[attribute]
-            end.any?
+            self
+              .class::HTML_ELEMENTS_MAP
+              .filter_map { |name, attribute| node if name == node.name && node[attribute] }
+              .any?
           end
       end
 

data/lib/micro_micro/parsers/base_property_parser.rb

@@ -18,7 +18,7 @@ module MicroMicro
       def value
         @value ||=
           Helpers.text_content_from(node) do |context|
-            context.css('img').each { |img| img.content = " #{img['alt'] || img['src']} " }
+            context.css("img").each { |img| img.content = " #{img["alt"] || img["src"]} " }
           end
       end
 

data/lib/micro_micro/parsers/date_time_parser.rb

@@ -24,7 +24,7 @@ module MicroMicro
         (?:#{DATE_REGEXP_PATTERN})?
         (?:\s?#{TIME_REGEXP_PATTERN}(?:#{TIMEZONE_REGEXP_PATTERN})?)?
         \z
-      /x.freeze
+      /x
 
       # Parse a string for date and/or time values according to the Microformats
       # Value Class Pattern date and time parsing specification.
@@ -39,13 +39,9 @@ module MicroMicro
 
       # Define getter and predicate methods for all possible named captures
       # returned by the DATE_TIME_TIMEZONE_REGEXP regular expression.
-      [
-        :year, :ordinal, :month, :day,
-        :hours, :minutes, :seconds,
-        :abbreviation, :zulu, :offset
-      ].each do |name|
+      [:year, :ordinal, :month, :day, :hours, :minutes, :seconds, :abbreviation, :zulu, :offset].each do |name|
         define_method(name) { values[name] }
-        define_method("#{name}?") { public_send(name).present? }
+        define_method(:"#{name}?") { public_send(name).present? }
       end
 
       # @return [String, nil]
@@ -62,15 +58,15 @@ module MicroMicro
       def normalized_hours
         @normalized_hours ||=
           if hours?
-            return (hours.to_i + 12).to_s if abbreviation&.tr('.', '')&.downcase == 'pm'
+            return (hours.to_i + 12).to_s if abbreviation&.tr(".", "")&.downcase == "pm"
 
-            format('%<hours>02d', hours: hours)
+            format("%<hours>02d", hours: hours)
           end
       end
 
       # @return [String]
       def normalized_minutes
-        @normalized_minutes ||= minutes || '00'
+        @normalized_minutes ||= minutes || "00"
       end
 
       # @return [String, nil]
@@ -80,12 +76,12 @@ module MicroMicro
 
       # @return [String, nil]
       def normalized_time
-        @normalized_time ||= [normalized_hours, normalized_minutes, seconds].compact.join(':') if normalized_hours
+        @normalized_time ||= [normalized_hours, normalized_minutes, seconds].compact.join(":") if normalized_hours
       end
 
       # @return [String, nil]
       def normalized_timezone
-        @normalized_timezone ||= zulu || offset&.tr(':', '')
+        @normalized_timezone ||= zulu || offset&.tr(":", "")
       end
 
       # @return [String, nil]

data/lib/micro_micro/parsers/date_time_property_parser.rb

@@ -4,9 +4,9 @@ module MicroMicro
   module Parsers
     class DateTimePropertyParser < BasePropertyParser
       HTML_ATTRIBUTES_MAP = {
-        'datetime' => %w[del ins time],
-        'title'    => %w[abbr],
-        'value'    => %w[data input]
+        "datetime" => ["del", "ins", "time"],
+        "title"    => ["abbr"],
+        "value"    => ["data", "input"]
       }.freeze
 
       # @see https://microformats.org/wiki/microformats2-parsing#parsing_a_dt-_property
@@ -25,9 +25,13 @@ module MicroMicro
       # @return [MicroMicro::Parsers::DateTimeParser, nil]
       def adopted_date_time_parser
         @adopted_date_time_parser ||=
-          (property.prev_all.reverse + property.next_all).filter_map do |prop|
-            DateTimeParser.new(prop.value) if prop.date_time_property?
-          end.find(&:normalized_date)
+          begin
+            head, tail = property.collection.split(property)
+
+            (head.reverse + tail)
+              .filter_map { |prop| DateTimeParser.new(prop.value) if prop.date_time_property? }
+              .find(&:normalized_date)
+          end
       end
 
       # @return [String, nil]
@@ -37,7 +41,7 @@ module MicroMicro
 
       # @return [MicroMicro::Parsers::DateTimeParser]
       def date_time_parser
-        @date_time_parser ||= DateTimeParser.new(ValueClassPatternParser.new(node, ' ').value)
+        @date_time_parser ||= DateTimeParser.new(ValueClassPatternParser.new(node, " ").value)
       end
 
       # @see https://microformats.org/wiki/value-class-pattern#microformats2_parsers_implied_date

data/lib/micro_micro/parsers/image_element_parser.rb

@@ -15,7 +15,7 @@ module MicroMicro
 
       # @return [String, nil]
       def alt
-        @alt ||= node['alt']&.strip
+        @alt ||= node["alt"]&.strip
       end
 
       # @return [Boolean]
@@ -25,7 +25,7 @@ module MicroMicro
 
       # @return [Hash{Symbol => String}, nil]
       def srcset
-        @srcset ||= image_candidates if node['srcset']
+        @srcset ||= image_candidates if node["srcset"]
       end
 
       # @return [Boolean]
@@ -49,20 +49,17 @@ module MicroMicro
       attr_reader :node
 
       # @return [Hash{Symbol => String}]
-      #
-      # rubocop:disable Style/PerlBackrefs
       def image_candidates
-        node['srcset']
-          .split(',')
+        node["srcset"]
+          .split(",")
           .each_with_object({}) do |candidate, hash|
             candidate.strip.match(/^(.+?)(\s+.+)?$/) do
-              key = ($2 || '1x').strip.to_sym
+              key = (Regexp.last_match(2) || "1x").strip.to_sym
 
-              hash[key] = $1 unless hash[key]
+              hash[key] = Regexp.last_match(1) unless hash[key]
             end
           end
       end
-      # rubocop:enable Style/PerlBackrefs
     end
   end
 end

data/lib/micro_micro/parsers/implied_name_property_parser.rb

@@ -4,9 +4,9 @@ module MicroMicro
   module Parsers
     class ImpliedNamePropertyParser < BaseImpliedPropertyParser
       HTML_ELEMENTS_MAP = {
-        'img'  => 'alt',
-        'area' => 'alt',
-        'abbr' => 'title'
+        "img"  => "alt",
+        "area" => "alt",
+        "abbr" => "title"
       }.freeze
 
       # @see https://microformats.org/wiki/microformats2-parsing#parsing_for_implied_properties
@@ -22,15 +22,15 @@ module MicroMicro
       # @return [Array]
       def child_nodes
         [
-          node.at_css('> :only-child'),
-          node.at_css('> :only-child > :only-child')
-        ].compact.reject { |child_node| Helpers.item_node?(child_node) }
+          node.at_css("> :only-child"),
+          node.at_css("> :only-child > :only-child")
+        ].delete_if { |child_node| child_node.nil? || Helpers.item_node?(child_node) }
       end
 
       # @return [String]
       def text_content
         Helpers.text_content_from(node) do |context|
-          context.css('img').each { |img| img.content = img['alt'] }
+          context.css("img").each { |img| img.content = img["alt"] }
         end
       end
     end

data/lib/micro_micro/parsers/implied_photo_property_parser.rb

@@ -3,11 +3,11 @@
 module MicroMicro
   module Parsers
     class ImpliedPhotoPropertyParser < BaseImpliedPropertyParser
-      CSS_SELECTORS_ARRAY = ['> img[src]:only-of-type', '> object[data]:only-of-type'].freeze
+      CSS_SELECTORS_ARRAY = ["> img[src]:only-of-type", "> object[data]:only-of-type"].freeze
 
       HTML_ELEMENTS_MAP = {
-        'img'    => 'src',
-        'object' => 'data'
+        "img"    => "src",
+        "object" => "data"
       }.freeze
 
       # @see https://microformats.org/wiki/microformats2-parsing#parsing_for_implied_properties
@@ -19,7 +19,7 @@ module MicroMicro
       def value
         @value ||=
           if attribute_value
-            if candidate_node.matches?('img[alt], img[srcset]')
+            if candidate_node.matches?("img[alt], img[srcset]")
               ImageElementParser.new(candidate_node, attribute_value).to_h
             else
               attribute_value
@@ -35,7 +35,7 @@ module MicroMicro
 
         nodes << node.first_element_child.at_css(*CSS_SELECTORS_ARRAY) if node.element_children.one?
 
-        nodes.compact.reject { |child_node| Helpers.item_node?(child_node) }
+        nodes.delete_if { |child_node| child_node.nil? || Helpers.item_node?(child_node) }
       end
     end
   end

data/lib/micro_micro/parsers/implied_url_property_parser.rb

@@ -3,11 +3,11 @@
 module MicroMicro
   module Parsers
     class ImpliedUrlPropertyParser < BaseImpliedPropertyParser
-      CSS_SELECTORS_ARRAY = ['> a[href]:only-of-type', '> area[href]:only-of-type'].freeze
+      CSS_SELECTORS_ARRAY = ["> a[href]:only-of-type", "> area[href]:only-of-type"].freeze
 
       HTML_ELEMENTS_MAP = {
-        'a'    => 'href',
-        'area' => 'href'
+        "a"    => "href",
+        "area" => "href"
       }.freeze
 
       # @see https://microformats.org/wiki/microformats2-parsing#parsing_for_implied_properties
@@ -26,7 +26,7 @@ module MicroMicro
 
         nodes << node.first_element_child.at_css(*CSS_SELECTORS_ARRAY) if node.element_children.one?
 
-        nodes.compact.reject { |child_node| Helpers.item_node?(child_node) }
+        nodes.delete_if { |child_node| child_node.nil? || Helpers.item_node?(child_node) }
       end
     end
   end

data/lib/micro_micro/parsers/plain_text_property_parser.rb

@@ -4,9 +4,9 @@ module MicroMicro
   module Parsers
     class PlainTextPropertyParser < BasePropertyParser
       HTML_ATTRIBUTES_MAP = {
-        'title' => %w[abbr link],
-        'value' => %w[data input],
-        'alt'   => %w[area img]
+        "title" => ["abbr", "link"],
+        "value" => ["data", "input"],
+        "alt"   => ["area", "img"]
       }.freeze
 
       # @see https://microformats.org/wiki/microformats2-parsing#parsing_a_p-_property

data/lib/micro_micro/parsers/url_property_parser.rb

@@ -4,15 +4,15 @@ module MicroMicro
   module Parsers
     class UrlPropertyParser < BasePropertyParser
       HTML_ATTRIBUTES_MAP = {
-        'href'   => %w[a area link],
-        'src'    => %w[audio iframe img source video],
-        'poster' => %w[video],
-        'data'   => %w[object]
+        "href"   => ["a", "area", "link"],
+        "src"    => ["audio", "iframe", "img", "source", "video"],
+        "poster" => ["video"],
+        "data"   => ["object"]
       }.freeze
 
       EXTENDED_HTML_ATTRIBUTES_MAP = {
-        'title' => %w[abbr],
-        'value' => %w[data input]
+        "title" => ["abbr"],
+        "value" => ["data", "input"]
       }.freeze
 
       # @see https://microformats.org/wiki/microformats2-parsing#parsing_a_u-_property
@@ -23,7 +23,7 @@ module MicroMicro
       # @return [String, Hash{Symbol => String}]
       def value
         @value ||=
-          if node.matches?('img[alt], img[srcset]')
+          if node.matches?("img[alt], img[srcset]")
             ImageElementParser.new(node, resolved_value).to_h
           else
             resolved_value

data/lib/micro_micro/parsers/value_class_pattern_parser.rb

@@ -8,10 +8,10 @@ module MicroMicro
       # @see https://microformats.org/wiki/value-class-pattern#Date_and_time_values
       #   microformats.org: Value Class Pattern § Date and time values
       HTML_ATTRIBUTES_MAP = {
-        'alt'      => %w[area img],
-        'value'    => %w[data],
-        'title'    => %w[abbr],
-        'datetime' => %w[del ins time]
+        "alt"      => ["area", "img"],
+        "value"    => ["data"],
+        "title"    => ["abbr"],
+        "datetime" => ["del", "ins", "time"]
       }.freeze
 
       # @param context [Nokogiri::XML::NodeSet, Nokogiri::XML::Element]
@@ -34,14 +34,14 @@ module MicroMicro
       # @param node [Nokogiri::XML::Element]
       # @return [String, nil]
       def self.value_from(node)
-        return node['title'] if Helpers.value_title_node?(node)
+        return node["title"] if Helpers.value_title_node?(node)
 
         Helpers.attribute_value_from(node, HTML_ATTRIBUTES_MAP) || node.text
       end
 
       # @param node [Nokogiri::XML::Element]
       # @param separator [String]
-      def initialize(node, separator = '')
+      def initialize(node, separator = "")
         @node = node
         @separator = separator
       end
@@ -54,10 +54,11 @@ module MicroMicro
       # @return [Array<String>]
       def values
         @values ||=
-          self.class
-              .node_set_from(node)
-              .map { |value_node| self.class.value_from(value_node) }
-              .compact_blank!
+          self
+            .class
+            .node_set_from(node)
+            .map { |value_node| self.class.value_from(value_node) }
+            .compact_blank!
       end
 
       private

data/lib/micro_micro/property.rb

@@ -2,13 +2,11 @@
 
 module MicroMicro
   class Property
-    include Collectible
-
     PROPERTY_PARSERS_MAP = {
-      'dt' => Parsers::DateTimePropertyParser,
-      'e'  => Parsers::EmbeddedMarkupPropertyParser,
-      'p'  => Parsers::PlainTextPropertyParser,
-      'u'  => Parsers::UrlPropertyParser
+      "dt" => Parsers::DateTimePropertyParser,
+      "e"  => Parsers::EmbeddedMarkupPropertyParser,
+      "p"  => Parsers::PlainTextPropertyParser,
+      "u"  => Parsers::UrlPropertyParser
     }.freeze
 
     private_constant :PROPERTY_PARSERS_MAP
@@ -35,6 +33,12 @@ module MicroMicro
 
     private_constant :PropertyNodeSearch
 
+    # The {MicroMicro::PropertiesCollection} to which this
+    # {MicroMicro::Property} belongs.
+    #
+    # @return [MicroMicro::PropertiesCollection]
+    attr_accessor :collection
+
     # This {MicroMicro::Property}'s +name+ value.
     #
     # @return [String]
@@ -70,21 +74,21 @@ module MicroMicro
     #   property value (e.g. +p-name+, +u-url+).
     def initialize(node, token)
       @node = node
-      @prefix, @name = token.split(/-/, 2)
+      @prefix, @name = token.split("-", 2)
     end
 
     # Is this {MicroMicro::Property} a datetime property?
     #
     # @return [Boolean]
     def date_time_property?
-      prefix == 'dt'
+      prefix == "dt"
     end
 
     # Is this {MicroMicro::Property} an embedded markup property?
     #
     # @return [Boolean]
     def embedded_markup_property?
-      prefix == 'e'
+      prefix == "e"
     end
 
     # Always return +false+ when asked if this {MicroMicro::Property} is an
@@ -101,7 +105,7 @@ module MicroMicro
     #
     # :nocov:
     def inspect
-      "#<#{self.class}:#{format('%#0x', object_id)} " \
+      "#<#{self.class}:#{format("%#0x", object_id)} " \
         "name: #{name.inspect}, " \
         "prefix: #{prefix.inspect}, " \
         "value: #{value.inspect}>"
@@ -130,14 +134,14 @@ module MicroMicro
     #
     # @return [Boolean]
     def plain_text_property?
-      prefix == 'p'
+      prefix == "p"
     end
 
     # Is this {MicroMicro::Property} a url property?
     #
     # @return [Boolean]
     def url_property?
-      prefix == 'u'
+      prefix == "u"
     end
 
     # Return this {MicroMicro::Property}'s parsed value.
@@ -152,8 +156,8 @@ module MicroMicro
 
           return hash.merge(parser.value) if embedded_markup_property?
 
-          p_property = item.properties.find_by(name: 'name') if plain_text_property?
-          u_property = item.properties.find_by(name: 'url') if url_property?
+          p_property = item.properties.find_by(name: "name") if plain_text_property?
+          u_property = item.properties.find_by(name: "url") if url_property?
 
           hash.merge(value: (p_property || u_property || parser).value)
         else

data/lib/micro_micro/relationship.rb

@@ -2,16 +2,20 @@
 
 module MicroMicro
   class Relationship
-    include Collectible
+    # The {MicroMicro::RelationshipsCollection} to which this
+    # {MicroMicro::Relationship} belongs.
+    #
+    # @return [MicroMicro::RelationshipsCollection]
+    attr_accessor :collection
 
     # Extract {MicroMicro::Relationship}s from a context.
     #
     # @param context [Nokogiri::HTML5::Document, Nokogiri::XML::Element]
     # @return [Array<MicroMicro::Relationship>]
     def self.from_context(context)
-      context.css('[href][rel]:not([rel=""])')
-             .reject { |node| Helpers.ignore_nodes?(node.ancestors) }
-             .map { |node| new(node) }
+      context
+        .css(%([href][rel]:not([rel=""])))
+        .filter_map { |node| new(node) unless Helpers.ignore_nodes?(node.ancestors) }
     end
 
     # Parse a node for relationship data.
@@ -26,21 +30,21 @@ module MicroMicro
     #
     # @return [String]
     def href
-      @href ||= node['href']
+      @href ||= node["href"]
     end
 
     # The value of the node's +hreflang+ attribute, if present.
     #
     # @return [String, nil]
     def hreflang
-      @hreflang ||= node['hreflang']&.strip
+      @hreflang ||= node["hreflang"]&.strip
     end
 
     # @return [String]
     #
     # :nocov:
     def inspect
-      "#<#{self.class}:#{format('%#0x', object_id)} " \
+      "#<#{self.class}:#{format("%#0x", object_id)} " \
         "href: #{href.inspect}, " \
         "rels: #{rels.inspect}>"
     end
@@ -50,7 +54,7 @@ module MicroMicro
     #
     # @return [String, nil]
     def media
-      @media ||= node['media']&.strip
+      @media ||= node["media"]&.strip
     end
 
     # Return the parsed {MicroMicro::Relationship} as a Hash.
@@ -72,7 +76,7 @@ module MicroMicro
     #
     # @return [Array<String>]
     def rels
-      @rels ||= node['rel'].split.uniq.sort
+      @rels ||= Set[*node["rel"].split].to_a.sort
     end
 
     # The node's text content.
@@ -86,14 +90,14 @@ module MicroMicro
     #
     # @return [String, nil]
     def title
-      @title ||= node['title']&.strip
+      @title ||= node["title"]&.strip
     end
 
     # The value of the node's +type+ attribute, if present.
     #
     # @return [String, nil]
     def type
-      @type ||= node['type']&.strip
+      @type ||= node["type"]&.strip
     end
 
     private

data/lib/micro_micro/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module MicroMicro
-  VERSION = '4.0.0'
+  VERSION = "5.0.1"
 end

data/lib/micromicro.rb

@@ -1,44 +1,42 @@
 # frozen_string_literal: true
 
-require 'forwardable'
-
-require 'active_support/core_ext/array/grouping'
-require 'active_support/core_ext/enumerable'
-require 'active_support/core_ext/hash/deep_transform_values'
-require 'active_support/core_ext/hash/except'
-require 'active_support/core_ext/object/blank'
-require 'nokogiri'
-require 'nokogiri/html-ext'
-
-require_relative 'micro_micro/version'
-require_relative 'micro_micro/collectible'
-require_relative 'micro_micro/helpers'
-
-require_relative 'micro_micro/parsers/date_time_parser'
-require_relative 'micro_micro/parsers/image_element_parser'
-require_relative 'micro_micro/parsers/value_class_pattern_parser'
-
-require_relative 'micro_micro/parsers/base_property_parser'
-require_relative 'micro_micro/parsers/date_time_property_parser'
-require_relative 'micro_micro/parsers/embedded_markup_property_parser'
-require_relative 'micro_micro/parsers/plain_text_property_parser'
-require_relative 'micro_micro/parsers/url_property_parser'
-
-require_relative 'micro_micro/parsers/base_implied_property_parser'
-require_relative 'micro_micro/parsers/implied_name_property_parser'
-require_relative 'micro_micro/parsers/implied_photo_property_parser'
-require_relative 'micro_micro/parsers/implied_url_property_parser'
-
-require_relative 'micro_micro/document'
-require_relative 'micro_micro/item'
-require_relative 'micro_micro/property'
-require_relative 'micro_micro/implied_property'
-require_relative 'micro_micro/relationship'
-
-require_relative 'micro_micro/collections/base_collection'
-require_relative 'micro_micro/collections/items_collection'
-require_relative 'micro_micro/collections/properties_collection'
-require_relative 'micro_micro/collections/relationships_collection'
+require "forwardable"
+
+require "active_support/core_ext/array/grouping"
+require "active_support/core_ext/enumerable"
+require "active_support/core_ext/hash/deep_transform_values"
+require "active_support/core_ext/object/blank"
+require "nokogiri"
+require "nokogiri/html-ext"
+
+require_relative "micro_micro/version"
+require_relative "micro_micro/helpers"
+
+require_relative "micro_micro/parsers/date_time_parser"
+require_relative "micro_micro/parsers/image_element_parser"
+require_relative "micro_micro/parsers/value_class_pattern_parser"
+
+require_relative "micro_micro/parsers/base_property_parser"
+require_relative "micro_micro/parsers/date_time_property_parser"
+require_relative "micro_micro/parsers/embedded_markup_property_parser"
+require_relative "micro_micro/parsers/plain_text_property_parser"
+require_relative "micro_micro/parsers/url_property_parser"
+
+require_relative "micro_micro/parsers/base_implied_property_parser"
+require_relative "micro_micro/parsers/implied_name_property_parser"
+require_relative "micro_micro/parsers/implied_photo_property_parser"
+require_relative "micro_micro/parsers/implied_url_property_parser"
+
+require_relative "micro_micro/document"
+require_relative "micro_micro/item"
+require_relative "micro_micro/property"
+require_relative "micro_micro/implied_property"
+require_relative "micro_micro/relationship"
+
+require_relative "micro_micro/collections/base_collection"
+require_relative "micro_micro/collections/items_collection"
+require_relative "micro_micro/collections/properties_collection"
+require_relative "micro_micro/collections/relationships_collection"
 
 module MicroMicro
   # Parse a string of HTML for microformats2-encoded data.
@@ -46,7 +44,7 @@ module MicroMicro
   # Convenience method for {MicroMicro::Document#initialize}.
   #
   # @example
-  #   MicroMicro.parse('<a href="/" class="h-card" rel="me">Jason Garber</a>', 'https://sixtwothree.org')
+  #   MicroMicro.parse(%(<a href="/" class="h-card" rel="me">Jason Garber</a>), "https://sixtwothree.org")
   #
   # @param (see MicroMicro::Document#initialize)
   # @return (see MicroMicro::Document#initialize)

data/micromicro.gemspec

@@ -1,33 +1,34 @@
 # frozen_string_literal: true
 
-require_relative 'lib/micro_micro/version'
+require_relative "lib/micro_micro/version"
 
 Gem::Specification.new do |spec|
-  spec.required_ruby_version = '>= 2.7', '< 4'
+  spec.required_ruby_version = ">= 3.0"
 
-  spec.name          = 'micromicro'
+  spec.name          = "micromicro"
   spec.version       = MicroMicro::VERSION
-  spec.authors       = ['Jason Garber']
-  spec.email         = ['jason@sixtwothree.org']
+  spec.authors       = ["Jason Garber"]
+  spec.email         = ["jason@sixtwothree.org"]
 
-  spec.summary       = 'Extract microformats2-encoded data from HTML documents.'
+  spec.summary       = "Extract microformats2-encoded data from HTML documents."
   spec.description   = spec.summary
-  spec.homepage      = 'https://github.com/jgarber623/micromicro'
-  spec.license       = 'MIT'
+  spec.homepage      = "https://github.com/jgarber623/micromicro"
+  spec.license       = "MIT"
 
-  spec.files         = Dir['lib/**/*'].reject { |f| File.directory?(f) }
-  spec.files        += %w[LICENSE CHANGELOG.md CONTRIBUTING.md README.md]
-  spec.files        += %w[micromicro.gemspec]
+  spec.files         = Dir["lib/**/*"].reject { |f| File.directory?(f) }
+  spec.files        += ["LICENSE", "CHANGELOG.md", "README.md"]
+  spec.files        += ["micromicro.gemspec"]
 
-  spec.require_paths = ['lib']
+  spec.require_paths = ["lib"]
 
   spec.metadata = {
-    'bug_tracker_uri'       => "#{spec.homepage}/issues",
-    'changelog_uri'         => "#{spec.homepage}/blob/v#{spec.version}/CHANGELOG.md",
-    'rubygems_mfa_required' => 'true'
+    "bug_tracker_uri"       => "#{spec.homepage}/issues",
+    "changelog_uri"         => "#{spec.homepage}/blob/v#{spec.version}/CHANGELOG.md",
+    "rubygems_mfa_required" => "true",
+    "source_code_uri"       => "#{spec.homepage}/tree/v#{spec.version}"
   }
 
-  spec.add_runtime_dependency 'activesupport', '~> 7.0'
-  spec.add_runtime_dependency 'nokogiri', '>= 1.14'
-  spec.add_runtime_dependency 'nokogiri-html-ext', '~> 0.4.0'
+  spec.add_runtime_dependency "activesupport", "~> 7.0"
+  spec.add_runtime_dependency "nokogiri", ">= 1.14"
+  spec.add_runtime_dependency "nokogiri-html-ext", "~> 0.4.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: micromicro
 version: !ruby/object:Gem::Version
-  version: 4.0.0
+  version: 5.0.1
 platform: ruby
 authors:
 - Jason Garber
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-03-14 00:00:00.000000000 Z
+date: 2024-01-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -60,10 +60,8 @@ extensions: []
 extra_rdoc_files: []
 files:
 - CHANGELOG.md
-- CONTRIBUTING.md
 - LICENSE
 - README.md
-- lib/micro_micro/collectible.rb
 - lib/micro_micro/collections/base_collection.rb
 - lib/micro_micro/collections/items_collection.rb
 - lib/micro_micro/collections/properties_collection.rb
@@ -94,8 +92,9 @@ licenses:
 - MIT
 metadata:
   bug_tracker_uri: https://github.com/jgarber623/micromicro/issues
-  changelog_uri: https://github.com/jgarber623/micromicro/blob/v4.0.0/CHANGELOG.md
+  changelog_uri: https://github.com/jgarber623/micromicro/blob/v5.0.1/CHANGELOG.md
   rubygems_mfa_required: 'true'
+  source_code_uri: https://github.com/jgarber623/micromicro/tree/v5.0.1
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -104,17 +103,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.7'
-  - - "<"
-    - !ruby/object:Gem::Version
-      version: '4'
+      version: '3.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.26
+rubygems_version: 3.2.33
 signing_key: 
 specification_version: 4
 summary: Extract microformats2-encoded data from HTML documents.

data/CONTRIBUTING.md

@@ -1,37 +0,0 @@
-# Contributing to MicroMicro
-
-There are a couple ways you can help improve MicroMicro:
-
-1. Fix an existing [issue][issues] and submit a [pull request][pulls].
-1. Review open [pull requests][pulls].
-1. Report a new [issue][issues]. _Only do this after you've made sure the behavior or problem you're observing isn't already documented in an open issue._
-
-## Getting Started
-
-MicroMicro is developed using Ruby 2.7.7 and is additionally tested against Ruby 3.0, 3.1, and 3.2 using [GitHub Actions](https://github.com/jgarber623/micromicro/actions).
-
-Before making changes to MicroMicro, you'll want to install Ruby 2.7.7. It's recommended that you use a Ruby version managment tool like [rbenv](https://github.com/rbenv/rbenv), [chruby](https://github.com/postmodern/chruby), or [rvm](https://github.com/rvm/rvm). Once you've installed Ruby 2.7.7 using your method of choice, install the project's gems by running:
-
-```sh
-bundle install
-```
-
-## Making Changes
-
-1. Fork and clone the project's repo.
-1. Install development dependencies as outlined above.
-1. Create a feature branch for the code changes you're looking to make: `git checkout -b my-new-feature`.
-1. _Write some code!_
-1. If your changes would benefit from testing, add the necessary tests and verify everything passes by running `bundle exec rspec`.
-1. Commit your changes: `git commit -am 'Add some new feature or fix some issue'`. _(See [this excellent article](https://chris.beams.io/posts/git-commit/) for tips on writing useful Git commit messages.)_
-1. Push the branch to your fork: `git push -u origin my-new-feature`.
-1. Create a new [pull request][pulls] and we'll review your changes.
-
-## Code Style
-
-Code formatting conventions are defined in the `.editorconfig` file which uses the [EditorConfig](http://editorconfig.org) syntax. There are [plugins for a variety of editors](http://editorconfig.org/#download) that utilize the settings in the `.editorconfig` file. We recommended you install the EditorConfig plugin for your editor of choice.
-
-Your bug fix or feature addition won't be rejected if it runs afoul of any (or all) of these guidelines, but following the guidelines will definitely make everyone's lives a little easier.
-
-[issues]: https://github.com/jgarber623/micromicro/issues
-[pulls]: https://github.com/jgarber623/micromicro/pulls

data/lib/micro_micro/collectible.rb

@@ -1,15 +0,0 @@
-# frozen_string_literal: true
-
-module MicroMicro
-  module Collectible
-    attr_accessor :collection
-
-    def next_all
-      collection.split(self).last
-    end
-
-    def prev_all
-      collection.split(self).first
-    end
-  end
-end