machineconfig 2.2__py3-none-any.whl → 2.4__py3-none-any.whl

machineconfig/scripts/linux/gh_models

@@ -1,11 +1,2 @@
-
 #!/usr/bin/env bash
-
-source ~/code/machineconfig/.venv/bin/activate
-
-python -m machineconfig.scripts.python.gh_models "$@"
-
-if [ -n "$VIRTUAL_ENV" ]; then
-  deactivate || true
-
-fi
+uv run --no-dev --project $HOME/code/machineconfig python -m machineconfig.scripts.python.gh_models "$@"

machineconfig/scripts/linux/kill_process

@@ -1,10 +1,2 @@
 #!/usr/bin/env bash
-
-source ~/code/machineconfig/.venv/bin/activate
-
-python -c "from machineconfig.utils.procs import ProcessManager; ProcessManager().choose_and_kill()"
-
-if [ -n "$VIRTUAL_ENV" ]; then
-  deactivate || true
-
-fi
+uv run --no-dev --project $HOME/code/machineconfig python -c "from machineconfig.utils.procs import ProcessManager; ProcessManager().choose_and_kill()"

machineconfig/scripts/linux/mcinit

@@ -1,27 +1,2 @@
 #!/usr/bin/env bash
-
-. $HOME/code/machineconfig/.venv/bin/activate
-
-# Generate random string of length 5
-random_str=$(cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 10 | head -n 1)
-export op_script=$HOME/tmp_results/shells/$random_str/python_return_command.sh
-# op_script=$HOME/tmp_results/shells/$random_str/python_return_command.sh
-
-if [ -f "$op_script" ]; then
-  rm $op_script
-fi
-
-
-python -m machineconfig.scripts.python.ai.mcinit "$@"
-
-if [ -f "$op_script" ]; then
-  echo "Running $op_script"
-  chmod +x $op_script
-  set --  # clear all positional parameters
-  source $op_script  # sourcing the script means the args passed to the this script are passed to the sourced script which cofuses the sources script as it contains activate_ve and it doesn't understand first.sh arguments.
-fi
-
-
-if [ -n "$VIRTUAL_ENV" ]; then
-  deactivate || true
-fi
+uv run --no-dev --project $HOME/code/machineconfig python -m machineconfig.scripts.python.ai.mcinit "$@"

machineconfig/scripts/linux/mount_nfs

@@ -5,19 +5,7 @@
 # mkdir ~/data/local
 # sudo mount -o nolock,noatime,nodiratime,proto=tcp,timeo=600,retrans=2,noac alex-p51s-5:/home/alex/data/local ./data/local
 
-
-op_script=$HOME/tmp_results/shells/python_return_command.sh
-if [ -f "$op_script" ]; then
-  rm $op_script
-fi
-. activate_ve
-python -m machineconfig.scripts.python.mount_nfs
-#source $HOME/tmp_results/shells/python_return_command.sh
-if [ -f "$op_script" ]; then
-  chmod +x $op_script
-  source $op_script
-fi
-
+uv run --no-dev --project $HOME/code/machineconfig python -m machineconfig.scripts.python.mount_nfs
 # Check if remote server is reachable and share folder exists
 if ! ping -c 1 "$remote_server" &> /dev/null; then
   echo "💥 Error: Remote server $remote_server is not reachable."

machineconfig/scripts/linux/repos

@@ -1,24 +1,2 @@
 #!/usr/bin/env bash
-
-# check below if VIRTUAL_ENV is set
-# if [ -z "$VIRTUAL_ENV" ]; then
-source ~/code/machineconfig/.venv/bin/activate
-# fi
-
-op_script=$HOME/tmp_results/shells/python_return_command.sh
-if [ -f "$op_script" ]; then
-  rm $op_script
-fi
-
-python -m machineconfig.scripts.python.repos "$@"
-
-if [ -f "$op_script" ]; then
-  chmod +x $op_script
-  source $op_script
-fi
-
-
-# check below if VIRTUAL_ENV enviroment variable exist, then deactivate it, otherwise skip
-if [ -n "$VIRTUAL_ENV" ]; then
-  deactivate
-fi
+uv run --no-dev --project $HOME/code/machineconfig python -m machineconfig.scripts.python.repos "$@"

machineconfig/scripts/linux/scheduler

