machineconfig 3.81__tar.gz → 3.83__tar.gz

{machineconfig-3.81/src/machineconfig.egg-info → machineconfig-3.83}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: machineconfig
-Version: 3.81
+Version: 3.83
 Summary: Dotfiles management package
 Author-email: Alex Al-Saffar <programmer@usa.com>
 License: Apache 2.0

{machineconfig-3.81 → machineconfig-3.83}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "machineconfig"
-version = "3.81"
+version = "3.83"
 description = "Dotfiles management package"
 readme = "README.md"
 license = {text = "Apache 2.0"}
@@ -58,13 +58,13 @@ 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.83/src/machineconfig/scripts/python/ai/scripts/lint_and_type_check.ps1

@@ -0,0 +1,115 @@
+# gotch1: make sure we are in the right directory: repo root. Solution: check if .pyproject.toml exists, otherwise stop.
+if (!(Test-Path "./pyproject.toml")) {
+    Write-Host "Error: pyproject.toml not found in the current directory. Please run this script from the root of a Python project." -ForegroundColor Red
+    exit 1
+}
+
+# Color definitions (using ANSI escape sequences for cross-platform compatibility)
+$RED = "`e[0;31m"
+$GREEN = "`e[0;32m"
+$YELLOW = "`e[1;33m"
+$BLUE = "`e[0;34m"
+$PURPLE = "`e[0;35m"
+$CYAN = "`e[0;36m"
+$WHITE = "`e[1;37m"
+$BOLD = "`e[1m"
+$UNDERLINE = "`e[4m"
+$NC = "`e[0m" # No Color
+
+# Box drawing functions
+function Draw-Box {
+    param([string]$text, [string]$color)
+    $width = 60
+    $padding = [math]::Floor(($width - $text.Length) / 2)
+    $line = "─" * $width
+
+    Write-Host "${color}┌${line}┐${NC}"
+    Write-Host ("${color}│" + (" " * $padding) + $text + (" " * $padding) + "│${NC}")
+    Write-Host "${color}└${line}┘${NC}"
+}
+
+function Draw-Progress {
+    param([int]$current, [int]$total, [string]$description)
+    Write-Host "${CYAN}┌────────────────────────────────────────────────────────────┐${NC}"
+    $padding = 50 - $description.Length - 8
+    Write-Host ("${CYAN}│${NC} ${BOLD}${WHITE}Step ${current}/${total}:${NC} ${description}" + (" " * $padding) + "${CYAN}│${NC}")
+    Write-Host "${CYAN}└────────────────────────────────────────────────────────────┘${NC}"
+}
+
+$TOTAL_STEPS = 7
+$CURRENT_STEP = 0
+
+Draw-Box "🚀 LINTING & TYPE CHECKING SUITE 🚀" "${BOLD}${CYAN}"
+Write-Host
+
+$CURRENT_STEP++
+Draw-Progress $CURRENT_STEP $TOTAL_STEPS "Environment Setup"
+Write-Host "${BLUE}🔧 Installing and updating development dependencies...${NC}"
+# uv add pylint pyright mypy pyrefly ruff ty --dev  # linters and type checkers
+# uv add --dev cleanpy pylint pyright mypy pyrefly --upgrade-package cleanpy pylint pyright mypy pyrefly
+uv add --dev pyright --upgrade-package pyright
+uv add --dev pylint --upgrade-package pylint
+uv add --dev mypy --upgrade-package mypy
+uv add --dev pyrefly --upgrade-package pyrefly
+uv add --dev cleanpy --upgrade-package cleanpy
+
+uv add types-requests types-toml types-PyYAML types-pytz types-paramiko types-urllib3 --dev
+uv add types-mysqlclient types-SQLAlchemy --dev
+
+Write-Host "${GREEN}✅ Environment setup complete!${NC}"
+Write-Host
+
+$CURRENT_STEP++
+Draw-Progress $CURRENT_STEP $TOTAL_STEPS "Code Cleanup"
+Write-Host "${YELLOW}🧹 Cleaning and formatting code...${NC}"
+uv run -m cleanpy .
+uv run -m ruff clean
+# uv run -m ruff format .
+uv run -m ruff check . --fix
+uv run --no-dev --project $HOME/code/machineconfig -m machineconfig.scripts.python.ai.generate_files
+
+New-Item -ItemType Directory -Force -Path .linters | Out-Null
+
+Write-Host "${GREEN}🧹 Code cleanup complete!${NC}"
+Write-Host
+
+Draw-Box "🔍 TYPE CHECKERS & LINTERS 🔍" "${BOLD}${PURPLE}"
+
+$CURRENT_STEP++
+Draw-Progress $CURRENT_STEP $TOTAL_STEPS "Pyright Type Checker"
+Write-Host "${BLUE}📋 Analyzing types with Pyright...${NC}"
+Remove-Item ./.linters/pyright_result.md -ErrorAction SilentlyContinue
+uv run pyright . | Out-File -FilePath ./.linters/pyright_result.md
+Write-Host "${GREEN}✅ Results saved to ${UNDERLINE}./.linters/pyright_result.md${NC}"
+
+$CURRENT_STEP++
+Draw-Progress $CURRENT_STEP $TOTAL_STEPS "MyPy Type Checker"
+Write-Host "${BLUE}📋 Analyzing types with MyPy...${NC}"
+Remove-Item ./.linters/mypy_result.md -ErrorAction SilentlyContinue
+uv run mypy . | Out-File -FilePath ./.linters/mypy_result.md
+Write-Host "${GREEN}✅ Results saved to ${UNDERLINE}./.linters/mypy_result.md${NC}"
+
+$CURRENT_STEP++
+Draw-Progress $CURRENT_STEP $TOTAL_STEPS "Pylint Code Analysis"
+Write-Host "${BLUE}📋 Analyzing code quality with Pylint...${NC}"
+Remove-Item ./.linters/pylint_result.md -ErrorAction SilentlyContinue
+uv run pylint ./src/ | Out-File -FilePath ./.linters/pylint_result.md
+Write-Host "${GREEN}✅ Results saved to ${UNDERLINE}./.linters/pylint_result.md${NC}"
+
+$CURRENT_STEP++
+Draw-Progress $CURRENT_STEP $TOTAL_STEPS "Pyrefly Type Checker"
+Write-Host "${BLUE}📋 Analyzing types with Pyrefly...${NC}"
+Remove-Item ./.linters/pyrefly_result.md -ErrorAction SilentlyContinue
+uv run pyrefly check . | Out-File -FilePath ./.linters/pyrefly_result.md
+Write-Host "${GREEN}✅ Results saved to ${UNDERLINE}./.linters/pyrefly_result.md${NC}"
+
+$CURRENT_STEP++
+Draw-Progress $CURRENT_STEP $TOTAL_STEPS "Ruff Linter"
+Write-Host "${BLUE}📋 Checking code style with Ruff...${NC}"
+Remove-Item ./.linters/ruff_result.md -ErrorAction SilentlyContinue
+uv run ruff check . | Out-File -FilePath ./.linters/ruff_result.md
+Write-Host "${GREEN}✅ Results saved to ${UNDERLINE}./.linters/ruff_result.md${NC}"
+
+Write-Host
+Draw-Box "🎉 ALL CHECKS COMPLETED! 🎉" "${BOLD}${GREEN}"
+Write-Host "${BOLD}${GREEN}📁 Check the ${UNDERLINE}.linters${NC}${BOLD}${GREEN} directory for detailed results.${NC}"

