machineconfig 1.5__py3-none-any.whl → 1.8__py3-none-any.whl

machineconfig/scripts/python/mount_ssh.py

@@ -1,20 +1,44 @@
-
-import crocodile.toolbox as tb
-from platform import system
-
-
-def main():
-    if system() == "Linux":
-        txt = fr"""
-        net use Y: \\sshfs\aalsaf01@sshfs\229234!9546
-        """
-    elif system() == "Windows":
-        txt = fr"""
-        sshfs alex@:/media/dbhdd /media/dbhdd
-        fusermount -u /mnt/dbhdd
-        """
-    else: raise ValueError(f"Not implemented for this system {system()}")
-
-
-if __name__ == '__main__':
-    pass
+
+"""Mount a remote SSHFS share on a local directory
+"""
+
+
+from platform import system
+from crocodile.meta import SSH, Terminal
+from crocodile.file_management import P
+
+from machineconfig.utils.utils import PROGRAM_PATH, choose_ssh_host
+
+
+def main():
+
+    print(f"Mounting SSHFS ... ")
+    share_info = input("share path? (e.g. user@host:/path) [press enter for interactive choice] = ")
+    if share_info == "":
+        tmp = choose_ssh_host(multi=False)
+        assert isinstance(tmp, str)
+        ssh = SSH(host=tmp)
+        share_info = f"{ssh.username}@{ssh.hostname}:{ssh.run('echo $HOME').op}/data/share_ssh"
+    else:
+        ssh = SSH(share_info.split(":")[0])
+    print(Terminal().run("net use", shell="powershell").op)
+    driver_letter = input(r"Choose driver letter (e.g. Z:\) (avoid the ones already used) : ") or "Z:\\"
+
+    mount_point = input(f"Enter the mount point directory (ex: /mnt/network) [default: ~/data/mount_ssh/{ssh.hostname}]: ")
+    if mount_point == "": mount_point = P.home().joinpath(fr"data/mount_ssh/{ssh.hostname}")
+
+    if system() == "Linux":
+        txt = fr"""
+sshfs alex@:/media/dbhdd /media/dbhdd\
+"""
+    elif system() == "Windows":
+        txt = fr"""
+net use {driver_letter} {share_info}
+fusermount -u /mnt/dbhdd
+"""
+    else: raise ValueError(f"Not implemented for this system {system()}")
+    PROGRAM_PATH.write_text(txt)
+
+
+if __name__ == '__main__':
+    pass

machineconfig/scripts/python/onetimeshare.py