@@ -1,8 +1,2 @@
 #!/usr/bin/env bash
-
-source ~/code/machineconfig/.venv/bin/activate
-python -m machineconfig.scripts.python.scheduler "$@"
-if [ -n "$VIRTUAL_ENV" ]; then
-  deactivate || true
-
-fi
+uv run --no-dev --project $HOME/code/machineconfig python -m machineconfig.scripts.python.scheduler "$@"

machineconfig/scripts/linux/start_slidev

@@ -1,23 +1,2 @@
 #!/usr/bin/env bash
-
-source ~/code/machineconfig/.venv/bin/activate
-
-op_script=$HOME/tmp_results/shells/python_return_command.sh
-if [ -f "$op_script" ]; then
-  rm $op_script
-fi
-
-
-python -m machineconfig.scripts.python.start_slidev "$@"
-
-if [ -f "$op_script" ]; then
-  chmod +x $op_script
-  set --  # clear all positional parameters
-  source $op_script  # sourcing the script means the args passed to the this script are passed to the sourced script which cofuses the sources script as it contains activate_ve and it doesn't understand first.sh arguments.
-fi
-
-
-if [ -n "$VIRTUAL_ENV" ]; then
-  deactivate || true
-
-fi
+uv run --no-dev --project $HOME/code/machineconfig python -m machineconfig.scripts.python.start_slidev "$@"

machineconfig/scripts/linux/start_terminals

@@ -1,12 +1,4 @@
 #!/usr/bin/env bash
 
-source ~/code/machineconfig/.venv/bin/activate
-
-python -m machineconfig.jobs.python.create_zellij_template
-
+uv run --no-dev --project $HOME/code/machineconfig python -m machineconfig.jobs.python.create_zellij_template
 zellij --layout $HOME/tmp_results/tmp_files/templates/zellij_template.kdl
-
-if [ -n "$VIRTUAL_ENV" ]; then
-  deactivate || true
-
-fi

machineconfig/scripts/linux/url2md

@@ -1,10 +1,2 @@
 #!/usr/bin/env bash
-
-source ~/code/machineconfig/.venv/bin/activate
-
-python -m machineconfig.utils.ai.url2md "$@"
-
-if [ -n "$VIRTUAL_ENV" ]; then
-  deactivate || true
-
-fi
+uv run --no-dev --project $HOME/code/machineconfig python -m machineconfig.utils.ai.url2md "$@"

machineconfig/scripts/python/cloud_mount.py

@@ -1,6 +1,6 @@
 """Cloud mount script"""
 
-from machineconfig.utils.source_of_truth import PROGRAM_PATH
+
 from machineconfig.utils.options import choose_one_option
 from machineconfig.utils.utils2 import read_ini
 from machineconfig.utils.path_reduced import PathExtended as PathExtended
@@ -144,7 +144,9 @@ zellij action move-focus up
     else:
         raise ValueError("unsupported platform")
     # print(f"running command: \n{txt}")
-    PROGRAM_PATH.write_text(txt, encoding="utf-8")
+    # PROGRAM_PATH.write_text(txt, encoding="utf-8")
+    import subprocess
+    subprocess.run(txt, shell=True, check=True)
     # draw success box dynamically
     title1 = "✅ Cloud mount command prepared successfully"
     title2 = "🔄 Running mount process..."

machineconfig/scripts/python/cloud_repo_sync.py

@@ -7,7 +7,7 @@ from machineconfig.utils.terminal import Terminal
 from machineconfig.utils.utils2 import randstr, read_ini
 
 from machineconfig.scripts.python.helpers.repo_sync_helpers import fetch_dotfiles
-from machineconfig.utils.source_of_truth import CONFIG_PATH, DEFAULTS_PATH, PROGRAM_PATH
+from machineconfig.utils.source_of_truth import CONFIG_PATH, DEFAULTS_PATH
 from machineconfig.utils.options import choose_one_option
 from machineconfig.utils.code import get_shell_file_executing_python_script, write_shell_script_to_file
 import platform
@@ -161,7 +161,10 @@ git commit -am "finished merging"
                 program_content = program_4
             case _:
                 raise ValueError(f"Unknown action: {action}")
