micromicro 2.0.1 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d9c965d277e7c87c68de6ce7a12aff28da257d813573de2519bfe36943df1f4f
-  data.tar.gz: a62d02a8fe962b060c36a9c615445f586fe76ea1c570d71f05175d140d631d32
+  metadata.gz: 75bb9eaa673828648bc3f0a78d9822f434ae99317ae9499998f984c661c0771b
+  data.tar.gz: 2ab7a2896a8498507cb57f7e1c5a10c1e5dff8091328370a10e645420374ec12
 SHA512:
-  metadata.gz: 8ee19e4ca072c36137746dd54e435405a9a749761c9b735d75ff9f97a5c28f8e5367f79c3a7ad45c83039eb8cb54f1043cac2dd7ddcd1bfd2d4fbbad0d218ad6
-  data.tar.gz: f5f88370b3fc92e2d467c8e358798c6266b5fb9dbfe50fb13e74b2235572e9adfbfeb4f171b1df3d5bf474cc549bac7adfe3fa7c2a59b6830d2bacc3cab3d500
+  metadata.gz: a24f38005e975861d4e5ce1c3b728ea4535d7a094cae2515a8b6e7f0e7bb7abe7558eec44651a7e833d0120d397bcb45687022c374a039f5d755d46798264e8c
+  data.tar.gz: 58f27f493e1255ef7b4ea1904cb643c1392f62dacea645708142f153eccfba2ed0a9ed52e33f76f4ec4eae5012b9dce159ec963c216a5506969b4a47be4e2042

