test/bdd/steps/queries.py

   1 """ Steps that run search queries.
   2
   3     Queries may either be run directly via PHP using the query script
   4     or via the HTTP interface.
   5 """
   6
   7 import json
   8 import os
   9 import io
  10 import re
  11 import logging
  12 import xml.etree.ElementTree as ET
  13 import subprocess
  14 from urllib.parse import urlencode
  15 from collections import OrderedDict
  16 from nose.tools import * # for assert functions
  17
  18 logger = logging.getLogger(__name__)
  19
  20 BASE_SERVER_ENV = {
  21     'HTTP_HOST' : 'localhost',
  22     'HTTP_USER_AGENT' : 'Mozilla/5.0 (X11; Linux x86_64; rv:51.0) Gecko/20100101 Firefox/51.0',
  23     'HTTP_ACCEPT' : 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
  24     'HTTP_ACCEPT_ENCODING' : 'gzip, deflate',
  25     'HTTP_CONNECTION' : 'keep-alive',
  26     'SERVER_SIGNATURE' : '<address>Nominatim BDD Tests</address>',
  27     'SERVER_SOFTWARE' : 'Nominatim test',
  28     'SERVER_NAME' : 'localhost',
  29     'SERVER_ADDR' : '127.0.1.1',
  30     'SERVER_PORT' : '80',
  31     'REMOTE_ADDR' : '127.0.0.1',
  32     'DOCUMENT_ROOT' : '/var/www',
  33     'REQUEST_SCHEME' : 'http',
  34     'CONTEXT_PREFIX' : '/',
  35     'SERVER_ADMIN' : 'webmaster@localhost',
  36     'REMOTE_PORT' : '49319',
  37     'GATEWAY_INTERFACE' : 'CGI/1.1',
  38     'SERVER_PROTOCOL' : 'HTTP/1.1',
  39     'REQUEST_METHOD' : 'GET',
  40     'REDIRECT_STATUS' : 'CGI'
  41 }
  42
  43
  44 def compare(operator, op1, op2):
  45     if operator == 'less than':
  46         return op1 < op2
  47     elif operator == 'more than':
  48         return op1 > op2
  49     elif operator == 'exactly':
  50         return op1 == op2
  51     elif operator == 'at least':
  52         return op1 >= op2
  53     elif operator == 'at most':
  54         return op1 <= op2
  55     else:
  56         raise Exception("unknown operator '%s'" % operator)
  57
  58 class GenericResponse(object):
  59
  60     def match_row(self, row):
  61         if 'ID' in row.headings:
  62             todo = [int(row['ID'])]
  63         else:
  64             todo = range(len(self.result))
  65
  66         for i in todo:
  67             res = self.result[i]
  68             for h in row.headings:
  69                 if h == 'ID':
  70                     pass
  71                 elif h == 'osm':
  72                     assert_equal(res['osm_type'], row[h][0])
  73                     assert_equal(res['osm_id'], int(row[h][1:]))
  74                 elif h == 'centroid':
  75                     x, y = row[h].split(' ')
  76                     assert_almost_equal(float(y), float(res['lat']))
  77                     assert_almost_equal(float(x), float(res['lon']))
  78                 elif row[h].startswith("^"):
  79                     assert_in(h, res)
  80                     assert_is_not_none(re.fullmatch(row[h], res[h]),
  81                                        "attribute '%s': expected: '%s', got '%s'"
  82                                           % (h, row[h], res[h]))
  83                 else:
  84                     assert_in(h, res)
  85                     assert_equal(str(res[h]), str(row[h]))
  86
  87     def property_list(self, prop):
  88         return [ x[prop] for x in self.result ]
  89
  90
  91 class SearchResponse(GenericResponse):
  92
  93     def __init__(self, page, fmt='json', errorcode=200):
  94         self.page = page
  95         self.format = fmt
  96         self.errorcode = errorcode
  97         self.result = []
  98         self.header = dict()
  99
 100         if errorcode == 200:
 101             getattr(self, 'parse_' + fmt)()
 102
 103     def parse_json(self):
 104         m = re.fullmatch(r'([\w$][^(]*)\((.*)\)', self.page)
 105         if m is None:
 106             code = self.page
 107         else:
 108             code = m.group(2)
 109             self.header['json_func'] = m.group(1)
 110         self.result = json.JSONDecoder(object_pairs_hook=OrderedDict).decode(code)
 111
 112     def parse_geojson(self):
 113         self.parse_json()
 114         self.result = geojson_results_to_json_results(self.result)
 115
 116     def parse_geocodejson(self):
 117         self.parse_geojson()
 118         if self.result is not None:
 119             self.result = [r['geocoding'] for r in self.result]
 120
 121     def parse_xml(self):
 122         et = ET.fromstring(self.page)
 123
 124         self.header = dict(et.attrib)
 125
 126         for child in et:
 127             assert_equal(child.tag, "place")
 128             self.result.append(dict(child.attrib))
 129
 130             address = {}
 131             for sub in child:
 132                 if sub.tag == 'extratags':
 133                     self.result[-1]['extratags'] = {}
 134                     for tag in sub:
 135                         self.result[-1]['extratags'][tag.attrib['key']] = tag.attrib['value']
 136                 elif sub.tag == 'namedetails':
 137                     self.result[-1]['namedetails'] = {}
 138                     for tag in sub:
 139                         self.result[-1]['namedetails'][tag.attrib['desc']] = tag.text
 140                 elif sub.tag in ('geokml'):
 141                     self.result[-1][sub.tag] = True
 142                 else:
 143                     address[sub.tag] = sub.text
 144
 145             if len(address) > 0:
 146                 self.result[-1]['address'] = address
 147
 148
 149 class ReverseResponse(GenericResponse):
 150
 151     def __init__(self, page, fmt='json', errorcode=200):
 152         self.page = page
 153         self.format = fmt
 154         self.errorcode = errorcode
 155         self.result = []
 156         self.header = dict()
 157
 158         if errorcode == 200:
 159             getattr(self, 'parse_' + fmt)()
 160
 161     def parse_json(self):
 162         m = re.fullmatch(r'([\w$][^(]*)\((.*)\)', self.page)
 163         if m is None:
 164             code = self.page
 165         else:
 166             code = m.group(2)
 167             self.header['json_func'] = m.group(1)
 168         self.result = [json.JSONDecoder(object_pairs_hook=OrderedDict).decode(code)]
 169
 170     def parse_geojson(self):
 171         self.parse_json()
 172         if 'error' in self.result:
 173             return
 174         self.result = geojson_results_to_json_results(self.result[0])
 175
 176     def parse_geocodejson(self):
 177         self.parse_geojson()
 178         if self.result is not None:
 179             self.result = [r['geocoding'] for r in self.result]
 180
 181     def parse_xml(self):
 182         et = ET.fromstring(self.page)
 183
 184         self.header = dict(et.attrib)
 185         self.result = []
 186
 187         for child in et:
 188             if child.tag == 'result':
 189                 eq_(0, len(self.result), "More than one result in reverse result")
 190                 self.result.append(dict(child.attrib))
 191             elif child.tag == 'addressparts':
 192                 address = {}
 193                 for sub in child:
 194                     address[sub.tag] = sub.text
 195                 self.result[0]['address'] = address
 196             elif child.tag == 'extratags':
 197                 self.result[0]['extratags'] = {}
 198                 for tag in child:
 199                     self.result[0]['extratags'][tag.attrib['key']] = tag.attrib['value']
 200             elif child.tag == 'namedetails':
 201                 self.result[0]['namedetails'] = {}
 202                 for tag in child:
 203                     self.result[0]['namedetails'][tag.attrib['desc']] = tag.text
 204             elif child.tag in ('geokml'):
 205                 self.result[0][child.tag] = True
 206             else:
 207                 assert child.tag == 'error', \
 208                         "Unknown XML tag %s on page: %s" % (child.tag, self.page)
 209
 210
 211 class DetailsResponse(GenericResponse):
 212
 213     def __init__(self, page, fmt='json', errorcode=200):
 214         self.page = page
 215         self.format = fmt
 216         self.errorcode = errorcode
 217         self.result = []
 218         self.header = dict()
 219
 220         if errorcode == 200:
 221             getattr(self, 'parse_' + fmt)()
 222
 223     def parse_json(self):
 224         self.result = [json.JSONDecoder(object_pairs_hook=OrderedDict).decode(self.page)]
 225
 226
 227 class StatusResponse(GenericResponse):
 228
 229     def __init__(self, page, fmt='text', errorcode=200):
 230         self.page = page
 231         self.format = fmt
 232         self.errorcode = errorcode
 233
 234         if errorcode == 200 and fmt != 'text':
 235             getattr(self, 'parse_' + fmt)()
 236
 237     def parse_json(self):
 238         self.result = [json.JSONDecoder(object_pairs_hook=OrderedDict).decode(self.page)]
 239
 240
 241 def geojson_result_to_json_result(geojson_result):
 242     result = geojson_result['properties']
 243     result['geojson'] = geojson_result['geometry']
 244     if 'bbox' in geojson_result:
 245         # bbox is  minlon, minlat, maxlon, maxlat
 246         # boundingbox is minlat, maxlat, minlon, maxlon
 247         result['boundingbox'] = [
 248                                     geojson_result['bbox'][1],
 249                                     geojson_result['bbox'][3],
 250                                     geojson_result['bbox'][0],
 251                                     geojson_result['bbox'][2]
 252                                 ]
 253     return result
 254
 255
 256 def geojson_results_to_json_results(geojson_results):
 257     if 'error' in geojson_results:
 258         return
 259     return list(map(geojson_result_to_json_result, geojson_results['features']))
 260
 261
 262 @when(u'searching for "(?P<query>.*)"(?P<dups> with dups)?')
 263 def query_cmd(context, query, dups):
 264     """ Query directly via PHP script.
 265     """
 266     cmd = ['/usr/bin/env', 'php']
 267     cmd.append(os.path.join(context.nominatim.build_dir, 'utils', 'query.php'))
 268     if query:
 269         cmd.extend(['--search', query])
 270     # add more parameters in table form
 271     if context.table:
 272         for h in context.table.headings:
 273             value = context.table[0][h].strip()
 274             if value:
 275                 cmd.extend(('--' + h, value))
 276
 277     if dups:
 278         cmd.extend(('--dedupe', '0'))
 279
 280     proc = subprocess.Popen(cmd, cwd=context.nominatim.build_dir,
 281                             stdout=subprocess.PIPE, stderr=subprocess.PIPE)
 282     (outp, err) = proc.communicate()
 283
 284     assert_equals (0, proc.returncode, "query.php failed with message: %s\noutput: %s" % (err, outp))
 285     logger.debug("run_nominatim_script: %s\n%s\n" % (cmd, outp.decode('utf-8').replace('\\n', '\n')))
 286
 287     context.response = SearchResponse(outp.decode('utf-8'), 'json')
 288
 289 def send_api_query(endpoint, params, fmt, context):
 290     if fmt is not None:
 291         params['format'] = fmt.strip()
 292     if context.table:
 293         if context.table.headings[0] == 'param':
 294             for line in context.table:
 295                 params[line['param']] = line['value']
 296         else:
 297             for h in context.table.headings:
 298                 params[h] = context.table[0][h]
 299
 300     env = dict(BASE_SERVER_ENV)
 301     env['QUERY_STRING'] = urlencode(params)
 302
 303     env['SCRIPT_NAME'] = '/%s.php' % endpoint
 304     env['REQUEST_URI'] = '%s?%s' % (env['SCRIPT_NAME'], env['QUERY_STRING'])
 305     env['CONTEXT_DOCUMENT_ROOT'] = os.path.join(context.nominatim.build_dir, 'website')
 306     env['SCRIPT_FILENAME'] = os.path.join(env['CONTEXT_DOCUMENT_ROOT'],
 307                                           '%s.php' % endpoint)
 308     env['NOMINATIM_SETTINGS'] = context.nominatim.local_settings_file
 309
 310     logger.debug("Environment:" + json.dumps(env, sort_keys=True, indent=2))
 311
 312     if hasattr(context, 'http_headers'):
 313         env.update(context.http_headers)
 314
 315     cmd = ['/usr/bin/env', 'php-cgi', '-f']
 316     if context.nominatim.code_coverage_path:
 317         env['COV_SCRIPT_FILENAME'] = env['SCRIPT_FILENAME']
 318         env['COV_PHP_DIR'] = os.path.join(context.nominatim.src_dir, "lib")
 319         env['COV_TEST_NAME'] = '%s:%s' % (context.scenario.filename, context.scenario.line)
 320         env['SCRIPT_FILENAME'] = \
 321                 os.path.join(os.path.split(__file__)[0], 'cgi-with-coverage.php')
 322         cmd.append(env['SCRIPT_FILENAME'])
 323         env['PHP_CODE_COVERAGE_FILE'] = context.nominatim.next_code_coverage_file()
 324     else:
 325         cmd.append(env['SCRIPT_FILENAME'])
 326
 327     for k,v in params.items():
 328         cmd.append("%s=%s" % (k, v))
 329
 330     proc = subprocess.Popen(cmd, cwd=context.nominatim.build_dir, env=env,
 331                             stdout=subprocess.PIPE, stderr=subprocess.PIPE)
 332
 333     (outp, err) = proc.communicate()
 334     outp = outp.decode('utf-8')
 335     err = err.decode("utf-8")
 336
 337     logger.debug("Result: \n===============================\n"
 338                  + outp + "\n===============================\n")
 339
 340     assert_equals(0, proc.returncode,
 341                   "%s failed with message: %s" % (
 342                       os.path.basename(env['SCRIPT_FILENAME']),
 343                       err))
 344
 345     assert_equals(0, len(err), "Unexpected PHP error: %s" % (err))
 346
 347     if outp.startswith('Status: '):
 348         status = int(outp[8:11])
 349     else:
 350         status = 200
 351
 352     content_start = outp.find('\r\n\r\n')
 353
 354     return outp[content_start + 4:], status
 355
 356 @given(u'the HTTP header')
 357 def add_http_header(context):
 358     if not hasattr(context, 'http_headers'):
 359         context.http_headers = {}
 360
 361     for h in context.table.headings:
 362         envvar = 'HTTP_' + h.upper().replace('-', '_')
 363         context.http_headers[envvar] = context.table[0][h]
 364
 365
 366 @when(u'sending (?P<fmt>\S+ )?search query "(?P<query>.*)"(?P<addr> with address)?')
 367 def website_search_request(context, fmt, query, addr):
 368     params = {}
 369     if query:
 370         params['q'] = query
 371     if addr is not None:
 372         params['addressdetails'] = '1'
 373
 374     outp, status = send_api_query('search', params, fmt, context)
 375
 376     if fmt is None or fmt == 'jsonv2 ':
 377         outfmt = 'json'
 378     else:
 379         outfmt = fmt.strip()
 380
 381     context.response = SearchResponse(outp, outfmt, status)
 382
 383 @when(u'sending (?P<fmt>\S+ )?reverse coordinates (?P<lat>.+)?,(?P<lon>.+)?')
 384 def website_reverse_request(context, fmt, lat, lon):
 385     params = {}
 386     if lat is not None:
 387         params['lat'] = lat
 388     if lon is not None:
 389         params['lon'] = lon
 390
 391     outp, status = send_api_query('reverse', params, fmt, context)
 392
 393     if fmt is None:
 394         outfmt = 'xml'
 395     elif fmt == 'jsonv2 ':
 396         outfmt = 'json'
 397     else:
 398         outfmt = fmt.strip()
 399
 400     context.response = ReverseResponse(outp, outfmt, status)
 401
 402 @when(u'sending (?P<fmt>\S+ )?details query for (?P<query>.*)')
 403 def website_details_request(context, fmt, query):
 404     params = {}
 405     if query[0] in 'NWR':
 406         params['osmtype'] = query[0]
 407         params['osmid'] = query[1:]
 408     else:
 409         params['place_id'] = query
 410     outp, status = send_api_query('details', params, fmt, context)
 411
 412     if fmt is None:
 413         outfmt = 'json'
 414     else:
 415         outfmt = fmt.strip()
 416
 417     context.response = DetailsResponse(outp, outfmt, status)
 418
 419 @when(u'sending (?P<fmt>\S+ )?lookup query for (?P<query>.*)')
 420 def website_lookup_request(context, fmt, query):
 421     params = { 'osm_ids' : query }
 422     outp, status = send_api_query('lookup', params, fmt, context)
 423
 424     if fmt == 'json ':
 425         outfmt = 'json'
 426     elif fmt == 'jsonv2 ':
 427         outfmt = 'json'
 428     elif fmt == 'geojson ':
 429         outfmt = 'geojson'
 430     elif fmt == 'geocodejson ':
 431         outfmt = 'geocodejson'
 432     else:
 433         outfmt = 'xml'
 434
 435     context.response = SearchResponse(outp, outfmt, status)
 436
 437 @when(u'sending (?P<fmt>\S+ )?status query')
 438 def website_status_request(context, fmt):
 439     params = {}
 440     outp, status = send_api_query('status', params, fmt, context)
 441
 442     if fmt is None:
 443         outfmt = 'text'
 444     else:
 445         outfmt = fmt.strip()
 446
 447     context.response = StatusResponse(outp, outfmt, status)
 448
 449 @step(u'(?P<operator>less than|more than|exactly|at least|at most) (?P<number>\d+) results? (?:is|are) returned')
 450 def validate_result_number(context, operator, number):
 451     eq_(context.response.errorcode, 200)
 452     numres = len(context.response.result)
 453     ok_(compare(operator, numres, int(number)),
 454         "Bad number of results: expected %s %s, got %d." % (operator, number, numres))
 455
 456 @then(u'a HTTP (?P<status>\d+) is returned')
 457 def check_http_return_status(context, status):
 458     eq_(context.response.errorcode, int(status))
 459
 460 @then(u'the page contents equals "(?P<text>.+)"')
 461 def check_page_content_equals(context, text):
 462     eq_(context.response.page, text)
 463
 464 @then(u'the result is valid (?P<fmt>\w+)')
 465 def step_impl(context, fmt):
 466     context.execute_steps("Then a HTTP 200 is returned")
 467     eq_(context.response.format, fmt)
 468
 469 @then(u'a (?P<fmt>\w+) user error is returned')
 470 def check_page_error(context, fmt):
 471     context.execute_steps("Then a HTTP 400 is returned")
 472     eq_(context.response.format, fmt)
 473
 474     if fmt == 'xml':
 475         assert_is_not_none(re.search(r'<error>.+</error>', context.response.page, re.DOTALL))
 476     else:
 477         assert_is_not_none(re.search(r'({"error":)', context.response.page, re.DOTALL))
 478
 479 @then(u'result header contains')
 480 def check_header_attr(context):
 481     for line in context.table:
 482         assert_is_not_none(re.fullmatch(line['value'], context.response.header[line['attr']]),
 483                      "attribute '%s': expected: '%s', got '%s'"
 484                        % (line['attr'], line['value'],
 485                           context.response.header[line['attr']]))
 486
 487 @then(u'result header has (?P<neg>not )?attributes (?P<attrs>.*)')
 488 def check_header_no_attr(context, neg, attrs):
 489     for attr in attrs.split(','):
 490         if neg:
 491             assert_not_in(attr, context.response.header)
 492         else:
 493             assert_in(attr, context.response.header)
 494
 495 @then(u'results contain')
 496 def step_impl(context):
 497     context.execute_steps("then at least 1 result is returned")
 498
 499     for line in context.table:
 500         context.response.match_row(line)
 501
 502 @then(u'result (?P<lid>\d+ )?has (?P<neg>not )?attributes (?P<attrs>.*)')
 503 def validate_attributes(context, lid, neg, attrs):
 504     if lid is None:
 505         idx = range(len(context.response.result))
 506         context.execute_steps("then at least 1 result is returned")
 507     else:
 508         idx = [int(lid.strip())]
 509         context.execute_steps("then more than %sresults are returned" % lid)
 510
 511     for i in idx:
 512         for attr in attrs.split(','):
 513             if neg:
 514                 assert_not_in(attr, context.response.result[i])
 515             else:
 516                 assert_in(attr, context.response.result[i])
 517
 518 @then(u'result addresses contain')
 519 def step_impl(context):
 520     context.execute_steps("then at least 1 result is returned")
 521
 522     if 'ID' not in context.table.headings:
 523         addr_parts = context.response.property_list('address')
 524
 525     for line in context.table:
 526         if 'ID' in context.table.headings:
 527             addr_parts = [dict(context.response.result[int(line['ID'])]['address'])]
 528
 529         for h in context.table.headings:
 530             if h != 'ID':
 531                 for p in addr_parts:
 532                     assert_in(h, p)
 533                     assert_equal(p[h], line[h], "Bad address value for %s" % h)
 534
 535 @then(u'address of result (?P<lid>\d+) has(?P<neg> no)? types (?P<attrs>.*)')
 536 def check_address(context, lid, neg, attrs):
 537     context.execute_steps("then more than %s results are returned" % lid)
 538
 539     addr_parts = context.response.result[int(lid)]['address']
 540
 541     for attr in attrs.split(','):
 542         if neg:
 543             assert_not_in(attr, addr_parts)
 544         else:
 545             assert_in(attr, addr_parts)
 546
 547 @then(u'address of result (?P<lid>\d+) (?P<complete>is|contains)')
 548 def check_address(context, lid, complete):
 549     context.execute_steps("then more than %s results are returned" % lid)
 550
 551     addr_parts = dict(context.response.result[int(lid)]['address'])
 552
 553     for line in context.table:
 554         assert_in(line['type'], addr_parts)
 555         assert_equal(addr_parts[line['type']], line['value'],
 556                      "Bad address value for %s" % line['type'])
 557         del addr_parts[line['type']]
 558
 559     if complete == 'is':
 560         eq_(0, len(addr_parts), "Additional address parts found: %s" % str(addr_parts))
 561
 562 @then(u'result (?P<lid>\d+ )?has bounding box in (?P<coords>[\d,.-]+)')
 563 def step_impl(context, lid, coords):
 564     if lid is None:
 565         context.execute_steps("then at least 1 result is returned")
 566         bboxes = context.response.property_list('boundingbox')
 567     else:
 568         context.execute_steps("then more than %sresults are returned" % lid)
 569         bboxes = [ context.response.result[int(lid)]['boundingbox']]
 570
 571     coord = [ float(x) for x in coords.split(',') ]
 572
 573     for bbox in bboxes:
 574         if isinstance(bbox, str):
 575             bbox = bbox.split(',')
 576         bbox = [ float(x) for x in bbox ]
 577
 578         assert_greater_equal(bbox[0], coord[0])
 579         assert_less_equal(bbox[1], coord[1])
 580         assert_greater_equal(bbox[2], coord[2])
 581         assert_less_equal(bbox[3], coord[3])
 582
 583 @then(u'result (?P<lid>\d+ )?has centroid in (?P<coords>[\d,.-]+)')
 584 def step_impl(context, lid, coords):
 585     if lid is None:
 586         context.execute_steps("then at least 1 result is returned")
 587         bboxes = zip(context.response.property_list('lat'),
 588                      context.response.property_list('lon'))
 589     else:
 590         context.execute_steps("then more than %sresults are returned" % lid)
 591         res = context.response.result[int(lid)]
 592         bboxes = [ (res['lat'], res['lon']) ]
 593
 594     coord = [ float(x) for x in coords.split(',') ]
 595
 596     for lat, lon in bboxes:
 597         lat = float(lat)
 598         lon = float(lon)
 599         assert_greater_equal(lat, coord[0])
 600         assert_less_equal(lat, coord[1])
 601         assert_greater_equal(lon, coord[2])
 602         assert_less_equal(lon, coord[3])
 603
 604 @then(u'there are(?P<neg> no)? duplicates')
 605 def check_for_duplicates(context, neg):
 606     context.execute_steps("then at least 1 result is returned")
 607
 608     resarr = set()
 609     has_dupe = False
 610
 611     for res in context.response.result:
 612         dup = (res['osm_type'], res['class'], res['type'], res['display_name'])
 613         if dup in resarr:
 614             has_dupe = True
 615             break
 616         resarr.add(dup)
 617
 618     if neg:
 619         assert not has_dupe, "Found duplicate for %s" % (dup, )
 620     else:
 621         assert has_dupe, "No duplicates found"