-        PROGRAM_PATH.write_text(program_content, encoding="utf-8")
+        # PROGRAM_PATH.write_text(program_content, encoding="utf-8")
+        import subprocess
+        subprocess.run(program_content, shell=True, check=True)
+
     return program_content
 
 

machineconfig/scripts/python/cloud_sync.py

@@ -5,7 +5,7 @@ TODO: use typer or typed-argument-parser to parse args
 from machineconfig.scripts.python.helpers.helpers2 import parse_cloud_source_target
 from machineconfig.scripts.python.helpers.cloud_helpers import Args
 from machineconfig.scripts.python.cloud_mount import get_mprocs_mount_txt
-from machineconfig.utils.source_of_truth import PROGRAM_PATH
+
 import argparse
 from rich.console import Console
 from rich.panel import Panel
@@ -75,7 +75,9 @@ def args_parser():
     cmd_line = f"{rclone_cmd[:65]}..."
     console.print(Panel(f"{title}\n{cmd_line}", title="[bold blue]Command[/bold blue]", expand=False))
 
-    PROGRAM_PATH.write_text(txt, encoding="utf-8")
+    # PROGRAM_PATH.write_text(txt, encoding="utf-8")
+    import subprocess
+    subprocess.run(txt, shell=True, check=True)
 
 
 if __name__ == "__main__":

machineconfig/scripts/python/croshell.py

@@ -7,7 +7,7 @@ croshell
 import argparse
 from machineconfig.utils.path_reduced import PathExtended as PathExtended
 from machineconfig.utils.utils2 import randstr
-from machineconfig.utils.source_of_truth import PROGRAM_PATH
+
 from machineconfig.utils.options import display_options
 from machineconfig.utils.ve import get_ve_activate_line
 from typing import Optional
@@ -204,11 +204,13 @@ print(f"🐊 Crocodile Shell | Running @ {Path.cwd()}")
     title = "🚀 LAUNCHING SCRIPT"
     text1 = f"📄 Script: {pyfile}"
     text2 = f"🔥 Command: {fire_line}"
-    launch_message = f"{title}   {PROGRAM_PATH}\n{text1}\n{text2}"
+    launch_message = f"{title}   \n{text1}\n{text2}"
     console.print(Panel(Text(launch_message, justify="left"), expand=False, border_style="blue"))
 
-    PROGRAM_PATH.write_text(data=final_program, encoding="utf-8")
+    # PROGRAM_PATH.write_text(data=final_program, encoding="utf-8")
     # (PROGRAM_PATH + ".py").write_text(str(pyfile), encoding='utf-8')
+    import subprocess
+    subprocess.run(final_program, shell=True, check=True)
 
     # if platform.system() == "Windows":
     # return subprocess.run([f"powershell", "-Command", res], shell=True, capture_output=False, text=True, check=True)

machineconfig/scripts/python/devops.py

@@ -1,7 +1,7 @@
 """devops with emojis"""
 
 from machineconfig.utils.options import display_options
-from machineconfig.utils.source_of_truth import PROGRAM_PATH
+
 from machineconfig.utils.code import write_shell_script_to_default_program_path
 from platform import system
 from enum import Enum
@@ -74,7 +74,8 @@ def display_task_success(success: str) -> None:
 
 def main(which: Optional[str] = None):
     from machineconfig.utils.path_reduced import PathExtended
-    PathExtended(PROGRAM_PATH).delete(sure=True, verbose=False)
+
+    # PathExtended(PROGRAM_PATH).delete(sure=True, verbose=False)
     console.print(Panel("🚀 Initializing DevOps operation...", width=BOX_WIDTH, border_style="blue"))
 
     options = [op.value for op in Options]

machineconfig/scripts/python/devops_devapps_install.py

@@ -39,6 +39,7 @@ def main(which: Optional[WHICH_CAT | str] = None):
     # interactive installation
     installers = [Installer.from_dict(d=vd, name=name) for __kat, vds in get_all_dicts(system=system()).items() for name, vd in vds.items()]
     options = [x.get_description() for x in tqdm(installers, desc="✅ Checking installed programs")] + list(get_args(WHICH_CAT))
+    # print("s"*1000)
     program_names = choose_multiple_options(msg="", options=options, header="🚀 CHOOSE DEV APP", default="AllEssentials")
 
     total_program = ""

machineconfig/scripts/python/fire_agents.py

