mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
29e4066944
* Initial commit * Adding maintainer in BOTMETA * Adding changelog fragment * Updating filter_guide * Applying initial review suggestions
40 lines
1.2 KiB
Python
40 lines
1.2 KiB
Python
# -*- coding: utf-8 -*-
|
|
|
|
# Copyright: (c) 2021, Andrew Pantuso (@ajpantuso) <ajpantuso@gmail.com>
|
|
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
|
|
from __future__ import absolute_import, division, print_function
|
|
__metaclass__ = type
|
|
|
|
from unicodedata import normalize
|
|
|
|
from ansible.errors import AnsibleFilterError, AnsibleFilterTypeError
|
|
from ansible.module_utils.six import text_type
|
|
|
|
|
|
def unicode_normalize(data, form='NFC'):
|
|
"""Applies normalization to 'unicode' strings.
|
|
|
|
Args:
|
|
data: A unicode string piped into the Jinja filter
|
|
form: One of ('NFC', 'NFD', 'NFKC', 'NFKD').
|
|
See https://docs.python.org/3/library/unicodedata.html#unicodedata.normalize for more information.
|
|
|
|
Returns:
|
|
A normalized unicode string of the specified 'form'.
|
|
"""
|
|
|
|
if not isinstance(data, text_type):
|
|
raise AnsibleFilterTypeError("%s is not a valid input type" % type(data))
|
|
|
|
if form not in ('NFC', 'NFD', 'NFKC', 'NFKD'):
|
|
raise AnsibleFilterError("%s is not a valid form" % form)
|
|
|
|
return normalize(form, data)
|
|
|
|
|
|
class FilterModule(object):
|
|
def filters(self):
|
|
return {
|
|
'unicode_normalize': unicode_normalize,
|
|
}
|