@@ -1,51 +1,60 @@
-
-# as per https://github.com/Luzifer/ots
-# this script is pure python and connects to server to create a secret
-# or use ots executable to do this job
-
-
-import requests
-import crocodile.file_management as fm
-
-
-from Crypto.Cipher import AES
-from Crypto.Hash import MD5
-import base64
-
-def encrypt(key, pwd):
-    pwd = pwd.encode("utf-8")
-    hash_object = MD5.new(key.encode("utf-8"))
-    key = hash_object.digest()
-    iv = b'\x00' * 16
-    cipher = AES.new(key, AES.MODE_CBC, iv)
-    pad = 16 - (len(pwd) % 16)
-    pwd += bytes([pad] * pad)
-    encrypted_password = cipher.encrypt(pwd)
-    return base64.b64encode(encrypted_password).decode("utf-8")
-
-
-secret = input("Secret: ")
-password = input("Password: ") or None
-
-
-if password is not None: encoded_secret = encrypt(password, secret)
-else: encoded_secret = secret
-
-
-url = "https://ots.fyi/api/create"
-
-payload = {"secret": encoded_secret}
-headers = {'Content-Type': 'application/json'}
-
-response = requests.post(url, json=payload, headers=headers)
-
-if response.status_code == 201:
-    res = response.json()
-    print(res)
-    assert res["success"] is True, "Request have failed"
-    share_url = fm.P(f"https://ots.fyi/#{res['secret_id']}") + (f"|{password}" if password is not None else "")
-    print(repr(share_url))
-else:
-    print("Request failed")
-    raise RuntimeError(response.text)
-
+
+"""Share
+"""
+
+# as per https://github.com/Luzifer/ots
+# this script is pure python and connects to server to create a secret
+# or use ots executable to do this job
+
+
+import requests
+import crocodile.file_management as fm
+from crocodile.core import install_n_import
+import base64
+from typing import Optional
+
+
+def encrypt(key: str, pwd: str):
+    install_n_import(library="Crypto.Cipher", package="pycryptodome")
+    # from Crypto.Cipher import AES
+    # from Crypto.Hash import MD5
+    AES = __import__("Crypto", fromlist=["Cipher"]).Cipher.AES
+    MD5 = __import__("Crypto", fromlist=["Hash"]).Hash.MD5
+    pwd_enc = pwd.encode("utf-8")
+    hash_object = MD5.new(key.encode("utf-8"))
+    key_digest = hash_object.digest()
+    iv = b'\x00' * 16
+    cipher = AES.new(key_digest, AES.MODE_CBC, iv)
+    pad = 16 - (len(pwd_enc) % 16)
+    pwd_enc += bytes([pad] * pad)
+    encrypted_password = cipher.encrypt(pwd_enc)
+    return base64.b64encode(encrypted_password).decode("utf-8")
+
+
+def share(secret: str, password: Optional[str]):
+    if password is not None: encoded_secret = encrypt(password, secret)
+    else: encoded_secret = secret
+
+    url = "https://ots.fyi/api/create"
+
+    payload = {"secret": encoded_secret}
+    headers = {'Content-Type': 'application/json'}
+
+    response = requests.post(url, json=payload, headers=headers, timeout=10)
+
+    if response.status_code == 201:
+        res = response.json()
+        print(res)
+        assert res["success"] is True, "Request have failed"
+        share_url = fm.P(f"https://ots.fyi/#{res['secret_id']}") + (f"|{password}" if password is not None else "")
+        print(repr(share_url))
+        return share_url
+    else:
+        print("Request failed")
+        raise RuntimeError(response.text)
+
+
+if __name__ == "__main__":
+    sc = input("Secret: ")
+    pwdd = input("Password: ") or None
+    share(secret=sc, password=pwdd)

machineconfig/scripts/python/pomodoro.py

