microformats 4.0.7 → 4.0.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f29e94e3eee963e0c2fc2beb186bbe65573590ae
-  data.tar.gz: 3197d92343b82c60f8f99daeebbaaf77d20a6763
+  metadata.gz: 707a6bf1f579b7e9b8f83446857f6d9aaef1a1f2
+  data.tar.gz: 36b751145439c8d4cffdeacba3530f332d7ac2d3
 SHA512:
-  metadata.gz: c0be09ac2f32fe2c1a5ae72c49c92aacf3de6f4c4a2ca62cadbca0d80aec86733cb8020836a873aad7020981ff7628a6884a0b671a63732e83caec71bec31167
-  data.tar.gz: dd565474811b712d5c15e792ee47be67dd3006cb8712e7595367ece6910daae09da33fa0af711ea76cb2275c60057d19f6cc3c616569be62ad20b74c9ef1d38c
+  metadata.gz: 47b5fc4c73c6d54395540ec93830da51372096d89855fb14d578ec8a7392561f724448526c26f30e97ecbffdd4d9f58ad3eb0376423fad193927c9e874bae8b0
+  data.tar.gz: b9cb79d88aeed23bc329f79317cafa1a1a8df3a2d60cde987f2a319fee19a5daf83ee4b029f045a0fd0638152e343c066d522801cd9c8d12f25497ad75b402ec

data/.editorconfig

@@ -0,0 +1,10 @@
+# EditorConfig is awesome: http://EditorConfig.org
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_size = 2
+indent_style = space
+trim_trailing_whitespace = true

data/.gitignore

@@ -1,19 +1,37 @@
 *.gem
 *.rbc
-.bundle
-.config
-.yardoc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+# Used by dotenv library to load environment variables.
+# .env
+
+# Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+# Environment normalization:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
 Gemfile.lock
-InstalledFiles
-_yardoc
-coverage
-doc/
-lib/bundler/man
-pkg
-rdoc
-spec/reports
-test/tmp
-test/version_tmp
-tmp
-coverage
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+#vim files being edited
 *.swp

data/.rspec

@@ -1,2 +1,3 @@
---color
---format doc
+--format documentation
+--order random
+--require spec_helper

data/.rubocop

@@ -0,0 +1,3 @@
+--display-style-guide
+--extra-details
+--parallel

data/.rubocop.yml

@@ -0,0 +1,25 @@
+require:
+  - rubocop-rspec
+
+Metrics/BlockLength:
+  Exclude:
+    - microformats.gemspec
+    - spec/**/*.rb
+
+Metrics/LineLength:
+  Enabled: false
+
+RSpec/ExampleLength:
+  Max: 15
+
+RSpec/MultipleExpectations:
+  Max: 10
+
+RSpec/NestedGroups:
+  Max: 6
+
+Style/Documentation:
+  Enabled: false
+
+Style/FrozenStringLiteralComment:
+  Enabled: false

data/.ruby-version

@@ -0,0 +1 @@
+2.4.4

data/.simplecov

@@ -0,0 +1,11 @@
+require 'simplecov-console'
+
+formatters = [SimpleCov::Formatter::HTMLFormatter]
+
+if RSpec.configuration.files_to_run.length > 1
+  formatters << SimpleCov::Formatter::Console
+end
+
+SimpleCov.start do
+  formatter SimpleCov::Formatter::MultiFormatter.new(formatters)
+end

data/.travis.yml

@@ -1,4 +1,16 @@
 language: ruby
+cache: bundler
 rvm:
-  - 2.2.5
-script: bundle exec rspec
+  - 2.4.4
+  - 2.5.1
+before_install:
+  - gem update --system
+  - gem update bundler
+before_script:
+  - curl -L https://codeclimate.com/downloads/test-reporter/test-reporter-latest-linux-amd64 > ./cc-test-reporter
+  - chmod +x ./cc-test-reporter
+  - ./cc-test-reporter before-build
+script:
+  - bundle exec rspec
+after_script:
+  - ./cc-test-reporter after-build --exit-code $TRAVIS_TEST_RESULT

data/CONTRIBUTING.md

