def find_file(re_filter=None, branch=".", recurse=True, depth=0, get_file=True, get_dir=True, case_i=True): """Search a branch directory for files and / or directories whose name matches one or more of the filter patterns Args: branch (str): (optional) Directory to search. Suggestion: use absolute path. Defaults to current working directory. re_filter (list): (optional) List of strings of wildcard patterns. Defaults to None, which skips any filtering. recurse (bool): (optional) Recursive search flag. Defaults to True. depth (int): (optional) Set the recursion depth. Defaults to 0, which has a max of Python's recursion limit. get_file (bool): (optional) Return entry for file. Defaults to True. get_dir (bool): (optional) Return entry for directory. Defaults to True. case_i (bool): (optional) Case insensitive search. Defaults to True. Returns: list: List of strings with paths of files. """ if not is_str_not_empty(branch): raise ValueError("branch must be a non empty string") if not os.path.isdir(branch): raise ValueError("branch must be a valid directory") if not is_bool(recurse): raise ValueError("recurse must be True or False") if is_int_neg(depth): raise ValueError("depth must be >= 0") if not is_bool(get_file): raise ValueError("get_file must be True or False") if not is_bool(get_dir): raise ValueError("get_dir must be True or False") if not is_bool(case_i): raise ValueError("case_i must be True or False") search_results = list_dir(branch, recurse, depth, get_file, get_dir) if re_filter is None or len(re_filter) < 1: return search_results elif re_filter == "*": return search_results elif is_list(re_filter) and "*" in re_filter: return search_results if is_str(re_filter): re_filter = [re_filter] re_flag = 0 if case_i: re_flag = re.IGNORECASE bre = partial(wildcard_re, wildcard="*", escape="\\") return list_filter(map(bre, re_filter), search_results, re_flag)
def find_file_re(re_filter=None, branch=".", recurse=True, depth=0, get_file=True, get_dir=True, re_flag=0): """Search a branch directory for files and / or directories whose name matches one or more of the regex filter patterns Args: branch (str): (optional) Directory to search. Suggestion: use absolute path. Defaults to current working directory. re_filter (list): (optional) List of strings of regular expression patterns. Defaults to None, which skips any filtering. recurse (bool): (optional) Recursive search flag. Defaults to True. depth (int): (optional) Set the recursion depth. Defaults to 0, which has a max of Python's recursion limit. get_file (bool): (optional) Return entry for file. Defaults to True. get_dir (bool): (optional) Return entry for directory. Defaults to True. re_flag (int): (optional) See :py:mod:`re` Returns: list: List of strings with paths of files. """ if not is_str_not_empty(branch): raise ValueError("branch must be a non empty string") if not os.path.isdir(branch): raise ValueError("branch must be a valid directory") if not is_bool(recurse): raise TypeError("recurse must be True or False") if is_int_neg(depth): raise ValueError("depth must be >= 0") if not is_bool(get_file): raise ValueError("get_file must be True or False") if not is_bool(get_dir): raise ValueError("get_dir must be True or False") search_results = list_dir(branch, recurse, depth, get_file, get_dir) if re_filter is None or len(re_filter) < 1: return search_results if is_str(re_filter): re_filter = [re_filter] return list_filter(re_filter, search_results, re_flag)