aboutsummaryrefslogtreecommitdiffstats
path: root/contrib/tools/cython/Cython/Compiler/Errors.py
blob: 82fe19a0e76e0ed045cfc047052a15f643d39ed0 (plain) (blame)
1
2
3
4
5
6
7
8
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
43
44
45
46
47
48
49
50
51
52
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
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
# 
#   Errors 
# 
 
from __future__ import absolute_import 
 
try:
    from __builtin__ import basestring as any_string_type
except ImportError:
    any_string_type = (bytes, str)

import sys 
from contextlib import contextmanager
 
from ..Utils import open_new_file 
from . import DebugFlags 
from . import Options 
 
 
class PyrexError(Exception): 
    pass 
 
 
class PyrexWarning(Exception): 
    pass 
 
 
def context(position): 
    source = position[0] 
    assert not (isinstance(source, any_string_type)), (
        "Please replace filename strings with Scanning.FileSourceDescriptor instances %r" % source) 
    try: 
        F = source.get_lines() 
    except UnicodeDecodeError: 
        # file has an encoding problem 
        s = u"[unprintable code]\n" 
    else: 
        s = u''.join(F[max(0, position[1]-6):position[1]]) 
        s = u'...\n%s%s^\n' % (s, u' '*(position[2]-1)) 
    s = u'%s\n%s%s\n' % (u'-'*60, s, u'-'*60) 
    return s 
 
def format_position(position): 
    if position: 
        return u"%s:%d:%d: " % (position[0].get_error_description(), 
                                position[1], position[2]) 
    return u'' 
 
def format_error(message, position): 
    if position: 
        pos_str = format_position(position) 
        cont = context(position) 
        message = u'\nError compiling Cython file:\n%s\n%s%s' % (cont, pos_str, message or u'') 
    return message 
 
class CompileError(PyrexError): 
 
    def __init__(self, position = None, message = u""): 
        self.position = position 
        self.message_only = message 
        self.formatted_message = format_error(message, position) 
        self.reported = False 
    # Deprecated and withdrawn in 2.6: 
    #   self.message = message 
        Exception.__init__(self, self.formatted_message) 
        # Python Exception subclass pickling is broken, 
        # see http://bugs.python.org/issue1692335 
        self.args = (position, message) 
 
    def __str__(self): 
        return self.formatted_message 
 
class CompileWarning(PyrexWarning): 
 
    def __init__(self, position = None, message = ""): 
        self.position = position 
    # Deprecated and withdrawn in 2.6: 
    #   self.message = message 
        Exception.__init__(self, format_position(position) + message) 
 
class InternalError(Exception): 
    # If this is ever raised, there is a bug in the compiler. 
 
    def __init__(self, message): 
        self.message_only = message 
        Exception.__init__(self, u"Internal compiler error: %s" 
            % message) 
 
class AbortError(Exception): 
    # Throw this to stop the compilation immediately. 
 
    def __init__(self, message): 
        self.message_only = message 
        Exception.__init__(self, u"Abort error: %s" % message) 
 
class CompilerCrash(CompileError): 
    # raised when an unexpected exception occurs in a transform 
    def __init__(self, pos, context, message, cause, stacktrace=None): 
        if message: 
            message = u'\n' + message 
        else: 
            message = u'\n' 
        self.message_only = message 
        if context: 
            message = u"Compiler crash in %s%s" % (context, message) 
        if stacktrace: 
            import traceback 
            message += ( 
                u'\n\nCompiler crash traceback from this point on:\n' + 
                u''.join(traceback.format_tb(stacktrace))) 
        if cause: 
            if not stacktrace: 
                message += u'\n' 
            message += u'%s: %s' % (cause.__class__.__name__, cause) 
        CompileError.__init__(self, pos, message) 
        # Python Exception subclass pickling is broken, 
        # see http://bugs.python.org/issue1692335 
        self.args = (pos, context, message, cause, stacktrace) 
 
