HackUpdate.py

#!/usr/bin/env python
# 0.0.0
from Scripts import bdmesg, disk, run, utils
import os, sys, json, shutil, argparse, subprocess, datetime, time, glob

class HackUpdate:
    def __init__(self, **kwargs):
        self.r  = run.Run()
        self.d  = disk.Disk()
        self.u  = utils.Utils("HackUpdate")
        self.boot_manager = bdmesg.get_bootloader_uuid()
        # Get the tools we need
        self.script_folder = "Scripts"
        self.settings = None
        cwd = os.getcwd()
        os.chdir(os.path.dirname(os.path.realpath(__file__)))
        # Load the settings if they exist
        settings_default = "./Scripts/settings.json"
        settings_path = kwargs.get("settings",settings_default)
        self.settings_file = self.u.check_path(settings_path)
        if settings_path != settings_default and not self.settings_file:
            # We have one specified, but couldn't find it
            self.u.head("Settings Error")
            print("")
            print("Failed to locate \"{}\".".format(settings_path))
            print("")
            exit(1)
        if self.settings_file:
            # The path resolved properly - try loading it
            try:
                self.settings = json.load(open(self.settings_file))
            except Exception as e:
                self.u.head("Settings Error")
                print("")
                print("Failed to load \"{}\":\n\n{}".format(os.path.basename(self.settings_file),e))
                print("")
                exit(1)
        # Fall back on defaults in the event they don't exist, or don't load
        if not self.settings:
            self.settings = {
                # Default settings here
                "debug_subscripts": False,
                "efi"  : "bootloader", # ask, boot, bootloader, or the mount point/disk#s#
                "disk" : None, # Overrides efi, and is an explicit mount point/identifier (not resolved to EFI)
                "no_git": False, # Prevents attempting to git pull each repo
                "folder_path" : None, # Overrides disk and efi, and is a direct path to the EFI folder
                "no_header": False,
                "skip_building_kexts" : False,
                "skip_extracting_kexts" : False,
                "skip_opencore" : False,
                "skip_plist_compare" : False,
                "lnf"  : "../Lilu-and-Friends",
                "lnfrun" : "Run.command",
                # "lnf_args" : ["-p", "Default"], # List of customized Lilu and Friends args
                "ke" : "../KextExtractor",
                "kerun" : "KextExtractor.command",
                # "ke_args" : [], # List of customized KextExtractor args
                "oc" : "../OC-Update",
                "ocrun" : "OC-Update.command",
                # "oc_args" : [], # List of customized OC-Update args
                "occ" : "../OCConfigCompare",
                "occrun" : "OCConfigCompare.command",
                # "occ_args" : [], # List of customized OCConfigCompare args
                "occ_unmount": False # Whether we unmount if differences are found or not
                # preflight : [ # List of tasks to run before anything else
                #    {"path":"/path/to/tool","args":["list","of","args"],"message":"something to display","abort_on_fail":True/False}
                # ],
                # postflight : [ # List of tasks to run after everything else
                #    {"path":"/path/to/tool","args":["list","of","args"],"message":"something to display","abort_on_fail":True/False}
                # ]
            }
        # Let's strip empty *_args entries
        empty_args = []
        for key in self.settings:
            if (key.endswith("_args") or key in ("preflight","postflight")) and isinstance(self.settings[key],(list,tuple)) and not self.settings[key]:
                empty_args.append(key)
        for key in empty_args:
            self.settings.pop(key,None)
        # Setup some colors
        self.c = {
            "r":u"\u001b[31;1m",
            "g":u"\u001b[32;1m",
            "b":u"\u001b[36;1m",
            "c":u"\u001b[0m"
        }
        os.chdir(cwd)

    def get_git(self):
        # Return the first instance
        git_path = self.r.run({"args":["which","git"]})[0].split("\n")[0].strip()
        if git_path and os.path.isfile(git_path):
            return git_path

    def update_repo(self,git_path,repo_path):
        cwd = os.getcwd()
        os.chdir(repo_path)
        print(" - Updating {} repo...".format(os.path.basename(repo_path)))
        updated = False
        o,e,r = self.r.run({"args":[git_path,"pull"]})
        if r != 0:
            if "not a git repository" in e:
                print(" --> Not a git repository.")
            else:
                print(" --> Pull failed with error code: {}".format(r))
        elif o:
            if "up to date" in o:
                print(" --> Already up to date.")
            else:
                print(" --> Updated to latest commit.")
                updated = True
        os.chdir(cwd)
        return updated

    def get_time(self,t):
        # A helper function to return a human readable time string from seconds
        try:
            dt = datetime.timedelta(seconds=int(t))
            time_tuple = (
                ("week",int(dt.days/7)),
                ("day",int(dt.days%7)),
                ("hour",int(dt.seconds/3600)),
                ("minute",int(dt.seconds%3600/60)),
                ("second",int(dt.seconds%3600%60))
            )
            msg_parts = ["{:,} {}{}".format(x[1],x[0],"" if x[1]==1 else "s") for x in time_tuple if x[1]]
        except:
            msg_parts = [] # Something went wrong - use an empty list
        return ", ".join(msg_parts) if len(msg_parts) else "0 seconds"

    def resolve_args(self, args, disk = None, folder_path = None):
        # Walk the passed list of args and replace instances of the following
        # case-sensitive placeholders:
        #
        # [[cd]]:          the current path to the folder containing this script
        # [[user]]:        the current user's home folder
        # [[disk]]:        the target disk/efi identifier
        # [[mount_point]]: the target disk/efi mount point, if any
        # [[folder_path]]: the target folder, if any - overrides disk and mount_point
        # [[config_path]]: resolves config.plist based on the folder_path or mount_point
        # [[oc_path]]:     resolves OpenCore.efi based on the folder_path or mount_point
        # [[lnf]]:         the path to Lilu-and-Friends
        # [[ke]]:          the path to KextExtractor
        # [[oc]]:          the path to OC-Update
        # [[occ]]:         the path to OCConfigCompare
        #

        d = self.d.get_identifier(disk)
        m = self.d.get_mount_point(disk)
        f = self.u.check_path(folder_path) if folder_path else None
        c = None
        o = None
        if f:
            # Check for f/EFI/OC/config.plist, f/OC/config.plist or f/config.plist
            path_check = ("EFI","OC")
            for i in range(len(path_check)+1):
                c_check = os.path.join(f,*path_check[i:],"config.plist")
                o_check = os.path.join(f,*path_check[i:],"OpenCore.efi")
                if os.path.isfile(c_check):
                    c = c_check
                if os.path.isfile(o_check):
                    o = o_check
        elif m:
            c_check = os.path.join(m,"EFI","OC","config.plist")
            o_check = os.path.join(m,"EFI","OC","OpenCore.efi")
            if os.path.isfile(c_check):
                c = c_check
            if os.path.isfile(o_check):
                o = o_check

        cwd  = os.getcwd()
        user = os.path.expanduser("~")
        cd   = os.path.dirname(os.path.realpath(__file__))
        os.chdir(cd)
        lnf  = os.path.realpath(self.settings.get("lnf","../Lilu-and-Friends"))
        ke   = os.path.realpath(self.settings.get("ke","../KextExtractor"))
        oc   = os.path.realpath(self.settings.get("oc","../OC-Update"))
        occ  = os.path.realpath(self.settings.get("occ","../OCConfigCompare"))
        os.chdir(cwd)

        new_args = []
        for arg in args:
            if f: # Only worry about the folder_path and config_path
                arg = arg.replace("[[folder_path]]",f)
                if c: arg = arg.replace("[[config_path]]",c)
                if o: arg = arg.replace("[[oc_path]]",o)
            elif d: # Only get the disk, mount_point, and config_path if accessible
                arg = arg.replace("[[disk]]",d)
                if m:
                    arg = arg.replace("[[mount_point]]",m)
                    if c: arg = arg.replace("[[config_path]]",c)
                    if o: arg = arg.replace("[[oc_path]]",o)
            arg = arg.replace("[[lnf]]",lnf) \
                  .replace("[[ke]]",ke) \
                  .replace("[[oc]]",oc) \
                  .replace("[[occ]]",occ) \
                  .replace("[[cd]]",cd) \
                  .replace("[[user]]",user)
            new_args.append(arg)
        return new_args

    def get_efi(self,allow_main=True):
        while True:
            self.d.update()
            pad = 4
            disk_string = "\n"
            if not self.settings.get("full"):
                boot_disk = self.d.get_parent(self.boot_manager)
                mounts = self.d.get_mounted_volume_dicts()
                # Gather some formatting info
                name_pad = size_pad = type_pad = 0
                index_pad = len(str(len(mounts)))
                for x in mounts:
                    if len(str(x["name"])) > name_pad: name_pad = len(str(x["name"]))
                    if len(x["size"]) > size_pad: size_pad = len(x["size"])
                    if len(str(x["readable_type"])) > type_pad: type_pad = len(str(x["readable_type"]))
                for i,d in enumerate(mounts,start=1):
                    disk_string += "{}. {} | {} | {} | {}".format(
                        str(i).rjust(index_pad),
                        str(d["name"]).ljust(name_pad),
                        d["size"].rjust(size_pad),
                        str(d["readable_type"]).ljust(type_pad),
                        d["identifier"]
                    )
                    if boot_disk and self.d.get_parent(d["identifier"]) == boot_disk:
                        disk_string += " *"
                    disk_string += "\n"
            else:
                mounts = self.d.get_disks_and_partitions_dict()
                disks = list(mounts)
                index_pad = len(str(len(disks)))
                # Gather some formatting info
                name_pad = size_pad = type_pad = 0
                for d in disks:
                    for x in mounts[d]["partitions"]:
                        name = "Container for {}".format(x["container_for"]) if "container_for" in x else str(x["name"])
                        if len(name) > name_pad: name_pad = len(name)
                        if len(x["size"]) > size_pad: size_pad = len(x["size"])
                        if len(str(x["readable_type"])) > type_pad: type_pad = len(str(x["readable_type"]))
                for i,d in enumerate(disks,start=1):
                    disk_string+= "{}. {} ({}):\n".format(
                        str(i).rjust(index_pad),
                        d,
                        mounts[d]["size"]
                    )
                    if mounts[d].get("scheme"):
                        disk_string += "      {}\n".format(mounts[d]["scheme"])
                    if mounts[d].get("physical_stores"):
                        disk_string += "      Physical Store{} on {}\n".format(
                            "" if len(mounts[d]["physical_stores"])==1 else "s",
                            ", ".join(mounts[d]["physical_stores"])
                        )
                    parts = mounts[d]["partitions"]
                    part_list = []
                    for p in parts:
                        name = "Container for {}".format(p["container_for"]) if "container_for" in p else p["name"]
                        p_text = "        - {} | {} | {} | {}".format(
                            str(name).ljust(name_pad),
                            p["size"].rjust(size_pad),
                            str(p["readable_type"]).ljust(type_pad),
                            p["identifier"]
                        )
                        if self.boot_manager and p["disk_uuid"] == self.boot_manager:
                            # Got boot manager
                            p_text += " *"
                        part_list.append(p_text)
                    if len(part_list):
                        disk_string += "\n".join(part_list) + "\n"
            disk_string += "\nS. Switch to {} Output\n".format("Slim" if self.settings.get("full") else "Full")
            disk_string += "B. Select the Boot Drive's EFI\n"
            if self.boot_manager:
                disk_string += "C. Select the Booted EFI (Clover/OC)\n"
            disk_string += ("\nM. Main" if allow_main else "") + "\nQ. Quit\n"
            if self.boot_manager:
                disk_string += "\n(* denotes the booted EFI (Clover/OC)"
            height = max(len(disk_string.split("\n"))+pad,24)
            width  = max((len(x) for x in disk_string.split("\n")))
            if self.settings.get("resize_window",True): self.u.resize(max(80,width), height)
            self.u.head()
            print(disk_string)
            menu = self.u.grab("Pick the drive containing your EFI:  ")
            if not len(menu):
                continue
            if menu.lower() == "q":
                if self.settings.get("resize_window",True): self.u.resize(80,24)
                self.u.custom_quit()
            elif allow_main and menu.lower() == "m":
                if self.settings.get("resize_window",True): self.u.resize(80,24)
                return
            elif menu.lower() == "s":
                self.settings["full"] = not self.settings.get("full")
                continue
            elif menu.lower() == "b":
                disk = "/"
            elif menu.lower() == "c" and self.boot_manager:
                disk = self.boot_manager
            else:
                try: disk = mounts[int(menu)-1]["identifier"] if isinstance(mounts,list) else list(mounts)[int(menu)-1]
                except: disk = menu
            if self.settings.get("resize_window",True): self.u.resize(80,24)
            iden = self.d.get_identifier(disk)
            if not iden:
                self.u.head("Invalid Disk")
                print("")
                print("'{}' is not a valid disk!".format(disk))
                print("")
                self.u.grab("Returning in 5 seconds...", timeout=5)
                continue
            # Valid disk!
            efi = self.d.get_efi(iden)
            if not efi:
                self.u.head("No EFI Partition")
                print("")
                print("There is no EFI partition associated with {}!".format(iden))
                print("")
                self.u.grab("Returning in 5 seconds...", timeout=5)
                continue
            return efi

    def run_tasks(self,key="preflight",name=None,disk=None,folder_path=None):
        print("Iterating {} tasks ({:,} total)".format(name or key,len(self.settings[key])))
        for i,task in enumerate(self.settings[key],start=1):
            print(" - Task {:,} of {:,}:".format(i,len(self.settings[key])))
            if not "path" in task:
                print(" --> Task malformed!")
                if task.get("abort_on_fail"):
                    print(" ---> Aborting...")
                    exit(1)
                continue
            # Got a valid task - verify the path exists
            if not os.path.exists(task["path"]):
                print(" --> Unable to locate {}!".format(task["path"]))
                if task.get("abort_on_fail"):
                    print(" ---> Aborting...")
                    exit(1)
                continue
            # Try to gather args
            args = [task["path"]]
            print(" --> {}{}".format(
                task["path"],
                ": "+str(task["message"]) if "message" in task else ""
            ))
            if task.get("args") and isinstance(task["args"],(tuple,list)):
                args += [a for a in task["args"]]
            # Resolve any arg placeholders
            args = self.resolve_args(args,disk=disk,folder_path=folder_path)
            # Glob as needed
            if task.get("glob"):
                globbed_args = []
                for arg in args:
                    if "*" in arg:
                        try:
                            arg = glob.glob(arg)
                        except:
                            pass
                    if isinstance(arg,list):
                        globbed_args.extend(arg)
                    else:
                        globbed_args.append(arg)
                args = globbed_args
            out = self.r.run({"args":args,"stream":self.settings.get("debug_subscripts",False)})
            if out[2] != 0 and task.get("abort_on_fail"):
                print(" --> Task returned a non-zero exit status - aborting...")
                exit(1)

    def main(self):
        if not self.settings.get("no_header"):
            self.u.head()
            print("")
        # Gather some values
        oc_diff = False
        efi = None
        folder_path = None
        efi_mounted = True # To avoid attempting to unmount a disk we didn't mount
        
        # Get our phases
        skip_building_kexts = self.settings.get("skip_building_kexts",False)
        skip_extracting_kexts = self.settings.get("skip_extracting_kexts",False)
        skip_opencore = self.settings.get("skip_opencore",False)
        skip_plist_compare = self.settings.get("skip_plist_compare",False)
        
        cwd = os.getcwd()
        os.chdir(os.path.dirname(os.path.realpath(__file__)))
        lnf = os.path.realpath(self.settings.get("lnf","../Lilu-and-Friends"))
        ke  = os.path.realpath(self.settings.get("ke","../KextExtractor"))
        oc  = os.path.realpath(self.settings.get("oc","../OC-Update"))
        occ = os.path.realpath(self.settings.get("occ","../OCConfigCompare"))
        os.chdir(cwd)

        # Check if we're using a settings file - and print it if so
        if self.settings_file:
            print("Using settings from:\n - {}".format(self.settings_file))
        else:
            print("Using default settings")

        # Establish git and try to update ourselves if possible
        git = None
        if not self.settings.get("no_git"):
            print("Locating git...")
            git = self.get_git()
            if git:
                print(" - Located at: {}".format(git))
                # Try our update
                if self.update_repo(git,os.path.dirname(os.path.realpath(__file__))):
                    print("Updates found - restarting...")
                    os.execv(sys.executable,[sys.executable,os.path.realpath(__file__)]+sys.argv[1:])
            else:
                print(" - Not located - will not attempt to update repos")

        # Check if we've disabled all steps
        if all((skip_building_kexts,skip_extracting_kexts,skip_opencore,skip_plist_compare)):
            print("All steps skipped, nothing to do.")
            print("\nDone.\n")
            exit()
        if all((skip_extracting_kexts,skip_opencore,skip_plist_compare)):
            print("Target EFI/disk not needed - only building kexts...")
        else:
            if self.settings.get("folder_path"): # We have an explicit folder - use it
                print("Resolving custom folder path \"{}\"...".format(self.settings["folder_path"]))
                folder_path = self.u.check_path(self.settings["folder_path"])
                if not folder_path:
                    print(" - Unable to locate!")
                    exit(1)
            elif self.settings.get("disk"): # We have an explicit disk - use it
                print("Resolving custom disk \"{}\"...".format(self.settings["disk"]))
                efi = self.d.get_identifier(self.settings["disk"])
                if not efi:
                    print(" - Unable to locate!")
                    exit(1)
            else:
                print("Finding EFI...")
                if self.settings.get("efi","bootloader").lower() == "bootloader":
                    efi = self.d.get_efi(bdmesg.get_bootloader_uuid())
                elif self.settings.get("efi","bootloader").lower() == "boot":
                    efi = self.d.get_efi("/")
                else:
                    efi = self.d.get_efi(self.settings.get("efi","bootloader"))
                if not efi:
                    # Let the user pick
                    efi = self.get_efi(allow_main=False)
                    if not efi:
                        print(" - Unable to locate!")
                        exit(1)
                    # Print the backlog
                    self.u.resize(80, 24)
                    self.u.head()
                    print("")
                    print("Finding EFI...")
            if folder_path:
                print(" - Located")
            else:
                print(" - Located at {}".format(efi))
                efi_mounted = self.d.is_mounted(efi)
                if efi_mounted:
                    print(" --> Already mounted")
                else:
                    print(" --> Not mounted, mounting...")
                    self.d.mount_partition(efi)
                if not self.d.is_mounted(efi):
                    print(" --> Failed to mount!")
                    exit(1)
        pid = str(os.getpid())
        print("Running caffeinate to prevent idle sleep...")
        print(" - Bound to PID {}".format(pid))
        subprocess.Popen(["caffeinate","-i","-w",pid])
        t = time.time() # Save the start time to use for later
        # Check for pre-flight tasks
        if self.settings.get("preflight",[]):
            self.run_tasks(key="preflight",disk=efi,folder_path=folder_path)
        # Set up Downloading vs Building nomenclature for L&F
        lnf_args = self.settings.get("lnf_args",["-r","-p","Default"])
        lnf_args_lower = [x.lower() for x in lnf_args]
        lnf_verb = "Downloading" if ("-m" in lnf_args_lower or "--build-mode" in lnf_args_lower) and not "build" in lnf_args_lower else "Building"
        if skip_building_kexts:
            print("Skipping kext {}...".format(lnf_verb.lower()))
        else:
            if self.settings.get("pre_lnf",[]):
                self.run_tasks(key="pre_lnf",name="pre-kext {}".format(lnf_verb.lower()),disk=efi,folder_path=folder_path)
            # Let's try to build kexts
            print("Locating Lilu-And-Friends...")
            if not os.path.exists(lnf):
                print(" - Unable to locate!")
                exit(1)
            print(" - Located at {}".format(lnf))
            if git:
                self.update_repo(git,lnf)
            # Clear out old kexts
            if os.path.exists(os.path.join(lnf, "Kexts")):
                print(" - Kexts folder found, clearing...")
                for x in os.listdir(os.path.join(lnf, "Kexts")):
                    if x.startswith("."):
                        continue
                    try:
                        test_path = os.path.join(lnf, "Kexts", x)
                        if os.path.isdir(test_path):
                            shutil.rmtree(test_path)
                        else:
                            os.remove(test_path)
                    except:
                        print(" --> {} Failed to remove!".format(x))
            # Let's build the new kexts
            print(" - {} kexts...".format(lnf_verb))
            args = [os.path.join(lnf, self.settings.get("lnfrun","Run.command"))]
            args.extend(self.resolve_args(lnf_args,disk=efi,folder_path=folder_path))
            out = self.r.run({"args":args,"stream":self.settings.get("debug_subscripts",False)})
            # Let's quick format our output
            primed = False
            success = False
            kextout = {
                "succeeded" : [],
                "failed"    : []
            }
            for line in out[0].split("\n"):
                if "succeeded:" in line.lower():
                    primed = True
                    success = True
                    continue
                if not primed or line == "" or line == " ":
                    continue
                if line.lower().startswith(("build took ","downloading took")):
                    break
                if "failed:" in line.lower():
                    success = False
                    continue
                if success:
                    kextout["succeeded"].append(line.replace("    ",""))
                else:
                    kextout["failed"].append(line.replace("    ",""))
            print(" --> Succeeded:")
            print("\n".join(["{} ----> {}".format(self.c["c"],x) for x in kextout["succeeded"]]))
            print(" --> Failed:")
            print("\n".join(["{} ----> {}".format(self.c["c"],x) for x in kextout["failed"]]))
            if self.settings.get("post_lnf",[]):
                self.run_tasks(key="post_lnf",name="post-kext {}".format(lnf_verb),disk=efi,folder_path=folder_path)
        if skip_extracting_kexts:
            print("Skipping kext extraction...")
        else:
            if self.settings.get("pre_ke",[]):
                self.run_tasks(key="pre_ke",disk=efi,name="pre-kext extraction",folder_path=folder_path)
            # Let's extract the kexts
            print("Locating KextExtractor...")
            if not os.path.exists(ke):
                print(" - Unable to locate!")
                exit(1)
            print(" - Located at {}".format(ke))
            if git:
                self.update_repo(git,ke)
            print(" - Extracting kexts...")
            args = [os.path.join(ke, self.settings.get("kerun","KextExtractor.command"))]
            if folder_path: ke_defaults = [os.path.join(lnf,"Kexts"),"f="+folder_path]
            else: ke_defaults = ["-d",os.path.join(lnf,"Kexts"),efi]
            args.extend(self.resolve_args(self.settings.get("ke_args",ke_defaults),disk=efi,folder_path=folder_path))
            out = self.r.run({"args":args,"stream":self.settings.get("debug_subscripts",False)})
            # Print the KextExtractor output
            check_primed = False
            for line in out[0].split("\n"):
                if line.strip().startswith("Checking for "): check_primed = True
                if not check_primed or not line.strip(): continue
                print("    "+line)
            if self.settings.get("post_ke",[]):
                self.run_tasks(key="post_ke",name="post-kext extraction",disk=efi,folder_path=folder_path)
        # Set up Downloading vs Building nomenclature for OC-Update
        oc_args = self.settings.get("oc_args",["-n","-p",folder_path] if folder_path else ["-n","-d",efi])
        oc_args_lower = [x.lower() for x in oc_args]
        oc_verb = "Downloading" if ("-s" in oc_args_lower or "--source" in oc_args_lower) and not "build" in oc_args_lower else "Building"
        if skip_opencore:
            print("Skipping OpenCore {} and updating...".format(oc_verb.lower()))
        else:
            if self.settings.get("pre_oc",[]):
                self.run_tasks(key="pre_oc",name="pre-OpenCore {}".format(oc_verb.lower()),disk=efi,folder_path=folder_path)
            # Let's get our OC
            print("Locating OC-Update...")
            if not os.path.exists(oc):
                print(" - Unable to locate!")
                exit(1)
            print(" - Located at {}".format(oc))
            if git:
                self.update_repo(git,oc)
            print(" - {} and updating OC...".format(oc_verb))
            args = [os.path.join(oc, self.settings.get("ocrun","OC-Update.command"))]
            args.extend(self.resolve_args(oc_args,disk=efi,folder_path=folder_path))
            out = self.r.run({"args":args,"stream":self.settings.get("debug_subscripts",False)})
            # Gather the output after updating
            if not "Updating .efi files..." in out[0]:
                print(" --> No .efi files updated!")
            else:
                for line in out[0].split("Updating .efi files...")[-1].split("\n"):
                    if not line.strip() or line.strip().lower() == "done.": continue
                    print("    "+line)
            if self.settings.get("post_oc",[]):
                self.run_tasks(key="post_oc",name="pre-OpenCore {}".format(oc_verb.lower()),disk=efi,folder_path=folder_path)
        if skip_plist_compare:
            print("Skipping plist compare...")
        else:
            if self.settings.get("pre_occ",[]):
                self.run_tasks(key="pre_occ",name="pre-plist compare",disk=efi,folder_path=folder_path)
            print("Locating OCConfigCompare...")
            if not os.path.exists(occ):
                print(" - Unable to locate!")
                exit(1)
            print(" - Located at {}".format(occ))
            if git:
                self.update_repo(git,occ)
            print(" - Checking for config.plist")
            config_path = self.resolve_args(["[[config_path]]"],disk=efi,folder_path=folder_path)[0]
            if not config_path or not os.path.exists(config_path):
                print(" --> Unable to locate!")
                exit(1)
            print(" --> Located at {}".format(config_path))
            print(" - Gathering differences:")
            args = [os.path.join(occ, self.settings.get("occrun","OCConfigCompare.command"))]
            args.extend(self.resolve_args(self.settings.get("occ_args",["-m","off","-w","-u",config_path]),disk=efi,folder_path=folder_path))
            out = self.r.run({"args":args,"stream":self.settings.get("debug_subscripts",False)})
            if not "Checking for values missing from User plist:" in out[0]:
                print(" --> Something went wrong comparing!")
            else:
                print("     Checking for values missing from User plist:")
                for line in out[0].split("Checking for values missing from User plist:")[-1].split("\n"):
                    line = line.strip()
                    if not line: continue
                    if line == "Checking for values missing from Sample:" or (line.startswith("Updating ") and line.endswith(" with changes...")) or (line.startswith("Backing up ") and line.endswith("...")): print("     "+line)
                    elif line.startswith("- Nothing missing from "): print("      - {}None{}".format(self.c["g"],self.c["c"]))
                    else:
                        oc_diff = True # Retain differences
                        print("      - {}{}{}".format(self.c["r"],line,self.c["c"]))
            if self.settings.get("post_occ",[]):
                self.run_tasks(key="post_occ",name="post-plist compare",disk=efi,folder_path=folder_path)
        # Check for post-flight tasks
        if self.settings.get("postflight",[]):
            self.run_tasks(key="postflight",disk=efi,folder_path=folder_path)
        # Reset our EFI to its original state
        if not efi_mounted:
            if oc_diff and not self.settings.get("occ_unmount",False):
                print("Leaving {} mounted due to config.plist differences...".format("target disk" if self.settings.get("disk") else "EFI"))
            else:
                print("Unmounting {}...".format("target disk" if self.settings.get("disk") else "EFI"))
                self.d.unmount_partition(efi)
        print("")
        print("Done. Tasks took {}.".format(self.get_time(time.time()-t)))
        print("")
        exit()

