Function try_resolve_path

keepercommander/subfolder.py:146–178

Look up the final keepercommander.subfolder.UserFolderNode and name of the final component(s). Set find_all_matches = True to get a list of folders and component path If a record, the final component is the record. If existent folder(s), the final component is ''. If a non-exis

(params, path, find_all_matches=False)

def try_resolve_path(params, path, find_all_matches=False):
    # type: (KeeperParams, str, bool) -> Tuple[Union[List[BaseFolderNode], BaseFolderNode, None], Optional[str]]
    """
    Look up the final keepercommander.subfolder.UserFolderNode and name of the final component(s).
    Set find_all_matches = True to get a list of folders and component path

    If a record, the final component is the record.
    If existent folder(s), the final component is ''.
    If a non-existent folder, the final component is the folders, joined with /, that do not (yet) exist..
    """
    if type(path) is not str:
        path = ''

    folder = (
        params.folder_cache[params.current_folder]
        if params.current_folder in params.folder_cache
        else params.root_folder
    )

    folder, components = path_split(params, folder, path)

    remainder, folders = lookup_path(params, folder, components)

    tail = components[remainder:]

    path = '/'.join(component.replace('/', '//') for component in tail)

    # Return a 2-tuple of BaseFolderNode (or List[BaseFolderNode] if find_all_matches set to True), str
    # The first is the folder/s containing the second, or the folder of the last component if the second is ''.
    # The second is the final component of the path we're passed as an argument to this function. It could be a record, or
    # a not-yet-existent directory.
    return (folders, path) if find_all_matches \
        else (next(iter(folders)) if folders else None, path)


def get_folder_uids(params, name):  # type: (KeeperParams, str or None) -> Set[Optional[str]]