machineconfig 3.8__tar.gz → 3.82__tar.gz

{machineconfig-3.8/src/machineconfig.egg-info → machineconfig-3.82}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: machineconfig
-Version: 3.8
+Version: 3.82
 Summary: Dotfiles management package
 Author-email: Alex Al-Saffar <programmer@usa.com>
 License: Apache 2.0
@@ -24,6 +24,7 @@ Requires-Dist: gitpython>=3.1.44
 Requires-Dist: pyfzf>=0.3.1
 Requires-Dist: rclone-python>=0.1.23
 Requires-Dist: pyjson5>=1.6.9
+Requires-Dist: typer-slim>=0.19.2
 Provides-Extra: windows
 Requires-Dist: pywin32; extra == "windows"
 Provides-Extra: docs

{machineconfig-3.8 → machineconfig-3.82}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "machineconfig"
-version = "3.8"
+version = "3.82"
 description = "Dotfiles management package"
 readme = "README.md"
 license = {text = "Apache 2.0"}
@@ -33,6 +33,7 @@ dependencies = [
     "pyfzf>=0.3.1",
     "rclone-python>=0.1.23",
     "pyjson5>=1.6.9",
+    "typer-slim>=0.19.2",
 ]
 
 [project.optional-dependencies]
@@ -50,20 +51,20 @@ docs = [
 
 [project.scripts]
 devops = "machineconfig.scripts.python.devops:args_parser"
-# machineconfig.scripts.python.devops_devapps_install
+install = "machineconfig.scripts.python.devops_devapps_install:main_with_parser"
 choose_wezterm_theme = "machineconfig.scripts.python.choose_wezterm_theme:main"
 cloud_copy = "machineconfig.scripts.python.cloud_copy:arg_parser"
 cloud_mount = "machineconfig.scripts.python.cloud_mount:main"
 cloud_repo_sync = "machineconfig.scripts.python.cloud_repo_sync:args_parser"
 cloud_sync = "machineconfig.scripts.python.cloud_sync:args_parser"
 croshell = "machineconfig.scripts.python.croshell:build_parser"
-fire = "machineconfig.scripts.python.fire_jobs:main"
+fire = "machineconfig.scripts.python.fire_jobs:main_from_parser"
 fire_agents = "machineconfig.scripts.python.fire_agents:main"
-ftpx = "machineconfig.scripts.python.ftpx:main"
+ftpx = "machineconfig.scripts.python.ftpx:main_from_parser"
 initai = "machineconfig.scripts.python.ai.initai:main"
 mount_nfs = "machineconfig.scripts.python.mount_nfs:main"
 mount_nw_drive = "machineconfig.scripts.python.mount_nw_drive:main"
-repos = "machineconfig.scripts.python.repos:main"
+repos = "machineconfig.scripts.python.repos:main_from_parser"
 start_slidev = "machineconfig.scripts.python.start_slidev:main"
 wifi_conn = "machineconfig.scripts.python.wifi_conn:main"
 kill_process = "machineconfig.utils.procs:main"

{machineconfig-3.8 → machineconfig-3.82}/src/machineconfig/scripts/python/cloud_repo_sync.py

@@ -5,14 +5,12 @@ import git
 from machineconfig.utils.io import read_ini
 from machineconfig.utils.path_extended import PathExtended as PathExtended
 from machineconfig.utils.terminal import Terminal
-from machineconfig.utils.accessories import randstr
 
 from machineconfig.scripts.python.helpers.repo_sync_helpers import fetch_dotfiles
 from machineconfig.utils.source_of_truth import CONFIG_PATH, DEFAULTS_PATH
 from machineconfig.utils.options import choose_from_options
 from machineconfig.utils.code import get_shell_file_executing_python_script, write_shell_script_to_file
 import platform
-import argparse
 from typing import Optional, Literal
 from rich.console import Console
 from rich.panel import Panel
@@ -171,21 +169,17 @@ git commit -am "finished merging"
 
 
 def args_parser():
-    console.print(Panel("🔄 Repository Synchronization Utility", title_align="left", border_style="blue"))
-
-    parser = argparse.ArgumentParser(description="Secure Repo CLI.")
-    # parser.add_argument("cmd", help="command to run", choices=["pull", "push"])
-    parser.add_argument("path", nargs="?", type=str, help="Repository path, defaults to cwd.", default=None)
-    # parser.add_argument("--share", help="Repository path, defaults to cwd.", action="store_true", default=False)
-    parser.add_argument("--cloud", "-c", help="rclone cloud profile name.", default=None)
-    parser.add_argument("--message", "-m", help="Commit Message", default=f"new message {randstr()}")
-    # parser.add_argument("--skip_confirmation", "-s", help="Skip confirmation.", action="store_true", default=False)
-    # parser.add_argument("--key", "-k", help="Key for encryption", default=None)
-    parser.add_argument("--pwd", "-p", help="Password for encryption", default=None)
-    # parser.add_argument("--no_push", "-u", help="push to reomte.", action="store_true")  # default is False
-    parser.add_argument("--action", "-a", help="Action to take if merge fails.", choices=["ask", "pushLocalMerge", "overwriteLocal", "InspectRepos", "RemoveLocalRclone"], default="ask")
-    args = parser.parse_args()
-    main(cloud=args.cloud, path=args.path, message=args.message, action=args.action)
+    # console.print(Panel("🔄 Repository Synchronization Utility", title_align="left", border_style="blue"))
+    # parser = argparse.ArgumentParser(description="Secure Repo CLI.")
+    # parser.add_argument("path", nargs="?", type=str, help="Repository path, defaults to cwd.", default=None)
+    # parser.add_argument("--cloud", "-c", help="rclone cloud profile name.", default=None)
+    # parser.add_argument("--message", "-m", help="Commit Message", default=f"new message {randstr()}")
+    # parser.add_argument("--pwd", "-p", help="Password for encryption", default=None)
+    # parser.add_argument("--action", "-a", help="Action to take if merge fails.", choices=["ask", "pushLocalMerge", "overwriteLocal", "InspectRepos", "RemoveLocalRclone"], default="ask")
+    # args = parser.parse_args()
+    # main(cloud=args.cloud, path=args.path, message=args.message, action=args.action)
+    import typer
+    typer.run(main)
 
 
 if __name__ == "__main__":

{machineconfig-3.8 → machineconfig-3.82}/src/machineconfig/scripts/python/croshell.py

@@ -13,8 +13,7 @@ from machineconfig.utils.ve import get_ve_activate_line
 from typing import Optional
 from rich.console import Console
 from rich.panel import Panel
-from rich.text import Text  # Added import for rich.text
-# from machineconfig.utils.utils2 import pprint
+from rich.text import Text
 
 console = Console()
 
@@ -24,7 +23,7 @@ def add_print_header_pycode(path: str, title: str):
 try:
     from crocodile.file_management import P as PathExtended
 except ImportError:
-    from machineconfig.utils.path_reduced import PathExtended
+    from machineconfig.utils.path_extended import PathExtended
 pycode = PathExtended(r'{path}').read_text(encoding="utf-8")
 pycode = pycode.split("except Exception: print(pycode)")[2]
 

{machineconfig-3.8 → machineconfig-3.82}/src/machineconfig/scripts/python/devops.py

@@ -3,8 +3,7 @@
 from machineconfig.utils.options import choose_from_options
 
 from platform import system
-from enum import Enum
-from typing import Optional
+from typing import Optional, Literal, TypeAlias
 from rich.console import Console
 from rich.panel import Panel
 
@@ -13,36 +12,20 @@ console = Console()
 BOX_WIDTH = 150  # width for box drawing
 
 
-class Options(Enum):
-    update = "🔄 UPDATE essential repos"
-    cli_install = "⚙️ DEVAPPS install"
-    sym_path_shell = "🔗 SYMLINKS, SHELL PROFILE, FONT, TERMINAL SETTINGS."
-    sym_new = "🆕 SYMLINKS new"
-    ssh_add_pubkey = "🔑 SSH add pub key to this machine"
-    ssh_add_id = "🗝️ SSH add identity (private key) to this machine"
-    ssh_use_pair = "🔐 SSH use key pair to connect two machines"
-    ssh_setup = "📡 SSH setup"
-    ssh_setup_wsl = "🐧 SSH setup wsl"
-    backup = "💾 BACKUP"
-    retreive = "📥 RETRIEVE"
-    scheduler = "⏰ SCHEDULER"
+Options: TypeAlias = Literal["🔄 UPDATE essential repos", "⚙️ DEVAPPS install", "🔗 SYMLINKS, SHELL PROFILE, FONT, TERMINAL SETTINGS.", "🆕 SYMLINKS new", "🔑 SSH add pub key to this machine", "🗝️ SSH add identity (private key) to this machine", "🔐 SSH use key pair to connect two machines", "📡 SSH setup", "🐧 SSH setup wsl", "💾 BACKUP", "📥 RETRIEVE", "⏰ SCHEDULER"]
 
+options_list = list(Options.__args__)
 
-def args_parser():
-    console.print(Panel("🛠️  DevOps Tool Suite", title_align="left", border_style="blue", width=BOX_WIDTH))
-    import argparse
 
-    parser = argparse.ArgumentParser()
-    new_line = "\n\n"
-    parser.add_argument("-w", "--which", help=f"""which option to run\nChoose one of those:\n{new_line.join([f"{item.name}: {item.value}" for item in list(Options)])}""", type=str, default=None)  # , choices=[op.value for op in Options]
-    args = parser.parse_args()
-    main(which=args.which)
+def args_parser():
+    import typer
+    typer.run(main)
 
 
-def main(which: Optional[str] = None):
+def main(which: Optional[Options] = None):
     # 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]
+    options = options_list
     if which is None:
         try:
             choice_key = choose_from_options(msg="", options=options, header="🛠️ DEVOPS", default=options[0], multi=False)
@@ -50,51 +33,51 @@ def main(which: Optional[str] = None):
             console.print(Panel("❌ Operation cancelled by user", title_align="left", border_style="red", width=BOX_WIDTH))
             return
     else:
-        choice_key = Options[which].value
+        choice_key = which
 
     console.print(Panel(f"🔧 SELECTED OPERATION\n{choice_key}", title_align="left", border_style="green", width=BOX_WIDTH))
 
-    if choice_key == Options.update.value:
+    if choice_key == "🔄 UPDATE essential repos":
         console.print(Panel("🔄 Updating essential repositories...", width=BOX_WIDTH, border_style="blue"))
         import machineconfig.scripts.python.devops_update_repos as helper
 
         helper.main()
-    elif choice_key == Options.cli_install.value:
+    elif choice_key == "⚙️ DEVAPPS install":
         console.print(Panel("⚙️  Installing development applications...", width=BOX_WIDTH, border_style="blue"))
         import machineconfig.scripts.python.devops_devapps_install as helper
 
         helper.main(which=None)
 
-    elif choice_key == Options.sym_new.value:
+    elif choice_key == "🆕 SYMLINKS new":
         console.print(Panel("🔄 Creating new symlinks...", width=BOX_WIDTH, border_style="blue"))
         import machineconfig.jobs.python.python_ve_symlink as helper
 
         helper.main()
 
-    elif choice_key == Options.sym_path_shell.value:
+    elif choice_key == "🔗 SYMLINKS, SHELL PROFILE, FONT, TERMINAL SETTINGS.":
         console.print(Panel("🔗 Setting up symlinks, PATH, and shell profile...", width=BOX_WIDTH, border_style="blue"))
         import machineconfig.profile.create as helper
 
         helper.main()
         "echo '✅ done with symlinks'"
 
-    elif choice_key == Options.ssh_add_pubkey.value:
+    elif choice_key == "🔑 SSH add pub key to this machine":
         console.print(Panel("🔑 Adding public SSH key to this machine...", width=BOX_WIDTH, border_style="blue"))
         import machineconfig.scripts.python.devops_add_ssh_key as helper
 
         helper.main()
 
-    elif choice_key == Options.ssh_use_pair.value:
+    elif choice_key == "🔐 SSH use key pair to connect two machines":
         console.print(Panel("❌ ERROR: Not Implemented\nSSH key pair connection feature is not yet implemented", title_align="left", border_style="red", width=BOX_WIDTH))
         raise NotImplementedError
 
-    elif choice_key == Options.ssh_add_id.value:  # so that you can SSH directly withuot pointing to identity key.
+    elif choice_key == "🗝️ SSH add identity (private key) to this machine":  # so that you can SSH directly withuot pointing to identity key.
         console.print(Panel("🗝️  Adding SSH identity (private key) to this machine...", width=BOX_WIDTH, border_style="blue"))
         import machineconfig.scripts.python.devops_add_identity as helper
 
         helper.main()
 
-    elif choice_key == Options.ssh_setup.value:
+    elif choice_key == "📡 SSH setup":
         console.print(Panel("📡 Setting up SSH...", width=BOX_WIDTH, border_style="blue"))
         _program_windows = """Invoke-WebRequest https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/openssh_all.ps1 | Invoke-Expression  # https://github.com/thisismygitrepo.keys"""
         _program_linux = """curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/openssh_all.sh | sudo bash  # https://github.com/thisismygitrepo.keys"""
@@ -103,23 +86,23 @@ def main(which: Optional[str] = None):
 
         subprocess.run(_program_linux if system() == "Linux" else _program_windows, shell=True, check=True)
 
-    elif choice_key == Options.ssh_setup_wsl.value:
+    elif choice_key == "🐧 SSH setup wsl":
         console.print(Panel("🐧 Setting up SSH for WSL...", width=BOX_WIDTH, border_style="blue"))
         """curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/openssh_wsl.sh | sudo bash"""
 
-    elif choice_key == Options.backup.value:
+    elif choice_key == "💾 BACKUP":
         console.print(Panel("💾 Creating backup...", width=BOX_WIDTH, border_style="blue"))
         from machineconfig.scripts.python.devops_backup_retrieve import main_backup_retrieve
 
         main_backup_retrieve(direction="BACKUP")
 
-    elif choice_key == Options.retreive.value:
+    elif choice_key == "📥 RETRIEVE":
         console.print(Panel("📥 Retrieving backup...", width=BOX_WIDTH, border_style="blue"))
         from machineconfig.scripts.python.devops_backup_retrieve import main_backup_retrieve
 
         main_backup_retrieve(direction="RETRIEVE")
 
-    elif choice_key == Options.scheduler.value:
+    elif choice_key == "⏰ SCHEDULER":
         console.print(Panel("⏰ Setting up scheduler...", width=BOX_WIDTH, border_style="blue"))
         # from machineconfig.scripts.python.scheduler import main as helper
         # helper()

{machineconfig-3.8 → machineconfig-3.82}/src/machineconfig/scripts/python/devops_devapps_install.py

@@ -1,18 +1,25 @@
 """Devops Devapps Install"""
 
 # import subprocess
+import typer
 from rich.progress import Progress, SpinnerColumn, TextColumn
 from machineconfig.utils.source_of_truth import LIBRARY_ROOT
 from machineconfig.utils.options import choose_from_options
 from machineconfig.utils.installer import get_installers, install_all
 from platform import system
-from typing import Any, Optional, Literal, TypeAlias, get_args
-
+from typing import Any, Optional, Literal, TypeAlias, get_args, Annotated
 
 WHICH_CAT: TypeAlias = Literal["AllEssentials", "EssentialsAndOthers", "SystemInstallers", "PrecheckedCloudInstaller"]
 
 
-def main(which: Optional[WHICH_CAT | str]) -> None:
+def main_with_parser():
+    import typer
+    app = typer.Typer()
+    app.command()(main)
+    app()
+
+
+def main(which: Annotated[Optional[str], typer.Argument(help=f"Choose a category or program to install, {list(get_args(WHICH_CAT))} or <program_name>")]) -> None:
     if which is not None and which in get_args(WHICH_CAT):  # install by category
         return get_programs_by_category(program_name=which)  # type: ignore
 
@@ -123,7 +130,7 @@ def get_programs_by_category(program_name: WHICH_CAT):
                 if sub_program.startswith("#winget"):
                     sub_program = sub_program[1:]
                 program += "\n" + sub_program
-
+        # case "CHOOSE": raise NotImplementedError("CHOOSE is not implemented yet.")
         # case "OtherDevApps":
         #     installers = get_installers(dev=True, system=system())
         #     options__: list[str] = [x.get_description() for x in tqdm(installers, desc="Checking installed programs")]

{machineconfig-3.8 → machineconfig-3.82}/src/machineconfig/scripts/python/fire_jobs.py

@@ -17,11 +17,12 @@ from machineconfig.utils.path_helper import match_file_name, sanitize_path
 
 from machineconfig.utils.path_extended import PathExtended as PathExtended
 from machineconfig.utils.accessories import get_repo_root, randstr
-from machineconfig.scripts.python.fire_jobs_args_helper import get_args, FireJobArgs, extract_kwargs
+from machineconfig.scripts.python.fire_jobs_args_helper import FireJobArgs, extract_kwargs
 import platform
-from typing import Optional
+from typing import Optional, Annotated
 from pathlib import Path
 import tomllib
+import typer
 # import os
 
 
@@ -328,12 +329,64 @@ python -m machineconfig.cluster.templates.cli_click --file {choice_file} """
     subprocess.run(command, shell=True, check=True)
 
 
-def main():
-    args = get_args()
+def main(
+    path: Annotated[str, typer.Argument(help="The directory containing the jobs")] = ".",
+    function: Annotated[Optional[str], typer.Argument(help="Function to run")] = None,
+    ve: Annotated[str, typer.Option("--ve", "-v", help="Virtual environment name")] = "",
+    cmd: Annotated[bool, typer.Option("--cmd", "-B", help="Create a cmd fire command to launch the job asynchronously")] = False,
+    interactive: Annotated[bool, typer.Option("--interactive", "-i", help="Whether to run the job interactively using IPython")] = False,
+    debug: Annotated[bool, typer.Option("--debug", "-d", help="Enable debug mode")] = False,
+    choose_function: Annotated[bool, typer.Option("--choose_function", "-c", help="Choose function interactively")] = False,
+    loop: Annotated[bool, typer.Option("--loop", "-l", help="Infinite recursion (runs again after completion/interruption)")] = False,
+    jupyter: Annotated[bool, typer.Option("--jupyter", "-j", help="Open in a jupyter notebook")] = False,
+    submit_to_cloud: Annotated[bool, typer.Option("--submit_to_cloud", "-C", help="Submit to cloud compute")] = False,
+    remote: Annotated[bool, typer.Option("--remote", "-r", help="Launch on a remote machine")] = False,
+    module: Annotated[bool, typer.Option("--module", "-m", help="Launch the main file")] = False,
+    streamlit: Annotated[bool, typer.Option("--streamlit", "-S", help="Run as streamlit app")] = False,
+    environment: Annotated[str, typer.Option("--environment", "-E", help="Choose ip, localhost, hostname or arbitrary url")] = "",
+    holdDirectory: Annotated[bool, typer.Option("--holdDirectory", "-D", help="Hold current directory and avoid cd'ing to the script directory")] = False,
+    PathExport: Annotated[bool, typer.Option("--PathExport", "-P", help="Augment the PYTHONPATH with repo root")] = False,
+    git_pull: Annotated[bool, typer.Option("--git_pull", "-g", help="Start by pulling the git repo")] = False,
+    optimized: Annotated[bool, typer.Option("--optimized", "-O", help="Run the optimized version of the function")] = False,
+    Nprocess: Annotated[int, typer.Option("--Nprocess", "-p", help="Number of processes to use")] = 1,
+    zellij_tab: Annotated[Optional[str], typer.Option("--zellij_tab", "-z", help="Open in a new zellij tab")] = None,
+    watch: Annotated[bool, typer.Option("--watch", "-w", help="Watch the file for changes")] = False,
+    kw: Annotated[Optional[list[str]], typer.Option("--kw", help="Keyword arguments to pass to the function in the form of k1 v1 k2 v2 ... (meaning k1=v1, k2=v2, etc)")] = None,
+    layout: Annotated[bool, typer.Option("--layout", "-L", help="Use layout configuration (Zellij Or WindowsTerminal)")] = False,
+) -> None:
+    """Main function to process fire jobs arguments."""
+    args = FireJobArgs(
+        path=path,
+        function=function,
+        ve=ve,
+        cmd=cmd,
+        interactive=interactive,
+        debug=debug,
+        choose_function=choose_function,
+        loop=loop,
+        jupyter=jupyter,
+        submit_to_cloud=submit_to_cloud,
+        remote=remote,
+        module=module,
+        streamlit=streamlit,
+        environment=environment,
+        holdDirectory=holdDirectory,
+        PathExport=PathExport,
+        git_pull=git_pull,
+        optimized=optimized,
+        Nprocess=Nprocess,
+        zellij_tab=zellij_tab,
+        watch=watch,
+        kw=kw,
+        layout=layout,
+    )
     route(args)
 
 
+def main_from_parser():
+    typer.run(main)
+
+
 if __name__ == "__main__":
     # options, func_args = parse_pyfile(file_path="C:/Users/aalsaf01/code/machineconfig/myresources/crocodile/core.py")
-    args = get_args()
-    route(args)
+    pass

machineconfig-3.82/src/machineconfig/scripts/python/fire_jobs_args_helper.py

@@ -0,0 +1,48 @@
+from dataclasses import dataclass
+from typing import Optional, Annotated
+import typer
+
+
+@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 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

{machineconfig-3.8 → machineconfig-3.82}/src/machineconfig/scripts/python/ftpx.py

@@ -6,39 +6,40 @@ Currently, the only way to work around this is to predifine the host in ~/.ssh/c
 
 """
 
-import argparse
+import typer
+from typing_extensions import Annotated
 from machineconfig.utils.ssh import SSH
 from machineconfig.utils.path_extended import PathExtended as PathExtended
 from machineconfig.scripts.python.helpers.helpers2 import ES
 from machineconfig.utils.accessories import pprint
 
 
-def main():
+def main(
+    source: Annotated[str, typer.Argument(help="Source path (machine:path)")],
+    target: Annotated[str, typer.Argument(help="Target path (machine:path)")],
+    recursive: Annotated[bool, typer.Option("--recursive", "-r", help="Send recursively.")] = False,
+    zipFirst: Annotated[bool, typer.Option("--zipFirst", "-z", help="Zip before sending.")] = False,
+    cloud: Annotated[bool, typer.Option("--cloud", "-c", help="Transfer through the cloud.")] = False,
+) -> None:
     print("""
 ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ┃ 🚀 FTP File Transfer
 ┃ 📋 Starting transfer process...
 ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━""")
-    parser = argparse.ArgumentParser(description="FTP client")
-
-    parser.add_argument("source", help="source path (machine:path)")
-    parser.add_argument("target", help="target path (machine:path)")
-
-    # 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
-    parser.add_argument("--cloud", "-c", help="Transfer through the cloud.", action="store_true")  # default is False
-
-    args = parser.parse_args()
-
-    if ":" in args.source and (args.source[1] != ":" if len(args.source) > 1 else True):  # avoid the case of "C:/":
+    
+    # Initialize variables
+    resolved_source: str | None = None
+    resolved_target: str | None = None
+    machine: str = ""
+    
+    if ":" in source and (source[1] != ":" if len(source) > 1 else True):  # avoid the case of "C:/":
         source_is_remote = True
 
         # calculating source:
-        source_parts = args.source.split(":")
+        source_parts = source.split(":")
         machine = source_parts[0]
         if len(source_parts) > 1 and source_parts[1] == ES:  # the source path is to be inferred from target.
-            if args.target == ES:
+            if target == ES:
                 raise ValueError(f"""
 ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ┃ ❌ Configuration Error
@@ -46,21 +47,22 @@ def main():
 ┃    This creates a cyclical inference dependency
 ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━""")
             else:
-                target = PathExtended(args.target).expanduser().absolute()
-            source = target.collapseuser().as_posix()
+                target_path_obj = PathExtended(target).expanduser().absolute()
+            resolved_source = target_path_obj.collapseuser().as_posix()
+            resolved_target = target
         else:
-            source = ":".join(args.source.split(":")[1:])
-            if args.target == ES:
-                target = None
+            resolved_source = ":".join(source.split(":")[1:])
+            if target == ES:
+                resolved_target = None
             else:
-                target = PathExtended(args.target).expanduser().absolute().as_posix()
+                resolved_target = PathExtended(target).expanduser().absolute().as_posix()
 
-    elif ":" in args.target and (args.target[1] != ":" if len(args.target) > 1 else True):  # avoid the case of "C:/":
+    elif ":" in target and (target[1] != ":" if len(target) > 1 else True):  # avoid the case of "C:/":
         source_is_remote = False
-        target_parts = args.target.split(":")
+        target_parts = target.split(":")
         machine = target_parts[0]
         if len(target_parts) > 1 and target_parts[1] == ES:
-            if args.source == ES:
+            if source == ES:
                 raise ValueError(f"""
 ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ┃ ❌ Configuration Error
@@ -68,14 +70,14 @@ def main():
 ┃    This creates a cyclical inference dependency
 ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━""")
             else:
-                source = args.source
-            target = None
+                resolved_source = source
+            resolved_target = None
         else:
-            target = ":".join(args.target.split(":")[1:])
-            if args.source == ES:
-                source = None
+            resolved_target = ":".join(target.split(":")[1:])
+            if source == ES:
+                resolved_source = None
             else:
-                source = PathExtended(args.source).expanduser().absolute()
+                resolved_source = PathExtended(source).expanduser().absolute().as_posix()
 
     else:
         raise ValueError("""
@@ -85,7 +87,7 @@ def main():
 ┃    Format should be: machine:path
 ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━""")
 
-    pprint({"source": str(source), "target": str(target), "machine": machine}, "CLI Resolution")
+    pprint({"source": str(resolved_source), "target": str(resolved_target), "machine": machine}, "CLI Resolution")
 
     from paramiko.ssh_exception import AuthenticationException  # type: ignore
 
@@ -105,43 +107,43 @@ def main():
         pwd = getpass.getpass()
         ssh = SSH(rf"{machine}", pwd=pwd)
 
-    if args.cloud:
+    if cloud:
         print("""
 ┌────────────────────────────────────────────────────────────────
 │ ☁️  Cloud Transfer Mode
 │    Uploading from remote to cloud...
 └────────────────────────────────────────────────────────────────""")
-        ssh.run(f"cloud_copy {source} :^", desc="Uploading from remote to the cloud.").print()
+        ssh.run(f"cloud_copy {resolved_source} :^", desc="Uploading from remote to the cloud.").print()
         print("""
 ┌────────────────────────────────────────────────────────────────
 │ ⬇️  Cloud Transfer Mode
 │    Downloading from cloud to local...
 └────────────────────────────────────────────────────────────────""")
-        ssh.run_locally(f"cloud_copy :^ {target}").print()
-        received_file = PathExtended(target)  # type: ignore
+        ssh.run_locally(f"cloud_copy :^ {resolved_target}").print()
+        received_file = PathExtended(resolved_target)  # type: ignore
     else:
         if source_is_remote:
-            assert source is not None, """
+            assert resolved_source is not None, """
 ❌ Path Error: Source must be a remote path (machine:path)"""
             print(f"""
 ┌────────────────────────────────────────────────────────────────
 │ 📥 Transfer Mode: Remote → Local
-│    Source: {source}
-│    Target: {target}
-│    Options: {"ZIP compression" if args.zipFirst else "No compression"}, {"Recursive" if args.recursive else "Non-recursive"}
+│    Source: {resolved_source}
+│    Target: {resolved_target}
+│    Options: {"ZIP compression" if zipFirst else "No compression"}, {"Recursive" if recursive else "Non-recursive"}
 └────────────────────────────────────────────────────────────────""")
-            received_file = ssh.copy_to_here(source=source, target=target, z=args.zipFirst, r=args.recursive)
+            received_file = ssh.copy_to_here(source=resolved_source, target=resolved_target, z=zipFirst, r=recursive)
         else:
-            assert source is not None, """
+            assert resolved_source is not None, """
 ❌ Path Error: Target must be a remote path (machine:path)"""
             print(f"""
 ┌────────────────────────────────────────────────────────────────
 │ 📤 Transfer Mode: Local → Remote
-│    Source: {source}
-│    Target: {target}
-│    Options: {"ZIP compression" if args.zipFirst else "No compression"}, {"Recursive" if args.recursive else "Non-recursive"}
+│    Source: {resolved_source}
+│    Target: {resolved_target}
+│    Options: {"ZIP compression" if zipFirst else "No compression"}, {"Recursive" if recursive else "Non-recursive"}
 └────────────────────────────────────────────────────────────────""")
-            received_file = ssh.copy_from_here(source=source, target=target, z=args.zipFirst, r=args.recursive)
+            received_file = ssh.copy_from_here(source=resolved_source, target=resolved_target, z=zipFirst, r=recursive)
 
     if source_is_remote and isinstance(received_file, PathExtended):
         print(f"""
@@ -157,5 +159,10 @@ def main():
 ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━""")
 
 
+def main_from_parser() -> None:
+    """Entry point function that uses typer to parse arguments and call main."""
+    typer.run(main)
+
+
 if __name__ == "__main__":
-    main()
+    main_from_parser()