Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

moardocsfilters #78800

Merged
merged 13 commits into from Sep 20, 2022
Merged

moardocsfilters #78800

merged 13 commits into from Sep 20, 2022

Conversation

bcoca
Copy link
Member

@bcoca bcoca commented Sep 16, 2022

moardocs
moardocs
moardocs
moardocs
also docsfix

ISSUE TYPE
  • Docs Pull Request
COMPONENT NAME

docs

@ansibot ansibot added affects_2.14 docs This issue/PR relates to or includes documentation. needs_ci This PR requires CI testing to be performed. Please close and re-open this PR to trigger CI. needs_rebase https://docs.ansible.com/ansible/devel/dev_guide/developing_rebasing.html needs_revision This PR fails CI tests or a maintainer has requested a review/revision of the PR. needs_triage Needs a first human triage before being processed. new_plugin This PR includes a new plugin. support:core This issue/PR relates to code supported by the Ansible Engineering Team. labels Sep 16, 2022
  moardocs
  moardocs
  moardocs
  moardocs
  also docsfix
@ansibot ansibot added core_review In order to be merged, this PR must follow the core review workflow. needs_revision This PR fails CI tests or a maintainer has requested a review/revision of the PR. and removed needs_ci This PR requires CI testing to be performed. Please close and re-open this PR to trigger CI. needs_rebase https://docs.ansible.com/ansible/devel/dev_guide/developing_rebasing.html needs_revision This PR fails CI tests or a maintainer has requested a review/revision of the PR. core_review In order to be merged, this PR must follow the core review workflow. labels Sep 19, 2022
@webknjaz webknjaz added the ci_verified Changes made in this PR are causing tests to fail. label Sep 19, 2022
Copy link
Contributor

@felixfontein felixfontein left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The

docs/docsite/rst/collections/ansible/builtin/random_filter.rst:35:0: duplicate-label: duplicate label random_filter, other instance in /root/ansible/docs/docsite/rst/playbook_guide/playbooks_filters.rst
docs/docsite/rst/collections/ansible/builtin/zip_filter.rst:35:0: duplicate-label: duplicate label zip_filter, other instance in /root/ansible/docs/docsite/rst/playbook_guide/playbooks_filters.rst

errors in the docs bulid sanity test stem from a feature in antsibull-docs that creates shortname labels for backwards compatibility for plugins/modules in ansible.builtin. Since there was no auto-generated docs for tests and filters before, we now have to label collisions because of this...

Both labels random_filter and zip_filter only appear in docs/docsite/rst/playbook_guide/playbooks_filters.rst, and aren't used anywhere else in the documentation (at least the one included in ansible/ansible), so it should be safe to rename these. (If any collection documentation was referring to these labels before, they will now refer to the auto-generated filter docs. I guess that won't be too wrong, so the rename should be really OK.)

lib/ansible/plugins/filter/combine.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/to_datetime.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/urldecode.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/urlsplit.py Outdated Show resolved Hide resolved
bcoca and others added 2 commits September 19, 2022 15:09
Co-authored-by: Felix Fontein <felix@fontein.de>
Co-authored-by: Felix Fontein <felix@fontein.de>
@ansibot ansibot added core_review In order to be merged, this PR must follow the core review workflow. and removed ci_verified Changes made in this PR are causing tests to fail. needs_revision This PR fails CI tests or a maintainer has requested a review/revision of the PR. labels Sep 19, 2022
@ansible ansible deleted a comment from ansibot Sep 19, 2022
version_added: "historical"
short_description: cast into a boolean
description:
- Attempt to cast the input into a boolean (C(True) or C(False)) value
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Attempt to cast the input into a boolean (C(True) or C(False)) value
- Attempt to cast the input into a boolean (C(True) or C(False)) value.

lib/ansible/plugins/filter/bool.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/bool.yml Show resolved Hide resolved
lib/ansible/plugins/filter/checksum.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/checksum.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/checksum.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/combinations.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/combinations.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/combinations.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/combinations.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/combine.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/combine.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/combine.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/combine.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/combine.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/comment.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/comment.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/comment.yml Outdated Show resolved Hide resolved
default: plain
choices: ['plain', 'decoration', 'erlang', 'c', 'cblock', 'xml']
decoration:
description: string that indicate comment or intermediate comment depending on the style
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
description: string that indicate comment or intermediate comment depending on the style
description: String that indicates a comment or intermediate comment depending on the style.

description: string that indicate comment or intermediate comment depending on the style
type: string
begining:
description : string to indicate the start of a comment block, only available for styles that support multiline comments
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
description : string to indicate the start of a comment block, only available for styles that support multiline comments
description: String to indicate the start of a comment block. Only available for styles that support multiline comments.

description: first list
type: list
required: true
_additional_lis': #TODO: *args, N possible additional lists
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
_additional_lis': #TODO: *args, N possible additional lists
_additional_list: #TODO: *args, N possible additional lists

