Exception: Pod::DSLError

Inherits:
Informative show all
Defined in:
lib/cocoapods-core/standard_error.rb

Overview

Wraps an exception raised by a DSL file in order to show to the user the contents of the line that raised the exception.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(description, dsl_path, underlying_exception, contents = nil) ⇒ DSLError

Returns a new instance of DSLError.

Parameters:

  • underlying_exception (Exception) —

    @see underlying_exception

  • dsl_path (String) —

    @see dsl_path

[View source]

28
29
30
31
32
33
 
# File 'lib/cocoapods-core/standard_error.rb', line 28

def initialize(description, dsl_path, underlying_exception, contents = nil)
  @description          = description
  @dsl_path             = dsl_path
  @underlying_exception = underlying_exception
  @contents             = contents
end

Instance Attribute Details

#description ⇒ String (readonly)

Returns the description that should be presented to the user.

Returns:

  • (String) —

    the description that should be presented to the user.


14
15
16
 
# File 'lib/cocoapods-core/standard_error.rb', line 14

def description
  @description
end

#dsl_path ⇒ String (readonly)

Returns the path of the dsl file that raised the exception.

Returns:

  • (String) —

    the path of the dsl file that raised the exception.


18
19
20
 
# File 'lib/cocoapods-core/standard_error.rb', line 18

def dsl_path
  @dsl_path
end

#underlying_exception ⇒ Exception (readonly)

Returns the exception raised by the evaluation of the dsl file.

Returns:

  • (Exception) —

    the exception raised by the evaluation of the dsl file.


23
24
25
 
# File 'lib/cocoapods-core/standard_error.rb', line 23

def underlying_exception
  @underlying_exception
end

Instance Method Details

#contents ⇒ String

Returns the contents of the DSL that cause the exception to be raised.

Returns:

  • (String) —

    the contents of the DSL that cause the exception to be raised.

[View source]

38
39
40
41
42
 
# File 'lib/cocoapods-core/standard_error.rb', line 38

def contents
  @contents ||= begin
    dsl_path && File.exist?(dsl_path) && File.read(dsl_path)
  end
end

#message ⇒ String

The message of the exception reports the content of podspec for the line that generated the original exception.

Examples:

Output


Invalid podspec at `RestKit.podspec` - undefined method
`exclude_header_search_paths=' for #<Pod::Specification for
`RestKit/Network (0.9.3)`>

    from spec-repos/master/RestKit/0.9.3/RestKit.podspec:36
    -------------------------------------------
        # because it would break: #import <CoreData/CoreData.h>
 >      ns.exclude_header_search_paths = 'Code/RestKit.h'
      end
    -------------------------------------------

Returns:

  • (String) —

    the message of the exception.

[View source]

62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
 
# File 'lib/cocoapods-core/standard_error.rb', line 62

def message
  @message ||= begin
    trace_line, description = parse_line_number_from_description

    m = "\n[!] #{description}.\n"
    m = m.red if m.respond_to?(:red)

    backtrace = underlying_exception.backtrace
    return m unless backtrace && dsl_path && contents

    trace_line = backtrace.find { |l| l.include?(dsl_path.to_s) } || trace_line
    return m unless trace_line
    line_numer = trace_line.split(':')[1].to_i - 1
    return m unless line_numer

    lines      = contents.lines
    indent     = ' #  '
    indicator  = indent.tr('#', '>')
    first_line = (line_numer.zero?)
    last_line  = (line_numer == (lines.count - 1))

    m << "\n"
    m << "#{indent}from #{trace_line.gsub(/:in.*$/, '')}\n"
    m << "#{indent}-------------------------------------------\n"
    m << "#{indent}#{lines[line_numer - 1]}" unless first_line
    m << "#{indicator}#{lines[line_numer]}"
    m << "#{indent}#{lines[line_numer + 1]}" unless last_line
    m << "\n" unless m.end_with?("\n")
    m << "#{indent}-------------------------------------------\n"
  end
end