@@ -1,37 +1,41 @@
-
-from crocodile.toolbox import Log, install_n_import, Scheduler, P
-import time
-from datetime import datetime
-
-
-def pomodoro(work=25, rest=5, repeats=4):
-    logger = Log(name="pomodoro", file=False, stream=True)
-    def loop(sched):
-        speak("Alright, time to start working..."); start = datetime.now(); _ = sched
-        while (diff := work - ((datetime.now() - start).seconds / 60)) > 0: logger.debug(f"Keep working. Time Left: {round(diff)} minutes"); time.sleep(60 * 1)
-        speak("Now, its time to take a break."); start = datetime.now()
-        while (diff := rest - ((datetime.now() - start).seconds / 60)) > 0: logger.critical(f"Keep Resting. Time Left: {round(diff)} minutes"); time.sleep(60 * 1)
-    def speak(txt):
-        install_n_import("gtts").gTTS(txt, lang='en', tld='com.au').save(tmp := P.tmpfile(suffix=".mp3")); time.sleep(0.5)
-        pyglet = install_n_import("pyglet"); pyglet.resource.path = [tmp.parent.str]; pyglet.resource.reindex(); pyglet.resource.media(tmp.name).play()
-    def beep(duration=1, frequency=3000):
-        try: import winsound
-        except ImportError: __import__("os").system('beep -f %s -l %s' % (frequency, 1000 * duration))
-        else: winsound.Beep(frequency, 1000 * duration)
-    return Scheduler(routine=loop, max_cycles=repeats, logger=logger, wait="0.1m").run()
-
-
-# def main():
-#     parser = argparse.ArgumentParser(description='FTP client')
-#
-#     parser.add_argument("machine", help=f"machine ssh address", default="")
-#     parser.add_argument("file", help="file/folder path.", default="")
-#     # FLAGS
-#     parser.add_argument("--recursive", "-r", help="Send recursively.", action="store_true")  # default is False
-#     parser.add_argument("--zipFirst", "-z", help="Zip before sending.", action="store_true")  # default is False
-#
-#     args = parser.parse_args()
-
-
-if __name__ == '__main__':
-    pomodoro()
+
+"""Pomodoro
+"""
+
+from crocodile.toolbox import Log, install_n_import, Scheduler, P
+import time
+from datetime import datetime
+
+
+def pomodoro(work: int = 25, rest: int = 5, repeats: int = 4):
+    logger = Log(name="pomodoro", file=False, stream=True)
+    def loop(sched: Scheduler):
+        speak("Alright, time to start working..."); start = datetime.now(); _ = sched
+        while (diff := work - ((datetime.now() - start).seconds / 60)) > 0: logger.debug(f"Keep working. Time Left: {round(diff)} minutes"); time.sleep(60 * 1)
+        speak("Now, its time to take a break."); start = datetime.now()
+        while (diff := rest - ((datetime.now() - start).seconds / 60)) > 0: logger.critical(f"Keep Resting. Time Left: {round(diff)} minutes"); time.sleep(60 * 1)
+    def speak(txt: str):
+        install_n_import("gtts").gTTS(txt, lang='en', tld='com.au').save(tmp := P.tmpfile(suffix=".mp3")); time.sleep(0.5)
+        pyglet = install_n_import("pyglet"); pyglet.resource.path = [tmp.parent.str]; pyglet.resource.reindex(); pyglet.resource.media(tmp.name).play()
+    def beep(duration: int = 1, frequency: int = 3000):
+        try: import winsound
+        except ImportError: __import__("os").system(f'beep -f {frequency} -l {1000 * duration}')
+        else: winsound.Beep(frequency, 1000 * duration)  # type: ignore
+    _ = beep
+    return Scheduler(routine=loop, max_cycles=repeats, logger=logger, wait="0.1m").run()
+
+
+# def main():
+#     parser = argparse.ArgumentParser(description='FTP client')
+#
+#     parser.add_argument("machine", help=f"machine ssh address", default="")
+#     parser.add_argument("file", help="file/folder path.", default="")
+#     # FLAGS
+#     parser.add_argument("--recursive", "-r", help="Send recursively.", action="store_true")  # default is False
+#     parser.add_argument("--zipFirst", "-z", help="Zip before sending.", action="store_true")  # default is False
+#
+#     args = parser.parse_args()
+
+
+if __name__ == '__main__':
+    pomodoro()

machineconfig/scripts/python/repos.py

