Class: Decode::Languages

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

Overview

A context for looking up languages based on file extension or name.

Constant Summary collapse

REFERENCE = 
/\A(?<name>[a-z]+)?\s+(?<identifier>.*?)\z/

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize ⇒ Languages

Returns a new instance of Languages.



33
34
35
36
 
# File 'lib/decode/languages.rb', line 33

def initialize
	@named = {}
	@extensions = {}
end

Class Method Details

.all ⇒ Object 



27
28
29
30
31
 
# File 'lib/decode/languages.rb', line 27

def self.all
	self.new.tap do |languages|
		languages.add(Language::Ruby)
	end
end

Instance Method Details

#add(language) ⇒ Object 



47
48
49
50
51
52
53
54
55
 
# File 'lib/decode/languages.rb', line 47

def add(language)
	language.names.each do |name|
		@named[name] = language
	end
	
	language.extensions.each do |extension|
		@extensions[extension] = language
	end
end

#fetch(name) ⇒ Object 



57
58
59
60
61
62
63
 
# File 'lib/decode/languages.rb', line 57

def fetch(name)
	@named.fetch(name) do
		unless @named.frozen?
			@named[name] = Language::Generic.new(name)
		end
	end
end

#freeze ⇒ Object 



38
39
40
41
42
43
44
45
 
# File 'lib/decode/languages.rb', line 38

def freeze
	return unless frozen?
	
	@named.freeze
	@extensions.freeze
	
	super
end

#parse_reference(text, default_language: nil) ⇒ Object

Parse a language agnostic reference: e.g. ‘ruby MyModule::MyClass`



78
79
80
81
82
83
84
85
86
 
# File 'lib/decode/languages.rb', line 78

def parse_reference(text, default_language: nil)
	if match = REFERENCE.match(text)
		language = self.fetch(match[:name]) || default_language
		
		return language.reference_for(match[:identifier])
	elsif default_language
		return default_language.reference_for(text)
	end
end

#reference_for(name, identifier) ⇒ Object 



88
89
90
 
# File 'lib/decode/languages.rb', line 88

def reference_for(name, identifier)
	self.fetch(name).reference_for(identifier)
end

#source_for(path) ⇒ Object 



65
66
67
68
69
70
71
 
# File 'lib/decode/languages.rb', line 65

def source_for(path)
	extension = File.extname(path)
	
	if language = @extensions[extension]
		Source.new(path, language)
	end
end