Merge pull request #3463 from stoned/filterskipped

Add Jinja2 filter 'skipped' to test for a registered variable from a ski...

docsite/latest/rst/playbooks2.rst

@@ -300,6 +300,8 @@ decide to do something conditionally based on success or failure::
         when: result|failed
       - action: command /bin/something_else
         when: result|success
+      - action: command /bin/still/something_else
+        when: result|skipped
 
 
 As a reminder, to see what derived variables are available, you can do::

lib/ansible/runner/filter_plugins/core.py

@@ -45,6 +45,13 @@ def failed(*a, **kw):
 def success(*a, **kw):
     return not failed(*a, **kw)
 
+def skipped(*a, **kw):
+    item = a[0]
+    if type(item) != dict:
+        raise errors.AnsibleError("|skipped expects a dictionary")
+    skipped = item.get('skipped', False)
+    return skipped
+
 def mandatory(a):
     ''' Make a variable mandatory '''
     if not a:
@@ -93,6 +100,9 @@ class FilterModule(object):
             'failed'  : failed,
             'success' : success,
 
+            # skip testing
+            'skipped' : skipped,
+
             # variable existence
             'mandatory': mandatory,