File: //lib/python3.9/site-packages/ansible_collections/community/dns/plugins/module_utils/names.py
# -*- coding: utf-8 -*-
#
# Copyright (c) 2021 Felix Fontein
# GNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt or https://www.gnu.org/licenses/gpl-3.0.txt)
# SPDX-License-Identifier: GPL-3.0-or-later
from __future__ import (absolute_import, division, print_function)
__metaclass__ = type
import re
from ansible.module_utils.common.text.converters import to_text
_ASCII_PRINTABLE_MATCHER = re.compile(r'^[\x20-\x7e]*$')
def is_ascii_label(domain):
'''
Check whether domain name has only ASCII labels.
'''
return _ASCII_PRINTABLE_MATCHER.match(domain) is not None
class InvalidDomainName(Exception):
'''
The provided domain name is not valid.
'''
pass
def split_into_labels(domain):
'''
Split domain name to a list of labels. Start with the top-most label.
Returns a list of labels and a tail, which is either ``''`` or ``'.'``.
Raises ``InvalidDomainName`` if the domain name is not valid.
'''
result = []
index = len(domain)
tail = ''
if domain.endswith('.'):
index -= 1
tail = '.'
if index > 0:
while index >= 0:
next_index = domain.rfind('.', 0, index)
label = domain[next_index + 1:index]
if label == '' or label[0] == '-' or label[-1] == '-' or len(label) > 63:
raise InvalidDomainName(domain)
result.append(label)
index = next_index
return result, tail
def join_labels(labels, tail=''):
'''
Combines the result of split_into_labels() back into a domain name.
'''
return '.'.join(reversed(labels)) + tail
def normalize_label(label):
'''
Normalize a domain label. Returns a lower-case ASCII label.
If a ulabel is provided, it is converted to an alabel.
'''
if not is_ascii_label(label):
# Convert ulabel to alabel
label = to_text(b'xn--' + to_text(label).encode('punycode'))
# Always convert to lower-case
return label.lower()