Class: Toys::SourceInfo

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

Overview

Information about source toys directories and files.

Instance Attribute Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#context_directory ⇒ String? (readonly)

The context directory path (normally the directory containing the toplevel toys file or directory).

Returns:

  • (String) —

    The context directory path.

  • (nil) —

    if there is no context directory (perhaps because the tool is being defined from a block)



41
42
43
 
# File 'lib/toys/source_info.rb', line 41

def context_directory
  @context_directory
end

#parent ⇒ Toys::SourceInfo? (readonly)

The parent of this SourceInfo.

Returns:



31
32
33
 
# File 'lib/toys/source_info.rb', line 31

def parent
  @parent
end

#source ⇒ String, Proc (readonly)

The source, which may be a path or a proc.

Returns:

  • (String) —

    Path to the source file or directory.

  • (Proc) —

    The block serving as the source.



49
50
51
 
# File 'lib/toys/source_info.rb', line 49

def source
  @source
end

#source_name ⇒ String (readonly) Also known as: to_s

The user-visible name of this source.

Returns:

  • (String) 


79
80
81
 
# File 'lib/toys/source_info.rb', line 79

def source_name
  @source_name
end

#source_path ⇒ String? (readonly)

The path of the current source file or directory.

Returns:

  • (String) —

    The source path

  • (nil) —

    if this source has no file system path.



64
65
66
 
# File 'lib/toys/source_info.rb', line 64

def source_path
  @source_path
end

#source_proc ⇒ Proc? (readonly)

The source proc.

Returns:

  • (Proc) —

    The source proc

  • (nil) —

    if this source has no proc.



72
73
74
 
# File 'lib/toys/source_info.rb', line 72

def source_proc
  @source_proc
end

#source_type ⇒ :file, ... (readonly)

Return the type of source.

Returns:

  • (:file, :directory, :proc) 


56
57
58
 
# File 'lib/toys/source_info.rb', line 56

def source_type
  @source_type
end

Instance Method Details

#apply_lib_paths ⇒ self

Apply all lib paths in order from high to low priority

Returns:

  • (self) 


111
112
113
114
115
 
# File 'lib/toys/source_info.rb', line 111

def apply_lib_paths
  parent&.apply_lib_paths
  $LOAD_PATH.unshift(@lib_dir) if @lib_dir && !$LOAD_PATH.include?(@lib_dir)
  self
end

#find_data(path, type: nil) ⇒ String?

Locate the given data file or directory and return an absolute path.

Parameters:

  • path (String) —

    The relative path to find

  • type (nil, :file, :directory) (defaults to: nil) —

    Type of file system object to find, or nil (the default) to return any type.

Returns:

  • (String) —

    Absolute path of the resulting data.

  • (nil) —

    if the data was not found.



91
92
93
94
95
96
97
98
99
100
101
102
103
104
 
# File 'lib/toys/source_info.rb', line 91

def find_data(path, type: nil)
  if @data_dir
    full_path = ::File.join(@data_dir, path)
    case type
    when :file
      return full_path if ::File.file?(full_path)
    when :directory
      return full_path if ::File.directory?(full_path)
    else
      return full_path if ::File.readable?(full_path)
    end
  end
  parent&.find_data(path, type: type)
end