data/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 3.1.0 / 2022-09-24
+
+- **New feature:** parse `img[srcset]` (microformats/microformats2-parsing#7) (cdda328)
+- Improve usage of activesupport extensions (5ed120c)
+
+## 3.0.0 / 2022-08-28
+
+- Improved YARD documentation
+- New `Item` instance methods (8105d6f):
+  - `MicroMicro::Item#children?`
+  - `MicroMicro::Item#id?`
+- **Breaking change:** Remove property-centric methods from `MicroMicro::Item` (926dedb):
+  - `MicroMicro::Item#plain_text_properties`
+  - `MicroMicro::Item#url_properties`
+- Add predicate methods to `MicroMicro::Collections::PropertiesCollection` (82e91c8):
+  - `MicroMicro::Collections::PropertiesCollection#plain_text_properties?`
+  - `MicroMicro::Collections::PropertiesCollection#url_properties?`
+- Add collections search methods `#where` and `#find_by` (847cb77)
+- **Breaking change:** Refactor `.node_set_from` class methods into private classes (b18a714)
+
 ## 2.0.1 / 2022-08-20
 
 - Use ruby/debug instead of pry-byebug (2965b2e)

data/README.md

@@ -18,15 +18,9 @@
 
 <small>¹ …with some exceptions until [this pull request](https://github.com/microformats/tests/pull/112) is merged.</small>
 
-## Getting Started
-
-Before installing and using MicroMicro, you'll want to have [Ruby](https://www.ruby-lang.org) 2.7 (or newer) installed. 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).
-
-MicroMicro is developed using Ruby 2.7.6 and is additionally tested against Ruby 3.0 and 3.1 using [GitHub Actions](https://github.com/jgarber623/micromicro/actions).
-
 ## Installation
 
-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) 2.7 (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'
@@ -42,13 +36,7 @@ gem install micromicro
 
 ## Usage
 
-### Basic Usage
-
-MicroMicro's `parse` method accepts two arguments: a `String` of markup and a `String` representing the URL associated with that markup.
-
-The markup (typically HTML) can be retrieved from the Web using a library of your choosing or provided inline as a simple `String` (e.g. `<div class="h-card">Jason Garber</div>`) The URL provided is used to resolve relative URLs in accordance with the document's language rules.
-
-An example using a simple `String` of HTML as input:
+MicroMicro's `parse` method accepts two arguments: a `String` of markup and a `String` representing the URL associated with that markup. The resulting `MicroMicro::Document` may be converted to a `Hash` which may be further manipulated using conventional Ruby tooling.
 
 ```ruby
 require 'micromicro'
@@ -60,88 +48,7 @@ doc.to_h
 #=> { :items => [{ :type => ["h-card"], :properties => { :name => ["Jason Garber"] } }], :rels => {}, :"rel-urls" => {} }
 ```
 
-The `Hash` produced by calling `doc.to_h` may be converted to JSON (e.g. `doc.to_h.to_json`) for storage, additional manipulation, or use with other tools.
-
-Another example pulling the source HTML from [Tantek](https://tantek.com)'s website:
-
-```ruby
-require 'net/http'
-require 'micromicro'
-
-url = 'https://tantek.com'
-rsp = Net::HTTP.get(URI.parse(url))
-
-doc = MicroMicro.parse(rsp, url)
-#=> #<MicroMicro::Document items: #<MicroMicro::Collections::ItemsCollection count: 1, members: […]>, relationships: #<MicroMicro::Collections::RelationshipsCollection count: 31, members: […]>>
-
-doc.to_h
-#=> { :items => [{ :type => ["h-card"], :properties => {…}, :children => […]}], :rels => {…}, :'rel-urls' => {…} }
-```
-
-### Advanced Usage
-
-Building on the example above, a MicroMicro-parsed document is navigable and manipulable using a familiar `Enumerable`-esque interface.
-
-#### Items
-
-```ruby
-doc.items.first
-#=> #<MicroMicro::Item types: ["h-card"], properties: 42, children: 6>
-
-# 🆕 in v1.0.0
-doc.items.types
-#=> ["h-card"]
-
-doc.items.first.children
-#=> #<MicroMicro::Collections::ItemsCollection count: 6, members: […]>
-```
-
-#### Properties
-
-```ruby
-doc.items.first.properties
-#=> #<MicroMicro::Collections::PropertiesCollection count: 42, members: […]>
-
-# 🆕 in v1.0.0
-doc.items.first.plain_text_properties
-#=> #<MicroMicro::Collections::PropertiesCollection count: 34, members: […]>
-
-# 🆕 in v1.0.0
-doc.items.first.url_properties
-#=> #<MicroMicro::Collections::PropertiesCollection count: 11, members: […]>
-
-# 🆕 in v1.0.0
-doc.items.first.properties.names
-#=> ["category", "name", "note", "org", "photo", "pronoun", "pronouns", "role", "uid", "url"]
-
-# 🆕 in v1.0.0
-doc.items.first.properties.values
-#=> [{:value=>"https://tantek.com/photo.jpg", :alt=>""}, "https://tantek.com/", "Tantek Çelik", "Inventor, writer, teacher, runner, coder, more.", "Inventor", "writer", "teacher", "runner", "coder", …]
-
-doc.items.first.properties[7]
-#=> #<MicroMicro::Property name: "category", prefix: "p", value: "teacher">
-
-doc.items.first.properties.take(5).map { |property| [property.name, property.value] }
-#=> [["photo", { :value => "https://tantek.com/photo.jpg", :alt => "" }], ["url", "https://tantek.com/"], ["uid", "https://tantek.com/"], ["name", "Tantek Çelik"], ["role", "Inventor, writer, teacher, runner, coder, more."]]
-```
-
-#### Relationships
-
-```ruby
-doc.relationships.first
-#=> #<MicroMicro::Relationship href: "https://tantek.com/", rels: ["canonical"]>
-
-# 🆕 in v1.0.0
-doc.relationships.rels
-#=> ["alternate", "apple-touch-icon-precomposed", "author", "authorization_endpoint", "bookmark", "canonical", "hub", "icon", "me", "microsub", …]
-
-# 🆕 in v1.0.0
-doc.relationships.urls
-#=> ["http://dribbble.com/tantek/", "http://last.fm/user/tantekc", "https://aperture.p3k.io/microsub/277", "https://en.wikipedia.org/wiki/User:Tantek", "https://github.com/tantek", "https://indieauth.com/auth", "https://indieauth.com/openid", "https://micro.blog/t", "https://pubsubhubbub.superfeedr.com/", "https://tantek.com/", …]
-
-doc.relationships.find { |relationship| relationship.rels.include?('webmention') }
-# => #<MicroMicro::Relationship href: "https://webmention.io/tantek.com/webmention", rels: ["webmention"]>
-```
+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
 

data/lib/micro_micro/collections/base_collection.rb

@@ -14,8 +14,9 @@ module MicroMicro
         members.each { |member| push(member) }
       end
 
-      # :nocov:
       # @return [String]
+      #
+      # :nocov:
       def inspect
         "#<#{self.class}:#{format('%#0x', object_id)} " \
           "count: #{count}, " \

data/lib/micro_micro/collections/items_collection.rb

@@ -3,15 +3,96 @@
 module MicroMicro
   module Collections
     class ItemsCollection < BaseCollection
+      class ItemsCollectionSearch
+        attr_reader :results
+
+        def initialize
+          @results = []
+        end
+
+        def search(items, **args, &block)
+          items.each do |item|
+            results << item if item_matches_conditions?(item, **args, &block)
+
+            search(item.properties.filter_map { |property| property.item if property.item_node? }, **args, &block)
+            search(item.children, **args, &block)
+          end
+
+          results
+        end
+
+        private
+
+        def item_matches_conditions?(item, **args)
+          return yield(item) if args.none?
+
+          args.all? { |key, value| (Array(item.public_send(key.to_sym)) & Array(value)).any? }
+        end
+      end
+
+      private_constant :ItemsCollectionSearch
+
+      # Return the first {MicroMicro::Item} from a search.
+      #
+      # @see #where
+      #
+      # @param (see #where)
+      # @yieldparam (see #where))
+      # @return [MicroMicro::Item, nil]
+      def find_by(**args, &block)
+        where(**args, &block).first
+      end
+
+      # Return an Array of this collection's {MicroMicro::Item}s as Hashes.
+      #
+      # @see MicroMicro::Item#to_h
+      #
       # @return [Array<Hash{Symbol => Array<String, Hash>}>]
       def to_a
         map(&:to_h)
       end
 
+      # Retrieve an Array of this collection's unique {MicroMicro::Item} types.
+      #
+      # @see MicroMicro::Item#types
+      #
       # @return [Array<String>]
       def types
         @types ||= flat_map(&:types).uniq.sort
       end
+
+      # Recursively search this collection for {MicroMicro::Item}s matching the
+      # given conditions.
+      #
+      # If a Hash is supplied, the returned collection will include
+      # {MicroMicro::Item}s matching _all_ conditions. Keys must be Symbols
+      # matching an instance method on {MicroMicro::Item} and values may be
+      # 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')
+      #
+      # @example Search using a Hash with an Array value
+      #   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
+      # {MicroMicro::Item}s that cause the block to return a value other than
+      # +false+ or +nil+.
+      #
+      # @example Search using a block
+      #   MicroMicro.parse(markup, url).items.where do |item|
+      #     item.properties.names.include?('email')
+      #   end
+      #
+      # @param args [Hash{Symbol => String, Array<String>}]
+      # @yieldparam item [MicroMicro::Item]
+      # @return [MicroMicro::Collections::ItemsCollection]
+      def where(**args, &block)
+        return self if args.none? && !block
+
+        self.class.new(ItemsCollectionSearch.new.search(self, **args, &block))
+      end
     end
   end
 end

data/lib/micro_micro/collections/properties_collection.rb

@@ -3,30 +3,129 @@
 module MicroMicro
   module Collections
     class PropertiesCollection < BaseCollection
+      class PropertiesCollectionSearch
+        def search(properties, **args, &block)
+          properties.select { |property| property_matches_conditions?(property, **args, &block) }
+        end
+
+        private
+
+        def property_matches_conditions?(property, **args)
+          return yield(property) if args.none?
+
+          args.all? { |key, value| (Array(property.public_send(key.to_sym)) & Array(value)).any? }
+        end
+      end
+
+      private_constant :PropertiesCollectionSearch
+
+      # Return the first {MicroMicro::Property} from a search.
+      #
+      # @see #where
+      #
+      # @param (see #where)
+      # @yieldparam (see #where))
+      # @return [MicroMicro::Property, nil]
+      def find_by(**args, &block)
+        where(**args, &block).first
+      end
+
+      # Retrieve an Array of this collection's unique {MicroMicro::Property}
+      # names.
+      #
+      # @see MicroMicro::Property#name
+      #
       # @return [Array<String>]
       def names
         @names ||= map(&:name).uniq.sort
       end
 
+      # A collection of plain text {MicroMicro::Property}s parsed from the node.
+      #
+      # @see MicroMicro::Property#plain_text_property?
+      #
       # @return [MicroMicro::Collections::PropertiesCollection]
       def plain_text_properties
-        self.class.new(select(&:plain_text_property?))
+        @plain_text_properties ||= self.class.new(select(&:plain_text_property?))
       end
 
+      # Does this {MicroMicro::Collections::PropertiesCollection} include any
+      # plain text {MicroMicro::Property}s?
+      #
+      # @return [Boolean]
+      def plain_text_properties?
+        plain_text_properties.any?
+      end
+
+      # Return a Hash of this collection's {MicroMicro::Property}s as Arrays.
+      #
+      # @see MicroMicro::Property#name
+      # @see MicroMicro::Property#value
+      #
       # @return [Hash{Symbol => Array<String, Hash>}]
       def to_h
-        group_by(&:name).symbolize_keys.deep_transform_values(&:value)
+        group_by(&:name).transform_keys(&:to_sym).deep_transform_values(&:value)
       end
 
+      # A collection of url {MicroMicro::Property}s parsed from the node.
+      #
+      # @see MicroMicro::Property#url_property?
+      #
       # @return [MicroMicro::Collections::PropertiesCollection]
       def url_properties
-        self.class.new(select(&:url_property?))
+        @url_properties ||= self.class.new(select(&:url_property?))
+      end
+
+      # Does this {MicroMicro::Collections::PropertiesCollection} include any
+      # url {MicroMicro::Property}s?
+      #
+      # @return [Boolean]
+      def url_properties?
+        url_properties.any?
       end
 
+      # Return an Array of this collection's unique {MicroMicro::Property}
+      # values.
+      #
+      # @see MicroMicro::Property#value
+      #
       # @return [Array<String, Hash>]
       def values
         @values ||= map(&:value).uniq
       end
+
+      # Search this collection for {MicroMicro::Property}s matching the given
+      # conditions.
+      #
+      # If a Hash is supplied, the returned collection will include
+      # {MicroMicro::Property}s matching _all_ conditions. Keys must be Symbols
+      # matching an instance method on {MicroMicro::Property} and values may be
+      # 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')
+      #
+      # @example Search using a Hash with an Array value
+      #   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
+      # {MicroMicro::Property}s that cause the block to return a value other
+      # than +false+ or +nil+.
+      #
+      # @example Search using a block
+      #   MicroMicro.parse(markup, url).properties.where do |property|
+      #     property.value.is_a?(Hash)
+      #   end
+      #
+      # @param args [Hash{Symbol => String, Array<String>}]
+      # @yieldparam property [MicroMicro::Property]
+      # @return [MicroMicro::Collections::PropertiesCollection]
+      def where(**args, &block)
+        return self if args.none? && !block
+
+        self.class.new(PropertiesCollectionSearch.new.search(self, **args, &block))
+      end
     end
   end
 end

data/lib/micro_micro/collections/relationships_collection.rb

@@ -3,31 +3,109 @@
 module MicroMicro
   module Collections
     class RelationshipsCollection < BaseCollection
+      class RelationshipsCollectionSearch
+        def search(relationships, **args, &block)
+          relationships.select { |relationship| relationship_matches_conditions?(relationship, **args, &block) }
+        end
+
+        private
+
+        def relationship_matches_conditions?(relationship, **args)
+          return yield(relationship) if args.none?
+
+          args.all? { |key, value| (Array(relationship.public_send(key.to_sym)) & Array(value)).any? }
+        end
+      end
+
+      private_constant :RelationshipsCollectionSearch
+
+      # Return the first {MicroMicro::Relationship} from a search.
+      #
+      # @see #where
+      #
+      # @param (see #where)
+      # @yieldparam (see #where))
+      # @return [MicroMicro::Relationship, nil]
+      def find_by(**args, &block)
+        where(**args, &block).first
+      end
+
+      # Return a Hash of this collection's {MicroMicro::Relationship}s grouped
+      # by their +rel+ attribute value.
+      #
       # @see https://microformats.org/wiki/microformats2-parsing#parse_a_hyperlink_element_for_rel_microformats
+      #   microformats.org: microformats2 parsing specification § Parse a hyperlink element for rel microformats
       #
       # @return [Hash{Symbol => Array<String>}]
       def group_by_rel
-        each_with_object(Hash.new { |hash, key| hash[key] = [] }) do |member, hash|
-          member.rels.each { |rel| hash[rel] << member.href }
-        end.symbolize_keys.transform_values(&:uniq)
+        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)
       end
 
+      # Return a Hash of this collection's {MicroMicro::Relationship}s grouped
+      # by their +href+ attribute value.
+      #
       # @see https://microformats.org/wiki/microformats2-parsing#parse_a_hyperlink_element_for_rel_microformats
+      #   microformats.org: microformats2 parsing specification § Parse a hyperlink element for rel microformats
       #
       # @return [Hash{Symbol => Hash{Symbol => Array, String}}]
       def group_by_url
-        group_by(&:href).symbolize_keys.transform_values { |relationships| relationships.first.to_h.slice!(:href) }
+        group_by(&:href).to_h { |k, v| [k.to_sym, v.first.to_h.except(:href)] }
       end
 
+      # Retrieve an Array of this collection's unique {MicroMicro::Relationship}
+      # +rel+ attrivute values.
+      #
+      # @see MicroMicro::Relationship#rels
+      #
       # @return [Array<String>]
       def rels
         @rels ||= flat_map(&:rels).uniq.sort
       end
 
+      # Retrieve an Array of this collection's unique {MicroMicro::Relationship}
+      # +href+ attribute values.
+      #
+      # @see MicroMicro::Relationship#urls
+      #
       # @return [Array<String>]
       def urls
         @urls ||= map(&:href).uniq.sort
       end
+
+      # Search this collection for {MicroMicro::Relationship}s matching the
+      # given conditions.
+      #
+      # If a Hash is supplied, the returned collection will include
+      # {MicroMicro::Relationship}s matching _all_ conditions. Keys must be
+      # Symbols matching an instance method on {MicroMicro::Relationship} and
+      # 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')
+      #
+      # @example Search using a Hash with an Array value
+      #   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
+      # {MicroMicro::Relationship}s that cause the block to return a value other
+      # than +false+ or +nil+.
+      #
+      # @example Search using a block
+      #   MicroMicro.parse(markup, url).relationships.where do |relationship|
+      #     relationship.href.match?(%r{https://webmention.io/.+})
+      #   end
+      #
+      # @param args [Hash{Symbol => String, Array<String>}]
+      # @yieldparam relationship [MicroMicro::Relationship]
+      # @return [MicroMicro::Collections::RelationshipsCollection]
+      def where(**args, &block)
+        return self if args.none? && !block
+
+        self.class.new(RelationshipsCollectionSearch.new.search(self, **args, &block))
+      end
     end
   end
 end

data/lib/micro_micro/document.rb

@@ -4,10 +4,10 @@ module MicroMicro
   class Document
     # 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')
     #
-    # Or, pull the source HTML of a page on the Web:
-    #
+    # @example Parse a String of markup from a URL
     #   url = 'https://tantek.com'
     #   markup = Net::HTTP.get(URI.parse(url))
     #
@@ -19,8 +19,9 @@ module MicroMicro
       @document = Nokogiri::HTML(markup, base_url).resolve_relative_urls!
     end
 
-    # :nocov:
     # @return [String]
+    #
+    # :nocov:
     def inspect
       "#<#{self.class}:#{format('%#0x', object_id)} " \
         "items: #{items.inspect}, " \
@@ -28,23 +29,28 @@ module MicroMicro
     end
     # :nocov:
 
-    # A collection of items parsed from the provided markup.
+    # A collection of {MicroMicro::Item}s parsed from the provided markup.
     #
     # @return [MicroMicro::Collections::ItemsCollection]
     def items
       @items ||= Collections::ItemsCollection.new(Item.from_context(document.element_children))
     end
 
-    # A collection of relationships parsed from the provided markup.
+    # A collection of {MicroMicro::Relationship}s parsed from the provided markup.
     #
     # @return [MicroMicro::Collections::RelationshipsCollection]
     def relationships
-      @relationships ||= Collections::RelationshipsCollection.new(Relationship.relationships_from(document))
+      @relationships ||= Collections::RelationshipsCollection.new(Relationship.from_context(document))
     end
 
     # Return the parsed document as a Hash.
     #
     # @see https://microformats.org/wiki/microformats2-parsing#parse_a_document_for_microformats
+    #   microformats.org: Parse a document for microformats
+    #
+    # @see MicroMicro::Collections::ItemsCollection#to_a
+    # @see MicroMicro::Collections::RelationshipsCollection#group_by_rel
+    # @see MicroMicro::Collections::RelationshipsCollection#group_by_url
     #
     # @return [Hash{Symbol => Array, Hash}]
     def to_h

data/lib/micro_micro/helpers.rb

@@ -4,6 +4,8 @@ module MicroMicro
   module Helpers
     IGNORED_NODE_NAMES = %w[script style template].freeze
 
+    private_constant :IGNORED_NODE_NAMES
+
     # @param node [Nokogiri::XML::Element]
     # @param attributes_map [Hash{String => Array}]
     # @return [String, nil]
@@ -56,7 +58,9 @@ module MicroMicro
     end
 
     # @see https://microformats.org/wiki/microformats2-parsing#parse_an_element_for_properties
+    #   microformats.org: microformats2 parsing specification § Parse an element for properties
     # @see https://microformats.org/wiki/microformats2-parsing#parsing_for_implied_properties
+    #   microformats.org: microformats2 parsing specification § Parsing for implied properties
     #
     # @param context [Nokogiri::HTML::Document, Nokogiri::XML::NodeSet, Nokogiri::XML::Element]
     # @yield [context]
@@ -70,6 +74,7 @@ module MicroMicro
     end
 
     # @see https://microformats.org/wiki/value-class-pattern#Basic_Parsing
+    #   microformats.org: Value Class Pattern § Basic Parsing
     #
     # @param node [Nokogiri::XML::Element]
     # @return [Boolean]
@@ -78,6 +83,7 @@ module MicroMicro
     end
 
     # @see https://microformats.org/wiki/value-class-pattern#Parsing_value_from_a_title_attribute
+    #   microformats.org: Value Class Pattern § Parsing value from a title attribute
     #
     # @param node [Nokogiri::XML::Element]
     # @return [Boolean]

data/lib/micro_micro/implied_property.rb

@@ -8,11 +8,24 @@ module MicroMicro
       'url'   => Parsers::ImpliedUrlPropertyParser
     }.freeze
 
+    private_constant :IMPLIED_PROPERTY_PARSERS_MAP
+
+    # Always return +true+ when asked if this {MicroMicro::ImpliedProperty} is
+    # an implied property.
+    #
+    # @see https://microformats.org/wiki/microformats2-parsing#parsing_for_implied_properties
+    #   microformats.org: microformats2 parsing specification § Parsing for implied properties
+    #
+    # @see MicroMicro::Property#implied?
+    #
     # @return [Boolean]
     def implied?
       true
     end
 
+    # Always return +false+ when asked if this {MicroMicro::ImpliedProperty} is
+    # a {MicroMicro::Item} node.
+    #
     # @return [Boolean]
     def item_node?
       false