feat(anta.tests)!: Implement caching

[carl-baillargeon]

Description

Implement caching with aiocache library.

Cache key design:

<device_name>:<uid>

The uid is a new property attribute of AntaCommand, which is a UID generated from the command, version, revision and output format.

Each UID has its own asyncio Lock. This way, coroutines that need to access the cache for different uid's can do so concurrently.

Caching is implemented in the AntaDevice.collect_commands async function where the inner collect_command function first checks if the command.uid is present in the cache and if it is, command.output will be populate by the cache. If not, the collect() function will be run as usual and the output will be saved in the cache.

Fixes #342

Tasks:

• Add a knob in AntaTest to activate/deactivate caching for a specific test
• Add logging with aiocache plugins for cache hit ratio, etc.
• Implement click CLI options to tweak caching (TTL, etc.)
• Maybe need to add a coroutine to check and clean-up unused Locks.
• Add functionalities to support external backend caches like Redis/memcached - future PR.
• Documentation + examples

Caveats:

• Some tests in ANTA will break with caching. Logging tests are a good example where we generate a log message and check for that log right after. That's why we need a way to activate/deactivate caching for specific tests.
• Since there is a lot of varied UIDs and each device has its own instance of the AntaDevice class, we might need a lock cleanup strategy to optimize performance when running thousands of tests on hundreds devices.

Checklist:

• My code follows the style guidelines of this project
• I have performed a self-review of my code
• I have run pre-commit for code linting and typing (pre-commit run)
• I have made corresponding changes to the documentation
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes (tox -e testenv)

[github-actions]

Conflicts have been resolved. A maintainer will review the pull request shortly.

[gmuloc]

• Let's add a way in the inventory to disable the cache per device if needed
• Let's add a CLI to disable the cache completely as well (as mentioned in your PR)
• Documentation to add as well with examples maybe
  • Disabling cache for a command
  • Disabling cache globally
  • Disabling cache for a device from the inventory

[titom73]

Looks good after resolving points raised by @gmuloc