machineconfig-3.83/src/machineconfig/scripts/python/ai/scripts/lint_and_type_check.sh

@@ -0,0 +1,119 @@
+
+# gotch1: make sure we are in the right directory: repo root. Solution: check if .pyproject.toml exists, otherwise stop.
+if [ ! -f "./pyproject.toml" ]; then
+    echo "Error: pyproject.toml not found in the current directory. Please run this script from the root of a Python project."
+    exit 1
+fi
+
+# Color definitions
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+PURPLE='\033[0;35m'
+CYAN='\033[0;36m'
+WHITE='\033[1;37m'
+BOLD='\033[1m'
+UNDERLINE='\033[4m'
+NC='\033[0m' # No Color
+
+# Box drawing functions
+draw_box() {
+    local text="$1"
+    local color="$2"
+    local width=60
+    local padding=$(( (width - ${#text}) / 2 ))
+    local line=""
+    for ((i=0; i<width; i++)); do line="${line}─"; done
+    
+    echo -e "${color}┌${line}┐${NC}"
+    printf "${color}│%*s%s%*s│${NC}\n" $padding "" "$text" $padding ""
+    echo -e "${color}└${line}┘${NC}"
+}
+
+draw_progress() {
+    local current="$1"
+    local total="$2"
+    local description="$3"
+    echo -e "${CYAN}┌────────────────────────────────────────────────────────────┐${NC}"
+    echo -e "${CYAN}│${NC} ${BOLD}${WHITE}Step ${current}/${total}:${NC} ${description}${CYAN}$(printf '%*s' $((50 - ${#description} - 8)) "")│${NC}"
+    echo -e "${CYAN}└────────────────────────────────────────────────────────────┘${NC}"
+}
+
+TOTAL_STEPS=7
+CURRENT_STEP=0
+
+draw_box "🚀 LINTING & TYPE CHECKING SUITE 🚀" "${BOLD}${CYAN}"
+echo
+
+((CURRENT_STEP++))
+draw_progress $CURRENT_STEP $TOTAL_STEPS "Environment Setup"
+echo -e "${BLUE}🔧 Installing and updating development dependencies...${NC}"
+# uv add pylint pyright mypy pyrefly ruff ty --dev  # linters and type checkers
+# uv add --dev cleanpy pylint pyright mypy pyrefly --upgrade-package cleanpy pylint pyright mypy pyrefly
+uv add --dev pyright --upgrade-package pyright
+uv add --dev pylint --upgrade-package pylint
+uv add --dev mypy --upgrade-package mypy
+uv add --dev pyrefly --upgrade-package pyrefly
+uv add --dev cleanpy --upgrade-package cleanpy
+
+uv add types-requests types-toml types-PyYAML types-pytz types-paramiko types-urllib3 --dev
+uv add types-mysqlclient types-SQLAlchemy --dev
+
+echo -e "${GREEN}✅ Environment setup complete!${NC}"
+echo
+
+((CURRENT_STEP++))
+draw_progress $CURRENT_STEP $TOTAL_STEPS "Code Cleanup"
+echo -e "${YELLOW}🧹 Cleaning and formatting code...${NC}"
+uv run -m cleanpy .
+uv run -m ruff clean
+# uv run -m ruff format .
+uv run -m ruff check . --fix
+uv run --no-dev --project $HOME/code/machineconfig -m machineconfig.scripts.python.ai.generate_files
+
+mkdir .linters
+
+echo -e "${GREEN}🧹 Code cleanup complete!${NC}"
+echo
+
+draw_box "🔍 TYPE CHECKERS & LINTERS 🔍" "${BOLD}${PURPLE}"
+
+((CURRENT_STEP++))
+draw_progress $CURRENT_STEP $TOTAL_STEPS "Pyright Type Checker"
+echo -e "${BLUE}📋 Analyzing types with Pyright...${NC}"
+rm ./.linters/pyright_result.md || true
+uv run pyright . > ./.linters/pyright_result.md
+echo -e "${GREEN}✅ Results saved to ${UNDERLINE}./.linters/pyright_result.md${NC}"
+
+((CURRENT_STEP++))
+draw_progress $CURRENT_STEP $TOTAL_STEPS "MyPy Type Checker"
+echo -e "${BLUE}📋 Analyzing types with MyPy...${NC}"
+rm ./.linters/mypy_result.md || true
+uv run mypy . > ./.linters/mypy_result.md
+echo -e "${GREEN}✅ Results saved to ${UNDERLINE}./.linters/mypy_result.md${NC}"
+
+((CURRENT_STEP++))
+draw_progress $CURRENT_STEP $TOTAL_STEPS "Pylint Code Analysis"
+echo -e "${BLUE}📋 Analyzing code quality with Pylint...${NC}"
+rm ./.linters/pylint_result.md || true
+uv run pylint ./src/ > ./.linters/pylint_result.md
+echo -e "${GREEN}✅ Results saved to ${UNDERLINE}./.linters/pylint_result.md${NC}"
+
+((CURRENT_STEP++))
+draw_progress $CURRENT_STEP $TOTAL_STEPS "Pyrefly Type Checker"
+echo -e "${BLUE}📋 Analyzing types with Pyrefly...${NC}"
+rm ./.linters/pyrefly_result.md || true
+uv run pyrefly check . > ./.linters/pyrefly_result.md
+echo -e "${GREEN}✅ Results saved to ${UNDERLINE}./.linters/pyrefly_result.md${NC}"
+
+((CURRENT_STEP++))
+draw_progress $CURRENT_STEP $TOTAL_STEPS "Ruff Linter"
+echo -e "${BLUE}📋 Checking code style with Ruff...${NC}"
+rm ./.linters/ruff_result.md || true
+uv run ruff check . > ./.linters/ruff_result.md
+echo -e "${GREEN}✅ Results saved to ${UNDERLINE}./.linters/ruff_result.md${NC}"
+
+echo
+draw_box "🎉 ALL CHECKS COMPLETED! 🎉" "${BOLD}${GREEN}"
+echo -e "${BOLD}${GREEN}📁 Check the ${UNDERLINE}.linters${NC}${BOLD}${GREEN} directory for detailed results.${NC}"

{machineconfig-3.81 → machineconfig-3.83}/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
 
 
@@ -48,11 +49,12 @@ def route(args: FireJobArgs) -> None:
     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")
 
     if choice_file.suffix == ".py":
         kwargs = extract_kwargs(args)
+        activate_ve_line = get_ve_activate_line(ve_root=args.ve or ve_root_from_file or "$HOME/code/machineconfig/.venv")
     else:
+        activate_ve_line = ""
         kwargs = {}
 
     # =========================  choosing function to run
@@ -92,7 +94,6 @@ def route(args: FireJobArgs) -> None:
     if choice_file.suffix == ".py":
         if args.streamlit:
             import socket
-
             s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
             try:
                 s.connect(("8.8.8.8", 1))
@@ -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.83/src/machineconfig/scripts/python/fire_jobs_args_helper.py

@@ -0,0 +1,47 @@
+from dataclasses import dataclass
+from typing import Optional
+
+
+@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.81 → machineconfig-3.83}/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()