Module: Bundler::FriendlyErrors

Defined in:
lib/bundler/friendly_errors.rb

Class Method Summary collapse

Class Method Details

.exit_status(error) ⇒ Object


44
45
46
47
48
49
50
51
# File 'lib/bundler/friendly_errors.rb', line 44

def exit_status(error)
  case error
  when BundlerError then error.status_code
  when Thor::Error then 15
  when SystemExit then error.status
  else 1
  end
end

.issues_url(exception) ⇒ Object


107
108
109
110
111
112
113
# File 'lib/bundler/friendly_errors.rb', line 107

def issues_url(exception)
  message = exception.message.lines.first.tr(":", " ").chomp
  message = message.split("-").first if exception.is_a?(Errno)
  require "cgi"
  "https://github.com/rubygems/bundler/search?q=" \
    "#{CGI.escape(message)}&type=Issues"
end

.log_error(error) ⇒ Object


9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
# File 'lib/bundler/friendly_errors.rb', line 9

def log_error(error)
  case error
  when YamlSyntaxError
    Bundler.ui.error error.message
    Bundler.ui.trace error.orig_exception
  when Dsl::DSLError, GemspecError
    Bundler.ui.error error.message
  when GemRequireError
    Bundler.ui.error error.message
    Bundler.ui.trace error.orig_exception
  when BundlerError
    Bundler.ui.error error.message, :wrap => true
    Bundler.ui.trace error
  when Thor::Error
    Bundler.ui.error error.message
  when LoadError
    raise error unless error.message =~ /cannot load such file -- openssl|openssl.so|libcrypto.so/
    Bundler.ui.error "\nCould not load OpenSSL. #{error.class}: #{error}\n#{error.backtrace.join("\n  ")}"
  when Interrupt
    Bundler.ui.error "\nQuitting..."
    Bundler.ui.trace error
  when Gem::InvalidSpecificationException
    Bundler.ui.error error.message, :wrap => true
  when SystemExit
  when *[defined?(Java::JavaLang::OutOfMemoryError) && Java::JavaLang::OutOfMemoryError].compact
    Bundler.ui.error "\nYour JVM has run out of memory, and Bundler cannot continue. " \
      "You can decrease the amount of memory Bundler needs by removing gems from your Gemfile, " \
      "especially large gems. (Gems can be as large as hundreds of megabytes, and Bundler has to read those files!). " \
      "Alternatively, you can increase the amount of memory the JVM is able to use by running Bundler with jruby -J-Xmx1024m -S bundle (JRuby defaults to 500MB)."
  else request_issue_report_for(error)
  end
rescue StandardError
  raise error
end

.request_issue_report_for(e) ⇒ Object


53
54
55
56
57
58
59
60
61
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
93
94
95
96
97
98
99
100
101
102
103
104
105
# File 'lib/bundler/friendly_errors.rb', line 53

def request_issue_report_for(e)
  Bundler.ui.info <<-EOS.gsub(/^ {8}/, "")
    --- ERROR REPORT TEMPLATE -------------------------------------------------------
    # Error Report

    ## Questions

    Please fill out answers to these questions, it'll help us figure out
    why things are going wrong.

    - **What did you do?**

      I ran the command `#{$PROGRAM_NAME} #{ARGV.join(" ")}`

    - **What did you expect to happen?**

      I expected Bundler to...

    - **What happened instead?**

      Instead, what happened was...

    - **Have you tried any solutions posted on similar issues in our issue tracker, stack overflow, or google?**

      I tried...

    - **Have you read our issues document, https://github.com/rubygems/bundler/blob/master/doc/contributing/ISSUES.md?**

      ...

    ## Backtrace

    ```
    #{e.class}: #{e.message}
      #{e.backtrace && e.backtrace.join("\n          ").chomp}
    ```

    #{Bundler::Env.report}
    --- TEMPLATE END ----------------------------------------------------------------

  EOS

  Bundler.ui.error "Unfortunately, an unexpected error occurred, and Bundler cannot continue."

  Bundler.ui.warn <<-EOS.gsub(/^ {8}/, "")

    First, try this link to see if there are any existing issue reports for this error:
    #{issues_url(e)}

    If there aren't any reports for this error yet, please create copy and paste the report template above into a new issue. Don't forget to anonymize any private data! The new issue form is located at:
    https://github.com/rubygems/bundler/issues/new
  EOS
end