Coverage for tests/test_exprParserLex.py : 10%

Hot-keys on this page
r m x p toggle line displays
j k next/prev highlighted chunk
0 (zero) top of page
1 (one) first highlighted chunk
1# This file is part of daf_butler.
2#
3# Developed for the LSST Data Management System.
4# This product includes software developed by the LSST Project
5# (https://www.lsst.org).
6# See the COPYRIGHT file at the top-level directory of this distribution
7# for details of code ownership.
8#
9# This program is free software: you can redistribute it and/or modify
10# it under the terms of the GNU General Public License as published by
11# the Free Software Foundation, either version 3 of the License, or
12# (at your option) any later version.
13#
14# This program is distributed in the hope that it will be useful,
15# but WITHOUT ANY WARRANTY; without even the implied warranty of
16# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17# GNU General Public License for more details.
18#
19# You should have received a copy of the GNU General Public License
20# along with this program. If not, see <https://www.gnu.org/licenses/>.
22"""Simple unit test for expr_parser/parserLex module.
23"""
25import re
26import unittest
28from lsst.daf.butler.registry.queries.exprParser import ParserLex, ParserLexError
31class ParserLexTestCase(unittest.TestCase):
32 """A test case for ParserLex
33 """
35 def _assertToken(self, token, type, value, lineno=None, lexpos=None):
36 self.assertIsNotNone(token)
37 self.assertEqual(token.type, type)
38 self.assertEqual(token.value, value)
39 if lineno is not None:
40 self.assertEqual(token.lineno, lineno)
41 if lexpos is not None:
42 self.assertEqual(token.lexpos, lexpos)
44 def setUp(self):
45 pass
47 def tearDown(self):
48 pass
50 def testInstantiate(self):
51 """Tests for making ParserLex instances
52 """
54 default_reflags = re.IGNORECASE | re.VERBOSE
55 lexer = ParserLex.make_lexer()
56 self.assertEqual(lexer.lexreflags, default_reflags)
58 lexer = ParserLex.make_lexer(reflags=re.DOTALL)
59 self.assertEqual(lexer.lexreflags, re.DOTALL | default_reflags)
61 def testSimpleTokens(self):
62 """Test for simple tokens"""
63 lexer = ParserLex.make_lexer()
65 lexer.input("=!= <<= >>= +-*/()")
66 self._assertToken(lexer.token(), 'EQ', '=')
67 self._assertToken(lexer.token(), 'NE', '!=')
68 self._assertToken(lexer.token(), 'LT', '<')
69 self._assertToken(lexer.token(), 'LE', '<=')
70 self._assertToken(lexer.token(), 'GT', '>')
71 self._assertToken(lexer.token(), 'GE', '>=')
72 self._assertToken(lexer.token(), 'ADD', '+')
73 self._assertToken(lexer.token(), 'SUB', '-')
74 self._assertToken(lexer.token(), 'MUL', '*')
75 self._assertToken(lexer.token(), 'DIV', '/')
76 self._assertToken(lexer.token(), 'LPAREN', '(')
77 self._assertToken(lexer.token(), 'RPAREN', ')')
78 self.assertIsNone(lexer.token())
80 def testReservedTokens(self):
81 """Test for reserved words"""
82 lexer = ParserLex.make_lexer()
84# tokens = "IS NOT IN NULL OR AND BETWEEN LIKE ESCAPE REGEXP"
85 tokens = "NOT IN OR AND"
86 lexer.input(tokens)
87 for token in tokens.split():
88 self._assertToken(lexer.token(), token, token)
89 self.assertIsNone(lexer.token())
91# tokens = "is not in null or and between like escape regexp"
92 tokens = "not in or and"
93 lexer.input(tokens)
94 for token in tokens.split():
95 self._assertToken(lexer.token(), token.upper(), token)
96 self.assertIsNone(lexer.token())
98 # not reserved
99 token = "ISNOTIN"
100 lexer.input(token)
101 self._assertToken(lexer.token(), "IDENTIFIER", token)
102 self.assertIsNone(lexer.token())
104 def testStringLiteral(self):
105 """Test for string literals"""
106 lexer = ParserLex.make_lexer()
108 lexer.input("''")
109 self._assertToken(lexer.token(), "STRING_LITERAL", "")
110 self.assertIsNone(lexer.token())
112 lexer.input("'string'")
113 self._assertToken(lexer.token(), "STRING_LITERAL", "string")
114 self.assertIsNone(lexer.token())
116 lexer.input("'string' 'string'\n'string'")
117 self._assertToken(lexer.token(), "STRING_LITERAL", "string")
118 self._assertToken(lexer.token(), "STRING_LITERAL", "string")
119 self._assertToken(lexer.token(), "STRING_LITERAL", "string")
120 self.assertIsNone(lexer.token())
122 # odd newline inside string
123 lexer.input("'string\nstring'")
124 with self.assertRaises(ParserLexError):
125 lexer.token()
127 lexer.input("'string")
128 with self.assertRaises(ParserLexError):
129 lexer.token()
131 def testNumericLiteral(self):
132 """Test for numeric literals"""
133 lexer = ParserLex.make_lexer()
135 lexer.input("0 100 999. 100.1 1e10 1e-10 1.e+20 .2E5")
136 self._assertToken(lexer.token(), "NUMERIC_LITERAL", "0")
137 self._assertToken(lexer.token(), "NUMERIC_LITERAL", "100")
138 self._assertToken(lexer.token(), "NUMERIC_LITERAL", "999.")
139 self._assertToken(lexer.token(), "NUMERIC_LITERAL", "100.1")
140 self._assertToken(lexer.token(), "NUMERIC_LITERAL", "1e10")
141 self._assertToken(lexer.token(), "NUMERIC_LITERAL", "1e-10")
142 self._assertToken(lexer.token(), "NUMERIC_LITERAL", "1.e+20")
143 self._assertToken(lexer.token(), "NUMERIC_LITERAL", ".2E5")
144 self.assertIsNone(lexer.token())
146 def testRangeLiteral(self):
147 """Test for range literals"""
148 lexer = ParserLex.make_lexer()
150 lexer.input("0..10 -10..-1 -10..10:2 0 .. 10 0 .. 10 : 2 ")
151 self._assertToken(lexer.token(), "RANGE_LITERAL", (0, 10, None))
152 self._assertToken(lexer.token(), "RANGE_LITERAL", (-10, -1, None))
153 self._assertToken(lexer.token(), "RANGE_LITERAL", (-10, 10, 2))
154 self._assertToken(lexer.token(), "RANGE_LITERAL", (0, 10, None))
155 self._assertToken(lexer.token(), "RANGE_LITERAL", (0, 10, 2))
156 self.assertIsNone(lexer.token())
158 def testTimeLiteral(self):
159 """Test for time literals"""
160 lexer = ParserLex.make_lexer()
162 # string can contain anything, lexer does not check it
163 lexer.input("T'2020-03-30' T'2020-03-30 00:00:00' T'2020-03-30T00:00:00' T'123.456' T'time'")
164 self._assertToken(lexer.token(), "TIME_LITERAL", "2020-03-30")
165 self._assertToken(lexer.token(), "TIME_LITERAL", "2020-03-30 00:00:00")
166 self._assertToken(lexer.token(), "TIME_LITERAL", "2020-03-30T00:00:00")
167 self._assertToken(lexer.token(), "TIME_LITERAL", "123.456")
168 self._assertToken(lexer.token(), "TIME_LITERAL", "time")
169 self.assertIsNone(lexer.token())
171 def testIdentifier(self):
172 """Test for numeric literals"""
173 lexer = ParserLex.make_lexer()
175 lexer.input("ID id _012 a_b_C")
176 self._assertToken(lexer.token(), "IDENTIFIER", "ID")
177 self._assertToken(lexer.token(), "IDENTIFIER", "id")
178 self._assertToken(lexer.token(), "IDENTIFIER", "_012")
179 self._assertToken(lexer.token(), "IDENTIFIER", "a_b_C")
180 self.assertIsNone(lexer.token())
182 lexer.input("a.b _._")
183 self._assertToken(lexer.token(), "IDENTIFIER", "a.b")
184 self._assertToken(lexer.token(), "IDENTIFIER", "_._")
185 self.assertIsNone(lexer.token())
187 lexer.input(".id")
188 with self.assertRaises(ParserLexError):
189 lexer.token()
191 lexer.input("id.")
192 self._assertToken(lexer.token(), "IDENTIFIER", "id")
193 with self.assertRaises(ParserLexError):
194 lexer.token()
196 lexer.input("id.id.id")
197 self._assertToken(lexer.token(), "IDENTIFIER", "id.id")
198 with self.assertRaises(ParserLexError):
199 lexer.token()
201 def testExpression(self):
202 """Test for more or less complete expression"""
203 lexer = ParserLex.make_lexer()
205 expr = ("((instrument='HSC' AND detector != 9) OR instrument='CFHT') "
206 "AND tract=8766 AND patch.cell_x > 5 AND "
207 "patch.cell_y < 4 AND band='i' "
208 "or visit IN (1..50:2)")
209 tokens = (("LPAREN", "("),
210 ("LPAREN", "("),
211 ("IDENTIFIER", "instrument"),
212 ("EQ", "="),
213 ("STRING_LITERAL", "HSC"),
214 ("AND", "AND"),
215 ("IDENTIFIER", "detector"),
216 ("NE", "!="),
217 ("NUMERIC_LITERAL", "9"),
218 ("RPAREN", ")"),
219 ("OR", "OR"),
220 ("IDENTIFIER", "instrument"),
221 ("EQ", "="),
222 ("STRING_LITERAL", "CFHT"),
223 ("RPAREN", ")"),
224 ("AND", "AND"),
225 ("IDENTIFIER", "tract"),
226 ("EQ", "="),
227 ("NUMERIC_LITERAL", "8766"),
228 ("AND", "AND"),
229 ("IDENTIFIER", "patch.cell_x"),
230 ("GT", ">"),
231 ("NUMERIC_LITERAL", "5"),
232 ("AND", "AND"),
233 ("IDENTIFIER", "patch.cell_y"),
234 ("LT", "<"),
235 ("NUMERIC_LITERAL", "4"),
236 ("AND", "AND"),
237 ("IDENTIFIER", "band"),
238 ("EQ", "="),
239 ("STRING_LITERAL", "i"),
240 ("OR", "or"),
241 ("IDENTIFIER", "visit"),
242 ("IN", "IN"),
243 ("LPAREN", "("),
244 ("RANGE_LITERAL", (1, 50, 2)),
245 ("RPAREN", ")"),
246 )
247 lexer.input(expr)
248 for type, value in tokens:
249 self._assertToken(lexer.token(), type, value)
250 self.assertIsNone(lexer.token())
252 def testExceptions(self):
253 """Test for exception contents"""
255 def _assertExc(exc, expr, remain, pos, lineno):
256 """Check exception attribute values"""
257 self.assertEqual(exc.expression, expr)
258 self.assertEqual(exc.remain, remain)
259 self.assertEqual(exc.pos, pos)
260 self.assertEqual(exc.lineno, lineno)
262 lexer = ParserLex.make_lexer()
263 expr = "a.b.c"
264 lexer.input(expr)
265 self._assertToken(lexer.token(), "IDENTIFIER", "a.b")
266 with self.assertRaises(ParserLexError) as catcher:
267 lexer.token()
268 _assertExc(catcher.exception, expr, ".c", 3, 1)
270 lexer = ParserLex.make_lexer()
271 expr = "a \n& b"
272 lexer.input(expr)
273 self._assertToken(lexer.token(), "IDENTIFIER", "a")
274 with self.assertRaises(ParserLexError) as catcher:
275 lexer.token()
276 _assertExc(catcher.exception, expr, "& b", 3, 2)
278 lexer = ParserLex.make_lexer()
279 expr = "a\n=\n1e5.e2"
280 lexer.input(expr)
281 self._assertToken(lexer.token(), "IDENTIFIER", "a")
282 self._assertToken(lexer.token(), "EQ", "=")
283 self._assertToken(lexer.token(), "NUMERIC_LITERAL", "1e5")
284 with self.assertRaises(ParserLexError) as catcher:
285 lexer.token()
286 _assertExc(catcher.exception, expr, ".e2", 7, 3)
288 # zero stride in range literal
289 lexer = ParserLex.make_lexer()
290 expr = "1..2:0"
291 lexer.input(expr)
292 self._assertToken(lexer.token(), "RANGE_LITERAL", (1, 2, None))
293 with self.assertRaises(ParserLexError) as catcher:
294 lexer.token()
295 _assertExc(catcher.exception, expr, ":0", 4, 1)
297 # negative stride in range literal
298 lexer = ParserLex.make_lexer()
299 expr = "1..2:-10"
300 lexer.input(expr)
301 self._assertToken(lexer.token(), "RANGE_LITERAL", (1, 2, None))
302 with self.assertRaises(ParserLexError) as catcher:
303 lexer.token()
304 _assertExc(catcher.exception, expr, ":-10", 4, 1)
307if __name__ == "__main__": 307 ↛ 308line 307 didn't jump to line 308, because the condition on line 307 was never true
308 unittest.main()