mirror of
https://github.com/ansible-collections/community.crypto.git
synced 2026-03-30 07:13:21 +00:00
4cf951596f
* Prepare IDNA/Unicode conversion code. Use to normalize input. * Use IDNA library first (IDNA2008) and Python's IDNA2003 implementation as a fallback. * Make sure idna is installed. * Add changelog fragment. * 'punycode' → 'idna'. * Add name_encoding options and tests. * Avoid invalid character for IDNA2008. * Linting. * Forgot to upate value. * Work around cryptography bug. Fix port handling for URIs. * Forgot other place sensitive to cryptography bug. * Forgot one. (Will likely still fail.) * Decode IDNA in _compress_entry() to avoid comparison screw-ups. * Work around Python 3.5 problem in Ansible 2.9's default test container. * Update changelog fragment. * Fix error, add tests. * Python 2 compatibility. * Update requirements.
31 lines
1.3 KiB
Python
31 lines
1.3 KiB
Python
# -*- coding: utf-8 -*-
|
|
|
|
# Copyright: (c) 2022, Felix Fontein <felix@fontein.de>
|
|
# 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
|
|
|
|
|
|
class ModuleDocFragment(object):
|
|
DOCUMENTATION = r'''
|
|
options:
|
|
name_encoding:
|
|
description:
|
|
- How to encode names (DNS names, URIs, email addresses) in return values.
|
|
- C(ignore) will use the encoding returned by the backend.
|
|
- C(idna) will convert all labels of domain names to IDNA encoding.
|
|
IDNA2008 will be preferred, and IDNA2003 will be used if IDNA2008 encoding fails.
|
|
- C(unicode) will convert all labels of domain names to Unicode.
|
|
IDNA2008 will be preferred, and IDNA2003 will be used if IDNA2008 decoding fails.
|
|
- B(Note) that C(idna) and C(unicode) require the L(idna Python library,https://pypi.org/project/idna/) to be installed.
|
|
type: str
|
|
default: ignore
|
|
choices:
|
|
- ignore
|
|
- idna
|
|
- unicode
|
|
requirements:
|
|
- If I(name_encoding) is set to another value than C(ignore), the L(idna Python library,https://pypi.org/project/idna/) needs to be installed.
|
|
'''
|