webmention-endpoint 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4666da2892037b8191954b2454929a8094c24c3f
-  data.tar.gz: b800c17e27f8b9069a3b6204aadf3fe79d333a1c
+  metadata.gz: 0f8949affbb9a7d11b3a7921836df000df533090
+  data.tar.gz: 6d8feea53689bb397ad3257eb8d2f27238887357
 SHA512:
-  metadata.gz: 10a81ebbad3379a0b8e7245bd9a8603c29b135ff8bf528ab2eba4105edbcc054ef160ecd5b0dc201d5e3c68c8838124d42e3f9d6a0dddf969a8c8385f0b6dd24
-  data.tar.gz: c2154f9d69135002509c847d16dbd02791d3d75c6236d2f9952ee72fda12882eebf41ef1be79a9a00fe44b7f33aa56540a37dbeb9e3d938c93c4778528cd1f6c
+  metadata.gz: ca338aef70ea4d02e959be264088c528dd9b4ea4959079d0b13e03abff4fade24ce83a5f0ac7065d1a582dae13054d7bc7d1bb6fed137e36d96a0c64296eaeb8
+  data.tar.gz: 9a2043839ba89dadc1944ead1a606276dabaa8eba495bf7f14175253348944521d194c39171f469a4f971a5f625a2f991a509e7b383102187df75036a50081a4

data/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+## 0.2.0 / 2018-06-25
+
+- Adds `Webmention::Endpoint::Error` class and subclasses ([f81852f](https://github.com/jgarber623/webmention-endpoint-ruby/commit/f81852f)).
+
+## 0.1.0 / 2018-06-24
+
+- Initial release!

data/README.md

@@ -80,17 +80,17 @@ puts discoverer.response # returns HTTP::Response
 
 ### Exception Handling
 
-There are several exceptions that may be raised by webmention-endpoint-ruby's underlying dependencies:
+There are several exceptions that may be raised by webmention-endpoint-ruby's underlying dependencies. These errors are raised as subclasses of `Webmention::Endpoint::Error` (which itself is a subclass of `StandardError`).
 
-- `Addressable::URI::InvalidURIError`
-- `HTTP::ConnectionError`
-- `HTTP::TimeoutError`
-- `HTTP::Redirector::TooManyRedirectsError`
+From [sporkmonger/addressable](https://github.com/sporkmonger/addressable):
 
-You'll want to make sure your code gracefully handles these exceptions. For more on each of these exceptions, see:
+- `Webmention::Endpoint::InvalidURIError`
 
-- [sporkmonger/addressable](https://github.com/sporkmonger/addressable) – Source code for the Addressable Ruby gem
-- [httprb/http](https://github.com/httprb/http) – Source code for the HTTP Ruby gem
+From [httprb/http](https://github.com/httprb/http):
+
+- `Webmention::Endpoint::ConnectionError`
+- `Webmention::Endpoint::TimeoutError`
+- `Webmention::Endpoint::TooManyRedirectsError`
 
 ## Contributing
 

data/lib/webmention/endpoint.rb

@@ -3,6 +3,7 @@ require 'http'
 require 'nokogiri'
 
 require 'webmention/endpoint/version'
+require 'webmention/endpoint/error'
 require 'webmention/endpoint/discover'
 
 module Webmention

data/lib/webmention/endpoint/discover.rb

@@ -25,6 +25,8 @@ module Webmention
 
         @url = url
         @uri = Addressable::URI.parse(url)
+      rescue Addressable::URI::InvalidURIError => error
+        raise InvalidURIError, error
       end
 
       def endpoint
@@ -36,6 +38,12 @@ module Webmention
           connect: 10,
           read: 10
         ).get(uri)
+      rescue HTTP::ConnectionError => error
+        raise ConnectionError, error
+      rescue HTTP::TimeoutError => error
+        raise TimeoutError, error
+      rescue HTTP::Redirector::TooManyRedirectsError => error
+        raise TooManyRedirectsError, error
       end
 
       private
@@ -49,6 +57,8 @@ module Webmention
         return relative if relative_uri.absolute?
 
         (base_uri + relative_uri).to_s
+      rescue Addressable::URI::InvalidURIError => error
+        raise InvalidURIError, error
       end
 
       def endpoint_from_body

data/lib/webmention/endpoint/error.rb

@@ -0,0 +1,15 @@
+module Webmention
+  module Endpoint
+    class Error < StandardError; end
+
+    class ArgumentError < Error; end
+
+    class ConnectionError < Error; end
+
+    class InvalidURIError < Error; end
+
+    class TimeoutError < Error; end
+
+    class TooManyRedirectsError < Error; end
+  end
+end

data/lib/webmention/endpoint/version.rb

@@ -1,5 +1,5 @@
 module Webmention
   module Endpoint
-    VERSION = '0.1.0'.freeze
+    VERSION = '0.2.0'.freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: webmention-endpoint
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Jason Garber
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-06-24 00:00:00.000000000 Z
+date: 2018-06-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -189,6 +189,7 @@ files:
 - ".ruby-version"
 - ".simplecov"
 - ".travis.yml"
+- CHANGELOG.md
 - CONTRIBUTING.md
 - Gemfile
 - LICENSE
@@ -196,6 +197,7 @@ files:
 - Rakefile
 - lib/webmention/endpoint.rb
 - lib/webmention/endpoint/discover.rb
+- lib/webmention/endpoint/error.rb
 - lib/webmention/endpoint/version.rb
 - webmention-endpoint.gemspec
 homepage: https://github.com/jgarber623/webmention-endpoint-ruby