Class: Solargraph::Workspace::Config

Inherits:
Object
  • Object
show all
Defined in:
lib/solargraph/workspace/config.rb

Overview

Configuration data for a workspace.

Constant Summary collapse

MAX_FILES =

The maximum number of files that can be added to a workspace. The workspace’s .solargraph.yml can override this value.

5000

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(directory = '') ⇒ Config

Returns a new instance of Config.

Parameters:

  • directory (String) (defaults to: '') 


22
23
24
25
26
27
 
# File 'lib/solargraph/workspace/config.rb', line 22

def initialize directory = ''
  @directory = File.absolute_path(directory)
  @raw_data = config_data
  included
  excluded
end

Instance Attribute Details

#directory ⇒ String (readonly)

Returns:

  • (String) 


15
16
17
 
# File 'lib/solargraph/workspace/config.rb', line 15

def directory
  @directory
end

#raw_data ⇒ Hash{String => Array, Hash, Integer, nil} (readonly)

TODO:

To make this strongly typed we’ll need a record syntax

Returns:

  • (Hash{String => Array, Hash, Integer, nil}) 


19
20
21
 
# File 'lib/solargraph/workspace/config.rb', line 19

def raw_data
  @raw_data
end

Instance Method Details

#allow?(filename) ⇒ Boolean

Parameters:

  • filename (String)

Returns:

  • (Boolean) 


46
47
48
49
50
51
 
# File 'lib/solargraph/workspace/config.rb', line 46

def allow? filename
  filename = File.absolute_path(filename, directory)
  filename.start_with?(directory) &&
    !excluded.include?(filename) &&
    excluded_directories.none? { |d| filename.start_with?(d) }
end

#calculated ⇒ Array<String>

The calculated array of (included - excluded) files in the workspace.

Returns:

  • (Array<String>) 


56
57
58
59
 
# File 'lib/solargraph/workspace/config.rb', line 56

def calculated
  Solargraph.logger.info "Indexing workspace files in #{directory}" unless @calculated || directory.empty? || directory == '*'
  @calculated ||= included - excluded
end

#domains ⇒ Array<String>

An array of domains configured for the workspace. A domain is a namespace that the ApiMap should include in the global namespace. It’s typically used to identify available DSLs.

Returns:

  • (Array<String>) 


66
67
68
 
# File 'lib/solargraph/workspace/config.rb', line 66

def domains
  raw_data['domains']
end

#excluded ⇒ Array<String>

An array of files excluded from the workspace.

Returns:

  • (Array<String>) 


40
41
42
43
 
# File 'lib/solargraph/workspace/config.rb', line 40

def excluded
  return [] if directory.empty? || directory == '*'
  @excluded ||= process_exclusions(@raw_data['exclude'])
end

#formatter ⇒ Hash

A hash of options supported by the formatter

Returns:

  • (Hash) 


94
95
96
 
# File 'lib/solargraph/workspace/config.rb', line 94

def formatter
  raw_data['formatter']
end

#included ⇒ Array<String>

An array of files included in the workspace (before calculating excluded files).

Returns:

  • (Array<String>) 


32
33
34
35
 
# File 'lib/solargraph/workspace/config.rb', line 32

def included
  return [] if directory.empty? || directory == '*'
  @included ||= process_globs(@raw_data['include'])
end

#max_files ⇒ Integer

The maximum number of files to parse from the workspace.

Returns:

  • (Integer) 


108
109
110
 
# File 'lib/solargraph/workspace/config.rb', line 108

def max_files
  raw_data['max_files']
end

#plugins ⇒ Array<String>

An array of plugins to require.

Returns:

  • (Array<String>) 


101
102
103
 
# File 'lib/solargraph/workspace/config.rb', line 101

def plugins
  raw_data['plugins']
end

#reporters ⇒ Array<String>

An array of reporters to use for diagnostics.

Returns:

  • (Array<String>) 


87
88
89
 
# File 'lib/solargraph/workspace/config.rb', line 87

def reporters
  raw_data['reporters']
end

#require_paths ⇒ Array<String>

An array of load paths for required paths.

Returns:

  • (Array<String>) 


80
81
82
 
# File 'lib/solargraph/workspace/config.rb', line 80

def require_paths
  raw_data['require_paths'] || []
end

#required ⇒ Array<String>

An array of required paths to add to the workspace.

Returns:

  • (Array<String>) 


73
74
75
 
# File 'lib/solargraph/workspace/config.rb', line 73

def required
  raw_data['require']
end