Fix(plugins): Prevent deprecation warnings when deprecated filters are not used

[gmuloc]

Change Summary

in 4.9.0 3 filters have been deprecated to be removed in 5.0.0

When running AVD and not using the filters in the playbook, users sees the deprecation warnings and they cannot do anything about it. This is because of the way ansible loads filters. A workaround has been found in this PR where all the deprecated filters are grouped in the same python file and the documentation is kept on the side.

Related Issue(s)

Fixes issue reported on slack and in the field

Component(s) name

plugins

Proposed changes

cf summary +

• updated pre-commit to render documentation from yaml files for these filters and ignore the deprecated_filter.py file

How to test

when running in molecule no more warnings.

Checklist

Repository Checklist

• My code has been rebased from devel before I start
• I have read the CONTRIBUTING document.
• My change requires a change to the documentation and documentation have been updated accordingly.
• I have updated molecule CI testing accordingly. (check the box if not applicable)

[github-actions]

Review docs on Read the Docs

To test this pull request:

# Create virtual environment for this testing below the current directory
python -m venv test-avd-pr-4199
# Activate the virtual environment
source test-avd-pr-4199/bin/activate
# Install all requirements including PyAVD
pip install "pyavd[ansible] @ git+https://github.com/gmuloc/avd.git@remove-deprecated-plugins-warning-when-not-used#subdirectory=python-avd" --force
# Install Ansible collection
ansible-galaxy collection install git+https://github.com/gmuloc/avd.git#/ansible_collections/arista/avd/,remove-deprecated-plugins-warning-when-not-used --force
# Optional: Install AVD examples
cd test-avd-pr-4199
ansible-playbook arista.avd.install_examples

[pmprado]

Tested on a Caravan repository and all the warnings were gone.

[carlbuchmann]

LGTM + added test in deprecated vars to ensure warning is raised: