[Path] Add both "present" end "absent" tests to check path dict state

Author: nervo

path/CHANGELOG.md

@@ -10,6 +10,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 
 - Add a "parse" filter to get path components
+- Add both "present" end "absent" tests to check path dict state
 
 ## [2.2.0] - 2026-01-02
 

path/plugins/test/absent.yaml

@@ -0,0 +1,20 @@
+---
+
+DOCUMENTATION:
+  name: absent
+  author:
+    - Manala (@manala)
+  short_description: Test if path dict is in an absent state
+  description:
+    - Test if path dict is in an absent state.
+  options:
+    _input:
+      description: A path dict.
+      type: dict
+      required: true
+
+EXAMPLES: |
+  - ansible.builtin.assert:
+      that:
+        - >
+          {'path': 'foo'} is manala.path.absent

path/plugins/test/present.yaml

@@ -0,0 +1,20 @@
+---
+
+DOCUMENTATION:
+  name: present
+  author:
+    - Manala (@manala)
+  short_description: Test if path dict is in a present state
+  description:
+    - Test if path dict is in a present state.
+  options:
+    _input:
+      description: A path dict.
+      type: dict
+      required: true
+
+EXAMPLES: |
+  - ansible.builtin.assert:
+      that:
+        - >
+          {'path': 'foo'} is manala.path.present

path/plugins/test/state.py

@@ -25,6 +25,20 @@ def _directory(path):
     return _filter_state(path) == 'directory'
 
 
+def _present(path):
+    if not isinstance(path, dict):
+        raise AnsibleTemplateError(f'present expects a dict but was given a {type(path).__name__}')
+
+    return _filter_state(path) != 'absent'
+
+
+def _absent(path):
+    if not isinstance(path, dict):
+        raise AnsibleTemplateError(f'absent expects a dict but was given a {type(path).__name__}')
+
+    return _filter_state(path) == 'absent'
+
+
 class TestModule(object):
     """ Manala path state jinja2 tests """
 
@@ -33,4 +47,6 @@ def tests(self):
             'file': _file,
             'link': _link,
             'directory': _directory,
+            'present': _present,
+            'absent': _absent,
         }

path/tests/unit/plugins/test/test_state.py

@@ -4,6 +4,8 @@
 from plugins.test.state import _file as _test_file
 from plugins.test.state import _link as _test_link
 from plugins.test.state import _directory as _test_directory
+from plugins.test.state import _present as _test_present
+from plugins.test.state import _absent as _test_absent
 
 from ansible.errors import AnsibleTemplateError
 
@@ -28,6 +30,8 @@ def test_empty(self):
         self.assertFalse(_test_file(path))
         self.assertFalse(_test_link(path))
         self.assertTrue(_test_directory(path))
+        self.assertTrue(_test_present(path))
+        self.assertFalse(_test_absent(path))
 
     def test_explicit(self):
         path_absent = {'path': 'path', 'state': 'absent'}
@@ -50,6 +54,16 @@ def test_explicit(self):
         self.assertFalse(_test_directory(path_link))
         self.assertTrue(_test_directory(path_directory))
 
+        self.assertFalse(_test_present(path_absent))
+        self.assertTrue(_test_present(path_file))
+        self.assertTrue(_test_present(path_link))
+        self.assertTrue(_test_present(path_directory))
+
+        self.assertTrue(_test_absent(path_absent))
+        self.assertFalse(_test_absent(path_file))
+        self.assertFalse(_test_absent(path_link))
+        self.assertFalse(_test_absent(path_directory))
+
     def test_implicit_file(self):
         path_content = {'path': 'path', 'content': 'content'}
         path_content_none = {'path': 'path', 'content': None}
@@ -79,6 +93,20 @@ def test_implicit_file(self):
         self.assertFalse(_test_directory(path_template))
         self.assertTrue(_test_directory(path_template_none))
 
+        self.assertTrue(_test_present(path_content))
+        self.assertTrue(_test_present(path_content_none))
+        self.assertTrue(_test_present(path_file))
+        self.assertTrue(_test_present(path_file_none))
+        self.assertTrue(_test_present(path_template))
+        self.assertTrue(_test_present(path_template_none))
+
+        self.assertFalse(_test_absent(path_content))
+        self.assertFalse(_test_absent(path_content_none))
+        self.assertFalse(_test_absent(path_file))
+        self.assertFalse(_test_absent(path_file_none))
+        self.assertFalse(_test_absent(path_template))
+        self.assertFalse(_test_absent(path_template_none))
+
     def test_implicit_link(self):
         path_src = {'path': 'path', 'src': 'src'}
         path_src_none = {'path': 'path', 'src': None}
@@ -92,6 +120,12 @@ def test_implicit_link(self):
         self.assertFalse(_test_directory(path_src))
         self.assertTrue(_test_directory(path_src_none))
 
+        self.assertTrue(_test_present(path_src))
+        self.assertTrue(_test_present(path_src_none))
+
+        self.assertFalse(_test_absent(path_src))
+        self.assertFalse(_test_absent(path_src_none))
+
     def test_implicit_directory(self):
         path = {'path': 'path'}
 
@@ -100,3 +134,7 @@ def test_implicit_directory(self):
         self.assertFalse(_test_link(path))
 
         self.assertTrue(_test_directory(path))
+
+        self.assertTrue(_test_present(path))
+
+        self.assertFalse(_test_absent(path))