M #-: Move 'match_address' to module_utils (fix)

plugins/module_utils/main.py

@@ -3,6 +3,32 @@
 # Apache License, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0)
 
 
+# NOTE: It does not validate character classes or character count!
+# EXAMPLES:
+# pci -> match_address('0000:0*:00.*', sep='[:.]')
+# mac -> match_address('52:54:*:*:*:0*', sep='[:]')
+def match_address(address, pattern, sep=None):
+    """Tests if a split string matches a set of simple glob patterns."""
+
+    import fnmatch
+    import re
+
+    # In case no separator is provided simply match the whole string.
+    if sep is None:
+        return fnmatch.fnmatch(address, pattern)
+
+    # Make sure both address and pattern contain identical separators.
+    if re.findall(sep, address) != re.findall(sep, pattern):
+        return False
+
+    # Try matching (glob) each segment separately.
+    for x, y in zip(re.split(sep, address), re.split(sep, pattern)):
+        if not fnmatch.fnmatch(x, y):
+            return False
+
+    return True
+
+
 def flatten(to_flatten, extract=False):
     """Flattens nested lists (with optional value extraction)."""
 

plugins/test/main.py

@@ -1,32 +1,6 @@
-#!/usr/bin/env python
+from ansible_collections.opennebula.deploy.plugins.module_utils.main import match_address
 
-import fnmatch
-import re
 
 class TestModule(object):
     def tests(self):
-        return {
-            'match_address': self.match_address,
-        }
-
-    # NOTE: It does not validate character classes or character count!
-    # EXAMPLES:
-    # pci -> match_address('0000:0*:00.*', sep='[:.]')
-    # mac -> match_address('52:54:*:*:*:0*', sep='[:]')
-    def match_address(self, address, pattern, sep=None):
-        """Tests if a split string matches a set of simple glob patterns."""
-
-        # In case no separator is provided simply match the whole string.
-        if sep is None:
-            return fnmatch.fnmatch(address, pattern)
-
-        # Make sure both address and pattern contain identical separators.
-        if re.findall(sep, address) != re.findall(sep, pattern):
-            return False
-
-        # Try matching (glob) each segment separately.
-        for x, y in zip(re.split(sep, address), re.split(sep, pattern)):
-            if not fnmatch.fnmatch(x, y):
-                return False
-
-        return True
+        return dict(match_address=match_address)

plugins/test/match_address.yml

@@ -13,6 +13,11 @@ DOCUMENTATION:
         - An address to match.
       type: string
       required: true
+    pattern:
+      description:
+        - A string containing a sequence of glob patterns.
+      type: string
+      required: true
     sep:
       description:
         - A regex expression used to split the input string (optional).