gitable 0.3.1 → 0.4.0

checksums.yaml

@@ -1,15 +1,7 @@
 ---
-!binary "U0hBMQ==":
-  metadata.gz: !binary |-
-    MDAyYWRhZmQ4YmE3ZTY5YWNlOTI0YWI1NjhiYTg3NWUxNWIyZjc0Zg==
-  data.tar.gz: !binary |-
-    NTlkZWEyMGYyMTMzZmUyNWNjY2FhMzg5NDU2ZTM0OTlmMmViYmJiYg==
-!binary "U0hBNTEy":
-  metadata.gz: !binary |-
-    ZDRlMzdlOGJjYWU4ZGJiNjY5NTFjMzdhNTViYjZmZDlkNzBhODJjYzhhMDA3
-    NTI3NWMxZTJmNGQxNGFhMzUzOTRkNTY0ZGMxN2VkZmU4ZjIzOTJmMjRjN2Yx
-    NWY2ZDFjZDE5M2U3ZmFiNTJlNWFkYTQyZDY3NzVjNDk1ZGM3NWI=
-  data.tar.gz: !binary |-
-    OGJhNjcwNDk3Mjg2MjE4NWM0NzAyMGFiZWJlMzg3YzI0OWJjZTYxMDg3NTdk
-    YzQ3MzU3MjZlZWQwMzYxNWZjM2UwM2E2Zjg3MTYwZjJiOWRiNmJlMDhiOTkx
-    OWQ5Y2NiMWRmZDA2OTFhNDcyZWZkYmYyMTJhMGU2NjkzY2YyNzg=
+SHA1:
+  metadata.gz: b8946d8df934b379e9bb04017f8d42c3aa9f0d0a
+  data.tar.gz: 9d3b013c3ccd4609d545f9c58b8dd87cc16856ac
+SHA512:
+  metadata.gz: 3c696b9586345ffd296491fdf911c08639aa5672be3be4f2d860655920ff5f91fa906fb00b9b9d10aafd8e1529b99c369b3b54743a65f420246dc7f966a1399e
+  data.tar.gz: 4a78d11b69c5a66b550e68d380e4001f20e40e21bd765ce88ccc3343e496ee20c11be5fcfffa1cdb223fb61e65f3d31d330c638d03eddb68ff7a2ea72648f82f

data/.gitignore

@@ -20,6 +20,7 @@ doc
 rdoc
 pkg
 vendor/gems
+vendor/bundle
 .yardoc
 .bundle
 Gemfile.lock

data/.travis.yml

@@ -1,6 +1,12 @@
 language: ruby
 rvm:
-  - 1.9.3
   - 2.0.0
