docs: def selectMap(name=None, excludeName=False, closestMatch=True, **tags):
      """select a map by name and/or critiera"""
      matches = filterMapAttrs(**tags)
      if not matches: raise c.InvalidMapSelection("could not find any matching maps given criteria: %s"%tags)
      if name: # if name is specified, consider only the best-matching names only
          matches = filterMapNames(name, excludeRegex=excludeName, closestMatch=closestMatch, records=matches)
      try:
          if closestMatch:    return random.choice(matches) # pick any map at random that matches all criteria
          elif matches:       return matches
      except IndexError: pass # matches is empty still
      raise c.InvalidMapSelection("requested map '%s', but could not locate "\
          "it within %s or its subdirectories.  Submit the map to https://"\
          "github.com/ttinies/sc2gameMapRepo/tree/master/sc2maptool/maps"%(
              name, c.PATH_MAP_INSTALL))