blob: 9017bb13e78dcdce0b7c61ed0bc2c4be63646567 [file] [log] [blame]
Guido van Rossumb51eaa11997-03-07 00:21:55 +00001"""Tokenization help for Python programs.
Guido van Rossum4d8e8591992-01-01 19:34:47 +00002
Florent Xicluna43e4ea12010-09-03 19:54:02 +00003tokenize(readline) is a generator that breaks a stream of bytes into
4Python tokens. It decodes the bytes according to PEP-0263 for
5determining source file encoding.
Trent Nelson428de652008-03-18 22:41:35 +00006
Florent Xicluna43e4ea12010-09-03 19:54:02 +00007It accepts a readline-like method which is called repeatedly to get the
8next line of input (or b"" for EOF). It generates 5-tuples with these
9members:
Tim Peters4efb6e92001-06-29 23:51:08 +000010
11 the token type (see token.py)
12 the token (a string)
13 the starting (row, column) indices of the token (a 2-tuple of ints)
14 the ending (row, column) indices of the token (a 2-tuple of ints)
15 the original line (string)
16
17It is designed to match the working of the Python tokenizer exactly, except
18that it produces COMMENT tokens for comments and gives type OP for all
Florent Xicluna43e4ea12010-09-03 19:54:02 +000019operators. Additionally, all token lists start with an ENCODING token
20which tells you which encoding was used to decode the bytes stream.
21"""
Guido van Rossumb51eaa11997-03-07 00:21:55 +000022
Ka-Ping Yee244c5932001-03-01 13:56:40 +000023__author__ = 'Ka-Ping Yee <ping@lfw.org>'
Trent Nelson428de652008-03-18 22:41:35 +000024__credits__ = ('GvR, ESR, Tim Peters, Thomas Wouters, Fred Drake, '
25 'Skip Montanaro, Raymond Hettinger, Trent Nelson, '
26 'Michael Foord')
Serhiy Storchakacf4a2f22015-03-11 17:18:03 +020027from builtins import open as _builtin_open
Benjamin Peterson433f32c2008-12-12 01:25:05 +000028from codecs import lookup, BOM_UTF8
Raymond Hettinger3fb79c72010-09-09 07:15:18 +000029import collections
Victor Stinner58c07522010-11-09 01:08:59 +000030from io import TextIOWrapper
Terry Jan Reedy5b8d2c32014-02-17 23:12:16 -050031from itertools import chain
Eric V. Smith1c8222c2015-10-26 04:37:55 -040032import itertools as _itertools
Terry Jan Reedy5b8d2c32014-02-17 23:12:16 -050033import re
34import sys
35from token import *
36
Serhiy Storchakae431d3c2016-03-20 23:36:29 +020037cookie_re = re.compile(r'^[ \t\f]*#.*?coding[:=][ \t]*([-\w.]+)', re.ASCII)
Serhiy Storchaka768c16c2014-01-09 18:36:09 +020038blank_re = re.compile(br'^[ \t\f]*(?:[#\r\n]|$)', re.ASCII)
Guido van Rossum4d8e8591992-01-01 19:34:47 +000039
Skip Montanaro40fc1602001-03-01 04:27:19 +000040import token
Alexander Belopolskyb9d10d02010-11-11 14:07:41 +000041__all__ = token.__all__ + ["COMMENT", "tokenize", "detect_encoding",
42 "NL", "untokenize", "ENCODING", "TokenInfo"]
Skip Montanaro40fc1602001-03-01 04:27:19 +000043del token
44
Guido van Rossum1aec3231997-04-08 14:24:39 +000045COMMENT = N_TOKENS
46tok_name[COMMENT] = 'COMMENT'
Guido van Rossuma90c78b1998-04-03 16:05:38 +000047NL = N_TOKENS + 1
48tok_name[NL] = 'NL'
Trent Nelson428de652008-03-18 22:41:35 +000049ENCODING = N_TOKENS + 2
50tok_name[ENCODING] = 'ENCODING'
51N_TOKENS += 3
Meador Inge00c7f852012-01-19 00:44:45 -060052EXACT_TOKEN_TYPES = {
53 '(': LPAR,
54 ')': RPAR,
55 '[': LSQB,
56 ']': RSQB,
57 ':': COLON,
58 ',': COMMA,
59 ';': SEMI,
60 '+': PLUS,
61 '-': MINUS,
62 '*': STAR,
63 '/': SLASH,
64 '|': VBAR,
65 '&': AMPER,
66 '<': LESS,
67 '>': GREATER,
68 '=': EQUAL,
69 '.': DOT,
70 '%': PERCENT,
71 '{': LBRACE,
72 '}': RBRACE,
73 '==': EQEQUAL,
74 '!=': NOTEQUAL,
75 '<=': LESSEQUAL,
76 '>=': GREATEREQUAL,
77 '~': TILDE,
78 '^': CIRCUMFLEX,
79 '<<': LEFTSHIFT,
80 '>>': RIGHTSHIFT,
81 '**': DOUBLESTAR,
82 '+=': PLUSEQUAL,
83 '-=': MINEQUAL,
84 '*=': STAREQUAL,
85 '/=': SLASHEQUAL,
86 '%=': PERCENTEQUAL,
87 '&=': AMPEREQUAL,
88 '|=': VBAREQUAL,
Jim Fasarakis-Hilliardd4914e92017-03-14 22:16:15 +020089 '^=': CIRCUMFLEXEQUAL,
Meador Inge00c7f852012-01-19 00:44:45 -060090 '<<=': LEFTSHIFTEQUAL,
91 '>>=': RIGHTSHIFTEQUAL,
92 '**=': DOUBLESTAREQUAL,
93 '//': DOUBLESLASH,
94 '//=': DOUBLESLASHEQUAL,
Jim Fasarakis-Hilliardd4914e92017-03-14 22:16:15 +020095 '...': ELLIPSIS,
96 '->': RARROW,
Benjamin Petersond51374e2014-04-09 23:55:56 -040097 '@': AT,
98 '@=': ATEQUAL,
Meador Inge00c7f852012-01-19 00:44:45 -060099}
Guido van Rossum1aec3231997-04-08 14:24:39 +0000100
Raymond Hettinger3fb79c72010-09-09 07:15:18 +0000101class TokenInfo(collections.namedtuple('TokenInfo', 'type string start end line')):
Raymond Hettingeraa17a7f2009-04-29 14:21:25 +0000102 def __repr__(self):
Raymond Hettingera0e79402010-09-09 08:29:05 +0000103 annotated_type = '%d (%s)' % (self.type, tok_name[self.type])
104 return ('TokenInfo(type=%s, string=%r, start=%r, end=%r, line=%r)' %
105 self._replace(type=annotated_type))
Raymond Hettingeraa17a7f2009-04-29 14:21:25 +0000106
Meador Inge00c7f852012-01-19 00:44:45 -0600107 @property
108 def exact_type(self):
109 if self.type == OP and self.string in EXACT_TOKEN_TYPES:
110 return EXACT_TOKEN_TYPES[self.string]
111 else:
112 return self.type
113
Eric S. Raymondb08b2d32001-02-09 11:10:16 +0000114def group(*choices): return '(' + '|'.join(choices) + ')'
Guido van Rossum68468eb2003-02-27 20:14:51 +0000115def any(*choices): return group(*choices) + '*'
116def maybe(*choices): return group(*choices) + '?'
Guido van Rossum4d8e8591992-01-01 19:34:47 +0000117
Antoine Pitroufd036452008-08-19 17:56:33 +0000118# Note: we use unicode matching for names ("\w") but ascii matching for
119# number literals.
Guido van Rossum3b631771997-10-27 20:44:15 +0000120Whitespace = r'[ \f\t]*'
121Comment = r'#[^\r\n]*'
122Ignore = Whitespace + any(r'\\\r?\n' + Whitespace) + maybe(Comment)
Benjamin Peterson33856de2010-08-30 14:41:20 +0000123Name = r'\w+'
Guido van Rossum4d8e8591992-01-01 19:34:47 +0000124
Brett Cannona721aba2016-09-09 14:57:09 -0700125Hexnumber = r'0[xX](?:_?[0-9a-fA-F])+'
126Binnumber = r'0[bB](?:_?[01])+'
127Octnumber = r'0[oO](?:_?[0-7])+'
128Decnumber = r'(?:0(?:_?0)*|[1-9](?:_?[0-9])*)'
Guido van Rossumcd16bf62007-06-13 18:07:49 +0000129Intnumber = group(Hexnumber, Binnumber, Octnumber, Decnumber)
Brett Cannona721aba2016-09-09 14:57:09 -0700130Exponent = r'[eE][-+]?[0-9](?:_?[0-9])*'
131Pointfloat = group(r'[0-9](?:_?[0-9])*\.(?:[0-9](?:_?[0-9])*)?',
132 r'\.[0-9](?:_?[0-9])*') + maybe(Exponent)
133Expfloat = r'[0-9](?:_?[0-9])*' + Exponent
Guido van Rossum1aec3231997-04-08 14:24:39 +0000134Floatnumber = group(Pointfloat, Expfloat)
Brett Cannona721aba2016-09-09 14:57:09 -0700135Imagnumber = group(r'[0-9](?:_?[0-9])*[jJ]', Floatnumber + r'[jJ]')
Guido van Rossum1aec3231997-04-08 14:24:39 +0000136Number = group(Imagnumber, Floatnumber, Intnumber)
Guido van Rossum4d8e8591992-01-01 19:34:47 +0000137
Eric V. Smith1c8222c2015-10-26 04:37:55 -0400138# Return the empty string, plus all of the valid string prefixes.
139def _all_string_prefixes():
140 # The valid string prefixes. Only contain the lower case versions,
141 # and don't contain any permuations (include 'fr', but not
142 # 'rf'). The various permutations will be generated.
143 _valid_string_prefixes = ['b', 'r', 'u', 'f', 'br', 'fr']
144 # if we add binary f-strings, add: ['fb', 'fbr']
Jon Dufresne39726282017-05-18 07:35:54 -0700145 result = {''}
Eric V. Smith1c8222c2015-10-26 04:37:55 -0400146 for prefix in _valid_string_prefixes:
147 for t in _itertools.permutations(prefix):
148 # create a list with upper and lower versions of each
149 # character
150 for u in _itertools.product(*[(c, c.upper()) for c in t]):
151 result.add(''.join(u))
152 return result
153
154def _compile(expr):
155 return re.compile(expr, re.UNICODE)
156
157# Note that since _all_string_prefixes includes the empty string,
158# StringPrefix can be the empty string (making it optional).
159StringPrefix = group(*_all_string_prefixes())
Armin Ronacherc0eaeca2012-03-04 13:07:57 +0000160
Tim Petersde495832000-10-07 05:09:39 +0000161# Tail end of ' string.
162Single = r"[^'\\]*(?:\\.[^'\\]*)*'"
163# Tail end of " string.
164Double = r'[^"\\]*(?:\\.[^"\\]*)*"'
165# Tail end of ''' string.
166Single3 = r"[^'\\]*(?:(?:\\.|'(?!''))[^'\\]*)*'''"
167# Tail end of """ string.
168Double3 = r'[^"\\]*(?:(?:\\.|"(?!""))[^"\\]*)*"""'
Armin Ronacherc0eaeca2012-03-04 13:07:57 +0000169Triple = group(StringPrefix + "'''", StringPrefix + '"""')
Tim Petersde495832000-10-07 05:09:39 +0000170# Single-line ' or " string.
Armin Ronacherc0eaeca2012-03-04 13:07:57 +0000171String = group(StringPrefix + r"'[^\n'\\]*(?:\\.[^\n'\\]*)*'",
172 StringPrefix + r'"[^\n"\\]*(?:\\.[^\n"\\]*)*"')
Guido van Rossum4d8e8591992-01-01 19:34:47 +0000173
Tim Petersde495832000-10-07 05:09:39 +0000174# Because of leftmost-then-longest match semantics, be sure to put the
175# longest operators first (e.g., if = came before ==, == would get
176# recognized as two instances of =).
Guido van Rossumb053cd82006-08-24 03:53:23 +0000177Operator = group(r"\*\*=?", r">>=?", r"<<=?", r"!=",
Neal Norwitzc1505362006-12-28 06:47:50 +0000178 r"//=?", r"->",
Benjamin Petersond51374e2014-04-09 23:55:56 -0400179 r"[+\-*/%&@|^=<>]=?",
Tim Petersde495832000-10-07 05:09:39 +0000180 r"~")
Thomas Wouterse1519a12000-08-24 21:44:52 +0000181
Guido van Rossum4d8e8591992-01-01 19:34:47 +0000182Bracket = '[][(){}]'
Georg Brandldde00282007-03-18 19:01:53 +0000183Special = group(r'\r?\n', r'\.\.\.', r'[:;.,@]')
Guido van Rossumfc6f5331997-03-07 00:21:12 +0000184Funny = group(Operator, Bracket, Special)
Guido van Rossum4d8e8591992-01-01 19:34:47 +0000185
Guido van Rossum3b631771997-10-27 20:44:15 +0000186PlainToken = group(Number, Funny, String, Name)
Guido van Rossumfc6f5331997-03-07 00:21:12 +0000187Token = Ignore + PlainToken
Guido van Rossum4d8e8591992-01-01 19:34:47 +0000188
Tim Petersde495832000-10-07 05:09:39 +0000189# First (or only) line of ' or " string.
Armin Ronacherc0eaeca2012-03-04 13:07:57 +0000190ContStr = group(StringPrefix + r"'[^\n'\\]*(?:\\.[^\n'\\]*)*" +
Ka-Ping Yee1ff08b12001-01-15 22:04:30 +0000191 group("'", r'\\\r?\n'),
Armin Ronacherc0eaeca2012-03-04 13:07:57 +0000192 StringPrefix + r'"[^\n"\\]*(?:\\.[^\n"\\]*)*' +
Ka-Ping Yee1ff08b12001-01-15 22:04:30 +0000193 group('"', r'\\\r?\n'))
Ezio Melotti2cc3b4b2012-11-03 17:38:43 +0200194PseudoExtras = group(r'\\\r?\n|\Z', Comment, Triple)
Guido van Rossum3b631771997-10-27 20:44:15 +0000195PseudoToken = Whitespace + group(PseudoExtras, Number, Funny, ContStr, Name)
Guido van Rossum1aec3231997-04-08 14:24:39 +0000196
Eric V. Smith1c8222c2015-10-26 04:37:55 -0400197# For a given string prefix plus quotes, endpats maps it to a regex
198# to match the remainder of that string. _prefix can be empty, for
199# a normal single or triple quoted string (with no prefix).
200endpats = {}
201for _prefix in _all_string_prefixes():
202 endpats[_prefix + "'"] = Single
203 endpats[_prefix + '"'] = Double
204 endpats[_prefix + "'''"] = Single3
205 endpats[_prefix + '"""'] = Double3
Benjamin Peterson33856de2010-08-30 14:41:20 +0000206
Eric V. Smith1c8222c2015-10-26 04:37:55 -0400207# A set of all of the single and triple quoted string prefixes,
208# including the opening quotes.
209single_quoted = set()
210triple_quoted = set()
211for t in _all_string_prefixes():
212 for u in (t + '"', t + "'"):
213 single_quoted.add(u)
214 for u in (t + '"""', t + "'''"):
215 triple_quoted.add(u)
Guido van Rossum9d6897a2002-08-24 06:54:19 +0000216
Guido van Rossumfc6f5331997-03-07 00:21:12 +0000217tabsize = 8
Fred Drake9b8d8012000-08-17 04:45:13 +0000218
Ka-Ping Yee28c62bb2001-03-23 05:22:49 +0000219class TokenError(Exception): pass
220
221class StopTokenizing(Exception): pass
Fred Drake9b8d8012000-08-17 04:45:13 +0000222
Tim Peters5ca576e2001-06-18 22:08:13 +0000223
Thomas Wouters89f507f2006-12-13 04:49:30 +0000224class Untokenizer:
225
226 def __init__(self):
227 self.tokens = []
228 self.prev_row = 1
229 self.prev_col = 0
Trent Nelson428de652008-03-18 22:41:35 +0000230 self.encoding = None
Thomas Wouters89f507f2006-12-13 04:49:30 +0000231
232 def add_whitespace(self, start):
233 row, col = start
Terry Jan Reedy5e6db312014-02-17 16:45:48 -0500234 if row < self.prev_row or row == self.prev_row and col < self.prev_col:
235 raise ValueError("start ({},{}) precedes previous end ({},{})"
236 .format(row, col, self.prev_row, self.prev_col))
Terry Jan Reedy9dc3a362014-02-23 23:33:08 -0500237 row_offset = row - self.prev_row
Terry Jan Reedyf106f8f2014-02-23 23:39:57 -0500238 if row_offset:
Terry Jan Reedy9dc3a362014-02-23 23:33:08 -0500239 self.tokens.append("\\\n" * row_offset)
240 self.prev_col = 0
Thomas Wouters89f507f2006-12-13 04:49:30 +0000241 col_offset = col - self.prev_col
242 if col_offset:
243 self.tokens.append(" " * col_offset)
244
245 def untokenize(self, iterable):
Terry Jan Reedy5b8d2c32014-02-17 23:12:16 -0500246 it = iter(iterable)
Dingyuan Wange411b662015-06-22 10:01:12 +0800247 indents = []
248 startline = False
Terry Jan Reedy5b8d2c32014-02-17 23:12:16 -0500249 for t in it:
Thomas Wouters89f507f2006-12-13 04:49:30 +0000250 if len(t) == 2:
Terry Jan Reedy5b8d2c32014-02-17 23:12:16 -0500251 self.compat(t, it)
Thomas Wouters89f507f2006-12-13 04:49:30 +0000252 break
253 tok_type, token, start, end, line = t
Trent Nelson428de652008-03-18 22:41:35 +0000254 if tok_type == ENCODING:
255 self.encoding = token
256 continue
Terry Jan Reedy9dc3a362014-02-23 23:33:08 -0500257 if tok_type == ENDMARKER:
258 break
Dingyuan Wange411b662015-06-22 10:01:12 +0800259 if tok_type == INDENT:
260 indents.append(token)
261 continue
262 elif tok_type == DEDENT:
263 indents.pop()
264 self.prev_row, self.prev_col = end
265 continue
266 elif tok_type in (NEWLINE, NL):
267 startline = True
268 elif startline and indents:
269 indent = indents[-1]
270 if start[1] >= len(indent):
271 self.tokens.append(indent)
272 self.prev_col = len(indent)
273 startline = False
Thomas Wouters89f507f2006-12-13 04:49:30 +0000274 self.add_whitespace(start)
275 self.tokens.append(token)
276 self.prev_row, self.prev_col = end
277 if tok_type in (NEWLINE, NL):
278 self.prev_row += 1
279 self.prev_col = 0
280 return "".join(self.tokens)
281
282 def compat(self, token, iterable):
Thomas Wouters89f507f2006-12-13 04:49:30 +0000283 indents = []
284 toks_append = self.tokens.append
Terry Jan Reedy5b8d2c32014-02-17 23:12:16 -0500285 startline = token[0] in (NEWLINE, NL)
Christian Heimesba4af492008-03-28 00:55:15 +0000286 prevstring = False
Terry Jan Reedy5b8d2c32014-02-17 23:12:16 -0500287
288 for tok in chain([token], iterable):
Thomas Wouters89f507f2006-12-13 04:49:30 +0000289 toknum, tokval = tok[:2]
Trent Nelson428de652008-03-18 22:41:35 +0000290 if toknum == ENCODING:
291 self.encoding = tokval
292 continue
Thomas Wouters89f507f2006-12-13 04:49:30 +0000293
Yury Selivanov75445082015-05-11 22:57:16 -0400294 if toknum in (NAME, NUMBER, ASYNC, AWAIT):
Thomas Wouters89f507f2006-12-13 04:49:30 +0000295 tokval += ' '
296
Christian Heimesba4af492008-03-28 00:55:15 +0000297 # Insert a space between two consecutive strings
298 if toknum == STRING:
299 if prevstring:
300 tokval = ' ' + tokval
301 prevstring = True
302 else:
303 prevstring = False
304
Thomas Wouters89f507f2006-12-13 04:49:30 +0000305 if toknum == INDENT:
306 indents.append(tokval)
307 continue
308 elif toknum == DEDENT:
309 indents.pop()
310 continue
311 elif toknum in (NEWLINE, NL):
312 startline = True
313 elif startline and indents:
314 toks_append(indents[-1])
315 startline = False
316 toks_append(tokval)
Raymond Hettinger68c04532005-06-10 11:05:19 +0000317
Trent Nelson428de652008-03-18 22:41:35 +0000318
Raymond Hettinger68c04532005-06-10 11:05:19 +0000319def untokenize(iterable):
320 """Transform tokens back into Python source code.
Trent Nelson428de652008-03-18 22:41:35 +0000321 It returns a bytes object, encoded using the ENCODING
322 token, which is the first token sequence output by tokenize.
Raymond Hettinger68c04532005-06-10 11:05:19 +0000323
324 Each element returned by the iterable must be a token sequence
Thomas Wouters89f507f2006-12-13 04:49:30 +0000325 with at least two elements, a token number and token value. If
326 only two tokens are passed, the resulting output is poor.
Raymond Hettinger68c04532005-06-10 11:05:19 +0000327
Thomas Wouters89f507f2006-12-13 04:49:30 +0000328 Round-trip invariant for full input:
329 Untokenized source will match input source exactly
330
Berker Peksagff8d0872015-12-30 01:41:58 +0200331 Round-trip invariant for limited input:
332 # Output bytes will tokenize back to the input
Trent Nelson428de652008-03-18 22:41:35 +0000333 t1 = [tok[:2] for tok in tokenize(f.readline)]
Raymond Hettinger68c04532005-06-10 11:05:19 +0000334 newcode = untokenize(t1)
Trent Nelson428de652008-03-18 22:41:35 +0000335 readline = BytesIO(newcode).readline
336 t2 = [tok[:2] for tok in tokenize(readline)]
Raymond Hettinger68c04532005-06-10 11:05:19 +0000337 assert t1 == t2
338 """
Thomas Wouters89f507f2006-12-13 04:49:30 +0000339 ut = Untokenizer()
Trent Nelson428de652008-03-18 22:41:35 +0000340 out = ut.untokenize(iterable)
341 if ut.encoding is not None:
342 out = out.encode(ut.encoding)
343 return out
Raymond Hettinger68c04532005-06-10 11:05:19 +0000344
Trent Nelson428de652008-03-18 22:41:35 +0000345
Benjamin Petersond3afada2009-10-09 21:43:09 +0000346def _get_normal_name(orig_enc):
347 """Imitates get_normal_name in tokenizer.c."""
348 # Only care about the first 12 characters.
349 enc = orig_enc[:12].lower().replace("_", "-")
350 if enc == "utf-8" or enc.startswith("utf-8-"):
351 return "utf-8"
352 if enc in ("latin-1", "iso-8859-1", "iso-latin-1") or \
353 enc.startswith(("latin-1-", "iso-8859-1-", "iso-latin-1-")):
354 return "iso-8859-1"
355 return orig_enc
356
Trent Nelson428de652008-03-18 22:41:35 +0000357def detect_encoding(readline):
Raymond Hettingerd1fa3db2002-05-15 02:56:03 +0000358 """
Trent Nelson428de652008-03-18 22:41:35 +0000359 The detect_encoding() function is used to detect the encoding that should
Ezio Melotti4bcc7962013-11-25 05:14:51 +0200360 be used to decode a Python source file. It requires one argument, readline,
Trent Nelson428de652008-03-18 22:41:35 +0000361 in the same way as the tokenize() generator.
362
363 It will call readline a maximum of twice, and return the encoding used
Florent Xicluna43e4ea12010-09-03 19:54:02 +0000364 (as a string) and a list of any lines (left as bytes) it has read in.
Trent Nelson428de652008-03-18 22:41:35 +0000365
366 It detects the encoding from the presence of a utf-8 bom or an encoding
Florent Xicluna43e4ea12010-09-03 19:54:02 +0000367 cookie as specified in pep-0263. If both a bom and a cookie are present,
368 but disagree, a SyntaxError will be raised. If the encoding cookie is an
369 invalid charset, raise a SyntaxError. Note that if a utf-8 bom is found,
Benjamin Peterson689a5582010-03-18 22:29:52 +0000370 'utf-8-sig' is returned.
Trent Nelson428de652008-03-18 22:41:35 +0000371
372 If no encoding is specified, then the default of 'utf-8' will be returned.
373 """
Brett Cannonc33f3f22012-04-20 13:23:54 -0400374 try:
375 filename = readline.__self__.name
376 except AttributeError:
377 filename = None
Trent Nelson428de652008-03-18 22:41:35 +0000378 bom_found = False
379 encoding = None
Benjamin Peterson689a5582010-03-18 22:29:52 +0000380 default = 'utf-8'
Trent Nelson428de652008-03-18 22:41:35 +0000381 def read_or_stop():
382 try:
383 return readline()
384 except StopIteration:
385 return b''
386
387 def find_cookie(line):
388 try:
Martin v. Löwis63674f42012-04-20 14:36:47 +0200389 # Decode as UTF-8. Either the line is an encoding declaration,
390 # in which case it should be pure ASCII, or it must be UTF-8
391 # per default encoding.
392 line_string = line.decode('utf-8')
Trent Nelson428de652008-03-18 22:41:35 +0000393 except UnicodeDecodeError:
Brett Cannonc33f3f22012-04-20 13:23:54 -0400394 msg = "invalid or missing encoding declaration"
395 if filename is not None:
396 msg = '{} for {!r}'.format(msg, filename)
397 raise SyntaxError(msg)
Benjamin Peterson433f32c2008-12-12 01:25:05 +0000398
Serhiy Storchakadafea852013-09-16 23:51:56 +0300399 match = cookie_re.match(line_string)
400 if not match:
Benjamin Peterson433f32c2008-12-12 01:25:05 +0000401 return None
Serhiy Storchakadafea852013-09-16 23:51:56 +0300402 encoding = _get_normal_name(match.group(1))
Benjamin Peterson433f32c2008-12-12 01:25:05 +0000403 try:
404 codec = lookup(encoding)
405 except LookupError:
406 # This behaviour mimics the Python interpreter
Brett Cannonc33f3f22012-04-20 13:23:54 -0400407 if filename is None:
408 msg = "unknown encoding: " + encoding
409 else:
410 msg = "unknown encoding for {!r}: {}".format(filename,
411 encoding)
412 raise SyntaxError(msg)
Benjamin Peterson433f32c2008-12-12 01:25:05 +0000413
Benjamin Peterson1613ed82010-03-18 22:34:15 +0000414 if bom_found:
Florent Xicluna11f0b412012-07-07 12:13:35 +0200415 if encoding != 'utf-8':
Benjamin Peterson1613ed82010-03-18 22:34:15 +0000416 # This behaviour mimics the Python interpreter
Brett Cannonc33f3f22012-04-20 13:23:54 -0400417 if filename is None:
418 msg = 'encoding problem: utf-8'
419 else:
420 msg = 'encoding problem for {!r}: utf-8'.format(filename)
421 raise SyntaxError(msg)
Benjamin Peterson1613ed82010-03-18 22:34:15 +0000422 encoding += '-sig'
Benjamin Peterson433f32c2008-12-12 01:25:05 +0000423 return encoding
Trent Nelson428de652008-03-18 22:41:35 +0000424
425 first = read_or_stop()
Benjamin Peterson433f32c2008-12-12 01:25:05 +0000426 if first.startswith(BOM_UTF8):
Trent Nelson428de652008-03-18 22:41:35 +0000427 bom_found = True
428 first = first[3:]
Benjamin Peterson689a5582010-03-18 22:29:52 +0000429 default = 'utf-8-sig'
Trent Nelson428de652008-03-18 22:41:35 +0000430 if not first:
Benjamin Peterson689a5582010-03-18 22:29:52 +0000431 return default, []
Trent Nelson428de652008-03-18 22:41:35 +0000432
433 encoding = find_cookie(first)
434 if encoding:
435 return encoding, [first]
Serhiy Storchaka768c16c2014-01-09 18:36:09 +0200436 if not blank_re.match(first):
437 return default, [first]
Trent Nelson428de652008-03-18 22:41:35 +0000438
439 second = read_or_stop()
440 if not second:
Benjamin Peterson689a5582010-03-18 22:29:52 +0000441 return default, [first]
Trent Nelson428de652008-03-18 22:41:35 +0000442
443 encoding = find_cookie(second)
444 if encoding:
445 return encoding, [first, second]
446
Benjamin Peterson689a5582010-03-18 22:29:52 +0000447 return default, [first, second]
Trent Nelson428de652008-03-18 22:41:35 +0000448
449
Victor Stinner58c07522010-11-09 01:08:59 +0000450def open(filename):
451 """Open a file in read only mode using the encoding detected by
452 detect_encoding().
453 """
Victor Stinner96917502014-12-05 10:17:10 +0100454 buffer = _builtin_open(filename, 'rb')
Victor Stinner387729e2015-05-26 00:43:58 +0200455 try:
456 encoding, lines = detect_encoding(buffer.readline)
457 buffer.seek(0)
458 text = TextIOWrapper(buffer, encoding, line_buffering=True)
459 text.mode = 'r'
460 return text
461 except:
462 buffer.close()
463 raise
Victor Stinner58c07522010-11-09 01:08:59 +0000464
465
Trent Nelson428de652008-03-18 22:41:35 +0000466def tokenize(readline):
467 """
Berker Peksagff8d0872015-12-30 01:41:58 +0200468 The tokenize() generator requires one argument, readline, which
Raymond Hettingerd1fa3db2002-05-15 02:56:03 +0000469 must be a callable object which provides the same interface as the
Florent Xicluna43e4ea12010-09-03 19:54:02 +0000470 readline() method of built-in file objects. Each call to the function
Berker Peksagff8d0872015-12-30 01:41:58 +0200471 should return one line of input as bytes. Alternatively, readline
Raymond Hettinger68c04532005-06-10 11:05:19 +0000472 can be a callable function terminating with StopIteration:
Trent Nelson428de652008-03-18 22:41:35 +0000473 readline = open(myfile, 'rb').__next__ # Example of alternate readline
Tim Peters8ac14952002-05-23 15:15:30 +0000474
Raymond Hettingerd1fa3db2002-05-15 02:56:03 +0000475 The generator produces 5-tuples with these members: the token type; the
476 token string; a 2-tuple (srow, scol) of ints specifying the row and
477 column where the token begins in the source; a 2-tuple (erow, ecol) of
478 ints specifying the row and column where the token ends in the source;
Florent Xicluna43e4ea12010-09-03 19:54:02 +0000479 and the line on which the token was found. The line passed is the
Tim Peters8ac14952002-05-23 15:15:30 +0000480 logical line; continuation lines are included.
Trent Nelson428de652008-03-18 22:41:35 +0000481
482 The first token sequence will always be an ENCODING token
483 which tells you which encoding was used to decode the bytes stream.
Raymond Hettingerd1fa3db2002-05-15 02:56:03 +0000484 """
Benjamin Peterson21db77e2009-11-14 16:27:26 +0000485 # This import is here to avoid problems when the itertools module is not
486 # built yet and tokenize is imported.
Benjamin Peterson81dd8b92009-11-14 18:09:17 +0000487 from itertools import chain, repeat
Trent Nelson428de652008-03-18 22:41:35 +0000488 encoding, consumed = detect_encoding(readline)
Benjamin Peterson81dd8b92009-11-14 18:09:17 +0000489 rl_gen = iter(readline, b"")
490 empty = repeat(b"")
491 return _tokenize(chain(consumed, rl_gen, empty).__next__, encoding)
Trent Nelson428de652008-03-18 22:41:35 +0000492
493
494def _tokenize(readline, encoding):
Guido van Rossum1aec3231997-04-08 14:24:39 +0000495 lnum = parenlev = continued = 0
Benjamin Peterson33856de2010-08-30 14:41:20 +0000496 numchars = '0123456789'
Guido van Rossumde655271997-04-09 17:15:54 +0000497 contstr, needcont = '', 0
Guido van Rossuma90c78b1998-04-03 16:05:38 +0000498 contline = None
Guido van Rossumfc6f5331997-03-07 00:21:12 +0000499 indents = [0]
Guido van Rossum1aec3231997-04-08 14:24:39 +0000500
Yury Selivanov96ec9342015-07-23 15:01:58 +0300501 # 'stashed' and 'async_*' are used for async/await parsing
Yury Selivanov75445082015-05-11 22:57:16 -0400502 stashed = None
Yury Selivanov96ec9342015-07-23 15:01:58 +0300503 async_def = False
504 async_def_indent = 0
505 async_def_nl = False
Yury Selivanov75445082015-05-11 22:57:16 -0400506
Trent Nelson428de652008-03-18 22:41:35 +0000507 if encoding is not None:
Benjamin Peterson689a5582010-03-18 22:29:52 +0000508 if encoding == "utf-8-sig":
509 # BOM will already have been stripped.
510 encoding = "utf-8"
Raymond Hettingera48db392009-04-29 00:34:27 +0000511 yield TokenInfo(ENCODING, encoding, (0, 0), (0, 0), '')
Benjamin Peterson0fe14382008-06-05 23:07:42 +0000512 while True: # loop over lines in stream
Raymond Hettinger68c04532005-06-10 11:05:19 +0000513 try:
514 line = readline()
515 except StopIteration:
Trent Nelson428de652008-03-18 22:41:35 +0000516 line = b''
517
518 if encoding is not None:
519 line = line.decode(encoding)
Benjamin Petersona0dfa822009-11-13 02:25:08 +0000520 lnum += 1
Guido van Rossumfc6f5331997-03-07 00:21:12 +0000521 pos, max = 0, len(line)
522
523 if contstr: # continued string
Guido van Rossumde655271997-04-09 17:15:54 +0000524 if not line:
Collin Winterce36ad82007-08-30 01:19:48 +0000525 raise TokenError("EOF in multi-line string", strstart)
Guido van Rossum3b631771997-10-27 20:44:15 +0000526 endmatch = endprog.match(line)
527 if endmatch:
528 pos = end = endmatch.end(0)
Raymond Hettingera48db392009-04-29 00:34:27 +0000529 yield TokenInfo(STRING, contstr + line[:end],
Thomas Wouters89f507f2006-12-13 04:49:30 +0000530 strstart, (lnum, end), contline + line)
Guido van Rossumde655271997-04-09 17:15:54 +0000531 contstr, needcont = '', 0
Guido van Rossuma90c78b1998-04-03 16:05:38 +0000532 contline = None
Guido van Rossumde655271997-04-09 17:15:54 +0000533 elif needcont and line[-2:] != '\\\n' and line[-3:] != '\\\r\n':
Raymond Hettingera48db392009-04-29 00:34:27 +0000534 yield TokenInfo(ERRORTOKEN, contstr + line,
Guido van Rossuma90c78b1998-04-03 16:05:38 +0000535 strstart, (lnum, len(line)), contline)
Guido van Rossumfc6f5331997-03-07 00:21:12 +0000536 contstr = ''
Guido van Rossuma90c78b1998-04-03 16:05:38 +0000537 contline = None
Guido van Rossumde655271997-04-09 17:15:54 +0000538 continue
Guido van Rossumfc6f5331997-03-07 00:21:12 +0000539 else:
540 contstr = contstr + line
Guido van Rossuma90c78b1998-04-03 16:05:38 +0000541 contline = contline + line
Guido van Rossumfc6f5331997-03-07 00:21:12 +0000542 continue
543
Guido van Rossum1aec3231997-04-08 14:24:39 +0000544 elif parenlev == 0 and not continued: # new statement
Guido van Rossumfc6f5331997-03-07 00:21:12 +0000545 if not line: break
546 column = 0
Guido van Rossum1aec3231997-04-08 14:24:39 +0000547 while pos < max: # measure leading whitespace
Benjamin Petersona0dfa822009-11-13 02:25:08 +0000548 if line[pos] == ' ':
549 column += 1
550 elif line[pos] == '\t':
551 column = (column//tabsize + 1)*tabsize
552 elif line[pos] == '\f':
553 column = 0
554 else:
555 break
556 pos += 1
557 if pos == max:
558 break
Guido van Rossum1aec3231997-04-08 14:24:39 +0000559
560 if line[pos] in '#\r\n': # skip comments or blank lines
Thomas Wouters89f507f2006-12-13 04:49:30 +0000561 if line[pos] == '#':
562 comment_token = line[pos:].rstrip('\r\n')
Raymond Hettingera48db392009-04-29 00:34:27 +0000563 yield TokenInfo(COMMENT, comment_token,
Thomas Wouters89f507f2006-12-13 04:49:30 +0000564 (lnum, pos), (lnum, pos + len(comment_token)), line)
Albert-Jan Nijburgc471ca42017-05-24 12:31:57 +0100565 pos += len(comment_token)
566
567 yield TokenInfo(NL, line[pos:],
Guido van Rossum1aec3231997-04-08 14:24:39 +0000568 (lnum, pos), (lnum, len(line)), line)
569 continue
Guido van Rossumfc6f5331997-03-07 00:21:12 +0000570
571 if column > indents[-1]: # count indents or dedents
572 indents.append(column)
Raymond Hettingera48db392009-04-29 00:34:27 +0000573 yield TokenInfo(INDENT, line[:pos], (lnum, 0), (lnum, pos), line)
Guido van Rossumfc6f5331997-03-07 00:21:12 +0000574 while column < indents[-1]:
Raymond Hettingerda99d1c2005-06-21 07:43:58 +0000575 if column not in indents:
576 raise IndentationError(
Thomas Wouters00ee7ba2006-08-21 19:07:27 +0000577 "unindent does not match any outer indentation level",
578 ("<tokenize>", lnum, pos, line))
Guido van Rossumfc6f5331997-03-07 00:21:12 +0000579 indents = indents[:-1]
Yury Selivanov75445082015-05-11 22:57:16 -0400580
Yury Selivanov96ec9342015-07-23 15:01:58 +0300581 if async_def and async_def_indent >= indents[-1]:
582 async_def = False
583 async_def_nl = False
584 async_def_indent = 0
Yury Selivanov75445082015-05-11 22:57:16 -0400585
Raymond Hettingera48db392009-04-29 00:34:27 +0000586 yield TokenInfo(DEDENT, '', (lnum, pos), (lnum, pos), line)
Guido van Rossumfc6f5331997-03-07 00:21:12 +0000587
Yury Selivanov96ec9342015-07-23 15:01:58 +0300588 if async_def and async_def_nl and async_def_indent >= indents[-1]:
589 async_def = False
590 async_def_nl = False
591 async_def_indent = 0
592
Guido van Rossumfc6f5331997-03-07 00:21:12 +0000593 else: # continued statement
Guido van Rossumde655271997-04-09 17:15:54 +0000594 if not line:
Collin Winterce36ad82007-08-30 01:19:48 +0000595 raise TokenError("EOF in multi-line statement", (lnum, 0))
Guido van Rossumfc6f5331997-03-07 00:21:12 +0000596 continued = 0
597
598 while pos < max:
Antoine Pitrou10a99b02011-10-11 15:45:56 +0200599 pseudomatch = _compile(PseudoToken).match(line, pos)
Guido van Rossum3b631771997-10-27 20:44:15 +0000600 if pseudomatch: # scan for tokens
601 start, end = pseudomatch.span(1)
Guido van Rossumde655271997-04-09 17:15:54 +0000602 spos, epos, pos = (lnum, start), (lnum, end), end
Ezio Melotti2cc3b4b2012-11-03 17:38:43 +0200603 if start == end:
604 continue
Guido van Rossum1aec3231997-04-08 14:24:39 +0000605 token, initial = line[start:end], line[start]
Guido van Rossumfc6f5331997-03-07 00:21:12 +0000606
Georg Brandldde00282007-03-18 19:01:53 +0000607 if (initial in numchars or # ordinary number
608 (initial == '.' and token != '.' and token != '...')):
Raymond Hettingera48db392009-04-29 00:34:27 +0000609 yield TokenInfo(NUMBER, token, spos, epos, line)
Guido van Rossum1aec3231997-04-08 14:24:39 +0000610 elif initial in '\r\n':
Yury Selivanov75445082015-05-11 22:57:16 -0400611 if stashed:
612 yield stashed
613 stashed = None
Yury Selivanov96ec9342015-07-23 15:01:58 +0300614 if parenlev > 0:
615 yield TokenInfo(NL, token, spos, epos, line)
616 else:
617 yield TokenInfo(NEWLINE, token, spos, epos, line)
618 if async_def:
619 async_def_nl = True
620
Guido van Rossum1aec3231997-04-08 14:24:39 +0000621 elif initial == '#':
Thomas Wouters89f507f2006-12-13 04:49:30 +0000622 assert not token.endswith("\n")
Yury Selivanov75445082015-05-11 22:57:16 -0400623 if stashed:
624 yield stashed
625 stashed = None
Raymond Hettingera48db392009-04-29 00:34:27 +0000626 yield TokenInfo(COMMENT, token, spos, epos, line)
Eric V. Smith1c8222c2015-10-26 04:37:55 -0400627
Guido van Rossum9d6897a2002-08-24 06:54:19 +0000628 elif token in triple_quoted:
Antoine Pitrou10a99b02011-10-11 15:45:56 +0200629 endprog = _compile(endpats[token])
Guido van Rossum3b631771997-10-27 20:44:15 +0000630 endmatch = endprog.match(line, pos)
631 if endmatch: # all on one line
632 pos = endmatch.end(0)
Guido van Rossum1aec3231997-04-08 14:24:39 +0000633 token = line[start:pos]
Raymond Hettingera48db392009-04-29 00:34:27 +0000634 yield TokenInfo(STRING, token, spos, (lnum, pos), line)
Guido van Rossumfc6f5331997-03-07 00:21:12 +0000635 else:
Guido van Rossum1aec3231997-04-08 14:24:39 +0000636 strstart = (lnum, start) # multiple lines
637 contstr = line[start:]
Guido van Rossuma90c78b1998-04-03 16:05:38 +0000638 contline = line
Guido van Rossumfc6f5331997-03-07 00:21:12 +0000639 break
Eric V. Smith1c8222c2015-10-26 04:37:55 -0400640
641 # Check up to the first 3 chars of the token to see if
642 # they're in the single_quoted set. If so, they start
643 # a string.
644 # We're using the first 3, because we're looking for
645 # "rb'" (for example) at the start of the token. If
646 # we switch to longer prefixes, this needs to be
647 # adjusted.
648 # Note that initial == token[:1].
Berker Peksaga7161e72015-12-30 01:42:43 +0200649 # Also note that single quote checking must come after
Eric V. Smith1c8222c2015-10-26 04:37:55 -0400650 # triple quote checking (above).
651 elif (initial in single_quoted or
652 token[:2] in single_quoted or
653 token[:3] in single_quoted):
Guido van Rossumfc6f5331997-03-07 00:21:12 +0000654 if token[-1] == '\n': # continued string
Guido van Rossum1aec3231997-04-08 14:24:39 +0000655 strstart = (lnum, start)
Eric V. Smith1c8222c2015-10-26 04:37:55 -0400656 # Again, using the first 3 chars of the
657 # token. This is looking for the matching end
658 # regex for the correct type of quote
659 # character. So it's really looking for
660 # endpats["'"] or endpats['"'], by trying to
661 # skip string prefix characters, if any.
662 endprog = _compile(endpats.get(initial) or
663 endpats.get(token[1]) or
664 endpats.get(token[2]))
Guido van Rossumde655271997-04-09 17:15:54 +0000665 contstr, needcont = line[start:], 1
Guido van Rossuma90c78b1998-04-03 16:05:38 +0000666 contline = line
Guido van Rossumfc6f5331997-03-07 00:21:12 +0000667 break
668 else: # ordinary string
Raymond Hettingera48db392009-04-29 00:34:27 +0000669 yield TokenInfo(STRING, token, spos, epos, line)
Eric V. Smith1c8222c2015-10-26 04:37:55 -0400670
Benjamin Peterson33856de2010-08-30 14:41:20 +0000671 elif initial.isidentifier(): # ordinary name
Yury Selivanov75445082015-05-11 22:57:16 -0400672 if token in ('async', 'await'):
Yury Selivanov96ec9342015-07-23 15:01:58 +0300673 if async_def:
Yury Selivanov75445082015-05-11 22:57:16 -0400674 yield TokenInfo(
675 ASYNC if token == 'async' else AWAIT,
676 token, spos, epos, line)
677 continue
678
679 tok = TokenInfo(NAME, token, spos, epos, line)
680 if token == 'async' and not stashed:
681 stashed = tok
682 continue
683
684 if token == 'def':
685 if (stashed
686 and stashed.type == NAME
687 and stashed.string == 'async'):
688
Yury Selivanov96ec9342015-07-23 15:01:58 +0300689 async_def = True
690 async_def_indent = indents[-1]
Yury Selivanov75445082015-05-11 22:57:16 -0400691
692 yield TokenInfo(ASYNC, stashed.string,
693 stashed.start, stashed.end,
694 stashed.line)
695 stashed = None
Yury Selivanov75445082015-05-11 22:57:16 -0400696
697 if stashed:
698 yield stashed
699 stashed = None
700
701 yield tok
Guido van Rossum3b631771997-10-27 20:44:15 +0000702 elif initial == '\\': # continued stmt
703 continued = 1
Guido van Rossumfc6f5331997-03-07 00:21:12 +0000704 else:
Benjamin Petersona0dfa822009-11-13 02:25:08 +0000705 if initial in '([{':
706 parenlev += 1
707 elif initial in ')]}':
708 parenlev -= 1
Yury Selivanov75445082015-05-11 22:57:16 -0400709 if stashed:
710 yield stashed
711 stashed = None
Raymond Hettingera48db392009-04-29 00:34:27 +0000712 yield TokenInfo(OP, token, spos, epos, line)
Guido van Rossumfc6f5331997-03-07 00:21:12 +0000713 else:
Raymond Hettingera48db392009-04-29 00:34:27 +0000714 yield TokenInfo(ERRORTOKEN, line[pos],
Guido van Rossumde655271997-04-09 17:15:54 +0000715 (lnum, pos), (lnum, pos+1), line)
Benjamin Petersona0dfa822009-11-13 02:25:08 +0000716 pos += 1
Guido van Rossumfc6f5331997-03-07 00:21:12 +0000717
Yury Selivanov75445082015-05-11 22:57:16 -0400718 if stashed:
719 yield stashed
720 stashed = None
721
Guido van Rossumfc6f5331997-03-07 00:21:12 +0000722 for indent in indents[1:]: # pop remaining indent levels
Raymond Hettingera48db392009-04-29 00:34:27 +0000723 yield TokenInfo(DEDENT, '', (lnum, 0), (lnum, 0), '')
724 yield TokenInfo(ENDMARKER, '', (lnum, 0), (lnum, 0), '')
Guido van Rossumfc6f5331997-03-07 00:21:12 +0000725
Trent Nelson428de652008-03-18 22:41:35 +0000726
727# An undocumented, backwards compatible, API for all the places in the standard
728# library that expect to be able to use tokenize with strings
729def generate_tokens(readline):
730 return _tokenize(readline, None)
Raymond Hettinger6c60d092010-09-09 04:32:39 +0000731
Meador Inge14c0f032011-10-07 08:53:38 -0500732def main():
733 import argparse
734
735 # Helper error handling routines
736 def perror(message):
737 print(message, file=sys.stderr)
738
739 def error(message, filename=None, location=None):
740 if location:
741 args = (filename,) + location + (message,)
742 perror("%s:%d:%d: error: %s" % args)
743 elif filename:
744 perror("%s: error: %s" % (filename, message))
745 else:
746 perror("error: %s" % message)
747 sys.exit(1)
748
749 # Parse the arguments and options
750 parser = argparse.ArgumentParser(prog='python -m tokenize')
751 parser.add_argument(dest='filename', nargs='?',
752 metavar='filename.py',
753 help='the file to tokenize; defaults to stdin')
Meador Inge00c7f852012-01-19 00:44:45 -0600754 parser.add_argument('-e', '--exact', dest='exact', action='store_true',
755 help='display token names using the exact type')
Meador Inge14c0f032011-10-07 08:53:38 -0500756 args = parser.parse_args()
757
758 try:
759 # Tokenize the input
760 if args.filename:
761 filename = args.filename
Victor Stinner96917502014-12-05 10:17:10 +0100762 with _builtin_open(filename, 'rb') as f:
Meador Inge14c0f032011-10-07 08:53:38 -0500763 tokens = list(tokenize(f.readline))
764 else:
765 filename = "<stdin>"
766 tokens = _tokenize(sys.stdin.readline, None)
767
768 # Output the tokenization
769 for token in tokens:
Meador Inge00c7f852012-01-19 00:44:45 -0600770 token_type = token.type
771 if args.exact:
772 token_type = token.exact_type
Meador Inge14c0f032011-10-07 08:53:38 -0500773 token_range = "%d,%d-%d,%d:" % (token.start + token.end)
774 print("%-20s%-15s%-15r" %
Meador Inge00c7f852012-01-19 00:44:45 -0600775 (token_range, tok_name[token_type], token.string))
Meador Inge14c0f032011-10-07 08:53:38 -0500776 except IndentationError as err:
777 line, column = err.args[1][1:3]
778 error(err.args[0], filename, (line, column))
779 except TokenError as err:
780 line, column = err.args[1]
781 error(err.args[0], filename, (line, column))
782 except SyntaxError as err:
783 error(err, filename)
Andrew Svetlovf7a17b42012-12-25 16:47:37 +0200784 except OSError as err:
Meador Inge14c0f032011-10-07 08:53:38 -0500785 error(err)
786 except KeyboardInterrupt:
787 print("interrupted\n")
788 except Exception as err:
789 perror("unexpected error: %s" % err)
790 raise
791
Raymond Hettinger6c60d092010-09-09 04:32:39 +0000792if __name__ == "__main__":
Meador Inge14c0f032011-10-07 08:53:38 -0500793 main()