Class: Decode::Language::Reference

Inherits:
Object
  • Object
show all
Defined in:
lib/decode/language/reference.rb

Overview

An reference which can be resolved to zero or more definitions.

Direct Known Subclasses

Decode::Language::Ruby::Reference

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(identifier, language) ⇒ Reference

Initialize the reference.



27
28
29
30
31
32
33
 
# File 'lib/decode/language/reference.rb', line 27

def initialize(identifier, language)
	@identifier = identifier
	@language = language
	
	@lexical_path = nil
	@path = nil
end

Instance Attribute Details

#identifier ⇒ Object (readonly)

The identifier part of the reference.



45
46
47
 
# File 'lib/decode/language/reference.rb', line 45

def identifier
  @identifier
end

#language ⇒ Object (readonly)

The language associated with this reference.



49
50
51
 
# File 'lib/decode/language/reference.rb', line 49

def language
  @language
end

Instance Method Details

#absolute? ⇒ Boolean

Whether the reference starts at the base of the lexical tree.

Returns:

  • (Boolean) 


52
53
54
 
# File 'lib/decode/language/reference.rb', line 52

def absolute?
	!self.relative?
end

#best(definitions) ⇒ Object 



70
71
72
73
74
75
76
77
78
 
# File 'lib/decode/language/reference.rb', line 70

def best(definitions)
	prefix, name = lexical_path.last
	
	definitions.select do |definition|
		definition.language == @language && (
			prefix.nil? || definition.start_with?(prefix)
		)
	end
end

#inspect ⇒ Object 



39
40
41
 
# File 'lib/decode/language/reference.rb', line 39

def inspect
	"\#<#{self.class} {#{self.identifier}}>"
end

#lexical_path ⇒ Object 



66
67
68
 
# File 'lib/decode/language/reference.rb', line 66

def lexical_path
	@lexical_path ||= self.split(@identifier)
end

#path ⇒ Object

The lexical path of the reference.



82
83
84
 
# File 'lib/decode/language/reference.rb', line 82

def path
	@path ||= self.lexical_path.map{|_, name| name.to_sym}
end

#relative? ⇒ Boolean

Returns:

  • (Boolean) 


56
57
58
59
60
 
# File 'lib/decode/language/reference.rb', line 56

def relative?
	prefix, name = self.lexical_path.first
	
	return prefix.nil?
end

#split(identifier) ⇒ Object 



62
63
64
 
# File 'lib/decode/language/reference.rb', line 62

def split(identifier)
	identifier.scan(/(\W+)?(\w+)/)
end

#to_s ⇒ Object 



35
36
37
 
# File 'lib/decode/language/reference.rb', line 35

def to_s
	"{#{self.language} #{self.identifier}}"
end