Class: URN

Inherits:
Object
  • Object
show all
Defined in:
lib/urn.rb

Constant Summary collapse

InvalidURNError = 
Class.new(StandardError)
PATTERN = 
%{(?i:urn:(?!urn:)[a-z0-9][a-z0-9\-]{1,31}:} +
%{(?:[a-z0-9()+,-.:=@;$_!*']|%(?:2[1-9a-f]|[3-6][0-9a-f]|7[0-9a-e]))+)}.freeze
REGEX = 
/\A#{PATTERN}\z/

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(urn) ⇒ URN

Returns a new instance of URN.



19
20
21
22
23
24
25
 
# File 'lib/urn.rb', line 19

def initialize(urn)
  urn = urn.to_s
  fail InvalidURNError, "bad URN(is not URN?): #{urn}" if urn !~ REGEX

  @urn = urn
  _scheme, @nid, @nss = urn.split(':', 3)
end

Instance Attribute Details

#nid ⇒ Object (readonly)

Returns the value of attribute nid.



12
13
14
 
# File 'lib/urn.rb', line 12

def nid
  @nid
end

#nss ⇒ Object (readonly)

Returns the value of attribute nss.



12
13
14
 
# File 'lib/urn.rb', line 12

def nss
  @nss
end

Class Method Details

.extract(str, &blk) ⇒ Object 



15
16
17
 
# File 'lib/urn.rb', line 15

def self.extract(str, &blk)
  str.scan(/#{PATTERN}/, &blk)
end

Instance Method Details

#==(other) ⇒ Object 



52
53
54
55
56
 
# File 'lib/urn.rb', line 52

def ==(other)
  return false unless other.is_a?(URN)

  normalize.to_s == other.normalize.to_s
end

#===(other) ⇒ Object 



38
39
40
41
42
43
44
45
46
47
48
49
50
 
# File 'lib/urn.rb', line 38

def ===(other)
  if other.respond_to?(:normalize)
    urn_string = other.normalize.to_s
  else
    begin
      urn_string = URN.new(other).normalize.to_s
    rescue URN::InvalidURNError
      return false
    end
  end

  normalize.to_s == urn_string
end

#eql?(other) ⇒ Boolean

Returns:

  • (Boolean) 


58
59
60
61
62
 
# File 'lib/urn.rb', line 58

def eql?(other)
  return false unless other.is_a?(URN)

  to_s == other.to_s
end

#normalize ⇒ Object 



27
28
29
30
31
32
 
# File 'lib/urn.rb', line 27

def normalize
  normalized_nid = nid.downcase
  normalized_nss = nss.gsub(/%([0-9a-f]{2})/i) { |hex| hex.downcase }

  URN.new("urn:#{normalized_nid}:#{normalized_nss}")
end

#to_s ⇒ Object 



34
35
36
 
# File 'lib/urn.rb', line 34

def to_s
  urn
end