# SPDX-License-Identifier: GPL-2.0-only
#
# This file is part of Nominatim. (https://nominatim.org)
#
# Copyright (C) 2022 by the Nominatim developer community.
# For a full list of authors see the git log.
"""
Sanitizer that preprocesses address tags for house numbers. The sanitizer
allows to

* define which tags are to be considered house numbers (see 'filter-kind')
* split house number lists into individual numbers (see 'delimiters')

Arguments:
    delimiters: Define the set of characters to be used for
                splitting a list of house numbers into parts. (default: ',;')
    filter-kind: Define the address tags that are considered to be a
                 house number. Either takes a single string or a list of strings,
                 where each string is a regular expression. An address item
                 is considered a house number if the 'kind' fully matches any
                 of the given regular expressions. (default: 'housenumber')

"""
from nominatim.tokenizer.sanitizers.helpers import create_split_regex, create_kind_filter

class _HousenumberSanitizer:

    def __init__(self, config):
        self.filter_kind = create_kind_filter(config, 'housenumber')
        self.split_regexp = create_split_regex(config)


    def __call__(self, obj):
        if not obj.address:
            return

        new_address = []
        for item in obj.address:
            if self.filter_kind(item):
                new_address.extend(item.clone(kind='housenumber', name=n)
                                   for n in self.sanitize(item.name))
            else:
                # Don't touch other address items.
                new_address.append(item)

        obj.address = new_address


    def sanitize(self, value):
        """ Extract housenumbers in a regularized format from an OSM value.

            The function works as a generator that yields all valid housenumbers
            that can be created from the value.
        """
        for hnr in self.split_regexp.split(value):
            if hnr:
                yield from self._regularize(hnr)


    @staticmethod
    def _regularize(hnr):
        yield hnr


def create(config):
    """ Create a housenumber processing function.
    """

    return _HousenumberSanitizer(config)