class NoElementTreeInstalledException(PyrexError): 
    """raised when the user enabled options.gdb_debug but no ElementTree 
    implementation was found 
    """ 
 
listing_file = None 
num_errors = 0 
echo_file = None 
 
def open_listing_file(path, echo_to_stderr = 1): 
    # Begin a new error listing. If path is None, no file 
    # is opened, the error counter is just reset. 
    global listing_file, num_errors, echo_file 
    if path is not None: 
        listing_file = open_new_file(path) 
    else: 
        listing_file = None 
    if echo_to_stderr: 
        echo_file = sys.stderr 
    else: 
        echo_file = None 
    num_errors = 0 
 
def close_listing_file(): 
    global listing_file 
    if listing_file: 
        listing_file.close() 
        listing_file = None 
 
def report_error(err, use_stack=True):
    if error_stack and use_stack:
        error_stack[-1].append(err) 
    else: 
        global num_errors 
        # See Main.py for why dual reporting occurs. Quick fix for now. 
        if err.reported: return 
        err.reported = True 
        try: line = u"%s\n" % err 
        except UnicodeEncodeError: 
            # Python <= 2.5 does this for non-ASCII Unicode exceptions 
            line = format_error(getattr(err, 'message_only', "[unprintable exception message]"), 
                                getattr(err, 'position', None)) + u'\n' 
        if listing_file: 
            try: listing_file.write(line) 
            except UnicodeEncodeError: 
                listing_file.write(line.encode('ASCII', 'replace')) 
        if echo_file: 
            try: echo_file.write(line) 
            except UnicodeEncodeError: 
                echo_file.write(line.encode('ASCII', 'replace')) 
        num_errors += 1 
        if Options.fast_fail: 
            raise AbortError("fatal errors") 
 
 
def error(position, message): 
    #print("Errors.error:", repr(position), repr(message)) ###
    if position is None: 
        raise InternalError(message) 
    err = CompileError(position, message) 
    if DebugFlags.debug_exception_on_error: raise Exception(err) # debug 
    report_error(err) 
    return err 
 
 
LEVEL = 1 # warn about all errors level 1 or higher 
 
 
def message(position, message, level=1): 
    if level < LEVEL: 
        return 
    warn = CompileWarning(position, message) 
    line = "note: %s\n" % warn 
    if listing_file: 
        listing_file.write(line) 
    if echo_file: 
        echo_file.write(line) 
    return warn 
 
 
def warning(position, message, level=0): 
    if level < LEVEL: 
        return 
    if Options.warning_errors and position: 
        return error(position, message) 
    warn = CompileWarning(position, message) 
    line = "warning: %s\n" % warn 
    if listing_file: 
        listing_file.write(line) 
    if echo_file: 
        echo_file.write(line) 
    return warn 
 
 
_warn_once_seen = {} 
def warn_once(position, message, level=0): 
    if level < LEVEL or message in _warn_once_seen: 
        return 
    warn = CompileWarning(position, message) 
    line = "warning: %s\n" % warn 
    if listing_file: 
        listing_file.write(line) 
    if echo_file: 
        echo_file.write(line) 
    _warn_once_seen[message] = True 
    return warn 
 
 
# These functions can be used to momentarily suppress errors. 
 
error_stack = [] 
 

def hold_errors(): 
    error_stack.append([]) 
 

def release_errors(ignore=False): 
    held_errors = error_stack.pop() 
    if not ignore: 
        for err in held_errors: 
            report_error(err) 
 

def held_errors(): 
    return error_stack[-1] 
 
 
# same as context manager:

@contextmanager
def local_errors(ignore=False):
    errors = []
    error_stack.append(errors)
    try:
        yield errors
    finally:
        release_errors(ignore=ignore)


# this module needs a redesign to support parallel cythonisation, but 
# for now, the following works at least in sequential compiler runs 
 
def reset(): 
    _warn_once_seen.clear() 
    del error_stack[:]