tag_uri 1.0.1 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 24aedc1ef59817936be23c8bd7a0d11c96b02251
-  data.tar.gz: a5c2c2a78131e12b451317ff03a30025b6a2387e
+SHA256:
+  metadata.gz: f1f7613a274c36cb5de4cb1105e0af41db251bf2fa0f16bdd31c2eeb7d8a5bdb
+  data.tar.gz: 8cdd72e27fdd464ecbb36f65a3c6f5ee60e0a762ac73270058827cf2724d0eb0
 SHA512:
-  metadata.gz: eb905bff1541a2df1c0ddc83e9c851ae43d4cae802d201450ed7e375f22475130bba0a8bb79c73d7996c738eb8d362b488a072e55d8a4624a6f95804da5974fa
-  data.tar.gz: 3b6aac238508687f5c616295e0342454bddb1bdd52a9bc996d62088528e47a945aff2b16ac5d7533de0e47009bc339d6b3ee0f68aefd3d0474e9fc1e99c7891d
+  metadata.gz: af684a9e4ce533c01ed5600b730959551a4dfbca805c2e5e2f2f6d3da2462a9365b856cb03c3e358a54cde88339699f043f02ceb9f3379124bf9a00cd9a9f49e
+  data.tar.gz: f802572ff78c7a1e2d965370019cae2e046ae93f250e4ed9c23e10992236d2ce5a39f55f4c42ff86666d979f65b5f9f30f6f9c58f30b8ca8ce015e7c7d1fcba5

data/.travis.yml

@@ -1,7 +1,6 @@
 language: ruby
 rvm:
-  - 2.1.0
-  - 2.2.2
+  - ruby-2.5.2
   - rbx
   - ruby-head
   - jruby-head

data/CHANGES.md

@@ -1,27 +1,62 @@
 # CH CH CH CHANGES #
 
-## Sunday the 14th of June, 2015 ##
+## Otherwise known as the changelog
 
-### v1.0.1 ###
+All notable changes to this project will be documented in this file.
 
-* Improved the docs.
+The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
+and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
-----
 
-### v1.0.0 ###
+## Unreleased
 
-* Updated to use Ruby v2's keywords.
-* Bumped to v1.0.0 as a semver release.
 
-----
+## [v2.0.1] - Tuesday the 15th of January, 2019
 
-### v0.0.3 ###
+### Added
 
-* Since the Github repo is called tag-uri (because a hypen is clearer in a URL) I've added tag-uri.rb and taguri.rb to the lib to require the library in case anyone uses the wrong name.
+- Support for a more secure installation via MediumSecurity and HighSecurity options.
 
-### 27th of February, 2013 v0.0.2 ###
+### Changed
 
-* Changed to be a class method, as if it's mixed in to a model then the model will likely want to use that name for the field.
-* Changed the module name, it should all be uppercase so now it is.
+- Updated the README to reflect the changes.
 
