Refactoring Idea: s3_bucket

[alinabuzachis]

Summary

The s3_bucket plugin, as it is currently written, is very difficult to understand and quite complex.
I propose to refactor it to make our code easier to understand, in particular:

• Break each function down into smaller scoped functions.
• Add documentation to each function to clarify what it does.
• Ensure that each method has type hints so that it is clear what a given method returns.
• Make sure we have unit tests that cover all the logic we are trying to apply.

Issue Type

Feature Idea

Component Name

s3_bucket

Additional Information

No response

Code of Conduct

• I agree to follow the Ansible Code of Conduct