bcoca and others added 3 commits September 19, 2022 15:50
Co-authored-by: Felix Fontein <felix@fontein.de>
lib/ansible/plugins/filter/combine.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/combine.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/combine.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/comment.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/comment.yml Outdated Show resolved Hide resolved
type: string
default: '\n'
prefix:
description : Token to start each line inside a comment block, only available for styles that support multiline comments
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
description : Token to start each line inside a comment block, only available for styles that support multiline comments
description: Token to start each line inside a comment block, only available for styles that support multiline comments.

description : Token to start each line inside a comment block, only available for styles that support multiline comments
type: string
prefix_count:
description : Number of times to add a prefix at the start of a line, when a prefix exists and is usable
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
description : Number of times to add a prefix at the start of a line, when a prefix exists and is usable
description: Number of times to add a prefix at the start of a line, when a prefix exists and is usable.

type: int
default: 1
postfix:
description : Indicator of the end of each line inside a comment block, only available for styles that support multiline comments
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
description : Indicator of the end of each line inside a comment block, only available for styles that support multiline comments
description: Indicator of the end of each line inside a comment block, only available for styles that support multiline comments.

Comment on lines 41 to 42
prefix_count:
description : Number of times to add a postfix at the end of a line, when a prefix exists and is usable
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
prefix_count:
description : Number of times to add a postfix at the end of a line, when a prefix exists and is usable
postfix_count:
description: Number of times to add a postfix at the end of a line, when a prefix exists and is usable

lib/ansible/plugins/filter/comment.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/dict2items.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/dict2items.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/dict2items.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/dict2items.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/extract.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/extract.yml Outdated Show resolved Hide resolved
type: raw
required: true
contianer:
description: dictionary or list from which to extract a value
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
description: dictionary or list from which to extract a value
description: Dictionary or list from which to extract a value.

lib/ansible/plugins/filter/extract.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/extract.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/fileglob.yml Outdated Show resolved Hide resolved
Comment on lines +5 to +6
- return a list of files that matches the supplied path glob pattern
- filters run on the controller, so the files are matched from the controller's file system
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- return a list of files that matches the supplied path glob pattern
- filters run on the controller, so the files are matched from the controller's file system
- Return a list of files that matches the supplied path glob pattern.
- Filters run on the controller, so the files are matched from the controller's file system.

lib/ansible/plugins/filter/fileglob.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/fileglob.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/flatten.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/flatten.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/flatten.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/flatten.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/flatten.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/from_json.yml Outdated Show resolved Hide resolved
lib/ansible/plugins/filter/from_json.yml Outdated Show resolved Hide resolved
@ansibot ansibot added needs_revision This PR fails CI tests or a maintainer has requested a review/revision of the PR. and removed core_review In order to be merged, this PR must follow the core review workflow. labels Sep 19, 2022
bcoca and others added 2 commits September 20, 2022 09:06
Co-authored-by: Felix Fontein <felix@fontein.de>
@ansibot ansibot added core_review In order to be merged, this PR must follow the core review workflow. and removed needs_revision This PR fails CI tests or a maintainer has requested a review/revision of the PR. labels Sep 20, 2022
@ansible ansible deleted a comment from ansibot Sep 20, 2022
@ansibot
Copy link
Contributor

ansibot commented Sep 20, 2022

The test ansible-test sanity --test yamllint [explain] failed with 2 errors:

lib/ansible/plugins/filter/comment.yml:41:5: key-duplicates: duplication of key "prefix_count" in mapping
lib/ansible/plugins/filter/to_datetime.yml:35:1: empty-lines: too many blank lines (1 > 0)

click here for bot help

@ansibot ansibot added ci_verified Changes made in this PR are causing tests to fail. needs_revision This PR fails CI tests or a maintainer has requested a review/revision of the PR. and removed core_review In order to be merged, this PR must follow the core review workflow. labels Sep 20, 2022
@mkrizek mkrizek removed the needs_triage Needs a first human triage before being processed. label Sep 20, 2022
@ansibot ansibot added core_review In order to be merged, this PR must follow the core review workflow. and removed ci_verified Changes made in this PR are causing tests to fail. needs_revision This PR fails CI tests or a maintainer has requested a review/revision of the PR. labels Sep 20, 2022
@bcoca bcoca merged commit 3b93712 into ansible:devel Sep 20, 2022
@bcoca bcoca deleted the moardocs6 branch September 20, 2022 15:38
@ansibot ansibot added needs_rebase https://docs.ansible.com/ansible/devel/dev_guide/developing_rebasing.html needs_revision This PR fails CI tests or a maintainer has requested a review/revision of the PR. and removed core_review In order to be merged, this PR must follow the core review workflow. labels Sep 20, 2022
@ansible ansible locked and limited conversation to collaborators Sep 27, 2022
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
affects_2.14 docs This issue/PR relates to or includes documentation. needs_rebase https://docs.ansible.com/ansible/devel/dev_guide/developing_rebasing.html needs_revision This PR fails CI tests or a maintainer has requested a review/revision of the PR. new_plugin This PR includes a new plugin. support:core This issue/PR relates to code supported by the Ansible Engineering Team.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

5 participants