@@ -1,128 +1,195 @@
-
-import crocodile.toolbox as tb
-import argparse
-from machineconfig.utils.utils import write_shell_script, CONFIG_PATH
-from rich import print
-# from dataclasses import dataclass
-from enum import Enum
-# tm = tb.Terminal()
-
-
-class GitAction(Enum):
-    commit = "commit"
-    push = "push"
-    pull = "pull"
-
-
-def git_action(path: tb.P, action: GitAction, mess: str or None = None, r=False) -> str:
-    import git
-    try:
-        repo = git.Repo(str(path), search_parent_directories=False)
-    except git.exc.InvalidGitRepositoryError:
-        print(f"Skipping {path} because it is not a git repository.")
-        if r:
-            prgs = [git_action(path=sub_path, action=action, mess=mess, r=r) for sub_path in path.search()]
-            return "\n".join(prgs)
-        else: return "\necho 'skipped because not a git repo'\n\n"
-
-    program = f'''
-echo '>>>>>>>>> {action}'
-cd '{path}'
-'''
-    if action == GitAction.commit:
-        if mess is None: mess = "auto_commit_" + tb.randstr()
-        program += f'''
-git add .; git commit -am "{mess}"
-'''
-    if action == GitAction.push or action == GitAction.pull:
-        # remotes = tm.run(f"cd {path}; git remote", shell="powershell").op.split("\n")
-        action_name = "pull" if action == GitAction.pull else "push"
-        cmds = [f'echo "pulling from {remote.url}" ; git {action_name} {remote.name} {repo.active_branch.name}' for remote in repo.remotes]
-        program += '\n' + '\n'.join(cmds) + '\n'
-    program = program + f'''
-echo ""; echo ""
-'''
-    return program
-
-
-def main():
-    parser = argparse.ArgumentParser(description='REPO MANAGER')
-    # POSITIONAL
-    parser.add_argument("directory", help="folder containing repos.", default="")
-    # FLAGS
-    parser.add_argument("--push", help=f"push", action="store_true")
-    parser.add_argument("--pull", help=f"pull", action="store_true")
-    parser.add_argument("--commit", help=f"commit", action="store_true")
-    parser.add_argument("--all", help=f"pull, commit and push", action="store_true")
-    parser.add_argument("--record", help=f"record respos", action="store_true")
-    parser.add_argument("--clone", help=f"clone repos from record", action="store_true")
-    parser.add_argument("--recursive", "-r", help=f"recursive flag", action="store_true")
-    # OPTIONAL
-    parser.add_argument("--cloud", "-c", help=f"cloud", default=None)
-
-    args = parser.parse_args()
-    if args.directory == "": path = tb.P.home().joinpath("code")
-    else: path = tb.P(args.directory).expanduser().absolute()
-    _ = tb.install_n_import("git", "gitpython")
-
-    program = ""
-    if args.record:
-        res = record_repos(path=path)
-        print(f"Recorded repositories:\n", res)
-        save_path = tb.Save.pickle(obj=res, path=CONFIG_PATH.joinpath("repos").joinpath(path.rel2home()).joinpath("repos.pkl"))
-        print(f"Result pickled at {tb.P(save_path)}")
-        if args.cloud is not None: tb.P(save_path).to_cloud(rel2home=True, cloud=args.cloud)
-        program += f"""\necho '>>>>>>>>> Finished Recording'\n"""
-    elif args.clone:
-        program += f"""\necho '>>>>>>>>> Cloning Repos'\n"""
-        if not path.exists():  # user didn't pass absolute path to pickle file, but rather expected it to be in the default save location
-            path = CONFIG_PATH.joinpath("repos").joinpath(path.rel2home()).joinpath("repos.pkl")
-        assert (path.exists() and path.stem == 'repos.pkl') or args.cloud is not None, f"Path {path} does not exist and cloud was not passed. You can't clone without one of them."
-        program += install_repos(path=path, cloud=args.cloud)
-    elif args.all or args.commit or args.pull or args.push:
-        for a_path in path.search("*"):
-            program += f"""echo "{("Handling " + str(a_path)).center(80, "-")}" """
-            if args.pull or args.all: program += git_action(path=a_path, action=GitAction.pull, r=args.recursive)
-            if args.commit or args.all: program += git_action(a_path, action=GitAction.commit, r=args.recursive)
-            if args.push or args.all: program += git_action(a_path, action=GitAction.push, r=args.recursive)
-    else: program = "echo 'no action specified, try to pass --push, --pull, --commit or --all'"
-    write_shell_script(program, "Script to update repos")
-
-
-def record_repos(path, r=True) -> list[dict]:
-    import git
-    path = tb.P(path).expanduser().absolute()
-    if path.is_file(): return []
-    search_res = path.search("*", files=False)
-    res = []
-    for a_search_res in search_res:
-        if a_search_res.joinpath(".git").exists():
-            # get list of remotes using git python
-            repo = git.Repo(a_search_res)
-            remotes = {remote.name: remote.url for remote in repo.remotes}
-            res.append({"parent_dir": a_search_res.parent.collapseuser().as_posix(), "remotes": remotes})
-        else:
-            if r: res += record_repos(a_search_res, r=r)
-    return res
-
-
-def install_repos(path=None, cloud=None):
-    program = ""
-    if cloud is not None:
-        path = path.from_cloud(rel2home=True, cloud=cloud)
-    else:
-        path = tb.P(path).expanduser().absolute()
-    repos = tb.Read.pickle(path)
-    for repo in repos:
-        for idx, (remote_name, remote_url) in enumerate(repo["remotes"].items()):
-            parent_dir = tb.P(repo["parent_dir"]).expanduser().absolute().create()
-            if idx == 0:
-                program += f"\ncd {parent_dir}; git clone {remote_url} --origin {remote_name}\n"
-            else:
-                program += f"\ncd {parent_dir.as_posix()}/{tb.P(remote_url)[-1].stem}; git remote add {remote_name} {remote_url}\n"
-    print(program)
-    return program
-
-
-if __name__ == '__main__':
-    main()
+
+"""Repos
+"""
+
+from rich import print as pprint
+from machineconfig.utils.utils import write_shell_script, CONFIG_PATH, DEFAULTS_PATH
+from crocodile.file_management import P, install_n_import, Read, Save
+from crocodile.core import randstr
+import argparse
+from dataclasses import dataclass
+from enum import Enum
+from typing import Optional, Any
+# tm = Terminal()
+
+
+class GitAction(Enum):
+    commit = "commit"
+    push = "push"
+    pull = "pull"
+
+
+@dataclass
+class RepoRecord:
+    name: str
+    parent_dir: str
+    remotes: list[str]
+    version: dict[str, str]
+
+
+def git_action(path: P, action: GitAction, mess: Optional[str] = None, r: bool = False) -> str:
+    from git.exc import InvalidGitRepositoryError
+    from git.repo import Repo
+    try:
+        repo = Repo(str(path), search_parent_directories=False)
+    except InvalidGitRepositoryError:
+        pprint(f"Skipping {path} because it is not a git repository.")
+        if r:
+            prgs = [git_action(path=sub_path, action=action, mess=mess, r=r) for sub_path in path.search()]
+            return "\n".join(prgs)
+        else: return "\necho 'skipped because not a git repo'\n\n"
+
+    program = f'''
+echo '>>>>>>>>> {action}'
+cd '{path}'
+'''
+    if action == GitAction.commit:
+        if mess is None: mess = "auto_commit_" + randstr()
+        program += f'''
+git add .; git commit -am "{mess}"
+'''
+    if action == GitAction.push or action == GitAction.pull:
+        # remotes = tm.run(f"cd {path}; git remote", shell="powershell").op.split("\n")
+        action_name = "pull" if action == GitAction.pull else "push"
+        cmds = [f'echo "pulling from {remote.url}" ; git {action_name} {remote.name} {repo.active_branch.name}' for remote in repo.remotes]
+        program += '\n' + '\n'.join(cmds) + '\n'
+    program = program + f'''
+echo ""; echo ""
+'''
+    return program
+
+
+def main():
+    parser = argparse.ArgumentParser(description='REPO MANAGER')
+    # POSITIONAL
+    parser.add_argument("directory", help="folder containing repos to record a json out of OR a specs json file to follow.", default="")
+    # FLAGS
+    parser.add_argument("--push", help=f"push", action="store_true")
+    parser.add_argument("--pull", help=f"pull", action="store_true")
+    parser.add_argument("--commit", help=f"commit", action="store_true")
+    parser.add_argument("--all", help=f"pull, commit and push", action="store_true")
+    parser.add_argument("--record", help=f"record respos", action="store_true")
+    parser.add_argument("--clone", help=f"clone repos from record", action="store_true")
+    parser.add_argument("--checkout", help=f"Check out to versions prvided in this json file", action="store_true")
+    parser.add_argument("--checkout_to_branch", help="Checkout to the main branch", action="store_true")
+    parser.add_argument("--recursive", "-r", help=f"recursive flag", action="store_true")
+    # OPTIONAL
+    parser.add_argument("--cloud", "-c", help=f"cloud", default=None)
+    args = parser.parse_args()
+
+    if args.directory == "": repos_root = P.home().joinpath("code")  # it is a positional argument, can never be empty.
+    else: repos_root = P(args.directory).expanduser().absolute()
+    _ = install_n_import("git", "gitpython")
+
+    program = ""
+    if args.record:
+        res = record_repos(repos_root=str(repos_root))
+        pprint(f"Recorded repositories:\n", res)
+        save_path = CONFIG_PATH.joinpath("repos").joinpath(repos_root.rel2home()).joinpath("repos.json")
+        # Save.pickle(obj=res, path=save_path)
+        Save.json(obj=res, path=save_path)
+        pprint(f"Result pickled at {P(save_path)}")
+        if args.cloud is not None: P(save_path).to_cloud(rel2home=True, cloud=args.cloud)
+        program += f"""\necho '>>>>>>>>> Finished Recording'\n"""
+    elif args.clone or args.checkout or args.checkout_to_branch:
+        # preferred_remote = input("Enter preferred remote to use (default: None): ") or ""
+        program += f"""\necho '>>>>>>>>> Cloning Repos'\n"""
+        if not repos_root.exists() or repos_root.stem != 'repos.json':  # user didn't pass absolute path to pickle file, but rather expected it to be in the default save location
+            repos_root = CONFIG_PATH.joinpath("repos").joinpath(repos_root.rel2home()).joinpath("repos.json")
+            if not repos_root.exists():
+                if args.cloud is None:
+                    cloud: str = Read.ini(DEFAULTS_PATH)['general']['rclone_config_name']
+                    print(f"⚠️ Using default cloud: {cloud}")
+                else:
+                    cloud = args.cloud
+                    assert cloud is not None, f"Path {repos_root} does not exist and cloud was not passed. You can't clone without one of them."
+                repos_root.from_cloud(cloud=cloud, rel2home=True)
+        assert (repos_root.exists() and repos_root.name == 'repos.json') or args.cloud is not None, f"Path {repos_root} does not exist and cloud was not passed. You can't clone without one of them."
+        program += install_repos(specs_path=str(repos_root), clone=args.clone, checkout_to_recorded_commit=args.checkout, checkout_to_branch=args.checkout_to_branch)
+    # elif args.checkout is not None:
+
+    elif args.all or args.commit or args.pull or args.push:
+        for a_path in repos_root.search("*"):
+            program += f"""echo "{("Handling " + str(a_path)).center(80, "-")}" """
+            if args.pull or args.all: program += git_action(path=a_path, action=GitAction.pull, r=args.recursive)
+            if args.commit or args.all: program += git_action(a_path, action=GitAction.commit, r=args.recursive)
+            if args.push or args.all: program += git_action(a_path, action=GitAction.push, r=args.recursive)
+    else: program = "echo 'no action specified, try to pass --push, --pull, --commit or --all'"
+    write_shell_script(program, "Script to update repos")
+
+
+def record_repos(repos_root: str, r: bool = True) -> list[dict[str, Any]]:
+    path_obj = P(repos_root).expanduser().absolute()
+    if path_obj.is_file(): return []
+    search_res = path_obj.search("*", files=False)
+    res: list[dict[str, Any]] = []
+    for a_search_res in search_res:
+        if a_search_res.joinpath(".git").exists():
+            res.append(record_a_repo(a_search_res))
+        else:
+            if r: res += record_repos(str(a_search_res), r=r)
+    return res
+
+
+def record_a_repo(path: P, search_parent_directories: bool = False, preferred_remote: Optional[str] = None):
+    from git.repo import Repo
+    repo = Repo(path, search_parent_directories=search_parent_directories)  # get list of remotes using git python
+    repo_root = P(repo.working_dir).absolute()
+    remotes = {remote.name: remote.url for remote in repo.remotes}
+    if preferred_remote is not None:
+        if preferred_remote in remotes: remotes = {preferred_remote: remotes[preferred_remote]}
+        else:
+            print(f"⚠️ `{preferred_remote=}` not found in {remotes}.")
+            preferred_remote = None
+    try: commit = repo.head.commit.hexsha
+    except ValueError:  # look at https://github.com/gitpython-developers/GitPython/issues/1016
+        print(f"⚠️ Failed to get latest commit of {repo}")
+        # cmd = "git config --global -add safe.directory"
+        commit = None
+    try: current_branch = repo.head.reference.name  # same as repo.active_branch.name
+    except TypeError:
+        print(f"⁉️ Failed to get current branch of {repo}. It is probably in a detached state.")
+        current_branch = None
+    res: dict[str, Any] = {"name": repo_root.name, "parent_dir": repo_root.parent.collapseuser().as_posix(),
+                            "current_branch": current_branch,
+                            "remotes": remotes, "version": {"branch": current_branch, "commit": commit}}
+    return res
+
+
+def install_repos(specs_path: str, clone: bool = True, checkout_to_recorded_commit: bool = False, checkout_to_branch: bool = False, editable_install: bool = False, preferred_remote: Optional[str] = None):
+    program = ""
+    path_obj = P(specs_path).expanduser().absolute()
+    repos: list[dict[str, Any]] = Read.json(path_obj)
+    for repo in repos:
+        parent_dir = P(repo["parent_dir"]).expanduser().absolute().create()
+        for idx, (remote_name, remote_url) in enumerate(repo["remotes"].items()):
+            if clone:
+                if idx == 0:  # clone
+                    if preferred_remote is not None:
+                        if preferred_remote in repo["remotes"]:
+                            remote_name = preferred_remote
+                            remote_url: str = repo["remotes"][preferred_remote]
+                        else:
+                            print(f"⚠️ `{preferred_remote=}` not found in {repo['remotes']}.")
+                            # preferred_remote = None
+                    program += f"\ncd {parent_dir.collapseuser().as_posix()}; git clone {remote_url} --origin {remote_name}"
+                    program += f"\ncd {parent_dir.collapseuser().as_posix()}/{repo['name']}; git remote set-url {remote_name} {remote_url}"
+                    # the new url-setting to ensure that account name before `@` was not lost (git clone ignores it): https://thisismygitrepo@github.com/thisismygitrepo/crocodile.git
+                program += f"\ncd {parent_dir.collapseuser().as_posix()}/{repo['name']}; git remote add {remote_name} {remote_url}"
+            if checkout_to_recorded_commit:
+                commit = repo['version']['commit']
+                if isinstance(commit, str): program += f"\ncd {parent_dir.collapseuser().as_posix()}/{repo['name']}; git checkout {commit}"
+                else: print(f"Skipping {repo['parent_dir']} because it doesn't have a commit recorded. Found {commit}")
+                break  # you need to checkout only once, no need to repeat for other remotes.
+            if checkout_to_branch:
+                program += f"\ncd {parent_dir.collapseuser().as_posix()}/{repo['name']}; git checkout {repo['current_branch']}"
+                break
+            if editable_install and idx == 0:
+                program += f"\ncd {parent_dir.collapseuser().as_posix()}/{repo['name']}; pip install -e ."
+        program += "\n"
+    pprint(program)
+    return program
+
+
+if __name__ == '__main__':
+    main()