[Path] Support "force" argument on path link

Author: nervo

path/CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Support "force" argument on path link, to create link even if the source does not exist
+
 ## [2.3.0] - 2026-01-02
 
 ### Added

path/plugins/action/path.py

@@ -22,6 +22,7 @@ def run(self, tmp=None, task_vars=None):
                 'content': {'type': 'str'},
                 'file': {'type': 'path'},
                 'template': {'type': 'path'},
+                'force': {'type': 'bool'},
                 'vars': {'type': 'dict', 'default': {}},
                 'src': {'type': 'path'},
                 'user': {'type': 'str'},
@@ -184,6 +185,7 @@ def run_link(self, args, task_vars):
                 'path': args['path'],
                 'src': args['src'],
                 'state': 'link',
+                'force': args['force'] if (args.get('force') is not None) else False,
                 'owner': args['user'],
                 'group': args['group'],
             },

path/tests/integration/targets/path/tasks/link.yaml

@@ -13,8 +13,10 @@
       - { path: file, state: touch }
     paths:
       - { path: explicit_file, state: link, src: file }
+      - { path: explicit_missing_file, state: link, src: missing_file }
     expected:
-      - { path: explicit_file, exists: true, islnk: true, lnk_target: file }
+      - { path: explicit_file, exists: true, islnk: true, lnk_target: file, readable: true }
+      - { path: explicit_missing_file, exists: true, islnk: true, lnk_target: missing_file, readable: false }
   block:
 
     - name: link | Prepare root
@@ -51,6 +53,7 @@
           - stats.results[index].stat.exists == expected[index].exists
           - stats.results[index].stat.islnk == expected[index].islnk
           - stats.results[index].stat.lnk_target == expected[index].lnk_target
+          - stats.results[index].stat.readable == expected[index].readable
       loop: "{{ expected }}"
       loop_control:
         index_var: index