vmware_custom_attribute_manager: Enhance custom attribute management

[sbaerlocher]

SUMMARY

Extended support for additional object types and refactored the code to improve maintainability and readability. This update includes consistent parameter naming, the introduction of type hints and enhanced validations, and a more structured error handling approach. These changes enable a more robust integration with vCenter/vSphere.

ISSUE TYPE

• Feature Pull Request

COMPONENT NAME

vmware_custom_attribute_manager

ADDITIONAL INFORMATION

The changes include:

• Extended Object Types:
  • Expanding the supported vSphere object types by adding "Network" and "VirtualApp".
• Standardizing the parameter naming to "attributes" in the module documentation, options, and code.
  • Refactoring the module to consolidate setting and clearing custom attributes into a single method (process_custom_attributes) and providing an alias (update) for backward compatibility.
  • Adding enhanced validations for required parameters (ensuring that object_name and object_type are non-empty strings and that attributes is a non-empty list).
  • Implementing structured exception handling to catch and report specific errors more clearly.

[softwarefactory-project-zuul]

Build failed.
https://ansible.softwarefactory-project.io/zuul/buildset/6cd66da0d0c24a54b7f662a7b4e2bb88

✔️ ansible-tox-linters SUCCESS in 5m 03s
✔️ build-ansible-collection SUCCESS in 7m 29s
⚠️ ansible-test-cloud-integration-vcenter7_only-stable218 CANCELED
⚠️ ansible-test-cloud-integration-vcenter7_2esxi-stable218 CANCELED
⚠️ ansible-test-cloud-integration-vcenter7_1esxi-stable218_1_of_2 CANCELED
❌ ansible-test-cloud-integration-vcenter7_1esxi-stable218_2_of_2 FAILURE in 9m 39s
✔️ ansible-galaxy-importer SUCCESS in 3m 50s

[softwarefactory-project-zuul]

Build succeeded.
https://ansible.softwarefactory-project.io/zuul/buildset/fbcb9ee31ca24b85bcb6f0ce091a045d

✔️ ansible-tox-linters SUCCESS in 4m 33s
✔️ build-ansible-collection SUCCESS in 7m 29s
✔️ ansible-test-cloud-integration-vcenter7_only-stable218 SUCCESS in 20m 58s
✔️ ansible-test-cloud-integration-vcenter7_2esxi-stable218 SUCCESS in 19m 36s
✔️ ansible-test-cloud-integration-vcenter7_1esxi-stable218_1_of_2 SUCCESS in 51m 13s
✔️ ansible-test-cloud-integration-vcenter7_1esxi-stable218_2_of_2 SUCCESS in 55m 54s
✔️ ansible-galaxy-importer SUCCESS in 4m 36s