[Imprv] fiql string in filtering

examples/vm_info.yml

@@ -22,7 +22,13 @@
         kind: vm
       register: result
       ignore_errors: True
-
+
+    - name: List vms using FIQL filter string
+      ntnx_vms_info:
+        filter_string: "vm_name=={{vm.name}};power_state==off"
+      register: result
+      ignore_errors: True
+
     - name: List vms using length, offset and ascending vm_name sorting 
       ntnx_vms_info:
         length: 10

plugins/doc_fragments/ntnx_info.py

@@ -31,10 +31,14 @@ class ModuleDocFragment(object):
     type: int
   filter:
     description:
-      - The filter in FIQL syntax used for the results
+      - The filter in key-value syntax used for the results
     type: dict
   custom_filter:
     description:
-      - The filter in FIQL syntax used for the results
+      - The filter in key-value syntax used for the results
     type: dict
+  filter_string:
+    description:
+      - The filter in FIQL syntax used for the results
+    type: str
 """

plugins/module_utils/base_info_module.py

@@ -15,12 +15,21 @@ class BaseInfoModule(BaseModule):
         length=dict(type="int"),
         filter=dict(type="dict"),
         custom_filter=dict(type="dict"),
+        filter_string=dict(type="str"),
     )
 
+    info_args_mutually_exclusive = [
+        ("filter", "filter_string"),
+    ]
+
     def __init__(self, skip_info_args=False, **kwargs):
         self.argument_spec = deepcopy(BaseModule.argument_spec)
         self.argument_spec.pop("state")
         self.argument_spec.pop("wait")
         if not skip_info_args:
             self.argument_spec.update(self.info_argument_spec)
+            info_args_mutually_exclusive = deepcopy(self.info_args_mutually_exclusive)
+            if kwargs.get("mutually_exclusive"):
+                info_args_mutually_exclusive.extend(kwargs["mutually_exclusive"])
+            kwargs["mutually_exclusive"] = info_args_mutually_exclusive
         super(BaseInfoModule, self).__init__(**kwargs)

plugins/module_utils/entity.py

@@ -283,10 +283,14 @@ def get_info_spec(self):
             else:
                 spec.pop(key)
 
-        if params.get("filter", {}).get("name") and params.get("kind") == "vm":
-            spec["filter"]["vm_name"] = spec["filter"].pop("name")
+        if params.get("filter"):
+            if params.get("filter", {}).get("name") and params.get("kind") == "vm":
+                spec["filter"]["vm_name"] = spec["filter"].pop("name")
 
-        spec["filter"] = self._parse_filters(params.get("filter", {}))
+            spec["filter"] = self._parse_filters(params.get("filter", {}))
+
+        elif params.get("filter_string"):
+            spec["filter"] = params["filter_string"]
 
         return spec, None
 

tests/integration/targets/nutanix_vms_info/tasks/list_vms.yml

@@ -1,3 +1,43 @@
+- set_fact:
+    todelete: []
+
+- name: Creat anohter VM with same name 
+  ntnx_vms:
+    name: "{{ vm.name }}"
+    cluster:
+      name: "{{ cluster.name }}"
+    state: "power_off"
+  register: output
+  ignore_errors: true
+
+- name: Creation Status
+  assert:
+    that:
+      - output.response is defined
+      - output.response.status.state == 'COMPLETE'
+    fail_msg: ' Unable to create VM with minimum requiremnts '
+    success_msg: ' VM with minimum requiremnts created successfully '
+
+- set_fact:
+    todelete: '{{ todelete + [  output["response"]["metadata"]["uuid"] ] }}'
+  when: output.response.status.state == 'COMPLETE'
+##################################################
+- name: List vms using filter_string
+  ntnx_vms_info:
+    filter_string: vm_name=={{vm.name}};power_state==off
+  register: result
+  ignore_errors: True
+
+- name: Listing Status
+  assert:
+    that:
+      - result.response is defined
+      - result.response.entities[0].metadata.uuid == '{{output["response"]["metadata"]["uuid"]}}'
+      - result.response.metadata.kind == "vm"
+      - result.response.metadata.total_matches == 1
+    fail_msg: " Unable to list vms using filter_string"
+    success_msg: " VMs listed successfully using filter_string "
+################################################## 
 - name: List vms using name filter criteria
   ntnx_vms_info:
     filter:
@@ -44,3 +84,11 @@
     fail_msg: " Unable to list vms "
     success_msg: " VMs listed successfully "
 ####################################################
+- name: Delete all Created VMs 
+  ntnx_vms:
+    state: absent
+    vm_uuid: '{{ item }}'
+  register: result
+  loop: '{{ todelete }}'
+- set_fact:
+    todelete: []