-----
+
+## [v2.0.0] - Tuesday the 15th of January, 2019
+
+### Added
+
+- Started using [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
+
+### Changed
+
+- Expanded the use of the library beyond just atom.
+- Added lots more tests.
+- The API now adheres more to the terms used in the RFC.
+- Tried to keep the laziness factor available.
+- Removed the old `TagURI.create` API (the major version change means it's a breaking change).
+- Tried to get TagURI::URI closer to the Ruby stdlib's URI API. More could probably be done here.
+- Improved the docs by adding specs that mirror the examples given.
+- Git tags will now be signed by GPG too (look in my gists for Keybase or go to [http://keybase.io/iainb](http://keybase.io/iainb) to get the key).
+
+
+## [v1.0.1] - Sunday the 14th of June, 2015
+
+- Improved the docs.
+
+
+## [v1.0.0] - Sunday the 14th of June, 2015
+
+- Updated to use Ruby v2's keywords.
+- Bumped to v1.0.0 as a semver release.
+
+
+## [v0.0.3] - Wednesday the 27th of February, 2013
+
+- Since the Github repo is called tag-uri (because a hypen is clearer in a URL) I've added tag-uri.rb and taguri.rb to the lib to require the library in case anyone uses the wrong name.
+
+
+## [v0.0.2] - Wednesday the 27th of February, 2013
+
+- Changed to be a class method, as if it's mixed in to a model then the model will likely want to use that name for the field.
+- Changed the module name, it should all be uppercase so now it is.

data/Gemfile

@@ -11,11 +11,14 @@ group :development do
   gem "maruku"
   unless RUBY_ENGINE == 'jruby' || RUBY_ENGINE == "rbx"
     gem "pry-byebug"
+    gem "rb-readline"
   end
 end
 
 group :test do
   gem "rspec"
   gem "rspec-its"
+  gem "rspec-given"
   gem "simplecov"
+  gem "timecop"
 end

data/README.md

@@ -1,6 +1,6 @@
-# TagUri
+# TagURI
 
-An implementation of tag URI's.
+An implementation of tag URIs.
 See http://tools.ietf.org/html/rfc4151
 
 ### Build status ###
@@ -10,7 +10,7 @@ Master branch:
 
 ## Why? ##
 
-Because every Atom entry must have a globally unique ID, in the `id` element. 
+I originally wrote this because every Atom entry must have a globally unique ID, in the `id` element, and I was writing an atom feed.
 
 * The ID must be a valid URI, as defined by RFC 2396.
 * The ID must be globally unique, across all Atom feeds, everywhere, for all time. This part is actually easier than it sounds.
@@ -27,23 +27,69 @@ You don't have to just use it with Atom, it's also useful anywhere that a non-ti
 > Tag URIs finally let URIs do what they were meant to do: identify without implying any sort of location or behavior that they don't have. They're easy to create, they're human legible, they work with existing systems, they're an open standard, and they don't have any backward compatibility issues. What's not to like?
 
 
-## Installation
+## Usage
 
-Add this line to your application's Gemfile:
+    require 'tag_uri'
 
-    gem 'tag_uri'
+### THE MOST BASIC WAY
 
-And then execute:
+    tag_uri = TagURI::URI.new authority_name: "helpful-iain@theprintedbird.com",
+                    date: "2019-01-09",
+                    specific: "My slippers"
 
-    $ bundle
+    tag_uri.to_s
+    # => "tag:helpful-iain@theprintedbird.com,2019-01-09:My%20slippers"
+    tag.authority_name
+    # => "helpful-iain@theprintedbird.com"
+    tag.date
+    # => 2019-01-09 00:00:00 +0900 # You get a Time object back
+    tag.specific "My slippers"
 
-Or install it yourself as:
+### ANOTHER MOST BASIC WAY
 
-    $ gem install tag_uri
+    TagURI::URI.new email: "helpful-iain@theprintedbird.com",
+                    date: "2019-01-09",
+                    specific: "My slippers"
 
-## Usage
+    tag_uri.to_s
+    # => "tag:helpful-iain@theprintedbird.com,2019-01-09:My%20slippers"
+    tag.authority_name
+    # => "helpful-iain@theprintedbird.com"
+    tag.date
+    # => 2019-01-09 00:00:00 +0900
+    tag.specific "My slippers"
 
-    require 'tag_uri'
+### (NOT TO FLOG A DEAD HORSE BUT) ANOTHER MOST BASIC WAY
+
+    TagURI::URI.new domain: "theprintedbird.com",
+                    date: "2019-01-09",
+                    specific: "My slippers"
+
+    tag_uri.to_s
+    # => "tag:theprintedbird.com,2019-01-09:My%20slippers"
+    tag.authority_name
+    # => "theprintedbird.com"
+    tag.date
+    # => 2019-01-09 00:00:00 +0900
+    tag.specific "My slippers"
+
+
+### YOU HAVE A WEB LINK TO AN ARTICLE ABOUT BEESWAX (WHY NOT?) AND YOU'RE FEELING LAZY
+
+    Don't be this lazy as you'll be letting a computer and my programming try to guess what you wanted. But…
+
+    # Imagine it's the 2018-03-11 today, because today is the day that'll be
+    # chosen for your tag date.
+    tag_uri = TagURI::URI.new uri: "http://www.example.com/posts/beeswax#bees"
+
+    tag_uri.to_s
+    # => "tag:www.example.com,2018-03-11:/posts/beeswax#bees"
+    tag_uri.authority_name
+    # => "www.example.com"
+    tag_uri.specific
+    # => "/posts/beeswax"
+    tag_uri.fragment # yes, you get fragments too!
+    # => "bees"
 
 Given a model:
 
@@ -55,16 +101,49 @@ Given a model:
     # => "howto-atom-linkblog"
     post.created_at
     # => 2004-05-27 00:00:00 0100
-    
-    TagURI.create prefix: "/archives/2004/05/27", host: "diveintomark.org", slug: post.slug, created_at: post.created_at
-    # => "tag:diveintomark.org,2013-02-26:/archives/2004/05/27/howto-atom-linkblog"
+    post.prefix
+    # => "/archives/2004/05/27/" # Why? It's up to you.
 
-Although you'll probably do something more like this:
+    tag_uri = TagURI::URI.new authority_name: request.host,
+                    date: post.created_at,
+                    specific: "#{post.prefix}#{slug}"
 
-    TagURI.create slug: post.slug, created_at: post.created_at prefix: prefix, host: request.host
+    tag_uri.to_s
+    # => "tag:diveintomark.org,2013-02-26:/archives/2004/05/27/howto-atom-linkblog"
 
 or something like that.
 
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'tag_uri'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install tag_uri
+
+## Even better installation
+
+I'm trying to be a [responsible citizen regarding security](https://keybase.io/iainb) so I've followed the [instructions here](https://guides.rubygems.org/security/) and created a [public certicate](https://gist.github.com/yb66/0fb0e3007de4d4279aeaf162e0ced40a#file-yb66-pem) and signed the gem, so you can install it via:
+
+    gem cert --add <(curl -Ls https://gist.githubusercontent.com/yb66/0fb0e3007de4d4279aeaf162e0ced40a/raw/49466a801e1fd237fffe4658143a96c6cca6c961/yb66.pem)
+
+    gem install tag_uri -P MediumSecurity
+
+The MediumSecurity trust profile will verify signed gems, but allow the installation of unsigned dependencies.
+
+If all of TagURI’s dependencies are signed you can use HighSecurity.
+
+    gem install tag_uri -P HighSecurity
+
+It's just one more [good reason](https://cfoc.org/rubygems-vulnerability-can-compel-installing-malware/) to get on to gem authors and ask them to sign their gems, and ask the Rubygems authors to be [proactive with security measures](https://github.com/rubygems/rubygems/issues/2496).
+
 ## Versioning ##
 
 This library uses [semver](http://semver.org).

data/certs/yb66.pem

@@ -0,0 +1,26 @@
+-----BEGIN CERTIFICATE-----
+MIIEbjCCAtagAwIBAgIBATANBgkqhkiG9w0BAQsFADAwMS4wLAYDVQQDDCVoZWxw
+ZnVsLWlhaW4vREM9dGhlcHJpbnRlZGJpcmQvREM9Y29tMB4XDTE5MDExNTA3MjAw
+OVoXDTIwMDExNTA3MjAwOVowMDEuMCwGA1UEAwwlaGVscGZ1bC1pYWluL0RDPXRo
+ZXByaW50ZWRiaXJkL0RDPWNvbTCCAaIwDQYJKoZIhvcNAQEBBQADggGPADCCAYoC
+ggGBALhp1KlrdriWAuhXhM3I0oZblbOUAgk8UZSyI6vLQ4oK8uHWmdBkrzUublq4
+7cU1T0IIFeKOzjN2aXS660q2Ev7Bpwt1oBjMVqLMZYJM4gixwzXW9labQhnjefEy
+CTWRa/i4gL8NbwOg/UeX5rHiCy/xaqyxj//24E7m5e72JrpK11ZZ5/4TUvxDfOJr
+w+16BAxH3ELBRjXoOXnlb7SzA2ohNnwuoom5gi9Ju6z0ooSa9cegqauHBbme8wgO
+5bPwGi+MbiLKoMDcnakuUoKqWL6qA+/QofNnrmtgBmMe08dd9/ermztT/dBdNQiE
+eOXDR+sM5ardxl+5TdAcGuheMgZBiBVqaMVowUp1VPV1f/sY8RsfYqFVBg/I+jcu
+uulV50CkaLYmZVa0sWiCNg/pkKROpVktwfkRo3EKCllckMc29qPts64g0UkyBi1q
+stO7Yk/0PmhHcWHHv8Lfuin0Cmpt01AuKi3ToOBJHAvLWkORlOw1mIC9mdOR3c9Y
+jeBbawIDAQABo4GSMIGPMAkGA1UdEwQCMAAwCwYDVR0PBAQDAgSwMB0GA1UdDgQW
+BBSyOPfHSTgay7iGZ94b0JDrrcaBDTAqBgNVHREEIzAhgR9oZWxwZnVsLWlhaW5A
+dGhlcHJpbnRlZGJpcmQuY29tMCoGA1UdEgQjMCGBH2hlbHBmdWwtaWFpbkB0aGVw
+cmludGVkYmlyZC5jb20wDQYJKoZIhvcNAQELBQADggGBAAoYHPvpy84kUzvM1tMF
+AMUFH6V/hkBdcTRS3mE+8lpMHBiPluByk1/vfUTlo9kGFtEEXd1ginKqMozLKFrr
+5yRAi08zsRA0pSDuOJsX95x4Rr5GnAUKeVOXJHry0Kae3btQdJ59ZqvFPyNiXKEB
+SUIa4GUcWFaIl2yL7epcCNsyhEqvnRPq0zvfY0IGT3AcHxchCWbnurkci32eAiqW
+TESqr8zDJzsH7HSyOHlNdvWQRrYfhh8p+JsbRqJ4rChBPYnZM6fnlFtvPUNbBaRr
+cw7FROiP0G0E7GAd7loZ78WoQEM6regiCibP3LPehIl94P3K2+CCOI148rNlyXBE
+ATDB99qMn3ZgZEE0i5jxxVOHbMQWcvN3oElPuVVq6gLhqnZn50DW2B6wf3s4MMMd
+ILghhrKlF+3IGSo6pOtgZB3Y84IgtvmYyo3Unv8VkRqZ22ZSxz7GFy+X7SABSGxU
+ewk/WBT8wib1dm745Y+U42Icj8FgHqKkq1mDIcMcyLqxLA==
+-----END CERTIFICATE-----

data/lib/tag_uri.rb

@@ -1,6 +1,7 @@
 # encoding: UTF-8
 
 require 'addressable/uri'
+require 'time'
 
 # Implementation of tag URI's.
 # @see http://tools.ietf.org/html/rfc4151
@@ -9,26 +10,273 @@ module TagURI
   class Error < StandardError; end
   class ArgumentError < Error; end
 
-  # @param [Hash] opts
-  # @option opts [String] host The host portion e.g. http://example.com. If the host portion is not given then it is assumed that `self` will provide it.
-  # @option opts [String] slug The slugged name e.g. this-is-my-first-post. If a slug is not given then it is assumed that `self` will provide it.
-  # @option opts [String] prefix Anything you wish to tack on before the slug in the path e.g. for /posts/this-is-my-first-post pass in "prefix". If a prefix is not given then it will not be added to the string.
-  # @option opts [Time] created_at The time the resource was created. If a created_at time is not given then it is assumed that `self` will provide it.
-  # @return [String]
-  # @example
-  #   class Posts < Sequel::Model # or whatever ORM you're using.
-  #   end
-  #   post = Post.create #…
-  #   post.slug # => "this-is-my-first-post"
-  #   TagURI.create host: "http://example.com", prefix: "posts", slug: post.slug, created_at: post.created_at
-  def self.create( created_at: Time.now, prefix:"", slug:, host: )
-    fail ArgumentError if host.nil? || host.empty?
-    fail ArgumentError if slug.nil? || slug.empty?
-    
-    host = "https://#{host}" unless host =~ %r{^.+\://.+$}
-    uri = Addressable::URI.parse File.join( host, prefix, slug )
-    uri.scheme = "tag"
-    uri.host = "#{uri.host},#{created_at.strftime "%F"}:"
-    uri.to_s.sub(%r{://}, ":")
+
+  # From the RFC @see https://tools.ietf.org/html/rfc4151#section-2.1
+  # The general syntax of a tag URI, in ABNF [2], is:
+  #
+  #   tagURI = "tag:" taggingEntity ":" specific [ "#" fragment ]
+  #
+  # Where:
+  #
+  #   taggingEntity = authorityName "," date
+  #   authorityName = DNSname / emailAddress
+  #   date = year ["-" month ["-" day]]
+  #   year = 4DIGIT
+  #   month = 2DIGIT
+  #   day = 2DIGIT
+  #   DNSname = DNScomp *( "."  DNScomp ) ; see RFC 1035 [3]
+  #   DNScomp = alphaNum [*(alphaNum /"-") alphaNum]
+  #   emailAddress = 1*(alphaNum /"-"/"."/"_") "@" DNSname
+  #   alphaNum = DIGIT / ALPHA
+  #   specific = *( pchar / "/" / "?" ) ; pchar from RFC 3986 [1]
+  #   fragment = *( pchar / "/" / "?" ) ; same as RFC 3986 [1]
+  #   pchar         = unreserved / pct-encoded / sub-delims / ":" / "@"
+  #   unreserved = ALPHA / DIGIT / "-" / "." / "_" / "~"
+  #   pct-encoded   = "%" HEXDIG HEXDIG
+  #   sub-delims    = "!" / "$" / "&" / "'" / "(" / ")" / "*" / "+" / "," / ";" / "="
+  class URI
+    # To match the terminology of the RFC I've put straightforward regex into
+    # constants.
+
+    # No underscores, only alphanums.
+    ALPHANUM    = /[0-9a-zA-Z]/
+    # No percent encoding here for hexnums.
+    HEXDIG      = /[0-9a-fA-F]/
+    # This is where the percent encodings are checked, e.g. %20.
+    PCT_ENCODED = /% #{HEXDIG} #{HEXDIG}/x
+    # Magic markers here.
+    SUB_DELIMS  = /[\!\$\&'\(\)\*\+,\;\=]/x
+    # The uncarved block.
+    UNRESERVED  = /[\w\-\.\~]/
+    # (Possibly percent-encoded) characters
+    PCHAR       = /#{UNRESERVED} | #{PCT_ENCODED} | #{SUB_DELIMS} | \: | @/x
+    # The thing really being tagged.
+    SPECIFIC    = %r< (?: #{PCHAR} | / | \? )+ >x
+    #   fragment = *( pchar / "/" / "?" ) ; same as RFC 3986 [1]
+    # Even more specific.
+    FRAGMENT    = /(?<=\#)#{SPECIFIC}/x
+    #   DNScomp = alphaNum [*(alphaNum /"-") alphaNum]
+
+    # Don't get too hung up on validating it's a domain name,
+    # just do enough.
+    DNSNAME = /
+      \b
+      (?:
+        (?=[a-z0-9-]{1,63}\.)
+        (?: xn--)?
+        [a-z0-9]+
+        (?: -[a-z0-9]+)*
+      \.)+
+      [a-z]{2,63}
+      \b
+    /x
+
+    # It's not worth validating the email address beyond this either.
+    EMAIL = /(?<email_id>[^,]+)@(?<email_domain>[^,@]+)/ # yes, anything goes
+
+    # ISO8601 date
+    YYYY_MM_DD = /\d{4}-\d\d-\d\d/
+    OTHER_DATES = %r<\d{4}(?<separator>[\-\_/])\d\d[\-\_/]\d\d>
+
+    # One scheme to rule them all, at least in this module.
+    TAG_SCHEME = /(?<scheme>tag)\:/
+
+    # Be tolerant
+    ANY_SCHEME = /(?<scheme>#{ALPHANUM}+)\:/
+
+    # I have the authoritay!
+    AUTHORITY_NAME = /(?<authority_name>
+      (?: #{DNSNAME} )
+       |
+      (?: #{EMAIL} )
+    )/x
+
+    # The whole pattern to capture a tag uri.
+    TAG = /\A
+      #{ANY_SCHEME}
+      #{AUTHORITY_NAME}
+      ,
+      (?<date>#{YYYY_MM_DD})
+      \:
+      (?<specific> #{SPECIFIC} )
+      (?<fragment> #{FRAGMENT} )?
+    \z/x
+
+
+    # Should be slightly faster than the other version.
+    VALIDATE_TAG = /\A
+      #{TAG_SCHEME}
+      #{AUTHORITY_NAME}
+      ,
+      #{YYYY_MM_DD}
+      \:
+      #{SPECIFIC}
+      (?: #{FRAGMENT} )?
+    \z/x
+
+    TIME_FORMAT="%Y-%m-%d"
+
+
+    # @param uri [#to_s]
+    # @param authority_name [String]
+    # @param date  [String,Time,#to_time]
+    # @param specific [String]
+    # @param fragment [String]
+    # @param email [String]
+    # @param domain [String]
+    def initialize( uri:            nil,
+                    authority_name: nil,
+                    date:           nil,
+                    specific:       nil,
+                    fragment:       nil,
+                    email:          nil,
+                    domain:         nil
+                  )
+      @scheme = "tag"
+      if uri
+        # handle TagURI::URI object
+        if (uri.respond_to? :authority_name and
+             uri.respond_to? :date and
+             uri.respond_to? :specific)
+            @authority_name = uri.authority_name
+            @date = uri.date
+            @specific = uri.specific
+            return
+        else
+          uri = uri.to_s
+          # handle something that looks very like a TagURI::URI object
+          if ::URI.regexp.match uri and
+            (md = TAG.match uri) and
+            md[:scheme] == "tag"
+              @authority_name = md[:authority_name]
+              @date           = Time.strptime md[:date], TIME_FORMAT
+              @specific       = md[:specific]
+              self.fragment   = md[:fragment]
+              return
+          else # see what we can salvage from the uri
+            extra_uri = Addressable::URI.parse uri
+          end
+        end
+      end
+
+      @date =
+        if date
+          if date.respond_to? :to_time
+            date
+          elsif date.to_s =~ /\A#{YYYY_MM_DD}$/
+            Time.strptime date.to_s, TIME_FORMAT
+          else
+            fail ArgumentError, "Date should be a valid time/date/string that conforms to YYYY-MM-DD"
+          end
+        elsif uri and (md = /\A[^,]+,(?<date>#{YYYY_MM_DD})/.match uri )
+          Time.strptime md[:date], TIME_FORMAT
+        elsif extra_uri and (md = OTHER_DATES.match extra_uri.path)
+          Time.strptime md[0], "%Y#{md[:separator]}%m#{md[:separator]}%d"
+        else
+          Time.now
+        end
+
+      @authority_name =
+        if authority_name
+          if (md = AUTHORITY_NAME.match authority_name)
+            md[0]
+          else
+            fail ArgumentError, "Authority name must be a domain name or email address"
+          end
+        elsif email
+          if (md = EMAIL.match email)
+            md[0]
+          else
+            fail ArgumentError, "email given was invalid"
+          end
+        elsif domain
+          if (md = DNSNAME.match domain)
+            md[0]
+          else
+            fail ArgumentError, "domain given was invalid"
+          end
+        elsif extra_uri and extra_uri.normalized_authority
+          extra_uri.normalized_authority
+        elsif extra_uri and extra_uri.normalized_path and (md = AUTHORITY_NAME.match(extra_uri.normalized_path))
+          md[:authority_name]
+        elsif uri and (md = AUTHORITY_NAME.match uri)
+          md[0]
+        # else what?
+        end
+
+
+      @specific =
+        if specific
+          specific
+        elsif extra_uri and (md = /,[\d\-]+\:(?<specific>#{SPECIFIC})/.match extra_uri.normalized_path )
+          md[:specific]
+        elsif uri and (md = /,[\d\-]+\:(?<specific>#{SPECIFIC})/.match uri )
+          md[:specific]
+        elsif extra_uri
+          extra_uri.normalized_path
+        end
+
+      self.fragment =
+        if fragment
+          fragment
+        elsif extra_uri and (md = /,[\d\-]+\:[^\#]+#(?<fragment>#{FRAGMENT})/.match extra_uri.normalized_path)
+          md[:fragment]
+        elsif uri and (md = /,[\d\-]+\:[^\#]+#(?<fragment>#{FRAGMENT})/.match uri )
+          md[:fragment]
+        elsif extra_uri
+          extra_uri.normalized_fragment
+        end
+
+    end
+
+
+    # @!attribute [r] scheme
+    #   @return [String] Have a guess what it will be… (`"tag"`;)
+    attr_reader :scheme
+
+    # @!attribute [r] authority_name
+    #   @return [String]
+    # @!attribute [r] date
+    #   @return [String]
+    # @!attribute [r] specific
+    #   @return [String]
+    attr_accessor :authority_name, :date, :specific
+
+
+    def fragment
+      @fragment || ""
+    end
+
+
+    def fragment=( frag )
+      @fragment = if frag
+        frag.start_with?("#") ?
+          frag.sub(/#/, "") :
+          frag
+      else
+        ""
+      end
+      @fragment
+    end
+
+
+    def tagging_entity
+      %Q!#{@authority_name},#{@date.strftime "%F"}!
+    end
+
+
+    def to_s
+      s = %Q!#{self.scheme}:#{self.tagging_entity}:#{self.specific.gsub(/\s/, "%20")}!
+      unless @fragment.nil? or @fragment.empty?
+        s << "##{self.fragment}"
+      end
+      s
+    end
+
+
+    def valid?
+      !!(VALIDATE_TAG =~ self.to_s)
+    end
+
   end
 end

data/lib/tag_uri/version.rb

@@ -1,3 +1,6 @@
 module TagURI
-  VERSION = "1.0.1"
+
+  # Library version, adheres to semver
+  # @see https://semver.org/spec/v2.0.0.html
+  VERSION = "2.0.1"
 end

data/spec/spec_helper.rb

@@ -2,14 +2,13 @@
 
 require 'rspec'
 require 'rspec/its'
-Spec_dir = File.expand_path( File.dirname __FILE__ )
+require 'rspec/given'
+require 'timecop'
+Spec_dir = Pathname( __dir__ )
 
-unless Kernel.respond_to?(:require_relative)
-  module Kernel
-    def require_relative(path)
-      require File.join(File.dirname(caller[0]), path.to_str)
-    end
-  end
+if ENV["DEBUG"]
+  require 'pry-byebug'
+  binding.pry
 end
 
 # code coverage
@@ -18,6 +17,7 @@ SimpleCov.start do
   add_filter "/vendor.noindex/"
   add_filter "/coverage/"
   add_filter "/bin/"
+  add_filter "/spec/"
 end
 
 
@@ -25,5 +25,14 @@ Dir[ File.join( Spec_dir, "/support/**/*.rb")].each do |f|
   require f
 end
 
-# RSpec.configure do |config|
-# end
+TIME_NOW = Time.parse "2018-03-11T06:49:16+00:00"
+RSpec.configure do |config|
+
+  config.before(:each, :time_sensitive => true) do
+    Timecop.freeze TIME_NOW
+  end
+
+  config.after(:each, :time_sensitive => true) do
+    Timecop.return
+  end
+end

data/spec/support/fixtures/urls.txt

@@ -0,0 +1,82 @@
+SHOULD MATCH:
+
+j.mp
+1337.net
+a.b-c.de
+xn--bcher-kva.tld
+shouldfail.com
+foo.com
+
+END
+
+SHOULD NOT MATCH:
+
+223.255.255.254
+0.0.0.0
+10.1.1.0
+10.1.1.255
+224.1.1.1
+10.1.1.1
+1.1.1.1.1
+123.123.123
+a.b--c.de/
+foo.bar/
+142.42.1.1/
+foo.bar/foo(bar)baz quux
+foo.bar/baz
+foo.bar/?q=Test%20URL-encoded%20stuff
+foo.com/unicode_(✪)_in_parens
+foo.bar?q=Spaces should be encoded
+142.42.1.1:8080/
+foo.com/blah_(wikipedia)#cite-1
+foo.com/blah_(wikipedia)_blah#cite-1
+foo.com/(something)?after=parens
+code.google.com/events/#&product=browser
+foo.com/blah_blah
+foo.com/blah_blah/
+foo.com/blah_blah_(wikipedia)
+foo.com/blah_blah_(wikipedia)_(again)
+www.example.com/wpstyle/?p=364
+www.example.com/foo/?bar=baz&inga=42&quux
+userid@example.com
+userid@example.com/
+userid@example.com:8080
+userid@example.com:8080/
+✪df.ws/123
+bücher.tld
+☺.damowmow.com/
+userid:password@example.com
+userid:password@example.com/
+userid:password@example.com:8080
+userid:password@example.com:8080/
+مثال.إختبار
+例子.测试
+उदाहरण.परीक्षा
+➡.ws/䨹
+⌘.ws
+⌘.ws/
+-.~_!$&'()*+,;=:%40:80%2f::::::@example.com
+.
+..
+../
+?
+??
+??/
+#
+##
+##/
+//
+//a
+///a
+///
+/a
+1234
+h://test
+should fail
+-error-.invalid/
+-a.b.co
+a.b-.co
+3628126748
+.www.foo.bar/
+www.foo.bar./
+.www.foo.bar./

data/spec/tag_uri_spec.rb

@@ -2,27 +2,339 @@
 
 require 'spec_helper'
 require 'time'
-require 'ostruct'
 require_relative "../lib/tag_uri.rb"
 
-describe "Generating a tag uri" do
-  let(:url) { "http://diveintomark.org/archives/2004/05/27/howto-atom-linkblog" }
-  let(:slug) { "howto-atom-linkblog" }
-  let(:created_at) { Time.parse "2004/05/27" }
-  let(:host) { "diveintomark.org" }
-  let(:prefix) { "/archives/2004/05/27" }
-  let(:expected) { "tag:diveintomark.org,2004-05-27:/archives/2004/05/27/howto-atom-linkblog" }
-  let(:model) { OpenStruct.new created_at: created_at, slug: slug }
-
-  context "Given arguments" do
-    context "That are valid" do
-      subject { TagURI.create prefix: prefix, host: host, created_at: model.created_at, slug: model.slug }
-      it { should == expected }
+describe "Generating a tag uri", :time_sensitive do
+
+  context "THE MOST BASIC WAY" do
+    When(:tag_uri) {
+      TagURI::URI.new authority_name: "helpful-iain@theprintedbird.com",
+                      date: "2019-01-09",
+                      specific: "My slippers"
+    }
+    Then { tag_uri.to_s == "tag:helpful-iain@theprintedbird.com,2019-01-09:My%20slippers"}
+  end
+
+
+  context "ANOTHER MOST BASIC WAY" do
+    When(:tag_uri) {
+      TagURI::URI.new email: "helpful-iain@theprintedbird.com",
+                      date: "2019-01-09",
+                      specific: "My slippers"
+    }
+    Then { tag_uri.to_s == "tag:helpful-iain@theprintedbird.com,2019-01-09:My%20slippers"}
+  end
+
+  context "(NOT TO FLOG A DEAD HORSE BUT) ANOTHER MOST BASIC WAY" do
+    When(:tag_uri) {
+      TagURI::URI.new domain: "theprintedbird.com",
+                      date: "2019-01-09",
+                      specific: "My slippers"
+    }
+    Then { tag_uri.to_s == "tag:theprintedbird.com,2019-01-09:My%20slippers"}
+  end
+
+  context "YOU HAVE A WEB LINK TO AN ARTICLE ABOUT BEESWAX (WHY NOT?) AND YOU'RE FEELING LAZY", :time_sensitive do
+    When(:tag_uri) {
+      TagURI::URI.new uri: "http://www.example.com/posts/beeswax#bees"
+    }
+    Then { tag_uri.to_s == "tag:www.example.com,2018-03-11:/posts/beeswax#bees"}
+    And  { tag_uri.scheme == "tag" }
+    And  { tag_uri.authority_name == "www.example.com" }
+    And  { tag_uri.date == TIME_NOW }
+    And  { tag_uri.specific == "/posts/beeswax" }
+    And  { tag_uri.fragment == "bees" }
+  end
+
+  context "Some of the examples on the internet" do
+    context "diveintomark atom tag" do
+      Given(:url) { "http://diveintomark.org/archives/2004/05/27/howto-atom-linkblog" }
+      Given(:specific) { "/archives/2004/05/27/howto-atom-linkblog" }
+      Given(:date) { Time.strptime "2004/05/27", "%Y/%m/%d" }
+      Given(:authority_name) { "diveintomark.org" }
+      Given(:prefix) { "/archives/2004/05/27" }
+      Given(:expected) { "tag:diveintomark.org,2004-05-27:/archives/2004/05/27/howto-atom-linkblog" }
+      Given(:fragment) { "" }
+      context "identity" do
+        context "by string" do
+          When(:tag_uri) { TagURI::URI.new uri: expected }
+          Then { tag_uri.to_s           == expected }
+          And  { tag_uri.scheme         == "tag" }
+          And  { tag_uri.authority_name == authority_name }
+          And  { tag_uri.date           == date }
+          And  { tag_uri.specific       == specific }
+          And  { tag_uri.fragment       == fragment }
+        end
+        context "by uri" do
+          When(:tag_uri) { TagURI::URI.new uri: TagURI::URI.new(uri: expected) }
+          Then { tag_uri.to_s           == expected }
+          And  { tag_uri.scheme         == "tag" }
+          And  { tag_uri.authority_name == authority_name }
+          And  { tag_uri.date           == date }
+          And  { tag_uri.specific       == specific }
+          And  { tag_uri.fragment       == fragment }
+        end
+      end
+      context "authority_name given" do
+        context "That is valid" do
+          When(:tag_uri) { TagURI::URI.new  uri: url,
+                                            authority_name: authority_name }
+          Then { tag_uri.to_s           == expected }
+          And  { tag_uri.scheme         == "tag" }
+          And  { tag_uri.authority_name == authority_name }
+          And  { tag_uri.date           == date }
+          And  { tag_uri.specific       == specific }
+          And  { tag_uri.fragment       == fragment }
+        end
+        context "That is not valid" do
+          it "should fail, tagged by TagURI" do
+            expect { TagURI::URI.new uri: url,
+                                     authority_name: "NOT_A_DOMAIN_NAME"
+                    }.to raise_error TagURI::ArgumentError
+          end
+        end
+      end
+      context "date given" do
+        context "That is valid" do
+          When(:tag_uri) { TagURI::URI.new  uri: url,
+                                            date: date }
+          Then { tag_uri.to_s           == expected }
+          And  { tag_uri.scheme         == "tag" }
+          And  { tag_uri.authority_name == authority_name }
+          And  { tag_uri.date           == date }
+          And  { tag_uri.specific       == specific }
+          And  { tag_uri.fragment       == fragment }
+        end
+        
+        context "That is not valid" do
+          date = "Not a date"
+          it "should throw an error (tagged by the library)" do
+            expect { TagURI::URI.new  uri: url, date: date }.to raise_error TagURI::ArgumentError
+          end
+        end
+      end
+      context "specific given" do
+        When(:tag_uri) { TagURI::URI.new  uri: url,
+                                          specific: specific }
+        Then { tag_uri.to_s           == expected }
+        And  { tag_uri.scheme         == "tag" }
+        And  { tag_uri.authority_name == authority_name }
+        And  { tag_uri.date           == date }
+        And  { tag_uri.specific       == specific }
+        And  { tag_uri.fragment       == fragment }
+      end
+      context "email given" do
+        context "That is valid" do
+          Given(:email) { "alice@example.org" }
+          When(:tag_uri) { TagURI::URI.new  uri: url,
+                                            email: email }
+          Then { tag_uri.to_s           == expected.sub(authority_name, email) }
+          And  { tag_uri.scheme         == "tag" }
+          And  { tag_uri.authority_name == email }
+          And  { tag_uri.date           == date }
+          And  { tag_uri.specific       == specific }
+          And  { tag_uri.fragment       == fragment }
+        end
+        context "That is not valid" do
+          it "should fail, tagged by TagURI" do
+            expect { TagURI::URI.new uri: url,
+                                     email: "NOT_AN_EMAIL_ADDRESS"
+                    }.to raise_error TagURI::ArgumentError
+          end
+        end
+      end
+
+      context "domain given" do
+        context "That is valid" do
+          Given(:domain) { "diveintomark.org" }
+          When(:tag_uri) { TagURI::URI.new  uri: url,
+                                            domain: domain }
+          Then { tag_uri.to_s           == expected }
+          And  { tag_uri.scheme         == "tag" }
+          And  { tag_uri.authority_name == domain }
+          And  { tag_uri.date           == date }
+          And  { tag_uri.specific       == specific }
+          And  { tag_uri.fragment       == fragment }
+        end
+        context "That is not valid" do
+          it "should fail, tagged by TagURI" do
+            expect { TagURI::URI.new uri: url,
+                                     domain: "NOT_A_DOMAIN_NAME"
+                    }.to raise_error TagURI::ArgumentError
+          end
+        end
+      end
+
+      context "No authority_name or domain or email given" do
+        context "But the URI has valid one of those" do
+          When(:tag_uri) { TagURI::URI.new  uri: url }
+          Then { tag_uri.to_s           == expected }
+          And  { tag_uri.scheme         == "tag" }
+          And  { tag_uri.authority_name == authority_name }
+          And  { tag_uri.date           == date }
+          And  { tag_uri.specific       == specific }
+          And  { tag_uri.fragment       == fragment }
+        end
+      end
+    end
+    context "Sandro's dog tag" do
+      Given(:url) { "sandro@hawke.org" }
+      Given(:authority_name) { "sandro@hawke.org" }
+      Given(:specific) { "Taiko" }
+      Given(:date) { Time.parse "2001-06-05" }
+      Given(:expected) { "tag:sandro@hawke.org,2001-06-05:Taiko" }
+      Given(:fragment) { "" }
+      context "identity" do
+        When(:tag_uri) { TagURI::URI.new uri: expected }
+        Then { tag_uri.to_s           == expected }
+        And  { tag_uri.scheme         == "tag" }
+        And  { tag_uri.authority_name == authority_name }
+        And  { tag_uri.date           == date }
+        And  { tag_uri.specific       == specific }
+        And  { tag_uri.fragment       == fragment }
+      end
+      context "authority_name given" do
+        When(:tag_uri) { TagURI::URI.new  uri: url,
+                                          authority_name: authority_name }
+        Given(:expected) { "tag:sandro@hawke.org,2018-03-11:sandro@hawke.org" }
+        Then { tag_uri.to_s           == expected }
+        And  { tag_uri.scheme         == "tag" }
+        And  { tag_uri.authority_name == authority_name }
+        And  { tag_uri.date           == TIME_NOW }
+        And  { tag_uri.specific       == authority_name }
+        And  { tag_uri.fragment       == fragment }
+      end
+      context "date given" do
+        When(:tag_uri) { TagURI::URI.new  uri: url,
+                                          date: date }
+        Given(:expected) { "tag:sandro@hawke.org,2001-06-05:sandro@hawke.org" }
+        Then { tag_uri.to_s           == expected }
+        And  { tag_uri.scheme         == "tag" }
+        And  { tag_uri.authority_name == authority_name }
+        And  { tag_uri.date           == date }
+        And  { tag_uri.specific       == authority_name }
+        And  { tag_uri.fragment       == fragment }
+      end
+      context "specific given" do
+        When(:tag_uri) { TagURI::URI.new  uri: url,
+                                          specific: specific }
+        Given(:expected) { "tag:sandro@hawke.org,2018-03-11:Taiko" }
+        Then { tag_uri.to_s           == expected }
+        And  { tag_uri.scheme         == "tag" }
+        And  { tag_uri.authority_name == authority_name }
+        And  { tag_uri.date           == TIME_NOW }
+        And  { tag_uri.specific       == specific }
+        And  { tag_uri.fragment       == fragment }
+      end
+      context "No authority_name or domain or email given" do
+        context "But the URI has valid one of those" do
+          When(:tag_uri) { TagURI::URI.new  uri: url, specific: specific, date: date }
+          Then { tag_uri.to_s           == expected }
+          And  { tag_uri.scheme         == "tag" }
+          And  { tag_uri.authority_name == authority_name }
+          And  { tag_uri.date           == date }
+          And  { tag_uri.specific       == specific }
+          And  { tag_uri.fragment       == fragment }
+        end
+      end
     end
-    context "That are not valid" do
-      it "raises" do
-        expect { TagURI.create prefix: prefix, host: nil, created_at: model.created_at, slug: model.slug }.to raise_error TagURI::ArgumentError
+  end
+  context "And one I made up because I was listening to Beeswax by Nirvana at the time" do
+    context "Beeswax" do
+      Given(:url) { "http://example.com/2019-01-09/beeswax#bees" }
+      Given(:specific) { "beeswax" }
+      Given(:date) { Time.parse "2019-01-08" }
+      Given(:authority_name) { "example.com" }
+      Given(:expected) { "tag:example.com,2019-01-08:beeswax#bees" }
+      Given(:fragment) { "bees" }
+      context "identity" do
+        When(:tag_uri) { TagURI::URI.new uri: expected }
+        Then { tag_uri.to_s           == expected }
+        And  { tag_uri.scheme         == "tag" }
+        And  { tag_uri.authority_name == authority_name }
+        And  { tag_uri.date           == date }
+        And  { tag_uri.specific       == specific }
+        And  { tag_uri.fragment       == fragment }
+      end
+      context "authority_name given" do
+        When(:tag_uri) { TagURI::URI.new  uri: url,
+                                          authority_name: authority_name }
+        Given(:expected) { "tag:example.com,2019-01-09:/2019-01-09/beeswax#bees" }
+        Then { tag_uri.to_s           == expected }
+        And  { tag_uri.scheme         == "tag" }
+        And  { tag_uri.authority_name == authority_name }
+        And  { tag_uri.date           == Time.parse("2019-01-09") }
+        And  { tag_uri.specific       == "/2019-01-09/beeswax" }
+        And  { tag_uri.fragment       == fragment }
+      end
+      context "date given" do
+        When(:tag_uri) { TagURI::URI.new  uri: url,
+                                          date: date }
+        Given(:expected) { "tag:example.com,2019-01-08:/2019-01-09/beeswax#bees" }
+        Then { tag_uri.to_s           == expected }
+        And  { tag_uri.scheme         == "tag" }
+        And  { tag_uri.authority_name == authority_name }
+        And  { tag_uri.date           == date }
+        And  { tag_uri.specific       == "/2019-01-09/beeswax" }
+        And  { tag_uri.fragment       == fragment }
       end
+      context "fragment given" do
+        When(:tag_uri) { TagURI::URI.new  uri: url,
+                                          fragment: "bees" }
+        Given(:expected) { "tag:example.com,2019-01-09:/2019-01-09/beeswax#bees" }
+        Then { tag_uri.to_s           == expected }
+        And  { tag_uri.scheme         == "tag" }
+        And  { tag_uri.authority_name == authority_name }
+        And  { tag_uri.date           == Time.parse("2019-01-09") }
+        And  { tag_uri.specific       == "/2019-01-09/beeswax" }
+        And  { tag_uri.fragment       == fragment }
+      end
+    end
+  end
+end
+
+describe "Validating a tag" do
+  context "A valid tag" do
+    Given(:a_tag) { "tag:diveintomark.org,2004-05-27:/archives/2004/05/27/howto-atom-linkblog" }
+    When(:tag_uri) { TagURI::URI.new uri: a_tag }
+    Then { tag_uri.valid? }
+  end
+  context "An invalid tag" do
+    Given(:a_tag) { "tag:,2004-05-27:/archives/2004/05/27/howto-atom-linkblog" }
+    When(:tag_uri) { TagURI::URI.new uri: a_tag }
+    Then { !tag_uri.valid? }
+  end
+end
+
+
+SHOULD = []
+SHOULD_NOT = []
+pn = Spec_dir.join("support/fixtures/urls.txt")
+
+pn.each_line do |line|
+  line.chomp!
+  next if line.nil? or line.empty?
+  if ~ /^SHOULD MATCH\:/ ... ~ /^END/ # flip flop be bop
+    SHOULD << line unless $~ or ~ /^SHOULD MATCH\:/
+  else
+    SHOULD_NOT << line unless  ~ /^SHOULD NOT MATCH\:/
+  end
+end
+
+
+describe "TagURI::URI::DNSNAME" do
+
+  SHOULD.each do |uri|
+    context "#{uri}" do
+      When(:match) { /^#{TagURI::URI::DNSNAME}$/ =~ uri }
+      Then { match }
+    end
+  end
+
+  SHOULD_NOT.each do |uri|
+    context "#{uri}" do
+      When(:match) { /^#{TagURI::URI::DNSNAME}$/ =~ uri }
+      Then { !match }
     end
   end
 end

data/tag_uri.gemspec

@@ -7,10 +7,10 @@ Gem::Specification.new do |gem|
   gem.name          = "tag_uri"
   gem.version       = TagURI::VERSION
   gem.authors       = ["Iain Barnett"]
-  gem.email         = ["iainspeed@gmail.com"]
+  gem.email         = ["helpful-iain@theprintedbird.com"]
   gem.description   = %q{An implementation of tag URI's.
   See http://tools.ietf.org/html/rfc4151}
-  gem.summary       = %q{Instead of using a permalink as the id for an Atom feed entry, use a tag URI.}
+  gem.summary       = %q{Instead of using a permalink as the id for an Atom feed entry (or anything else you'd use a permalink for), use a tag URI.}
   gem.homepage      = "https://github.com/yb66/tag-uri"
 
   gem.files         = `git ls-files`.split($/)
@@ -19,4 +19,6 @@ Gem::Specification.new do |gem|
   gem.require_paths = ["lib"]
   gem.add_dependency("addressable")
   gem.required_ruby_version = '~> 2.0'
+  gem.cert_chain    = ['certs/yb66.pem']
+  gem.signing_key   = File.expand_path("~/.ssh/gem-private_key.pem") if $0 =~ /gem\z/
 end

metadata

@@ -1,14 +1,41 @@
 --- !ruby/object:Gem::Specification
 name: tag_uri
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 2.0.1
 platform: ruby
 authors:
 - Iain Barnett
 autorequire: 
 bindir: bin
-cert_chain: []
-date: 2015-06-14 00:00:00.000000000 Z
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIEbjCCAtagAwIBAgIBATANBgkqhkiG9w0BAQsFADAwMS4wLAYDVQQDDCVoZWxw
+  ZnVsLWlhaW4vREM9dGhlcHJpbnRlZGJpcmQvREM9Y29tMB4XDTE5MDExNTA3MjAw
+  OVoXDTIwMDExNTA3MjAwOVowMDEuMCwGA1UEAwwlaGVscGZ1bC1pYWluL0RDPXRo
+  ZXByaW50ZWRiaXJkL0RDPWNvbTCCAaIwDQYJKoZIhvcNAQEBBQADggGPADCCAYoC
+  ggGBALhp1KlrdriWAuhXhM3I0oZblbOUAgk8UZSyI6vLQ4oK8uHWmdBkrzUublq4
+  7cU1T0IIFeKOzjN2aXS660q2Ev7Bpwt1oBjMVqLMZYJM4gixwzXW9labQhnjefEy
+  CTWRa/i4gL8NbwOg/UeX5rHiCy/xaqyxj//24E7m5e72JrpK11ZZ5/4TUvxDfOJr
+  w+16BAxH3ELBRjXoOXnlb7SzA2ohNnwuoom5gi9Ju6z0ooSa9cegqauHBbme8wgO
+  5bPwGi+MbiLKoMDcnakuUoKqWL6qA+/QofNnrmtgBmMe08dd9/ermztT/dBdNQiE
+  eOXDR+sM5ardxl+5TdAcGuheMgZBiBVqaMVowUp1VPV1f/sY8RsfYqFVBg/I+jcu
+  uulV50CkaLYmZVa0sWiCNg/pkKROpVktwfkRo3EKCllckMc29qPts64g0UkyBi1q
+  stO7Yk/0PmhHcWHHv8Lfuin0Cmpt01AuKi3ToOBJHAvLWkORlOw1mIC9mdOR3c9Y
+  jeBbawIDAQABo4GSMIGPMAkGA1UdEwQCMAAwCwYDVR0PBAQDAgSwMB0GA1UdDgQW
+  BBSyOPfHSTgay7iGZ94b0JDrrcaBDTAqBgNVHREEIzAhgR9oZWxwZnVsLWlhaW5A
+  dGhlcHJpbnRlZGJpcmQuY29tMCoGA1UdEgQjMCGBH2hlbHBmdWwtaWFpbkB0aGVw
+  cmludGVkYmlyZC5jb20wDQYJKoZIhvcNAQELBQADggGBAAoYHPvpy84kUzvM1tMF
+  AMUFH6V/hkBdcTRS3mE+8lpMHBiPluByk1/vfUTlo9kGFtEEXd1ginKqMozLKFrr
+  5yRAi08zsRA0pSDuOJsX95x4Rr5GnAUKeVOXJHry0Kae3btQdJ59ZqvFPyNiXKEB
+  SUIa4GUcWFaIl2yL7epcCNsyhEqvnRPq0zvfY0IGT3AcHxchCWbnurkci32eAiqW
+  TESqr8zDJzsH7HSyOHlNdvWQRrYfhh8p+JsbRqJ4rChBPYnZM6fnlFtvPUNbBaRr
+  cw7FROiP0G0E7GAd7loZ78WoQEM6regiCibP3LPehIl94P3K2+CCOI148rNlyXBE
+  ATDB99qMn3ZgZEE0i5jxxVOHbMQWcvN3oElPuVVq6gLhqnZn50DW2B6wf3s4MMMd
+  ILghhrKlF+3IGSo6pOtgZB3Y84IgtvmYyo3Unv8VkRqZ22ZSxz7GFy+X7SABSGxU
+  ewk/WBT8wib1dm745Y+U42Icj8FgHqKkq1mDIcMcyLqxLA==
+  -----END CERTIFICATE-----
+date: 2019-01-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -28,7 +55,7 @@ description: |-
   An implementation of tag URI's.
     See http://tools.ietf.org/html/rfc4151
 email:
-- iainspeed@gmail.com
+- helpful-iain@theprintedbird.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -40,11 +67,13 @@ files:
 - LICENCE.txt
 - README.md
 - Rakefile
+- certs/yb66.pem
 - lib/tag-uri.rb
 - lib/tag_uri.rb
 - lib/tag_uri/version.rb
 - lib/taguri.rb
 - spec/spec_helper.rb
+- spec/support/fixtures/urls.txt
 - spec/tag_uri_spec.rb
 - tag_uri.gemspec
 homepage: https://github.com/yb66/tag-uri
@@ -66,11 +95,12 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.5
+rubygems_version: 2.7.3
 signing_key: 
 specification_version: 4
-summary: Instead of using a permalink as the id for an Atom feed entry, use a tag
-  URI.
+summary: Instead of using a permalink as the id for an Atom feed entry (or anything
+  else you'd use a permalink for), use a tag URI.
 test_files:
 - spec/spec_helper.rb
+- spec/support/fixtures/urls.txt
 - spec/tag_uri_spec.rb