@@ -0,0 +1,103 @@
+# Contributing to microformats-ruby
+
+There are a couple ways you can help improve microformats-ruby:
+
+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
+
+microformats-ruby is developed using Ruby 2.5.0 and is additionally tested against versions 2.2.9, 2.3.6, and 2.4.3 using [Travis CI](https://travis-ci.org/microformats/microformats-ruby).
+
+Before making changes to microformats-ruby, you'll want to install Ruby 2.5.0. 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.5.0 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.
+
+## Verifying Changes
+
+We use the following tools to evaluate code quality and verify behavior:
+
+- The test suite uses [RSpec](http://rspec.info) (`bundle exec rspec`).
+- Static code analysis uses [RuboCop](https://github.com/bbatsov/rubocop) (`bundle exec rubocop`).
+
+Before submitting a [pull request][pulls], use the above tools to verify your changes.
+
+You may also test your code interactively by running:
+
+```sh
+bundle console
+```
+
+## Releasing New Versions
+
+First, check out the latest code from GitHub:
+
+```sh
+git pull origin master
+```
+
+Following the [Semantic Versioning](https://semver.org) conventions, update the gem version throughout the project (but most importantly in `lib/microformats/version.rb`).
+
+Confirm that the gem builds correctly:
+
+```sh
+bundle exec rake build
+```
+
+If that works, install the new version of the gem locally:
+
+```sh
+bundle exec rake install
+```
+
+If that works, uninstall the gem.
+
+```sh
+gem uninstall microformats
+```
+
+Clean up any mess made from testing.
+
+```sh
+bundle exec rake clean
+bundle exec rake clobber
+```
+
+Assuming you're one of the gem owners and have release privileges, release the gem!
+
+```
+bundle exec rake release
+```
+
+If that works, you’ve just released a new version of the gem! Yay! You can see it at: [https://rubygems.org/gems/microformats](https://rubygems.org/gems/microformats)
+
+### Handling Errors
+
+If `rake release` failed because of an error with your authentication to RubyGems.org, follow the instructions in the error message then repeat the `rake release` step.
+
+### Getting Help
+
+If any other errors occurred along the way and you're stuck, get in touch via [IRC](http://microformats.org/wiki/irc) (#microformats on freenode) or the #microformats channel in [the IndieWebCamp Slack](https://indieweb.org/Slack) for help.
+
+## 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/microformats/microformats-ruby/issues
+[pulls]: https://github.com/microformats/microformats-ruby/pulls

data/Guardfile

@@ -1,5 +1,5 @@
-guard "rspec" do
+guard :rspec, cmd: 'bundle exec rspec' do
   watch(%r{^spec/.+_spec\.rb$})
   watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
-  watch("spec/spec_helper.rb")  { "spec" }
+  watch('spec/spec_helper.rb')  { 'spec' }
 end

data/LICENSE

@@ -0,0 +1,116 @@
+CC0 1.0 Universal
+
+Statement of Purpose
+
+The laws of most jurisdictions throughout the world automatically confer
+exclusive Copyright and Related Rights (defined below) upon the creator and
+subsequent owner(s) (each and all, an "owner") of an original work of
+authorship and/or a database (each, a "Work").
+
+Certain owners wish to permanently relinquish those rights to a Work for the
+purpose of contributing to a commons of creative, cultural and scientific
+works ("Commons") that the public can reliably and without fear of later
+claims of infringement build upon, modify, incorporate in other works, reuse
+and redistribute as freely as possible in any form whatsoever and for any
+purposes, including without limitation commercial purposes. These owners may
+contribute to the Commons to promote the ideal of a free culture and the
+further production of creative, cultural and scientific works, or to gain
+reputation or greater distribution for their Work in part through the use and
+efforts of others.
+
+For these and/or other purposes and motivations, and without any expectation
+of additional consideration or compensation, the person associating CC0 with a
+Work (the "Affirmer"), to the extent that he or she is an owner of Copyright
+and Related Rights in the Work, voluntarily elects to apply CC0 to the Work
+and publicly distribute the Work under its terms, with knowledge of his or her
+Copyright and Related Rights in the Work and the meaning and intended legal
+effect of CC0 on those rights.
+
+1. Copyright and Related Rights. A Work made available under CC0 may be
+protected by copyright and related or neighboring rights ("Copyright and
+Related Rights"). Copyright and Related Rights include, but are not limited
+to, the following:
+
+  i. the right to reproduce, adapt, distribute, perform, display, communicate,
+  and translate a Work;
+
+  ii. moral rights retained by the original author(s) and/or performer(s);
+
+  iii. publicity and privacy rights pertaining to a person's image or likeness
+  depicted in a Work;
+
+  iv. rights protecting against unfair competition in regards to a Work,
+  subject to the limitations in paragraph 4(a), below;
+
+  v. rights protecting the extraction, dissemination, use and reuse of data in
+  a Work;
+
+  vi. database rights (such as those arising under Directive 96/9/EC of the
+  European Parliament and of the Council of 11 March 1996 on the legal
+  protection of databases, and under any national implementation thereof,
+  including any amended or successor version of such directive); and
+
+  vii. other similar, equivalent or corresponding rights throughout the world
+  based on applicable law or treaty, and any national implementations thereof.
+
+2. Waiver. To the greatest extent permitted by, but not in contravention of,
+applicable law, Affirmer hereby overtly, fully, permanently, irrevocably and
+unconditionally waives, abandons, and surrenders all of Affirmer's Copyright
+and Related Rights and associated claims and causes of action, whether now
+known or unknown (including existing as well as future claims and causes of
+action), in the Work (i) in all territories worldwide, (ii) for the maximum
+duration provided by applicable law or treaty (including future time
+extensions), (iii) in any current or future medium and for any number of
+copies, and (iv) for any purpose whatsoever, including without limitation
+commercial, advertising or promotional purposes (the "Waiver"). Affirmer makes
+the Waiver for the benefit of each member of the public at large and to the
+detriment of Affirmer's heirs and successors, fully intending that such Waiver
+shall not be subject to revocation, rescission, cancellation, termination, or
+any other legal or equitable action to disrupt the quiet enjoyment of the Work
+by the public as contemplated by Affirmer's express Statement of Purpose.
+
+3. Public License Fallback. Should any part of the Waiver for any reason be
+judged legally invalid or ineffective under applicable law, then the Waiver
+shall be preserved to the maximum extent permitted taking into account
+Affirmer's express Statement of Purpose. In addition, to the extent the Waiver
+is so judged Affirmer hereby grants to each affected person a royalty-free,
+non transferable, non sublicensable, non exclusive, irrevocable and
+unconditional license to exercise Affirmer's Copyright and Related Rights in
+the Work (i) in all territories worldwide, (ii) for the maximum duration
+provided by applicable law or treaty (including future time extensions), (iii)
+in any current or future medium and for any number of copies, and (iv) for any
+purpose whatsoever, including without limitation commercial, advertising or
+promotional purposes (the "License"). The License shall be deemed effective as
+of the date CC0 was applied by Affirmer to the Work. Should any part of the
+License for any reason be judged legally invalid or ineffective under
+applicable law, such partial invalidity or ineffectiveness shall not
+invalidate the remainder of the License, and in such case Affirmer hereby
+affirms that he or she will not (i) exercise any of his or her remaining
+Copyright and Related Rights in the Work or (ii) assert any associated claims
+and causes of action with respect to the Work, in either case contrary to
+Affirmer's express Statement of Purpose.
+
+4. Limitations and Disclaimers.
+
+  a. No trademark or patent rights held by Affirmer are waived, abandoned,
+  surrendered, licensed or otherwise affected by this document.
+
+  b. Affirmer offers the Work as-is and makes no representations or warranties
+  of any kind concerning the Work, express, implied, statutory or otherwise,
+  including without limitation warranties of title, merchantability, fitness
+  for a particular purpose, non infringement, or the absence of latent or
+  other defects, accuracy, or the present or absence of errors, whether or not
+  discoverable, all to the greatest extent permissible under applicable law.
+
+  c. Affirmer disclaims responsibility for clearing rights of other persons
+  that may apply to the Work or any use thereof, including without limitation
+  any person's Copyright and Related Rights in the Work. Further, Affirmer
+  disclaims responsibility for obtaining any necessary consents, permissions
+  or other rights required for any use of the Work.
+
+  d. Affirmer understands and acknowledges that Creative Commons is not a
+  party to this document and has no duty or obligation with respect to this
+  CC0 or use of the Work.
+
+For more information, please see
+<http://creativecommons.org/publicdomain/zero/1.0/>

data/README.md

@@ -1,243 +1,183 @@
-# Microformats (ruby)
+# ![Microformats Logo](https://raw.githubusercontent.com/microformats/microformats-ruby/master/logo.svg?sanitize=true) Microformats Ruby
 
-[![Build Status](https://travis-ci.org/indieweb/microformats-ruby.svg)](https://travis-ci.org/indieweb/microformats-ruby)
-[![Code Climate](https://codeclimate.com/github/indieweb/microformats-ruby/badges/gpa.svg)](https://codeclimate.com/github/indieweb/microformats-ruby)
+**A Ruby gem for parsing HTML documents containing microformats.**
 
-A Ruby gem to parse HTML containing one or more microformats and [microformats2](http://microformats.org/wiki/microformats-2)
-and return a collection of dynamically defined Ruby objects, a Ruby hash or a JSON hash.
+[![Gem](https://img.shields.io/gem/v/microformats.svg?style=for-the-badge)](https://rubygems.org/gems/microformats)
+[![Downloads](https://img.shields.io/gem/dt/microformats.svg?style=for-the-badge)](https://rubygems.org/gems/microformats)
+[![Build](https://img.shields.io/travis/microformats/microformats-ruby/master.svg?style=for-the-badge)](https://travis-ci.org/microformats/microformats-ruby)
+[![Maintainability](https://img.shields.io/codeclimate/maintainability/microformats/microformats-ruby.svg?style=for-the-badge)](https://codeclimate.com/github/microformats/microformats-ruby)
+[![Coverage](https://img.shields.io/codeclimate/c/microformats/microformats-ruby.svg?style=for-the-badge)](https://codeclimate.com/github/microformats/microformats-ruby/code)
 
+## Key Features
 
-## Development Status
+- Compatible with both [classic microformats](http://microformats.org/wiki/Main_Page#Classic_Microformats) and [microformats2](http://microformats.org/wiki/microformats2) syntaxes.
+- Provides a [CLI](https://en.wikipedia.org/wiki/Command-line_interface) for extracting microformats from a URL, file, or string.
 
-Implemented:
+## Getting Started
 
-* [parsing depth first, doc order](http://microformats.org/wiki/microformats2-parsing#parse_a_document_for_microformats)
-* [parsing a p- property](http://microformats.org/wiki/microformats2-parsing#parsing_a_p-_property)
-* [parsing a u- property](http://microformats.org/wiki/microformats2-parsing#parsing_a_u-_property)
-* [parsing a dt- property](http://microformats.org/wiki/microformats2-parsing#parsing_a_dt-_property)
-* [parsing a e- property](http://microformats.org/wiki/microformats2-parsing#parsing_an_e-_property)
-* [parsing implied properties](http://microformats.org/wiki/microformats-2-parsing#parsing_for_implied_properties)
-* nested properties
-* nested microformat with associated property
-* dynamic creation of properties
-* [rel](http://microformats.org/wiki/rel)
-* [normalize u-* property values](http://microformats.org/wiki/microformats2-parsing-faq#normalizing_u-.2A_property_values)
-* nested microformat without associated property
-* [value-class-pattern](http://microformats.org/wiki/value-class-pattern)
-* recognition of [vendor extensions](http://microformats.org/wiki/microformats2#VENDOR_EXTENSIONS)
-* backward compatible support for microformats v1
-
-Not Implemented:
-
-* [include-pattern](http://microformats.org/wiki/include-pattern)
-
-
-## Current Version
-
-4.0.7
-
-![Version 4.0.7](https://img.shields.io/badge/VERSION-4.0.7-green.svg)
-
-
-## Requirements
-
-* [nokogiri](https://github.com/sparklemotion/nokogiri)
-* [json](https://github.com/flori/json)
+Before installing and using microformats-ruby, you'll want to have Ruby 2.2.9 (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).
 
+microformats-ruby is developed using Ruby 2.4.4 and is additionally tested against version 2.5.1 using [Travis CI](https://travis-ci.org/microformats/microformats-ruby).
 
 ## Installation
 
-Add this line to your application's Gemfile:
+If you're using [Bundler](https://bundler.io) to manage gem dependencies, add microformats-ruby to your project's Gemfile:
 
 ```ruby
-gem "microformats"
+source 'https://rubygems.org'
+
+gem 'microformats', '~> 4.0', '>= 4.0.9'
 ```
 
-And then execute:
+…and then run:
 
-```
-bundle
+```sh
+bundle install
 ```
 
-Or install it yourself as:
+You may also install microformats-ruby directly using:
 
-```
+```sh
 gem install microformats
 ```
 
-
 ## Usage
 
-```ruby
-require "microformats"
+An example working with a basic [h-card](http://microformats.org/wiki/h-card):
 
-source = "<div class='h-card'><p class='p-name'>Jessica Lynn Suttles</p></div>"
+```ruby
+source = '<div class="h-card"><p class="p-name">Jessica Lynn Suttles</p></div>'
 collection = Microformats.parse(source)
 
-# getting a copy of the canonical microformats hash structure
+# Get a copy of the canonical microformats hash structure
 collection.to_hash
 
-# the above, as JSON in a string
+# The above as JSON in a string
 collection.to_json
 
-# shortcuts
-
-# return a string if there is only one item found
+# Return a string if there is only one item found
 collection.card.name #=> "Jessica Lynn Suttles"
+```
+
+Below is a more complex markup structure using an [h-entry](http://microformats.org/wiki/h-entry) with a nested h-card:
+
+```ruby
+source = '<article class="h-entry">
+  <h1 class="p-name">Microformats 2</h1>
+  <div class="h-card p-author">
+    <p class="p-name"><span class="p-first-name">Jessica</span> Lynn Suttles</p>
+  </div>
+</article>'
 
-source = "<article class='h-entry'>
-  <h1 class='p-name'>Microformats 2</h1>
-  <div class='h-card p-author'><p class='p-name'><span class='p-first-name'>Jessica</span> Lynn Suttles</p></div>
-</article>"
 collection = Microformats.parse(source)
+
 collection.entry.name.to_s #=> "Microformats 2"
 
-# accessing nested microformats
+# Accessing nested microformats
 collection.entry.author.name.to_s #=> "Jessica Lynn Suttles"
 
-# accessing nested microformats can use shortcuts or more expanded method
+# Accessing nested microformats can use shortcuts or expanded method
 collection.entry.author.name #=> "Jessica Lynn Suttles"
 collection.entry.properties.author.properties.name.to_s #=> "Jessica Lynn Suttles"
 
-# use _ instead of - to get these items
+# Use `_` instead of `-` to return property values
 collection.entry.author.first_name #=> "Jessica"
 collection.rel_urls #=> {}
+```
+
+Using the same markup patterns as above, here's an h-entry with multiple authors, each marked up as h-cards:
+
+```ruby
+source = '<article class="h-entry">
+  <h1 class="p-name">Microformats 2</h1>
+  <div class="h-card p-author">
+    <p class="p-name"><span class="p-first-name">Jessica</span> Lynn Suttles</p>
+  </div>
+  <div class="h-card p-author">
+    <p class="p-name"><span class="p-first-name">Brandon</span> Edens</p>
+  </div>
+</article>'
 
-source = "<article class='h-entry'>
-  <h1 class='p-name'>Microformats 2</h1>
-  <div class='h-card p-author'><p class='p-name'><span class='p-first-name'>Jessica</span> Lynn Suttles</p></div>
-  <div class='h-card p-author'><p class='p-name'><span class='p-first-name'>Brandon</span> Edens</p></div>
-</article>"
 collection = Microformats.parse(source)
 
-# arrays of items with always take the first item by default
+# Arrays of items will always return the first item by default
 collection.entry.author.name #=> "Jessica Lynn Suttles"
 collection.entry.author(1).name #=> "Brandon Edens"
 
-# get the actual array with :all
+# Get the actual array of items by using `:all`
 collection.entry.author(:all).count #=> 2
 collection.entry.author(:all)[1].name #=> "Brandon Edens"
-
-```
-
-* `source` can be a URL, filepath, or HTML
-
-### Console utility
-
-This gem also provides a command like script 'microformats' that will return the JSON equivalent
-```
-microformats http://example.com
-```
-
-You can give the microformats script a URL, filepath, or HTML
-
-additionally, the script will accept input piped from stdin
-
 ```
-curl http://example.com | microformats
-```
-
-
-
-## Ruby Gem release process
-
-Check out latest code from GitHub repo.
-
-```
-git pull origin master
-```
-
-Make sure the version has been bumped up in all four places:
 
-- [lib/microformats/version.rb](https://github.com/indieweb/microformats-ruby/blob/master/lib/microformats/version.rb#L2)
-- [README.md (three places)](https://github.com/indieweb/microformats-ruby/blob/master/README.md)
+### Command Line Interface
 
-Do a test build locally to make sure it builds properly.
+microformats-ruby also includes a command like program that will parse HTML and return a JSON representation of the included microformats.
 
-```
-rake build
+```sh
+microformats http://tantek.com
 ```
 
-If that works, then do a test install locally.
+The program accepts URLs, file paths, or strings of HTML as an argument. Additionally, the script accepts piped input from other programs:
 
-  ```
-rake install
+```sh
+curl http://tantek.com | microformats
 ```
 
-If that works, uninstall the gem.
+## Implementation Status
 
-```
-gem uninstall microformats
-```
+| Status | Specification or Parsing Rule |
+|:------:|:------------------------------|
+| ✅ | [Parse a document for microformats](http://microformats.org/wiki/microformats2-parsing#parse_a_document_for_microformats) |
+| ✅ | [Parsing a `p-` property](http://microformats.org/wiki/microformats2-parsing#parsing_a_p-_property) |
+| ✅ | [Parsing a `u-` property](http://microformats.org/wiki/microformats2-parsing#parsing_a_u-_property) |
+| ✅ | [Parsing a `dt-` property](http://microformats.org/wiki/microformats2-parsing#parsing_a_dt-_property) |
+| ✅ | [Parsing an `e-` property](http://microformats.org/wiki/microformats2-parsing#parsing_an_e-_property) |
+| ✅ | [Parsing for implied properties](http://microformats.org/wiki/microformats2-parsing#parsing_for_implied_properties) |
+| ✅ | Nested properties |
+| ✅ | Nested microformat with associated property |
+| ✅ | Nested microformat without associated property |
+| ✅ | Recognize dynamically created properties |
+| ✅ | [Support for `rel` attribute values](http://microformats.org/wiki/rel) |
+| ✅ | [Normalizing `u-*` property values](http://microformats.org/wiki/microformats2-parsing-faq#normalizing_u-.2A_property_values) |
+| ✅ | Parse the [value class pattern](http://microformats.org/wiki/value-class-pattern) |
+| ✅ | Recognize [vendor extensions](http://microformats.org/wiki/microformats2#VENDOR_EXTENSIONS) |
+| ✅ | Support for [classic microformats](http://microformats.org/wiki/Main_Page#Classic_Microformats) |
+| ❌ | Recognize the [include pattern](http://microformats.org/wiki/include-pattern)
 
-Clean up any mess made from testing.
+## Improving microformats-ruby
 
-```
-rake clean
-rake clobber
-```
-
-Assuming your one of the gem owners and have release privileges, release the gem!
-
-```
-rake release
-```
+Have questions about using microformats-ruby? Found a bug? Have ideas for new or improved features? Want to pitch in and write some code?
 
-If that works, you’ve just release a new version of the gem! Yay! You can see it at:
+Check out [CONTRIBUTING.md](https://github.com/microformats/microformats-ruby/blob/master/CONTRIBUTING.md) for more on how you can help!
 
-[https://rubygems.org/gems/microformats](https://rubygems.org/gems/microformats)
+## Acknowledgments
 
-If `rake release` failed because of an error with your authentication to rubygems.org, follow their instructions in the error message. Then repeat the `rake release` step.
+The microformats-ruby logo is derived from the [microformats logo mark](http://microformats.org/wiki/spread-microformats) by [Rémi Prévost](http://microformats.org/wiki/User:Remi).
 
-If any other errors failed along the way before `rake release`, try to figure them out or reach out to the IRC/Slack channel for help.
+microformats-ruby is written and maintained by:
 
-Good luck.
-
-
-## Authors
-
-- Ben Roberts / [@dissolve](https://github.com/dissolve)
-- Jessica Lynn Suttles / [@jlsuttles](https://github.com/jlsuttles)
-- Shane Becker / [@veganstraightedge](https://github.com/veganstraightedge)
-- Chris Stringer / [@jcstringer](https://github.com/jcstringer)
-- Michael Mitchell / [@variousred](https://github.com/variousred)
-- Jessica Dillon / [@jessicard](https://github.com/jessicard)
-- Jeena Paradies / [@jeena](https://github.com/jeena)
-- Marty McGuire / [@martymcguire](https://github.com/martymcguire)
-
-## Contributions
-
-1. Fork it
-2. Get it running (see Installation above)
-3. Create your feature branch (`git checkout -b my-new-feature`)
-4. Write your code and **specs**
-5. Commit your changes (`git commit -am 'Add some feature'`)
-6. Push to the branch (`git push origin my-new-feature`)
-7. Create new Pull Request
-
-If you find bugs, have feature requests or questions, please
-[file an issue](https://github.com/indieweb/microformats-ruby/issues).
-
-
-## Testing
-
-### Specs
-
-This uses a copy of  [microformats tests repo](https://github.com/microformats/tests).
-
-To run specs
-```
-rake spec
-
-### Interactive
-
-You can use the code interacively for testing but running
-```
-bundle console
-```
+- Ben Roberts ([@dissolve](https://github.com/dissolve))
+- Jason Garber [(@jgarber623](https://github.com/jgarber623))
+- Jessica Suttles ([@jlsuttles](https://github.com/jlsuttles))
+- Shane Becker ([@veganstraightedge](https://github.com/veganstraightedge))
+- Chris Stringer ([@jcstringer](https://github.com/jcstringer))
+- Michael Mitchell ([@variousred](https://github.com/variousred))
+- Jessica Dillon ([@jessicard](https://github.com/jessicard))
+- Jeena Paradies ([@jeena](https://github.com/jeena))
+- Marty McGuire ([@martymcguire](https://github.com/martymcguire))
+- Tom Morris [(@tommorris](https://github.com/tommorris))
+- Don Peterson [(@dpetersen](https://github.com/dpetersen))
+- Matt Bohme [(@quady](https://github.com/quady))
+- Brian Miller [(@BRIMIL01](https://github.com/BRIMIL01))
+- Christian Weiske [(@cweiske](https://github.com/cweiske))
+- Christian Kruse [(@ckruse](https://github.com/ckruse))
+- Barnaby Walters [(@barnabywalters](https://github.com/barnabywalters))
+- Jeremy Keith [(@adactio](https://github.com/adactio))
 
 ## License
 
-Microformats (ruby) is dedicated to the public domain using Creative Commons -- CC0 1.0 Universal.
+microformats-ruby is dedicated to the public domain using the [Creative Commons CC0 1.0 Universal license](https://creativecommons.org/publicdomain/zero/1.0/).
+
+The authors waive all of their rights to the work worldwide under copyright law, including all related and neighboring rights, to the extent allowed by law. You can copy, modify, and distribute the work, even for commercial purposes, all without asking permission.
 
-http://creativecommons.org/publicdomain/zero/1.0
+See [LICENSE](https://github.com/microformats/microformats-ruby/blob/master/LICENSE) for more details.