@@ -15,6 +15,7 @@ from math import ceil
 from typing import Literal, TypeAlias, get_args, Iterable
 
 from machineconfig.cluster.sessions_managers.zellij_local_manager import ZellijLocalManager
+from machineconfig.cluster.sessions_managers.layout_types import TabConfig, LayoutConfig
 from machineconfig.utils.utils2 import randstr
 import random
 # import time
@@ -23,7 +24,6 @@ AGENTS: TypeAlias = Literal[
     "cursor-agent", "gemini", "crush", "q", "onlyPrepPromptFiles"
     # warp terminal
 ]
-TabConfig = dict[str, tuple[str, str]]  # tab name -> (cwd, command)
 DEFAULT_AGENT_CAP = 6
 
 
@@ -93,7 +93,7 @@ def _confirm(message: str, default_no: bool = True) -> bool:
     return False
 
 
-def launch_agents(repo_root: Path, prompts: list[str], agent: AGENTS, *, max_agents: int = DEFAULT_AGENT_CAP) -> TabConfig:
+def launch_agents(repo_root: Path, prompts: list[str], agent: AGENTS, *, max_agents: int = DEFAULT_AGENT_CAP) -> list[TabConfig]:
     """Create tab configuration for a set of agent prompts.
 
     If number of prompts exceeds max_agents, ask user for confirmation.
@@ -106,9 +106,9 @@ def launch_agents(repo_root: Path, prompts: list[str], agent: AGENTS, *, max_age
         proceed = _confirm(message=(f"You are about to launch {len(prompts)} agents which exceeds the cap ({max_agents}). Proceed?"))
         if not proceed:
             print("Aborting per user choice.")
-            return {}
+            return []
 
-    tab_config: TabConfig = {}
+    tab_config: list[TabConfig] = []
     tmp_dir = repo_root / ".ai" / f"tmp_prompts/{randstr()}"
     tmp_dir.mkdir(parents=True, exist_ok=True)
 
@@ -173,7 +173,7 @@ echo "---------END OF AGENT OUTPUT---------"
 """
         cmd_path.write_text(cmd_prefix + cmd + cmd_postfix, encoding="utf-8")
         fire_cmd = f"bash {shlex.quote(str(cmd_path))}"
-        tab_config[f"Agent{idx}"] = (str(repo_root), fire_cmd)
+        tab_config.append(TabConfig(tabName=f"Agent{idx}", startDir=str(repo_root), command=fire_cmd))
 
     print(f"Launching a template with #{len(tab_config)} agents")
     return tab_config
@@ -228,7 +228,7 @@ def main():  # noqa: C901 - (complexity acceptable for CLI glue)
     from machineconfig.utils.utils2 import randstr
 
     random_name = randstr(length=3)
-    manager = ZellijLocalManager(session2zellij_tabs={"Agents": tab_config}, session_name_prefix=random_name)
+    manager = ZellijLocalManager(session_layouts=[LayoutConfig(layoutName="Agents", layoutTabs=tab_config)], session_name_prefix=random_name)
     manager.start_all_sessions()
     manager.run_monitoring_routine()
 

machineconfig/scripts/python/fire_jobs.py

@@ -14,56 +14,27 @@ from machineconfig.scripts.python.helpers.helpers4 import get_import_module_code
 from machineconfig.utils.ve import get_repo_root, get_ve_activate_line, get_ve_path_and_ipython_profile
 from machineconfig.utils.options import display_options, choose_one_option
 from machineconfig.utils.path import match_file_name, sanitize_path
-from machineconfig.utils.source_of_truth import PROGRAM_PATH
+
 from machineconfig.utils.path_reduced import PathExtended as PathExtended
 from machineconfig.utils.io_save import save_toml
 from machineconfig.utils.utils2 import randstr, read_toml
+from machineconfig.scripts.python.fire_jobs_args_helper import get_args, FireJobArgs, extract_kwargs
 import platform
 from typing import Optional
-import argparse
-import os
+# import os
 
 
-str2obj = {"True": True, "False": False, "None": None}
+def main(args: FireJobArgs) -> None:
+    if args.layout:
+        from machineconfig.scripts.python.fire_jobs_layout_helper import handle_layout_args
 
+        return handle_layout_args(args)
 
