uri-urn 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 05fa7804f659ad3fc76e295280e767621645071f
+  data.tar.gz: 81eaffaa1a1e5c6f707fcb3903c824e10f1277f5
+SHA512:
+  metadata.gz: a42f90f530ad629031815c8c4fea7ec97c7205a99e536a82968074feac84e2d4d199261bf7c4beddb4968ed061d1540fa9a91436177e078760d702491fbae4e1
+  data.tar.gz: 7efb31337c70e1b03ba47176278d2ad228ba3fde0b4c3ea921367ddaa75d0851415a1502263142fff07be7b6fd1e3651bb7a5e61ca39e2f3578d6ab853c6b833

data/BSDL

@@ -0,0 +1,22 @@
+Copyright (C) 2014 KITAITI Makoto. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+1. Redistributions of source code must retain the above copyright
+notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright
+notice, this list of conditions and the following disclaimer in the
+documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGE.

data/CHANGELOG.markdown

@@ -0,0 +1,7 @@
+URI::URN Changelog
+==================
+
+0.0.1
+-----
+
+* Initial release

data/COPYING

@@ -0,0 +1,56 @@
+Ruby is copyrighted free software by KITAITI Makoto <KitaitiMakoto@gmail.com>.
+You can redistribute it and/or modify it under either the terms of the
+2-clause BSDL (see the file BSDL), or the conditions below:
+
+  1. You may make and give away verbatim copies of the source form of the
+     software without restriction, provided that you duplicate all of the
+     original copyright notices and associated disclaimers.
+
+  2. You may modify your copy of the software in any way, provided that
+     you do at least ONE of the following:
+
+       a) place your modifications in the Public Domain or otherwise
+          make them Freely Available, such as by posting said
+	  modifications to Usenet or an equivalent medium, or by allowing
+	  the author to include your modifications in the software.
+
+       b) use the modified software only within your corporation or
+          organization.
+
+       c) give non-standard binaries non-standard names, with
+          instructions on where to get the original software distribution.
+
+       d) make other distribution arrangements with the author.
+
+  3. You may distribute the software in object code or binary form,
+     provided that you do at least ONE of the following:
+
+       a) distribute the binaries and library files of the software,
+	  together with instructions (in the manual page or equivalent)
+	  on where to get the original distribution.
+
+       b) accompany the distribution with the machine-readable source of
+	  the software.
+
+       c) give non-standard binaries non-standard names, with
+          instructions on where to get the original software distribution.
+
+       d) make other distribution arrangements with the author.
+
+  4. You may modify and include the part of the software into any other
+     software (possibly commercial).  But some files in the distribution
+     are not written by the author, so that they are not under these terms.
+
+     For the list of those files and their copying conditions, see the
+     file LEGAL.
+
+  5. The scripts and library files supplied as input to or produced as 
+     output from the software do not automatically fall under the
+     copyright of the software, but belong to whomever generated them, 
+     and may be sold commercially, and may be aggregated with this
+     software.
+
+  6. THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+     IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+     WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+     PURPOSE.

data/README.markdown