if __name__ == '__main__':
    # Setup the cli args
    parser = argparse.ArgumentParser(prog="HackUpdate.command", description="HackUpdate - a py script that automates other scripts.")
    parser.add_argument("-e", "--efi", help="the EFI to consider - ask, boot, bootloader, or mount point/identifier")
    parser.add_argument("-d", "--disk", help="the mount point/identifier to target - EFI or not (overrides --efi)")
    parser.add_argument("-f", "--folder-path", help="an explicit path to use for the EFI (overrides --efi and --disk)")
    parser.add_argument("-b", "--skip-building-kexts", help="skip building kexts via Lilu and Friends", action="store_true")
    parser.add_argument("-x", "--skip-extracting-kexts", help="skip updating kexts via KextExtractor", action="store_true")
    parser.add_argument("-o", "--skip-opencore", help="skip building and updating OpenCore via OC-Update", action="store_true")
    parser.add_argument("-p", "--skip-plist-compare", help="skip comparing config.plist to latest sample.plist via OCConfigCompare", action="store_true")
    parser.add_argument("-t", "--no-git", help="don't attempt to update script repos with 'git pull'", action="store_true")
    parser.add_argument("-n", "--no-header", help="prevents clearing the screen and printing the header at script start", action="store_true")
    parser.add_argument("-g", "--debug-subscripts", help="streams the output of the scripts HackUpdate calls for debug purposes", action="store_true")
    parser.add_argument("-s", "--settings", help="path to settings.json file to use (default is ./Scripts/settings.json)")

    args = parser.parse_args()

    h = HackUpdate(settings=args.settings if args.settings else "./Scripts/settings.json")

    # Setup any phase/header overrides
    if args.skip_building_kexts:
        h.settings["skip_building_kexts"] = args.skip_building_kexts
    if args.skip_extracting_kexts:
        h.settings["skip_extracting_kexts"] = args.skip_extracting_kexts
    if args.skip_opencore:
        h.settings["skip_opencore"] = args.skip_opencore
    if args.skip_plist_compare:
        h.settings["skip_plist_compare"] = args.skip_plist_compare
    if args.no_header:
        h.settings["no_header"] = args.no_header
    if args.debug_subscripts:
        h.settings["debug_subscripts"] = args.debug_subscripts
    if args.no_git:
        h.settings["no_git"] = args.no_git

    # Check for pathing/disk/efi settings
    if args.folder_path:
        h.settings["folder_path"] = args.folder_path
    elif args.disk:
        h.settings["disk"] = args.disk
    elif args.efi:
        h.settings["efi"] = args.efi
    
    h.main()