indieweb-endpoints 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8ea000fd8ce1b67e86979bf4e7b15a92fdadbf6c06930c1592a9bc9004a709f8
+  data.tar.gz: 61065c74af761a2284a4df12ca9ace1eff6e0d73880139ecc88a7c5ab0d60c22
+SHA512:
+  metadata.gz: a168817ddd7650e4e7bf54e2029427d70e682027f72658607c9c710bbc4646e7438f6b92f36b4a2b758ab1882220b0ea38a36d59e0ac80a3b595e016d0c0218a
+  data.tar.gz: 97ca5850e60dbb0a1509809cd2982ec8eea9d3158e15dcfaaf3279eb92509eb738e76bbbdd007a9d925a3879b05ef3b4801932bb284c2d288894a20e00776ad1

data/.editorconfig

@@ -0,0 +1,14 @@
+# EditorConfig is awesome: https://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
+
+[*.md]
+indent_size = 4
+indent_style = tab

data/.github/CODEOWNERS

@@ -0,0 +1 @@
+*  jgarber623

data/.gitignore

@@ -0,0 +1,34 @@
+*.gem
+*.rbc
+/.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
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/.reek.yml

@@ -0,0 +1,12 @@
+detectors:
+  IrresponsibleModule:
+    enabled: false
+  TooManyStatements:
+    exclude:
+      - IndieWeb::Endpoints::Client#response
+  UtilityFunction:
+    exclude:
+      - FixtureHelpers#read_fixture
+
+exclude_paths:
+  - vendor/

data/.rspec

@@ -0,0 +1,2 @@
+--order random
+--require spec_helper

data/.rubocop

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

data/.rubocop.yml

@@ -0,0 +1,26 @@
+require:
+  - rubocop-performance
+  - rubocop-rspec
+
+Metrics/BlockLength:
+  Exclude:
+    - spec/**/*.rb
+
+Metrics/LineLength:
+  Enabled: false
+
+Naming/RescuedExceptionsVariableName:
+  PreferredName: exception
+
+RSpec/FilePath:
+  Exclude:
+    - spec/lib/indieweb/**/*_spec.rb
+
+Style/Documentation:
+  Enabled: false
+
+Style/FrozenStringLiteralComment:
+  Enabled: false
+
+Style/SymbolArray:
+  Enabled: false

data/.ruby-version

@@ -0,0 +1 @@
+2.4.6

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