-  - jruby
-  - rbx-19mode
+  - 2.1.0
+  - 2.2.0
+  - 2.3.0
+  - ruby-head
+  - jruby-head
+matrix:
+  allow_failures:
+    - rvm: ruby-head
+    - rvm: jruby-head

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2009 Martin Emde
+Copyright (c) 2009-2014 Martin Emde
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -0,0 +1,108 @@
+# Gitable
+
+[![Gem Version](https://badge.fury.io/rb/gitable.png)][gem]
+[![Build Status](https://travis-ci.org/martinemde/gitable.png?branch=master)][travis]
+[![Dependency Status](https://gemnasium.com/martinemde/gitable.png?travis)][gemnasium]
+[![Code Climate](https://codeclimate.com/github/martinemde/gitable.png)][codeclimate]
+
+[gem]: https://rubygems.org/gems/gitable
+[travis]: https://travis-ci.org/martinemde/gitable
+[gemnasium]: https://gemnasium.com/martinemde/gitable
+[codeclimate]: https://codeclimate.com/github/martinemde/gitable
+
+## A git remote URI parser backed by Addressable
+
+Works with any valid Git URI as described in the git docs.
+
+`git clone` accepts many different URI formats for remote repositories.
+Unfortunately, not all of them are actually URIs. Addressable is able to parse
+many of the standard URIs accepted by git, and this library extends Addressable
+to handle the non-standard scp-style repository locations.
+
+Gitable provides a uniform way to parse a git repository location and determine
+information about the project. Gitable can determine whether or not a repository
+will require authentication before actually using `git` to clone the repository.
+Gitable is also very useful for determining equivalence between git remotes that
+are entered slightly differently (e.g. trailing slashes, uri scheme, uri format)
+
+This is *not* a general substitute for Addressable, but rather a specific solution
+for accepting git repository addresses and confirming validity and authentication.
+Gitable *should not* be used as a general URI parser for anything other than git
+repository locations.
+
+Many thanks to [Bob Aman (sporkmonger)](https://github.com/sporkmonger) for his
+work on Addressable and for his feedback on this gem.
+
+## Example
+
+    require 'gitable/uri'
+    uri = Gitable::URI.parse('git@github.com:martinemde/gitable.git')
+
+    uri.path   # => 'martinemde/gitable.git'
+    uri.user   # => 'git'
+    uri.host   # => 'github.com'
+
+Maintain the same url format.
+
+    uri.to_s   # => 'git@github.com:martinemde/gitable.git'
+
+Uses ssh?
+
+    uri.ssh?   # => true
+
+SCP format?
+
+    uri.scp?   # => true
+
+If it can't guess the name, you named your repository wrong.
+
+    uri.project_name   # => 'gitable'
+
+Will this uri require authentication?
+
+    uri.authenticated? # => true
+
+Will I have to interactively type something into git (a password)?
+
+    uri.interactive_authenticated? # => false
+
+Matching public to private git uris?
+
+    uri.equivalent?('git://github.com/martinemde/gitable.git') # => true
+    uri.equivalent?('https://martinemde@github.com/martinemde/gitable.git') # => true
+
+Link to the web page for a project (github)
+
+    if uri.github?
+      uri.to_web_uri # => <Addressable::URI https://github.com/martinemde/gitable>
+    end
+
+Inherited from Addressable::URI
+
+    uri.kind_of?(Addressable::URI)   # => true
+
+Teenage Mutant Ninja Urls (mutable uris like Addressable, if you want)
+
+    uri.path = 'someotheruser/gitable.git'
+    uri.basename = 'umm.git'
+    uri.to_s    # => 'git@github.com:someotheruser/umm.git'
+
+## `Gitable::URI.heuristic_parse`
+
+`Gitable::URI.heuristic_parse` can be used to accept user input.
+
+Currently this supports the mistake of copying the url bar instead of the git
+uri for a few of the popular git webhosts. It also runs through Addressable's
+`heuristic_parse` so it will correct some poorly typed URIs.
+
+    uri = Gitable::URI.heuristic_parse('http://github.com:martinemde/gitable')
+    uri.to_s   # => 'git://github.com/martinemde/gitable.git'
+
+`heuristic_parse` is currently very limited. If the url doesn't end in .git, it
+switches http:// to git:// and adds .git to the basename.
+This works fine for github.com and gitorious.org but will happily screw up other
+URIs.
+
+## Copyright
+
+Copyright (c) 2014 Martin Emde. See LICENSE for details.

data/gitable.gemspec

@@ -1,16 +1,16 @@
 # -*- encoding: utf-8 -*-
 Gem::Specification.new do |s|
   s.name        = "gitable"
-  s.version     = "0.3.1"
+  s.version     = "0.4.0"
   s.authors     = ["Martin Emde"]
   s.email       = ["martin.emde@gmail.com"]
   s.homepage    = "http://github.org/martinemde/gitable"
-  s.summary     = %q{Addressable::URI for Git. Gitable::URI.}
-  s.description = %q{Addressable::URI for Git URIs with special handling for scp-style URIs that Addressable doesn't like.}
+  s.summary     = %q{Addressable::URI with additional support for Git "URIs"}
+  s.description = %q{Addressable::URI for Git "URIs" with special handling for scp-style remotes that Addressable intentionally doesn't parse.}
   s.license     = 'MIT'
 
-  s.add_dependency "addressable", ">= 2.2.7"
-  s.add_development_dependency "rspec", "~>2.11"
+  s.add_dependency "addressable", "~> 2.2", ">= 2.2.7"
+  s.add_development_dependency "rspec", "~> 3.0"
   s.add_development_dependency "rake"
   s.add_development_dependency "simplecov"
 
@@ -18,5 +18,5 @@ Gem::Specification.new do |s|
   s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
   s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
   s.require_paths = ["lib"]
-  s.extra_rdoc_files = ["LICENSE", "README.rdoc"]
+  s.extra_rdoc_files = ["LICENSE", "README.md"]
 end

data/lib/gitable/scp_uri.rb

@@ -83,22 +83,26 @@ module Gitable
       return if @validation_deferred
 
       if host.to_s.empty?
-        raise InvalidURIError, "Hostname segment missing: '#{to_s}'"
+        invalid! "Hostname segment missing"
       end
 
-      unless scheme.to_s.empty?
-        raise InvalidURIError, "Scp style URI must not have a scheme: '#{to_s}'"
+      if !scheme.to_s.empty?
+        invalid! "Scp style URI must not have a scheme"
       end
 
       if !port.to_s.empty?
-        raise InvalidURIError, "Scp style URI cannot have a port: '#{to_s}'"
+        invalid! "Scp style URI cannot have a port"
       end
 
       if path.to_s.empty?
-        raise InvalidURIError, "Absolute URI missing hierarchical segment: '#{to_s}'"
+        invalid! "Absolute URI missing hierarchical segment"
       end
 
       nil
     end
+
+    def invalid!(reason)
+      raise InvalidURIError, "#{reason}: '#{to_s}'"
+    end
   end
 end

data/lib/gitable/uri.rb

@@ -44,14 +44,15 @@ module Gitable
       query     = fragments[6]
       fragment  = fragments[8]
       host = nil
+
       if authority
         host = authority.gsub(/^([^\[\]]*)@/, '').gsub(/:([^:@\[\]]*?)$/, '')
       else
         authority = scheme
       end
 
-      if host.nil? && (parts = uri.scan(SCP_REGEXP)) && parts.any?
-        Gitable::ScpURI.new(:authority => parts.first[0], :path => parts.first[1])
+      if host.nil? && uri =~ SCP_REGEXP
+        Gitable::ScpURI.new(:authority => $1, :path => $2)
       else
         new(
           :scheme    => scheme,
@@ -96,7 +97,7 @@ module Gitable
       # Addressable::URI.heuristic_parse _does_ return the correct type :)
       gitable = super # boo inconsistency
 
-      if gitable.github?
+      if gitable.github? || gitable.bitbucket?
         gitable.extname = "git"
       end
       gitable
@@ -109,10 +110,18 @@ module Gitable
       !!normalized_host.to_s.match(/\.?github.com$/)
     end
 
+    # Is this uri a bitbucket uri?
+    #
+    # @return [Boolean] bitbucket.org is the host?
+    def bitbucket?
+      !!normalized_host.to_s.match(/\.?bitbucket.org$/)
+    end
+
     # Create a web link uri for repositories that follow the github pattern.
     #
     # This probably won't work for all git hosts, so it's a good idea to use
-    # this in conjunction with #github? to help ensure correct links.
+    # this in conjunction with #github? or #bitbucket? to help ensure correct
+    # links.
     #
     # @param [String] Scheme of the web uri (smart defaults)
     # @return [Addressable::URI] https://#{host}/#{path_without_git_extension}
@@ -125,7 +134,11 @@ module Gitable
     #
     # @return [String] Project name without .git
     def project_name
-      basename.sub(/\.git$/,'')
+      basename.sub(/\.git\/?$/,'')
+    end
+
+    def org_project
+      normalized_path.sub(/^\//,'').sub(/\.git\/?$/,'')
     end
 
     # Detect local filesystem URIs.
@@ -186,19 +199,15 @@ module Gitable
     def equivalent?(other_uri)
       other = Gitable::URI.parse_when_valid(other_uri)
       return false unless other
+      return false unless normalized_host.to_s == other.normalized_host.to_s
 
-      same_host = normalized_host.to_s == other.normalized_host.to_s
-
-      if github? && other.github?
-        # github doesn't care about relative vs absolute paths in scp uris (so we can remove leading / for comparison)
-        same_path = normalized_path.sub(%r#\.git/?$#, '').sub(%r#^/#,'') == other.normalized_path.sub(%r#\.git/?$#, '').sub(%r#^/#,'')
-        same_host && same_path
+      if github? || bitbucket?
+        # github doesn't care about relative vs absolute paths in scp uris
+        org_project == other.org_project
       else
-        same_path = normalized_path.sub(%r#/$#,'').to_s == other.normalized_path.sub(%r#/$#,'').to_s # remove trailing slashes.
-        same_user = normalized_user == other.normalized_user
-
         # if the path is absolute, we can assume it's the same for all users (so the user doesn't have to match).
-        same_host && same_path && (path =~ %r#^/# || same_user)
+        normalized_path.sub(/\/$/,'') == other.normalized_path.sub(/\/$/,'') &&
+          (path[0] == '/' || normalized_user == other.normalized_user)
       end
     end
 

data/spec/gitable_spec.rb

@@ -574,6 +574,7 @@ describe Gitable::URI do
         :authenticated?    => true,
         :interactive_authenticated? => false,
         :github?           => true,
+        :bitbucket?        => false,
         :to_web_uri        => Addressable::URI.parse("https://github.com/martinemde/gitable"),
       })
     end
@@ -601,6 +602,7 @@ describe Gitable::URI do
         :ssh?              => false,
         :scp?              => false,
         :github?           => true,
+        :bitbucket?        => false,
         :to_web_uri        => Addressable::URI.parse("https://github.com/martinemde/gitable"),
       })
     end
@@ -629,6 +631,7 @@ describe Gitable::URI do
         :ssh?              => false,
         :scp?              => false,
         :github?           => true,
+        :bitbucket?        => false,
         :authenticated?    => true,
         :interactive_authenticated? => true,
         :to_web_uri        => Addressable::URI.parse("https://github.com/martinemde/gitable"),
@@ -658,6 +661,7 @@ describe Gitable::URI do
         :ssh?              => false,
         :scp?              => false,
         :github?           => true,
+        :bitbucket?        => false,
         :authenticated?    => false,
         :interactive_authenticated? => false,
         :to_web_uri        => Addressable::URI.parse("https://github.com/martinemde/gitable"),
@@ -690,8 +694,159 @@ describe Gitable::URI do
         :authenticated?    => true,
         :interactive_authenticated? => false,
         :github?           => true,
+        :bitbucket?        => false,
         :to_web_uri        => Addressable::URI.parse("https://github.com/martinemde/gitable"),
       })
     end
+
+    describe_uri "ssh://git@bitbucket.org/martinemde/gitable.git" do
+      it { expect(subject.to_s).to eq(@uri) }
+      it { expect("#{subject}").to eq(@uri) }
+      it { expect(subject.inspect).to match(%r|^#<Gitable::URI #{@uri}>$|) }
+      it { expect(subject).to be_equivalent(@uri) }
+      it { expect(subject).to be_equivalent('git://bitbucket.org/martinemde/gitable.git') }
+      it { expect(subject).to be_equivalent('git@bitbucket.org:martinemde/gitable.git') }
+      it { expect(subject).to be_equivalent('git@bitbucket.org:/martinemde/gitable.git') }
+      it { expect(subject).to be_equivalent('https://martinemde@bitbucket.org/martinemde/gitable.git') }
+      it { expect(subject).to_not be_equivalent('git@othergit.com:martinemde/gitable.git') }
+      it { expect(subject).to_not be_equivalent('git@bitbucket.org:martinemde/not_gitable.git') }
+      it_sets({
+        :scheme            => "ssh",
+        :user              => "git",
+        :password          => nil,
+        :host              => "bitbucket.org",
+        :port              => nil,
+        :path              => "/martinemde/gitable.git",
+        :fragment          => nil,
+        :basename          => "gitable.git",
+        :ssh?              => true,
+        :scp?              => false,
+        :authenticated?    => true,
+        :interactive_authenticated? => false,
+        :github?           => false,
+        :bitbucket?        => true,
+        :to_web_uri        => Addressable::URI.parse("https://bitbucket.org/martinemde/gitable"),
+      })
+    end
+
+    describe_uri "https://bitbucket.org/martinemde/gitable.git" do
+      it { expect(subject.to_s).to eq(@uri) }
+      it { expect("#{subject}").to eq(@uri) }
+      it { expect(subject.inspect).to match(%r|^#<Gitable::URI #{@uri}>$|) }
+      it { expect(subject).to be_equivalent(@uri) }
+      it { expect(subject).to be_equivalent('ssh://git@bitbucket.org/martinemde/gitable.git') }
+      it { expect(subject).to be_equivalent('git://bitbucket.org/martinemde/gitable.git') }
+      it { expect(subject).to be_equivalent('git@bitbucket.org:martinemde/gitable.git') }
+      it { expect(subject).to be_equivalent('git@bitbucket.org:/martinemde/gitable.git') }
+      it { expect(subject).to_not be_equivalent('git@othergit.com:martinemde/gitable.git') }
+      it { expect(subject).to_not be_equivalent('git@bitbucket.org:martinemde/not_gitable.git') }
+      it_sets({
+        :scheme            => "https",
+        :user              => nil,
+        :password          => nil,
+        :host              => "bitbucket.org",
+        :port              => nil,
+        :path              => "/martinemde/gitable.git",
+        :fragment          => nil,
+        :basename          => "gitable.git",
+        :ssh?              => false,
+        :scp?              => false,
+        :github?           => false,
+        :bitbucket?        => true,
+        :to_web_uri        => Addressable::URI.parse("https://bitbucket.org/martinemde/gitable"),
+      })
+    end
+
+    describe_uri "https://martinemde@bitbucket.org/martinemde/gitable.git" do
+      it { expect(subject.to_s).to eq(@uri) }
+      it { expect("#{subject}").to eq(@uri) }
+      it { expect(subject.inspect).to match(%r|^#<Gitable::URI #{@uri}>$|) }
+      it { expect(subject).to be_equivalent(@uri) }
+      it { expect(subject).to be_equivalent('ssh://git@bitbucket.org/martinemde/gitable.git') }
+      it { expect(subject).to be_equivalent('git://bitbucket.org/martinemde/gitable.git') }
+      it { expect(subject).to be_equivalent('git@bitbucket.org:martinemde/gitable.git') }
+      it { expect(subject).to be_equivalent('git@bitbucket.org:/martinemde/gitable.git') }
+      it { expect(subject).to be_equivalent('https://bitbucket.org/martinemde/gitable.git') }
+      it { expect(subject).to_not be_equivalent('git@othergit.com:martinemde/gitable.git') }
+      it { expect(subject).to_not be_equivalent('git@bitbucket.org:martinemde/not_gitable.git') }
+      it_sets({
+        :scheme            => "https",
+        :user              => "martinemde",
+        :password          => nil,
+        :host              => "bitbucket.org",
+        :port              => nil,
+        :path              => "/martinemde/gitable.git",
+        :fragment          => nil,
+        :basename          => "gitable.git",
+        :ssh?              => false,
+        :scp?              => false,
+        :github?           => false,
+        :bitbucket?        => true,
+        :authenticated?    => true,
+        :interactive_authenticated? => true,
+        :to_web_uri        => Addressable::URI.parse("https://bitbucket.org/martinemde/gitable"),
+      })
+    end
+
+    describe_uri "git://bitbucket.org/martinemde/gitable.git" do
+      it { expect(subject.to_s).to eq(@uri) }
+      it { expect("#{subject}").to eq(@uri) }
+      it { expect(subject.inspect).to match(%r|^#<Gitable::URI #{@uri}>$|) }
+      it { expect(subject).to be_equivalent(@uri) }
+      it { expect(subject).to be_equivalent('ssh://git@bitbucket.org/martinemde/gitable.git') }
+      it { expect(subject).to be_equivalent('git@bitbucket.org:martinemde/gitable.git') }
+      it { expect(subject).to be_equivalent('git@bitbucket.org:/martinemde/gitable.git') }
+      it { expect(subject).to be_equivalent('https://martinemde@bitbucket.org/martinemde/gitable.git') }
+      it { expect(subject).to_not be_equivalent('git@othergit.com:martinemde/gitable.git') }
+      it { expect(subject).to_not be_equivalent('git@bitbucket.org:martinemde/not_gitable.git') }
+      it_sets({
+        :scheme            => "git",
+        :user              => nil,
+        :password          => nil,
+        :host              => "bitbucket.org",
+        :port              => nil,
+        :path              => "/martinemde/gitable.git",
+        :fragment          => nil,
+        :basename          => "gitable.git",
+        :ssh?              => false,
+        :scp?              => false,
+        :github?           => false,
+        :bitbucket?        => true,
+        :authenticated?    => false,
+        :interactive_authenticated? => false,
+        :to_web_uri        => Addressable::URI.parse("https://bitbucket.org/martinemde/gitable"),
+      })
+    end
+
+    describe_uri "git@bitbucket.org:martinemde/gitable.git" do
+      it { expect(subject.to_s).to eq(@uri) }
+      it { expect("#{subject}").to eq(@uri) }
+      it { expect(subject.inspect).to match(%r|^#<Gitable::ScpURI #{@uri}>$|) }
+      it { expect(subject).to be_equivalent(@uri) }
+      it { expect(subject).to be_equivalent('ssh://git@bitbucket.org/martinemde/gitable.git') }
+      it { expect(subject).to be_equivalent('git://bitbucket.org/martinemde/gitable.git') }
+      it { expect(subject).to be_equivalent('https://martinemde@bitbucket.org/martinemde/gitable.git') }
+      it { expect(subject).to_not be_equivalent('git@othergit.com:martinemde/gitable.git') }
+      it { expect(subject).to_not be_equivalent('git@bitbucket.org:martinemde/not_gitable.git') }
+      it_sets({
+        :scheme            => nil,
+        :inferred_scheme   => 'ssh',
+        :user              => "git",
+        :password          => nil,
+        :host              => "bitbucket.org",
+        :port              => nil,
+        :path              => "martinemde/gitable.git",
+        :fragment          => nil,
+        :basename          => "gitable.git",
+        :project_name      => "gitable",
+        :ssh?              => true,
+        :scp?              => true,
+        :authenticated?    => true,
+        :interactive_authenticated? => false,
+        :github?           => false,
+        :bitbucket?        => true,
+        :to_web_uri        => Addressable::URI.parse("https://bitbucket.org/martinemde/gitable"),
+      })
+    end
   end
 end

metadata

@@ -1,87 +1,93 @@
 --- !ruby/object:Gem::Specification
 name: gitable
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.4.0
 platform: ruby
 authors:
 - Martin Emde
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-08-20 00:00:00.000000000 Z
+date: 2016-12-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+    - - ">="
       - !ruby/object:Gem::Version
         version: 2.2.7
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+    - - ">="
       - !ruby/object:Gem::Version
         version: 2.2.7
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.11'
+        version: '3.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.11'
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: Addressable::URI for Git URIs with special handling for scp-style URIs
-  that Addressable doesn't like.
+description: Addressable::URI for Git "URIs" with special handling for scp-style remotes
+  that Addressable intentionally doesn't parse.
 email:
 - martin.emde@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files:
 - LICENSE
-- README.rdoc
+- README.md
 files:
-- .document
-- .gitignore
-- .travis.yml
+- ".document"
+- ".gitignore"
+- ".travis.yml"
 - Gemfile
 - LICENSE
-- README.rdoc
+- README.md
 - Rakefile
 - gitable.gemspec
 - lib/gitable.rb
@@ -101,20 +107,20 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.6
+rubygems_version: 2.5.2
 signing_key: 
 specification_version: 4
-summary: Addressable::URI for Git. Gitable::URI.
+summary: Addressable::URI with additional support for Git "URIs"
 test_files:
 - spec/describe_uri.rb
 - spec/gitable_spec.rb

data/README.rdoc

@@ -1,82 +0,0 @@
-= Gitable
-
-== Addressable::URI for Git.
-
-Works with any valid Git URI, because Addressable doesn't.
-
-== Example!?
-
-    require 'gitable/uri'
-    uri = Gitable::URI.parse('git@github.com:martinemde/gitable.git')
-
-    uri.path   # => 'martinemde/gitable.git'
-    uri.user   # => 'git'
-    uri.host   # => 'github.com'
-
-Maintain the same url format.
-
-    uri.to_s   # => 'git@github.com:martinemde/gitable.git'
-
-Uses ssh?
-
-    uri.ssh?   # => true
-
-SCP format?
-
-    uri.scp?   # => true
-
-If it can't guess the name, you named your repository wrong.
-
-    uri.project_name   # => 'gitable'
-
-Will this uri require authentication?
-
-    uri.authenticated? # => true
-
-Will I have to interactively type something into git (a password)?
-
-    uri.interactive_authenticated? # => false
-
-Matching public to private git uris?
-
-    uri.equivalent?('git://github.com/martinemde/gitable.git') # => true
-    uri.equivalent?('https://martinemde@github.com/martinemde/gitable.git') # => true
-
-Link to the web page for a project (github)
-
-    if uri.github?
-      uri.to_web_uri # => <Addressable::URI https://github.com/martinemde/gitable>
-    end
-
-Inherited from Addressable::URI
-
-    uri.kind_of?(Addressable::URI)   # => true
-
-Teenage Mutant Ninja Urls (mutable uris like Addressable, if you want)
-
-    uri.path = 'someotheruser/gitable.git'
-    uri.basename = 'umm.git'
-    uri.to_s    # => 'git@github.com:someotheruser/umm.git'
-
-== heuristic_parse
-
-You can use Gitable::URI.heuristic_parse to take user input.
-
-Currently this supports the mistake of copying the url bar instead of the git
-uri for a few of the popular git webhosts. It also runs through Addressable's
-heuristic_parse so it will correct some poorly typed URIs.
-
-    uri = Gitable::URI.heuristic_parse('http://github.com:martinemde/gitable')
-    uri.to_s   # => 'git://github.com/martinemde/gitable.git'
-
-heuristic_parse is currently very limited. If the url doesn't end in .git, it
-switches http:// to git:// and adds .git to the basename.
-This works fine for github.com and gitorious.org but will happily screw up other URIs.
-
-== That's it?
-
-Yep. What else did you expect? (let me know or write a patch)
-
-== Copyright
-
-Copyright (c) 2010 Martin Emde. See LICENSE for details.