-def main() -> None:
-    parser = argparse.ArgumentParser()
-    parser.add_argument("path", nargs="?", type=str, help="The directory containing the jobs", default=".")
-    parser.add_argument("function", nargs="?", type=str, help="Fuction to run", default=None)
-    parser.add_argument("--ve", "-v", type=str, help="virtual enviroment name", default="")
-    parser.add_argument("--cmd", "-B", action="store_true", help="Create a cmd fire command to launch the the job asynchronously.")
-    parser.add_argument("--interactive", "-i", action="store_true", help="Whether to run the job interactively using IPython")
-    parser.add_argument("--debug", "-d", action="store_true", help="debug")
-    parser.add_argument("--choose_function", "-c", action="store_true", help="debug")
-    parser.add_argument("--loop", "-l", action="store_true", help="infinite recusion (runs again after completion/interruption)")
-    parser.add_argument("--jupyter", "-j", action="store_true", help="open in a jupyter notebook")
-    parser.add_argument("--submit_to_cloud", "-C", action="store_true", help="submit to cloud compute")
-    parser.add_argument("--remote", "-r", action="store_true", help="launch on a remote machine")
-    parser.add_argument("--module", "-m", action="store_true", help="launch the main file")
-    parser.add_argument("--streamlit", "-S", action="store_true", help="run as streamlit app")
-    parser.add_argument("--environment", "-E", type=str, help="Choose ip, localhost, hostname or arbitrary url", default="")
-    parser.add_argument("--holdDirectory", "-D", action="store_true", help="hold current directory and avoid cd'ing to the script directory")
-    parser.add_argument("--PathExport", "-P", action="store_true", help="augment the PYTHONPATH with repo root.")
-    parser.add_argument("--git_pull", "-g", action="store_true", help="Start by pulling the git repo")
-    parser.add_argument("--optimized", "-O", action="store_true", help="Run the optimized version of the function")
-    parser.add_argument("--Nprocess", "-p", type=int, help="Number of processes to use", default=1)
-    parser.add_argument("--zellij_tab", "-z", type=str, dest="zellij_tab", help="open in a new zellij tab")
-    parser.add_argument("--watch", "-w", action="store_true", help="watch the file for changes")
-    parser.add_argument("--kw", nargs="*", default=None, help="keyword arguments to pass to the function in the form of k1 v1 k2 v2 ... (meaning k1=v1, k2=v2, etc)")
-    try:
-        args = parser.parse_args()
-    except Exception as ex:
-        print(f"❌ Failed to parse arguments: {ex}")
-        parser.print_help()
-        raise ex
     path_obj = sanitize_path(args.path)
-    # print(f"Passed path sanitied to {path_obj}")
     if not path_obj.exists():
-        path_obj = match_file_name(sub_string=args.path, search_root=PathExtended.cwd())
-    else:
-        pass
-    if path_obj.is_dir():
+        suffixes = {".py", ".sh", ".ps1"}
+        choice_file = match_file_name(sub_string=args.path, search_root=PathExtended.cwd(), suffixes=suffixes)
+    elif path_obj.is_dir():
         print(f"🔍 Searching recursively for Python, PowerShell and Shell scripts in directory `{path_obj}`")
         files = search_for_files_of_interest(path_obj)
         print(f"🔍 Got #{len(files)} results.")
@@ -73,24 +44,13 @@ def main() -> None:
         choice_file = path_obj
     repo_root = get_repo_root(str(choice_file))
     print(f"💾 Selected file: {choice_file}.\nRepo root: {repo_root}")
-
     ve_root_from_file, ipy_profile = get_ve_path_and_ipython_profile(choice_file)
     if ipy_profile is None:
         ipy_profile = "default"
     activate_ve_line = get_ve_activate_line(ve_root=args.ve or ve_root_from_file or "$HOME/code/machineconfig/.venv")
 
-    # Convert args.kw to dictionary
     if choice_file.suffix == ".py":
-        if args.kw is not None:
-            assert len(args.kw) % 2 == 0, f"args.kw must be a list of even length. Got {len(args.kw)}"
-            kwargs = dict(zip(args.kw[::2], args.kw[1::2]))
-            for key, value in kwargs.items():
-                if value in str2obj:
-                    kwargs[key] = str2obj[value]
-            if args.function is None:  # if user passed arguments and forgot to pass function, then assume they want to run the main function.
-                args.choose_function = True
-        else:
-            kwargs = {}
+        kwargs = extract_kwargs(args)
     else:
         kwargs = {}
 
