From c954c0727179064ce0ecf62336ec74173d36ec31 Mon Sep 17 00:00:00 2001 From: James Cassell Date: Thu, 8 Aug 2019 13:50:20 -0400 Subject: [PATCH] TRANSFORM_INVALID_GROUP_CHARS: document "ignore" option (#57318) Co-Authored-By: Alicia Cozine <879121+acozine@users.noreply.github.com> --- changelogs/fragments/group-chars-ignore-doc.yaml | 3 +++ lib/ansible/config/base.yml | 5 +++-- 2 files changed, 6 insertions(+), 2 deletions(-) create mode 100644 changelogs/fragments/group-chars-ignore-doc.yaml diff --git a/changelogs/fragments/group-chars-ignore-doc.yaml b/changelogs/fragments/group-chars-ignore-doc.yaml new file mode 100644 index 00000000000..70dbc22f964 --- /dev/null +++ b/changelogs/fragments/group-chars-ignore-doc.yaml @@ -0,0 +1,3 @@ +--- +bugfixes: +- documented ``ignore`` option for ``TRANSFORM_INVALID_GROUP_CHARS`` diff --git a/lib/ansible/config/base.yml b/lib/ansible/config/base.yml index df840fd37f5..16e091567b3 100644 --- a/lib/ansible/config/base.yml +++ b/lib/ansible/config/base.yml @@ -1421,13 +1421,14 @@ TRANSFORM_INVALID_GROUP_CHARS: description: - Make ansible transform invalid characters in group names supplied by inventory sources. - If 'never' it will allow for the group name but warn about the issue. + - When 'ignore', it does the same as 'never', without issuing a warning. - When 'always' it will replace any invalid charachters with '_' (underscore) and warn the user - - When 'silently', it does the same as 'always' sans the warnings. + - When 'silently', it does the same as 'always', without issuing a warning. env: [{name: ANSIBLE_TRANSFORM_INVALID_GROUP_CHARS}] ini: - {key: force_valid_group_names, section: defaults} type: string - choices: ['always', 'never', 'silently'] + choices: ['always', 'never', 'ignore', 'silently'] version_added: '2.8' INVALID_TASK_ATTRIBUTE_FAILED: name: Controls whether invalid attributes for a task result in errors instead of warnings