feat: Add has_target_in_args helper

Author: tony

src/libtmux/common.py

@@ -445,6 +445,43 @@ def session_check_name(session_name: t.Optional[str]) -> None:
         raise exc.BadSessionName(reason="contains colons", session_name=session_name)
 
 
+def has_target_in_args(val: t.List[t.Any]) -> bool:
+    """Return True if target in args.
+
+    Parameters
+    ----------
+    val : any
+        Any value to check if target is in it.
+
+    Returns
+    -------
+    bool
+        True if target in args.
+
+    Examples
+    --------
+    >>> has_target_in_args(['-t',])
+    False
+    >>> has_target_in_args(['-t', 'mytarget'])
+    True
+    >>> has_target_in_args(['-tmytarget'])
+    True
+    """
+    for idx, item in enumerate(val):
+        if not isinstance(item, str):
+            continue
+
+        if item == "-t":
+            try:
+                val[idx + 1]
+            except IndexError:
+                return False
+            return True
+        elif item.startswith("-t"):
+            return True
+    return False
+
+
 def handle_option_error(error: str) -> t.Type[exc.OptionError]:
     """Raise exception if error in option command found.