@@ -296,22 +256,13 @@ python -m machineconfig.cluster.templates.cli_click --file {choice_file} """
             command += f"--function {choice_function} "
 
     if args.Nprocess > 1:
-        # lines = [f""" zellij action new-tab --name nProcess{randstr(2)}"""]
-        # command = command.replace(". activate_ve", ". $HOME/scripts/activate_ve")
-        # for an_arg in range(args.Nprocess):
-        #     sub_command = f"{command} --idx={an_arg} --idx_max={args.Nprocess}"
-        #     if args.optimized:
-        #         sub_command = sub_command.replace("python ", "python -OO ")
-        #     sub_command_path = PathExtended.tmpfile(suffix=".sh").write_text(sub_command, encoding="utf-8")
-        #     lines.append(f"""zellij action new-pane -- bash {sub_command_path}  """)
-        #     lines.append("sleep 5")  # python tends to freeze if you launch instances within 1 microsecond of each other
-        # command = "\n".join(lines)
-        tab_config = {}
-        for an_arg in range(args.Nprocess):
-            tab_config[f"tab{an_arg}"] = (str(PathExtended.cwd()), f"uv run -m fire {choice_file} {choice_function} --idx={an_arg} --idx_max={args.Nprocess}")
         from machineconfig.cluster.sessions_managers.zellij_local import run_zellij_layout
+        from machineconfig.cluster.sessions_managers.layout_types import LayoutConfig
 
-        run_zellij_layout(tab_config=tab_config, session_name=None)
+        layout: LayoutConfig = {"layoutName": "fireNprocess", "layoutTabs": []}
+        for an_arg in range(args.Nprocess):
+            layout["layoutTabs"].append({"tabName": f"tab{an_arg}", "startDir": str(PathExtended.cwd()), "command": f"uv run -m fire {choice_file} {choice_function} --idx={an_arg} --idx_max={args.Nprocess}"})
+        run_zellij_layout(layout_config=layout)
         return None
 
     if args.optimized:
@@ -356,8 +307,8 @@ python -m machineconfig.cluster.templates.cli_click --file {choice_file} """
             raise NotImplementedError(f"Platform {platform.system()} not supported.")
         command = export_line + "\n" + command
 
-    program_path = os.environ.get("op_script", None)
-    program_path = PathExtended(program_path) if program_path is not None else PROGRAM_PATH
+    # program_path = os.environ.get("op_script", None)
+    # program_path = PathExtended(program_path) if program_path is not None else PROGRAM_PATH
     if args.loop:
         if platform.system() in ["Linux", "Darwin"]:
             command = command + "\nsleep 0.5"