@@ -0,0 +1,67 @@
+URI::URN
+========
+
+This library adds URN scheme support for standard bundled URI library described in [RFC 4122][rfc4122].
+
+Installation
+------------
+
+Install it yourself as:
+
+    $ gem install uri-urn
+
+Or add this line to your application's Gemfile:
+
+    gem 'uri-urn'
+
+And then execute:
+
+    $ bundle
+
+Usage
+-----
+
+For known Namespace IDs such as UUID, URI parses and returns URNs of them.
+
+    urn = URI.parse('urn:uuid:01787092-e668-4234-bde9-15444f9c5560')
+    urn.class # => URI::URN::UUID
+    urn.scheme # => "urn"
+    urn.nid # => "uuid"
+    urn.nss # => "01787092-e668-4234-bde9-15444f9c5560"
+
+For unknown Namespace URN, returns URI::URN::Generic object.
+
+    URI.parse('urn:dummy:specific-string') # => #<URI::URN::Generic:0x007f3028cc3c10 URL:urn:dummy:specific-string>
+
+### Supported Namespaces
+
+Currently supported:
+
+* UUID
+
+### Adding Namespaces
+
+Define subclass of `URI::URN::Generic` and register it:
+
+    module URI::URN
+      class IETF < Generic
+        # subclass definition here...
+      end
+
+      @@nids['IETF'] = IETF
+    end
+
+Now you can parse IETF URN URI as `URI::URN::IETF`:
+
+    URI.parse('urn:ietf:rfc:4122') # => #<URI::URN::IETF:0x007f6226e02470 URL:urn:ietf:rfc:4122>
+
+Contributing
+------------
+
+1. Clone it ( https://gitorious.org/uri-ext/uri-urn/clone )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Merge Request
+
+[rfc4122]: http://www.ietf.org/rfc/rfc4122.txt

data/Rakefile

@@ -0,0 +1,18 @@
+require 'rake/testtask'
+require 'rdoc/task'
+require 'rubygems/tasks'
+
+task :default => :test
+
+GEMSPEC = Gem::Specification.load(File.join(__dir__, 'uri-urn.gemspec'))
+
+Rake::TestTask.new do |task|
+  task.test_files = GEMSPEC.test_files
+end
+
+RDoc::Task.new do |task|
+  task.rdoc_files.include GEMSPEC.require_paths.inject([]) {|files, dir| files + Dir.glob("#{dir}/**/*.rb")}, GEMSPEC.extra_rdoc_files
+  task.main = 'README.markdown'
+end
+
+Gem::Tasks.new

data/lib/uri/urn.rb

@@ -0,0 +1,123 @@
+require 'uri/generic'
+
+module URI
+  module URN
+    COMPONENT = [:scheme, :nid, :nss]
+
+    def self.component
+      COMPONENT
+    end
+
+    def self.new(*arg)
+      nid = (md = arg[6].match(Generic::URN_REGEXP)) && md['nid']
+      @@nids[nid.to_s.upcase].new(*arg)
+    end
+
+    def self.build(args)
+      tmp = Util.make_components_hash(self, args)
+      @@nids[tmp[:nid].to_s.upcase].build(tmp)
+    end
+
+    class Generic < Generic
+      COMPONENT = URN::COMPONENT
+
+      NID_PATTERN = '[\w\d][\w\d\-]{0,31}'.freeze
+      URN_CHARS_PATTERN = "[\\w\\d()+,\\-.:=@;$_!*%/?#]|#{URI::PATTERN::ESCAPED}".freeze
+      NSS_PATTERN = "(?:#{URN_CHARS_PATTERN})+".freeze
+      URN_REGEXP = Regexp.new("\\A(?<nid>#{NID_PATTERN}):(?<nss>#{NSS_PATTERN})\\z").freeze
+
+      attr_reader :nid, :nss
+
+      def self.build(args)
+        nid = self.to_s.sub(/\A.*::/, '').downcase
+        unless nid == 'generic'
+          if args.kind_of?(Array)
+            args = [nid] + args
+          elsif args.kind_of?(Hash)
+            args[:nid] = nid
+          end
+        end
+        tmp = Util.make_components_hash(self, args)
+        tmp[:scheme] = 'urn'
+        tmp[:opaque] = "%{nid}:%{nss}" % tmp
+
+        return super(tmp)
+      end
+
+      def initialize(*arg)
+        super(*arg)
+        if arg[-1]
+          self.opaque = @opaque
+        end
+      end
+
+      def nid=(value)
+        check_nid(value)
+        set_nid(value)
+        value
+      end
+
+      def nss=(value)
+        check_nss(value)
+        set_nss(value)
+        value
+      end
+
+      def opaque=(value)
+        check_opaque(value)
+
+        if URN_REGEXP =~ value
+          self.nid = $~['nid']
+          self.nss = $~['nss']
+        else
+          raise InvalidURIError, "bad URI(nid nor nss not set?): #{self}"
+        end
+
+        set_opaque(value)
+        value
+      end
+
+      def normalize!
+        super
+        set_nid(self.nid.downcase)
+      end
+
+      protected
+
+      def set_nid(nid)
+        @nid = nid
+      end
+
+      def set_nss(nss)
+        @nss = nss
+      end
+
+      private
+
+      def check_nid(value)
+        if value !~ /\A#{NID_PATTERN}\z/o
+          raise InvalidComponentError, "bad component(expected nid component: #{value})"
+        end
+
+        return true
+      end
+
+      def check_nss(value)
+        if value !~ /\A#{self.class::NSS_PATTERN}\z/ # Do not set `o'(optimize) switch. This regepx may be overwritten at subclasses
+          raise InvalidComponentError, "bad component(expected nss component: #{value})"
+        end
+
+        return true
+      end
+    end
+
+    @@nids = Hash.new(URN::Generic)
+    def self.nid_list
+      @@nids
+    end
+  end
+
+  @@schemes['URN'] = URN
+end
+
+require 'uri/urn/uuid'

data/lib/uri/urn/uuid.rb

@@ -0,0 +1,28 @@
+require 'uri/urn'
+
+module URI
+  module URN
+    class UUID < Generic
+      NSS_PATTERN = "[#{PATTERN::HEX}]{8}-[#{PATTERN::HEX}]{4}-[#{PATTERN::HEX}]{4}-[#{PATTERN::HEX}]{4}-[#{PATTERN::HEX}]{12}".freeze
+
+      alias uuid nss
+
+      #
+      # Generate UUID and build URI::URN::UUID with it
+      #
+      # Currently only version 4 is supported
+      #
+      def self.generate
+        require 'securerandom' unless defined? SecureRandom
+        build(nss: SecureRandom.uuid)
+      end
+
+      def normalize!
+        super
+        set_nss(self.nss.downcase)
+      end
+    end
+
+    @@nids['UUID'] = UUID
+  end
+end

data/test/uri/test_urn.rb

@@ -0,0 +1,53 @@
+require 'test/unit'
+require 'uri/urn'
+
+module URI
+
+class TestURN < Test::Unit::TestCase
+  def setup
+    @uri_string = 'urn:nid:nss'
+    @uri = URI.parse(@uri_string)
+  end
+
+  def test_build
+    urn = nil
+    assert_nothing_raised do
+      urn = URI::URN.build(['nid', 'nss'])
+    end
+    assert_equal 'nid', urn.nid
+    assert_equal 'nss', urn.nss
+    assert_equal 'nid:nss', urn.opaque
+  end
+
+  def test_parse
+    assert_nothing_raised do
+      URI.parse @uri_string
+    end
+    [
+      'urn:',
+      'urn:sp ce'
+    ].each do |uri_string|
+      assert_raise InvalidURIError do
+        URI.parse uri_string
+      end
+    end
+  end
+
+  def test_component
+    assert_equal [:scheme, :nid, :nss], @uri.component
+  end
+
+  def test_components
+    assert_equal 'urn', @uri.scheme
+    assert_equal 'nid', @uri.nid
+    assert_equal 'nss', @uri.nss
+  end
+
+  def test_equal
+    assert_equal URI.parse('urn:nid:nss'), URI.parse('URN:NID:nss')
+
+    assert (URI.parse('urn:nid:nss') == URI.parse('URN:NID:nss'))
+  end
+end
+
+end

data/test/uri/urn/test_uuid.rb

@@ -0,0 +1,60 @@
+require 'test/unit'
+require 'uri/urn/uuid'
+
+module URI::URN
+
+class TestUUID < Test::Unit::TestCase
+  def setup
+    @uuid_string = '01787092-e668-4234-bde9-15444f9c5560'
+  end
+
+  def test_parse
+    uri = URI.parse("urn:uuid:#{@uuid_string}")
+    assert_instance_of UUID, uri
+    assert_raise URI::InvalidURIError do
+      URI.parse 'urn:uuid:'
+    end
+    assert_raise URI::InvalidComponentError do
+      URI.parse 'urn:uuid:hello'
+    end
+  end
+
+  def test_build
+    uri = nil
+    assert_nothing_raised do
+      uri = URI::URN::UUID.build([@uuid_string])
+    end
+    assert_equal 'urn', uri.scheme
+    assert_equal 'uuid', uri.nid
+    assert_equal @uuid_string, uri.uuid
+
+    assert_nothing_raised do
+      uri = URI::URN::UUID.build(nid: 'dummy', nss: @uuid_string)
+    end
+    assert_equal 'urn', uri.scheme
+    assert_equal 'uuid', uri.nid
+    assert_equal @uuid_string, uri.nss
+
+    assert_raise URI::InvalidComponentError do
+      URI::URN::UUID.build(['hello'])
+    end
+  end
+
+  def test_equal
+    assert (URI.parse("urn:uuid:#{@uuid_string}") == URI.parse("urn:uuid:#{@uuid_string}".upcase))
+  end
+
+  def test_components
+    uri = URI.parse("urn:uuid:#{@uuid_string}")
+    assert_equal "uuid:#{@uuid_string}", uri.opaque
+  end
+
+  def test_generate
+    uri = UUID.generate
+    assert_equal 'urn', uri.scheme
+    assert_equal 'uuid', uri.nid
+    assert_match /\A#{UUID::NSS_PATTERN}\z/, uri.uuid
+  end
+end
+
+end

data/uri-urn.gemspec

@@ -0,0 +1,22 @@
+Gem::Specification.new do |spec|
+  spec.name          = "uri-urn"
+  spec.version       = '0.0.1'
+  spec.authors       = ["KITAITI Makoto"]
+  spec.email         = ["KitaitiMakoto@gmail.com"]
+  spec.summary       = %q{Adds URN Scheme support to URI lib.}
+  spec.description   = %q{This library adds URN scheme support for standard bundled URI library described in RFC 4122.}
+  spec.homepage      = 'https://gitorious.org/uri-ext'
+  spec.license       = "Ruby"
+
+  spec.test_files    = Dir.glob('test/**/test_*.rb')
+  spec.require_paths = ["lib"]
+  spec.extra_rdoc_files = %w[README.markdown CHANGELOG.markdown COPYING BSDL]
+  spec.files = spec.require_paths.inject([]) {|files, dir|
+                 files + Dir.glob("#{dir}/**/*.rb")
+               } +
+               spec.test_files +
+               spec.extra_rdoc_files +
+               %w[uri-urn.gemspec Rakefile]
+
+  spec.add_development_dependency 'rubygems-tasks'
+end

metadata

@@ -0,0 +1,75 @@
+--- !ruby/object:Gem::Specification
+name: uri-urn
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- KITAITI Makoto
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-06-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rubygems-tasks
+  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: This library adds URN scheme support for standard bundled URI library
+  described in RFC 4122.
+email:
+- KitaitiMakoto@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.markdown
+- CHANGELOG.markdown
+- COPYING
+- BSDL
+files:
+- BSDL
+- CHANGELOG.markdown
+- COPYING
+- README.markdown
+- Rakefile
+- lib/uri/urn.rb
+- lib/uri/urn/uuid.rb
+- test/uri/test_urn.rb
+- test/uri/urn/test_uuid.rb
+- uri-urn.gemspec
+homepage: https://gitorious.org/uri-ext
+licenses:
+- Ruby
+metadata: {}
+post_install_message: 
+rdoc_options: []
+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.2.2
+signing_key: 
+specification_version: 4
+summary: Adds URN Scheme support to URI lib.
+test_files:
+- test/uri/test_urn.rb
+- test/uri/urn/test_uuid.rb