@@ -0,0 +1,16 @@
+language: ruby
+rvm:
+  - 2.4.6
+  - 2.5.5
+  - 2.6.2
+cache:
+  - bundler
+before_install:
+  - gem update --system
+  - gem install 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
+after_script:
+  - ./cc-test-reporter after-build --exit-code $TRAVIS_TEST_RESULT

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## 0.1.0 / 2019-04-24
+
+- Initial release!

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,3 @@
+# Code of Conduct
+
+By contributing to and participating in the development of indieweb-endpoints-ruby, you acknowledge that you have read and agree to the [IndieWeb Code of Conduct](https://indieweb.org/code-of-conduct).

data/CONTRIBUTING.md

@@ -0,0 +1,37 @@
+# Contributing to indieweb-endpoints-ruby
+
+There are a couple ways you can help improve indieweb-endpoints-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
+
+indieweb-endpoints-ruby is developed using Ruby 2.4.6 and is additionally tested against Ruby 2.5.5 and 2.6.2 using [Travis CI](https://travis-ci.com/indieweb/indieweb-endpoints-ruby).
+
+Before making changes to indieweb-endpoints-ruby, you'll want to install Ruby 2.4.6. 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.4.6 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/indieweb/indieweb-endpoints-ruby/issues
+[pulls]: https://github.com/indieweb/indieweb-endpoints-ruby/pulls

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in indieweb-endpoints.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 Jason Garber
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,108 @@
+# indieweb-endpoints-ruby
+
+**A Ruby gem for discovering a URL's [IndieAuth](https://indieweb.org/IndieAuth), [Micropub](https://indieweb.org/Micropub), and [Webmention](https://indieweb.org/Webmention) endpoints.**
+
+[![Gem](https://img.shields.io/gem/v/indieweb-endpoints.svg?style=for-the-badge)](https://rubygems.org/gems/indieweb-endpoints)
+[![Downloads](https://img.shields.io/gem/dt/indieweb-endpoints.svg?style=for-the-badge)](https://rubygems.org/gems/indieweb-endpoints)
+[![Build](https://img.shields.io/travis/com/indieweb/indieweb-endpoints-ruby/master.svg?style=for-the-badge)](https://travis-ci.com/indieweb/indieweb-endpoints-ruby)
+[![Maintainability](https://img.shields.io/codeclimate/maintainability/indieweb/indieweb-endpoints-ruby.svg?style=for-the-badge)](https://codeclimate.com/github/indieweb/indieweb-endpoints-ruby)
+[![Coverage](https://img.shields.io/codeclimate/c/indieweb/indieweb-endpoints-ruby.svg?style=for-the-badge)](https://codeclimate.com/github/indieweb/indieweb-endpoints-ruby/code)
+
+## Key Features
+
+- Compliant with [Section 4.1](https://www.w3.org/TR/indieauth/#discovery-by-clients) and [Section 4.2.2](https://www.w3.org/TR/indieauth/#redirect-url) of [the W3C's IndieAuth Working Group Note](https://www.w3.org/TR/indieauth/), [Section 5.3](https://www.w3.org/TR/micropub/#endpoint-discovery) of [the W3C's Micropub Recommendation](https://www.w3.org/TR/micropub/), and [Section 3.1.2](https://www.w3.org/TR/webmention/#sender-discovers-receiver-webmention-endpoint) of [the W3C's Webmention Recommendation](https://www.w3.org/TR/webmention/).
+- Passes all Endpoint Discovery tests on [webmention.rocks](https://webmention.rocks).
+- Supports Ruby 2.4 and newer.
+
+## Getting Started
+
+Before installing and using indieweb-endpoints-ruby, you'll want to have [Ruby](https://www.ruby-lang.org) 2.4 (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).
+
+indieweb-endpoints-ruby is developed using Ruby 2.4.6 and is additionally tested against Ruby 2.5.5 and 2.6.2 using [Travis CI](https://travis-ci.com/indieweb/indieweb-endpoints-ruby).
+
+## Installation
+
+If you're using [Bundler](https://bundler.io), add indieweb-endpoints-ruby to your project's `Gemfile`:
+
+```ruby
+source 'https://rubygems.org'
+
+gem 'indieweb-endpoints'
+```
+
+…and hop over to your command prompt and run…
+
+```sh
+$ bundle install
+```
+
+## Usage
+
+### Basic Usage
+
+With indieweb-endpoints-ruby added to your project's `Gemfile` and installed, you may discover a URL's IndieWeb-relevant endpoints by doing:
+
+```ruby
+require 'indieweb/endpoints'
+
+endpoints = IndieWeb::Endpoints.get('https://aaronparecki.com')
+
+puts endpoints
+```
+
+This example will search `https://aaronparecki.com` for valid IndieAuth, Micropub, and Webmention endpoints. In this case, the program returns a `Hash`:
+
+```ruby
+{
+  authorization_endpoint: 'https://aaronparecki.com/auth',
+  micropub: 'https://aaronparecki.com/micropub',
+  redirect_uri: nil,
+  token_endpoint: 'https://aaronparecki.com/auth/token',
+  webmention: 'https://webmention.io/aaronpk/webmention'
+}
+```
+
+Each key in the resulting `Hash` will return either a `String` representing a URL or `nil`. The `redirect_uri` key will return either an `Array` or `nil` since a given URL may register multiple callback URLs.
+
+### Advanced Usage
+
+Should the need arise, you may work directly with the `IndieWeb::Endpoints::Client` class:
+
+```ruby
+require 'indieweb/endpoints'
+
+client = IndieWeb::Endpoints::Client.new('https://aaronparecki.com')
+
+puts client.response  # => HTTP::Response
+puts client.endpoints # => Hash
+```
+
+### Exception Handling
+
+There are several exceptions that may be raised by indieweb-endpoints-ruby's underlying dependencies. These errors are raised as subclasses of `StandardError`.
+
+From [jgarber623/absolutely](https://github.com/jgarber623/absolutely) and  [sporkmonger/addressable](https://github.com/sporkmonger/addressable):
+
+- `IndieWeb::Endpoints::InvalidURIError`
+
+From [httprb/http](https://github.com/httprb/http):
+
+- `IndieWeb::Endpoints::ConnectionError`
+- `IndieWeb::Endpoints::TimeoutError`
+- `IndieWeb::Endpoints::TooManyRedirectsError`
+
+## Contributing
+
+Interested in helping improve indieweb-endpoints-ruby? Awesome! Your help is greatly appreciated. See [CONTRIBUTING.md](https://github.com/indieweb/indieweb-endpoints-ruby/blob/master/CONTRIBUTING.md) for details.
+
+By contributing to and participating in the development of indieweb-endpoints-ruby, you acknowledge that you have read and agree to the [IndieWeb Code of Conduct](https://indieweb.org/code-of-conduct).
+
+## Acknowledgments
+
+indieweb-endpoints-ruby wouldn't exist without IndieAuth, Micropub, and Webmention and the hard work put in by everyone involved in the [IndieWeb](https://indieweb.org) movement. Additionally, the comprehensive Webmention Endpoint Discovery test suite at [webmention.rocks](https://webmention.rocks) was invaluable in the development of this Ruby gem.
+
+indieweb-endpoints-ruby is written and maintained by [Jason Garber](https://sixtwothree.org).
+
+## License
+
+indieweb-endpoints-ruby is freely available under the [MIT License](https://opensource.org/licenses/MIT). Use it, learn from it, fork it, improve it, change it, tailor it to your needs.

data/Rakefile

@@ -0,0 +1,17 @@
+require 'bundler/gem_tasks'
+
+require 'reek/rake/task'
+require 'rspec/core/rake_task'
+require 'rubocop/rake_task'
+
+Reek::Rake::Task.new do |task|
+  task.fail_on_error = false
+end
+
+RSpec::Core::RakeTask.new
+
+RuboCop::RakeTask.new do |task|
+  task.fail_on_error = false
+end
+
+task default: [:rubocop, :reek, :spec]

data/indieweb-endpoints.gemspec

@@ -0,0 +1,37 @@
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'indieweb/endpoints/version'
+
+Gem::Specification.new do |spec|
+  spec.required_ruby_version = ['>= 2.4', '< 2.7']
+
+  spec.name          = 'indieweb-endpoints'
+  spec.version       = IndieWeb::Endpoints::VERSION
+  spec.authors       = ['Jason Garber']
+  spec.email         = ['jason@sixtwothree.org']
+
+  spec.summary       = 'Discover a URL’s IndieAuth, Micropub, and Webmention endpoints.'
+  spec.description   = spec.summary
+  spec.homepage      = 'https://github.com/indieweb/indieweb-endpoints-ruby'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(bin|spec)/}) }
+
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'rake', '~> 12.3'
+  spec.add_development_dependency 'reek', '~> 5.3'
+  spec.add_development_dependency 'rspec', '~> 3.8'
+  spec.add_development_dependency 'rubocop', '~> 0.67.2'
+  spec.add_development_dependency 'rubocop-performance', '~> 1.1'
+  spec.add_development_dependency 'rubocop-rspec', '~> 1.32'
+  spec.add_development_dependency 'simplecov', '~> 0.16.1'
+  spec.add_development_dependency 'simplecov-console', '~> 0.4.2'
+  spec.add_development_dependency 'webmock', '~> 3.5'
+
+  spec.add_runtime_dependency 'absolutely', '~> 1.1'
+  spec.add_runtime_dependency 'addressable', '~> 2.6'
+  spec.add_runtime_dependency 'http', '~> 5.0.0.pre'
+  spec.add_runtime_dependency 'nokogiri', '~> 1.10'
+end

data/lib/indieweb/endpoints/client.rb

@@ -0,0 +1,37 @@
+module IndieWeb
+  module Endpoints
+    class Client
+      HTTP_HEADERS_OPTS = {
+        accept: '*/*',
+        user_agent: 'IndieAuth, Micropub, and Webmention Endpoint Discovery (https://rubygems.org/gems/indieweb-endpoints)'
+      }.freeze
+
+      def initialize(url)
+        raise ArgumentError, "url must be a String (given #{url.class.name})" unless url.is_a?(String)
+
+        @url = Addressable::URI.parse(url)
+
+        raise ArgumentError, 'url must be an absolute URL (e.g. https://example.com)' unless @url.absolute?
+      rescue Addressable::URI::InvalidURIError => exception
+        raise InvalidURIError, exception
+      end
+
+      def endpoints
+        @endpoints ||= Parsers.registered.transform_values { |parser| parser.new(response).results }
+      end
+
+      def response
+        @response ||= HTTP.follow.headers(HTTP_HEADERS_OPTS).timeout(
+          connect: 10,
+          read: 10
+        ).get(@url)
+      rescue HTTP::ConnectionError => exception
+        raise ConnectionError, exception
+      rescue HTTP::TimeoutError => exception
+        raise TimeoutError, exception
+      rescue HTTP::Redirector::TooManyRedirectsError => exception
+        raise TooManyRedirectsError, exception
+      end
+    end
+  end
+end

data/lib/indieweb/endpoints/exceptions.rb

@@ -0,0 +1,13 @@
+module IndieWeb
+  module Endpoints
+    class ArgumentError < StandardError; end
+
+    class ConnectionError < StandardError; end
+
+    class InvalidURIError < StandardError; end
+
+    class TimeoutError < StandardError; end
+
+    class TooManyRedirectsError < StandardError; end
+  end
+end

data/lib/indieweb/endpoints/parsers/authorization_endpoint_parser.rb

@@ -0,0 +1,15 @@
+module IndieWeb
+  module Endpoints
+    module Parsers
+      class AuthorizationEndpointParser < BaseParser
+        Parsers.register(:authorization_endpoint, self)
+
+        private
+
+        def identifier
+          @identifier ||= :authorization_endpoint
+        end
+      end
+    end
+  end
+end

data/lib/indieweb/endpoints/parsers/micropub_parser.rb

@@ -0,0 +1,15 @@
+module IndieWeb
+  module Endpoints
+    module Parsers
+      class MicropubParser < BaseParser
+        Parsers.register(:micropub, self)
+
+        private
+
+        def identifier
+          @identifier ||= :micropub
+        end
+      end
+    end
+  end
+end

data/lib/indieweb/endpoints/parsers/redirect_uri_parser.rb

@@ -0,0 +1,41 @@
+module IndieWeb
+  module Endpoints
+    module Parsers
+      class RedirectUriParser < BaseParser
+        Parsers.register(:redirect_uri, self)
+
+        def results
+          return unless results_from_http_request.any?
+
+          @results ||= results_from_http_request.map { |endpoint| Absolutely.to_absolute_uri(base: @response.uri.to_s, relative: endpoint) }.uniq.sort
+        rescue Absolutely::InvalidURIError => exception
+          raise InvalidURIError, exception
+        end
+
+        private
+
+        def identifier
+          @identifier ||= :redirect_uri
+        end
+
+        def results_from_body
+          link_elements.map { |element| element['href'] } if response_is_html && link_elements.any?
+        end
+
+        def results_from_headers
+          return unless link_headers.any?
+
+          link_headers.map do |header|
+            endpoint_match_data = header.match(REGEXP_TARGET_URI_PATTERN)
+
+            endpoint_match_data[1] if endpoint_match_data
+          end
+        end
+
+        def results_from_http_request
+          @results_from_http_request ||= [results_from_headers, results_from_body].flatten.compact
+        end
+      end
+    end
+  end
+end

data/lib/indieweb/endpoints/parsers/token_endpoint_parser.rb

@@ -0,0 +1,15 @@
+module IndieWeb
+  module Endpoints
+    module Parsers
+      class TokenEndpointParser < BaseParser
+        Parsers.register(:token_endpoint, self)
+
+        private
+
+        def identifier
+          @identifier ||= :token_endpoint
+        end
+      end
+    end
+  end
+end

data/lib/indieweb/endpoints/parsers/webmention_parser.rb

@@ -0,0 +1,25 @@
+module IndieWeb
+  module Endpoints
+    module Parsers
+      class WebmentionParser < BaseParser
+        Parsers.register(:webmention, self)
+
+        private
+
+        def identifier
+          @identifier ||= :webmention
+        end
+
+        def link_element
+          # Return first `a` or `link` element with valid `rel` attribute
+          # https://www.w3.org/TR/webmention/#sender-discovers-receiver-webmention-endpoint
+          @link_element ||= link_elements.find { |element| %w[a link].include?(element.name) }
+        end
+
+        def link_elements_css_selector
+          @link_elements_css_selector ||= %([rel~="#{identifier}"][href])
+        end
+      end
+    end
+  end
+end

data/lib/indieweb/endpoints/parsers.rb

@@ -0,0 +1,93 @@
+module IndieWeb
+  module Endpoints
+    module Parsers
+      extend Registerable
+
+      class BaseParser
+        # Ultra-orthodox pattern matching allowed values in Link header `rel` parameter
+        # https://tools.ietf.org/html/rfc8288#section-3.3
+        REGEXP_REG_REL_TYPE_PATTERN = '[a-z\d][a-z\d\-\.]*'.freeze
+
+        # Liberal pattern matching a string of text between angle brackets
+        # https://tools.ietf.org/html/rfc5988#section-5.1
+        REGEXP_TARGET_URI_PATTERN = /^<(.*)>;/.freeze
+
+        def initialize(response)
+          raise ArgumentError, "response must be an HTTP::Response (given #{response.class.name})" unless response.is_a?(HTTP::Response)
+
+          @response = response
+        end
+
+        def results
+          return unless results_from_http_request
+
+          @results ||= Absolutely.to_absolute_uri(base: @response.uri.to_s, relative: results_from_http_request)
+        rescue Absolutely::InvalidURIError => exception
+          raise InvalidURIError, exception
+        end
+
+        private
+
+        def discrete_link_headers
+          # Split Link headers with multiple values, flatten the resulting array, and strip whitespace
+          # https://webmention.rocks/test/19
+          @discrete_link_headers ||= @response.headers.get('link').map { |header| header.split(',') }.flatten.map(&:strip)
+        end
+
+        def doc
+          @doc ||= Nokogiri::HTML(@response.body.to_s)
+        end
+
+        def link_element
+          # Return first `link` element with valid `rel` attribute
+          # https://www.w3.org/TR/indieauth/#discovery-1
+          # https://www.w3.org/TR/micropub/#endpoint-discovery
+          @link_element ||= link_elements.shift
+        end
+
+        def link_elements
+          @link_elements ||= doc.css(link_elements_css_selector)
+        end
+
+        def link_elements_css_selector
+          @link_elements_css_selector ||= %(link[rel~="#{identifier}"][href])
+        end
+
+        def link_header
+          @link_header ||= link_headers.shift
+        end
+
+        def link_headers
+          # Reduce Link headers to those with valid `rel` attribute
+          @link_headers ||= discrete_link_headers.find_all { |header| header.match?(regexp_rel_paramater_pattern) }
+        end
+
+        def regexp_rel_paramater_pattern
+          # Ultra-orthodox pattern matching Link header `rel` parameter including a matching identifier value
+          # https://www.w3.org/TR/webmention/#sender-discovers-receiver-webmention-endpoint
+          @regexp_rel_paramater_pattern ||= /(?:;|\s)rel="?(?:#{REGEXP_REG_REL_TYPE_PATTERN}+\s)?#{identifier}(?:\s#{REGEXP_REG_REL_TYPE_PATTERN})?"?/
+        end
+
+        def results_from_body
+          link_element['href'] if response_is_html && link_element
+        end
+
+        def results_from_headers
+          return unless link_header
+
+          endpoint_match_data = link_header.match(REGEXP_TARGET_URI_PATTERN)
+
+          return endpoint_match_data[1] if endpoint_match_data
+        end
+
+        def response_is_html
+          @response_is_html ||= @response.mime_type == 'text/html'
+        end
+
+        def results_from_http_request
+          @results_from_http_request ||= results_from_headers || results_from_body || nil
+        end
+      end
+    end
+  end
+end

data/lib/indieweb/endpoints/registerable.rb

@@ -0,0 +1,13 @@
+module IndieWeb
+  module Endpoints
+    module Registerable
+      def register(identifier, klass)
+        registered[identifier] = klass
+      end
+
+      def registered
+        @registered ||= {}
+      end
+    end
+  end
+end

data/lib/indieweb/endpoints/version.rb

@@ -0,0 +1,5 @@
+module IndieWeb
+  module Endpoints
+    VERSION = '0.1.0'.freeze
+  end
+end

data/lib/indieweb/endpoints.rb

@@ -0,0 +1,25 @@
+require 'absolutely'
+require 'addressable/uri'
+require 'http'
+require 'nokogiri'
+
+require 'indieweb/endpoints/version'
+require 'indieweb/endpoints/exceptions'
+
+require 'indieweb/endpoints/client'
+require 'indieweb/endpoints/registerable'
+
+require 'indieweb/endpoints/parsers'
+require 'indieweb/endpoints/parsers/authorization_endpoint_parser'
+require 'indieweb/endpoints/parsers/micropub_parser'
+require 'indieweb/endpoints/parsers/redirect_uri_parser'
+require 'indieweb/endpoints/parsers/token_endpoint_parser'
+require 'indieweb/endpoints/parsers/webmention_parser'
+
+module IndieWeb
+  module Endpoints
+    def self.get(url)
+      Client.new(url).endpoints
+    end
+  end
+end

metadata

@@ -0,0 +1,257 @@
+--- !ruby/object:Gem::Specification
+name: indieweb-endpoints
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Jason Garber
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-04-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.3'
+- !ruby/object:Gem::Dependency
+  name: reek
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.3'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.8'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.67.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.67.2
+- !ruby/object:Gem::Dependency
+  name: rubocop-performance
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.32'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.32'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.16.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.16.1
+- !ruby/object:Gem::Dependency
+  name: simplecov-console
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.2
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+- !ruby/object:Gem::Dependency
+  name: absolutely
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: addressable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+- !ruby/object:Gem::Dependency
+  name: http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 5.0.0.pre
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 5.0.0.pre
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+description: Discover a URL’s IndieAuth, Micropub, and Webmention endpoints.
+email:
+- jason@sixtwothree.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".editorconfig"
+- ".github/CODEOWNERS"
+- ".gitignore"
+- ".reek.yml"
+- ".rspec"
+- ".rubocop"
+- ".rubocop.yml"
+- ".ruby-version"
+- ".simplecov"
+- ".travis.yml"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- CONTRIBUTING.md
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- indieweb-endpoints.gemspec
+- lib/indieweb/endpoints.rb
+- lib/indieweb/endpoints/client.rb
+- lib/indieweb/endpoints/exceptions.rb
+- lib/indieweb/endpoints/parsers.rb
+- lib/indieweb/endpoints/parsers/authorization_endpoint_parser.rb
+- lib/indieweb/endpoints/parsers/micropub_parser.rb
+- lib/indieweb/endpoints/parsers/redirect_uri_parser.rb
+- lib/indieweb/endpoints/parsers/token_endpoint_parser.rb
+- lib/indieweb/endpoints/parsers/webmention_parser.rb
+- lib/indieweb/endpoints/registerable.rb
+- lib/indieweb/endpoints/version.rb
+homepage: https://github.com/indieweb/indieweb-endpoints-ruby
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.4'
+  - - "<"
+    - !ruby/object:Gem::Version
+      version: '2.7'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3
+signing_key: 
+specification_version: 4
+summary: Discover a URL’s IndieAuth, Micropub, and Webmention endpoints.
+test_files: []