@@ -367,12 +318,15 @@ python -m machineconfig.cluster.templates.cli_click --file {choice_file} """
             command = "$ErrorActionPreference = 'SilentlyContinue';\n" + command + "\nStart-Sleep -Seconds 0.5"
         else:
             raise NotImplementedError(f"Platform {platform.system()} not supported.")
-        command = command + f"\n. {program_path}"
-    console.print(Panel(Syntax(command, lexer="shell"), title=f"🔥 fire command @ {program_path}: "), style="bold red")
-    program_path.parent.mkdir(parents=True, exist_ok=True)
-    program_path.write_text(command, encoding="utf-8")
+        # command = command + f"\n. {program_path}"
+    console.print(Panel(Syntax(command, lexer="shell"), title=f"🔥 fire command @ {command}: "), style="bold red")
+    # program_path.parent.mkdir(parents=True, exist_ok=True)
+    # program_path.write_text(command, encoding="utf-8")
+    import subprocess
+    subprocess.run(command, shell=True, check=True)
 
 
 if __name__ == "__main__":
     # options, func_args = parse_pyfile(file_path="C:/Users/aalsaf01/code/machineconfig/myresources/crocodile/core.py")
-    main()
+    args = get_args()
+    main(args)

machineconfig/scripts/python/fire_jobs_args_helper.py

@@ -0,0 +1,84 @@
+from dataclasses import dataclass
+from typing import Optional
+import argparse
+
+
+@dataclass
+class FireJobArgs:
+    """Type-safe dataclass for fire_jobs command line arguments."""
+
+    path: str = "."
+    function: Optional[str] = None
+    ve: str = ""
+    cmd: bool = False
+    interactive: bool = False
+    debug: bool = False
+    choose_function: bool = False
+    loop: bool = False
+    jupyter: bool = False
+    submit_to_cloud: bool = False
+    remote: bool = False
+    module: bool = False
+    streamlit: bool = False
+    environment: str = ""
+    holdDirectory: bool = False
+    PathExport: bool = False
+    git_pull: bool = False
+    optimized: bool = False
+    Nprocess: int = 1
+    zellij_tab: Optional[str] = None
+    watch: bool = False
+    kw: Optional[list[str]] = None
+    layout: bool = False
+
+
+def get_args() -> FireJobArgs:
+    parser = argparse.ArgumentParser()
+    parser.add_argument("path", nargs="?", type=str, help="The directory containing the jobs", default=".")
+    parser.add_argument("function", nargs="?", type=str, help="Fuction to run", default=None)
+    parser.add_argument("--ve", "-v", type=str, help="virtual enviroment name", default="")
+    parser.add_argument("--cmd", "-B", action="store_true", help="Create a cmd fire command to launch the the job asynchronously.")
+    parser.add_argument("--interactive", "-i", action="store_true", help="Whether to run the job interactively using IPython")
+    parser.add_argument("--debug", "-d", action="store_true", help="debug")
+    parser.add_argument("--choose_function", "-c", action="store_true", help="debug")
+    parser.add_argument("--loop", "-l", action="store_true", help="infinite recusion (runs again after completion/interruption)")
+    parser.add_argument("--jupyter", "-j", action="store_true", help="open in a jupyter notebook")
+    parser.add_argument("--submit_to_cloud", "-C", action="store_true", help="submit to cloud compute")
+    parser.add_argument("--remote", "-r", action="store_true", help="launch on a remote machine")
+    parser.add_argument("--module", "-m", action="store_true", help="launch the main file")
+    parser.add_argument("--streamlit", "-S", action="store_true", help="run as streamlit app")
+    parser.add_argument("--environment", "-E", type=str, help="Choose ip, localhost, hostname or arbitrary url", default="")
+    parser.add_argument("--holdDirectory", "-D", action="store_true", help="hold current directory and avoid cd'ing to the script directory")
+    parser.add_argument("--PathExport", "-P", action="store_true", help="augment the PYTHONPATH with repo root.")
+    parser.add_argument("--git_pull", "-g", action="store_true", help="Start by pulling the git repo")
+    parser.add_argument("--optimized", "-O", action="store_true", help="Run the optimized version of the function")
+    parser.add_argument("--Nprocess", "-p", type=int, help="Number of processes to use", default=1)
+    parser.add_argument("--zellij_tab", "-z", type=str, dest="zellij_tab", help="open in a new zellij tab")
+    parser.add_argument("--watch", "-w", action="store_true", help="watch the file for changes")
+    parser.add_argument("--kw", nargs="*", default=None, help="keyword arguments to pass to the function in the form of k1 v1 k2 v2 ... (meaning k1=v1, k2=v2, etc)")
+    parser.add_argument("--layout", "-L", action="store_true", help="use layout configuration (Zellij Or WindowsTerminal)")
+
+    try:
+        args_raw = parser.parse_args()
+    except Exception as ex:
+        print(f"❌ Failed to parse arguments: {ex}")
+        parser.print_help()
+        raise ex
+    args = FireJobArgs(**vars(args_raw))
+    return args
+
+
+def extract_kwargs(args: FireJobArgs) -> dict[str, object]:
+    str2obj = {"True": True, "False": False, "None": None}
+    if args.kw is not None:
+        assert len(args.kw) % 2 == 0, f"args.kw must be a list of even length. Got {len(args.kw)}"
+        kwargs = dict(zip(args.kw[::2], args.kw[1::2]))
+        kwargs: dict[str, object]
+        for key, value in kwargs.items():
+            if value in str2obj:
+                kwargs[key] = str2obj[str(value)]
+        if args.function is None:  # if user passed arguments and forgot to pass function, then assume they want to run the main function.
+            args.choose_function = True
+    else:
+        kwargs = {}
+    return kwargs