machineconfig 5.20__py3-none-any.whl → 5.22__py3-none-any.whl

machineconfig/scripts/python/fire_jobs.py

@@ -7,17 +7,13 @@ fire
 
 """
 
-from machineconfig.scripts.python.fire_jobs_route_helper import get_command_streamlit
-from machineconfig.scripts.python.helpers.helpers4 import search_for_files_of_interest
-from machineconfig.scripts.python.helpers.helpers4 import parse_pyfile
-from machineconfig.scripts.python.helpers.helpers4 import get_import_module_code
 from machineconfig.utils.ve import get_ve_activate_line, get_ve_path_and_ipython_profile
 from machineconfig.utils.options import choose_from_options
 from machineconfig.utils.path_helper import match_file_name, sanitize_path
-
 from machineconfig.utils.path_extended import PathExtended
 from machineconfig.utils.accessories import get_repo_root, randstr
 from machineconfig.scripts.python.fire_jobs_args_helper import FireJobArgs, extract_kwargs, parse_fire_args_from_context
+
 import platform
 from typing import Optional, Annotated
 from pathlib import Path
@@ -30,6 +26,7 @@ def route(args: FireJobArgs, fire_args: str = "") -> None:
         suffixes = {".py", ".sh", ".ps1"}
         choice_file = match_file_name(sub_string=args.path, search_root=PathExtended.cwd(), suffixes=suffixes)
     elif path_obj.is_dir():
+        from machineconfig.scripts.python.helpers.helpers4 import search_for_files_of_interest
         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.")
@@ -37,12 +34,16 @@ def route(args: FireJobArgs, fire_args: str = "") -> None:
         choice_file = PathExtended(choice_file)
     else:
         choice_file = path_obj
+
+
     repo_root = get_repo_root(Path(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"
 
+
+    # =========================  preparing kwargs_dict
     if choice_file.suffix == ".py":
         kwargs_dict = extract_kwargs(args)  # This now returns empty dict, but kept for compatibility
         activate_ve_line = get_ve_activate_line(ve_root=args.ve or ve_root_from_file or "$HOME/code/machineconfig/.venv")
@@ -50,41 +51,17 @@ def route(args: FireJobArgs, fire_args: str = "") -> None:
         activate_ve_line = ""
         kwargs_dict = {}
 
+
     # =========================  choosing function to run
     choice_function: Optional[str] = None  # Initialize to avoid unbound variable
-    if args.choose_function or args.submit_to_cloud:
-        if choice_file.suffix == ".py":
-            options, func_args = parse_pyfile(file_path=str(choice_file))
-            choice_function_tmp = choose_from_options(msg="Choose a function to run", options=options, fzf=True, multi=False)
-            assert isinstance(choice_function_tmp, str), f"choice_function must be a string. Got {type(choice_function_tmp)}"
-            choice_index = options.index(choice_function_tmp)
-            choice_function = choice_function_tmp.split(" -- ")[0]
-            choice_function_args = func_args[choice_index]
-
-            if choice_function == "RUN AS MAIN":
-                choice_function = None
-            if len(choice_function_args) > 0 and len(kwargs_dict) == 0:
-                for item in choice_function_args:
-                    kwargs_dict[item.name] = input(f"Please enter a value for argument `{item.name}` (type = {item.type}) (default = {item.default}) : ") or item.default
-        elif choice_file.suffix == ".sh":  # in this case, we choos lines.
-            options = []
-            for line in choice_file.read_text(encoding="utf-8").splitlines():
-                if line.startswith("#"):
-                    continue
-                if line == "":
-                    continue
-                if line.startswith("echo"):
-                    continue
-                options.append(line)
-            chosen_lines = choose_from_options(msg="Choose a line to run", options=options, fzf=True, multi=True)
-            choice_file = PathExtended.tmpfile(suffix=".sh")
-            choice_file.parent.mkdir(parents=True, exist_ok=True)
-            choice_file.write_text("\n".join(chosen_lines), encoding="utf-8")
-            choice_function = None
+    if args.choose_function:
+        from machineconfig.scripts.python.fire_jobs_route_helper import choose_function_or_lines
+        choice_function, choice_file, kwargs_dict = choose_function_or_lines(choice_file, kwargs_dict)
     else:
         choice_function = args.function
 
     if choice_file.suffix == ".py":
+        from machineconfig.scripts.python.fire_jobs_route_helper import get_command_streamlit
         if args.streamlit:  exe = get_command_streamlit(choice_file, args.environment, repo_root)
         elif args.interactive is False: exe = "python"
         elif args.jupyter: exe = "jupyter-lab"
@@ -95,6 +72,7 @@ def route(args: FireJobArgs, fire_args: str = "") -> None:
 
     if args.module or (args.debug and args.choose_function):  # because debugging tools do not support choosing functions and don't interplay with fire module. So the only way to have debugging and choose function options is to import the file as a module into a new script and run the function of interest there and debug the new script.
         assert choice_file.suffix == ".py", f"File must be a python file to be imported as a module. Got {choice_file}"
+        from machineconfig.scripts.python.helpers.helpers4 import get_import_module_code
         import_line = get_import_module_code(str(choice_file))
         if repo_root is not None:
             repo_root_add = f"""sys.path.append(r'{repo_root}')"""
@@ -160,11 +138,9 @@ except ImportError as _ex:
     elif args.cmd:
         command = rf""" cd /d {choice_file.parent} & {exe} {choice_file.name} """
     else:
-        if choice_file.suffix == "":
-            command = f"{exe} {choice_file} {fire_args}"
-        else:
-            # command = f"cd {choice_file.parent}\n{exe} {choice_file.name}\ncd {PathExtended.cwd()}"
-            command = f"{exe} {choice_file} "
+        if choice_file.suffix == "": command = f"{exe} {choice_file} {fire_args}"
+        else: command = f"{exe} {choice_file} "
+
     if not args.cmd: command = f"{activate_ve_line}\n{command}"
     else:
         new_line = "\n"
@@ -176,14 +152,6 @@ python -m machineconfig.cluster.templates.cli_click --file {choice_file} """
         if choice_function is not None:
             command += f"--function {choice_function} "
 
-    if args.Nprocess > 1:
-        from machineconfig.cluster.sessions_managers.zellij_local import run_zellij_layout
-        from machineconfig.utils.schemas.layouts.layout_types import LayoutConfig
-        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:
         command = command.replace("python ", "python -OO ")
     from rich.panel import Panel
@@ -245,7 +213,6 @@ def main(
     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,
 ) -> None:
@@ -273,7 +240,6 @@ def main(
         PathExport=PathExport,
         git_pull=git_pull,
         optimized=optimized,
-        Nprocess=Nprocess,
         zellij_tab=zellij_tab,
         watch=watch,
     )
@@ -303,5 +269,4 @@ def main_from_parser():
 
 
 if __name__ == "__main__":
-    # options, func_args = parse_pyfile(file_path="C:/Users/aalsaf01/code/machineconfig/myresources/crocodile/core.py")
     main_from_parser()

machineconfig/scripts/python/fire_jobs_args_helper.py

@@ -24,7 +24,6 @@ class FireJobArgs:
     PathExport: bool = False
     git_pull: bool = False
     optimized: bool = False
-    Nprocess: int = 1
     zellij_tab: Optional[str] = None
     watch: bool = False
 
@@ -96,6 +95,10 @@ def _convert_value_type(value: str) -> object:
     elif value.lower() in ('false', '0', 'no', 'off'):
         return False
     
+    # Try to convert None
+    if value.lower() == 'none':
+        return None
+    
     # Try to parse as list (comma-separated values)
     if ',' in value:
         items = [_convert_value_type(item.strip()) for item in value.split(',')]

machineconfig/scripts/python/fire_jobs_route_helper.py

@@ -6,6 +6,52 @@ import tomllib
 from pathlib import Path
 from machineconfig.utils.accessories import randstr
 from machineconfig.utils.path_extended import PathExtended
+from machineconfig.utils.options import choose_from_options
+
+
+def choose_function_or_lines(choice_file: PathExtended, kwargs_dict: dict[str, object]) -> tuple[Optional[str], PathExtended, dict[str, object]]:
+    """
+    Choose a function to run from a Python file or lines from a shell script.
+    
+    Returns:
+        tuple: (choice_function, choice_file, kwargs_dict)
+        - choice_function: The selected function name or None
+        - choice_file: The file path (potentially modified for shell scripts)
+        - kwargs_dict: Updated kwargs dictionary with user-provided arguments
+    """
+    choice_function: Optional[str] = None
+    
+    if choice_file.suffix == ".py":
+        from machineconfig.scripts.python.helpers.helpers4 import parse_pyfile
+        options, func_args = parse_pyfile(file_path=str(choice_file))
+        choice_function_tmp = choose_from_options(msg="Choose a function to run", options=options, fzf=True, multi=False)
+        assert isinstance(choice_function_tmp, str), f"choice_function must be a string. Got {type(choice_function_tmp)}"
+        choice_index = options.index(choice_function_tmp)
+        choice_function = choice_function_tmp.split(" -- ")[0]
+        choice_function_args = func_args[choice_index]
+
+        if choice_function == "RUN AS MAIN":
+            choice_function = None
+        if len(choice_function_args) > 0 and len(kwargs_dict) == 0:
+            for item in choice_function_args:
+                kwargs_dict[item.name] = input(f"Please enter a value for argument `{item.name}` (type = {item.type}) (default = {item.default}) : ") or item.default
+    elif choice_file.suffix == ".sh":
+        options = []
+        for line in choice_file.read_text(encoding="utf-8").splitlines():
+            if line.startswith("#"):
+                continue
+            if line == "":
+                continue
+            if line.startswith("echo"):
+                continue
+            options.append(line)
+        chosen_lines = choose_from_options(msg="Choose a line to run", options=options, fzf=True, multi=True)
+        choice_file = PathExtended.tmpfile(suffix=".sh")
+        choice_file.parent.mkdir(parents=True, exist_ok=True)
+        choice_file.write_text("\n".join(chosen_lines), encoding="utf-8")
+        choice_function = None
+    
+    return choice_function, choice_file, kwargs_dict
 
 
 def get_command_streamlit(choice_file: Path, environment: str, repo_root: Optional[Path]) -> str:

machineconfig/scripts/python/helpers/repo_sync_helpers.py

@@ -1,11 +1,7 @@
 from machineconfig.utils.path_extended import PathExtended
-from machineconfig.utils.terminal import Response
 from machineconfig.scripts.python.get_zellij_cmd import get_zellij_cmd
-from machineconfig.utils.source_of_truth import CONFIG_PATH, DEFAULTS_PATH
-from machineconfig.utils.io import read_ini
 from machineconfig.utils.code import write_shell_script_to_file
 import platform
-import subprocess
 from rich.console import Console
 from rich.panel import Panel
 
@@ -60,42 +56,6 @@ def inspect_repos(repo_local_root: str, repo_remote_root: str):
         raise NotImplementedError(f"Platform {platform.system()} not implemented.")
 
 
-def fetch_dotfiles():
-    console.print(Panel("📁 Fetching Dotfiles", title="[bold blue]Dotfiles[/bold blue]", border_style="blue"))
-
-    cloud_resolved = read_ini(DEFAULTS_PATH)["general"]["rclone_config_name"]
-    console.print(Panel(f"⚠️  Using default cloud: `{cloud_resolved}` from {DEFAULTS_PATH}", width=150, border_style="yellow"))
-
-    dotfiles_local = PathExtended.home().joinpath("dotfiles")
-    CONFIG_PATH.joinpath("remote").mkdir(parents=True, exist_ok=True)
-    dotfiles_remote = PathExtended(CONFIG_PATH).joinpath("remote", dotfiles_local.rel2home())
-    remote_path = dotfiles_local.get_remote_path(rel2home=True, os_specific=False, root="myhome") + ".zip.enc"
-
-    console.print(Panel("📥 Downloading dotfiles from cloud...", width=150, border_style="blue"))
-
-    dotfiles_remote.from_cloud(remotepath=remote_path, cloud=cloud_resolved, unzip=True, decrypt=True, rel2home=True, os_specific=False, pwd=None)
-
-    console.print(Panel("🗑️  Removing old dotfiles and replacing with cloud version...", width=150, border_style="blue"))
-
-    dotfiles_local.delete(sure=True)
-    dotfiles_remote.move(folder=PathExtended.home())
-    script = f"""
-# rm -rf {dotfiles_local}
-# mv {dotfiles_remote} {dotfiles_local}
-"""
-    if platform.system() == "Linux":
-        script += """
-sudo chmod 600 $HOME/.ssh/*
-sudo chmod 700 $HOME/.ssh
-sudo chmod +x $HOME/dotfiles/scripts/linux -R
-"""
-    shell_path = write_shell_script_to_file(shell_script=script)
-    completed = subprocess.run(f". {shell_path}", capture_output=True, check=False, text=True, shell=True)
-    Response.from_completed_process(completed).capture().print()
-
-    console.print(Panel("✅ Dotfiles successfully fetched and installed", title="[bold green]Dotfiles[/bold green]", border_style="green"))
-
-
 def check_dotfiles_version_is_beyond(commit_dtm: str, update: bool) -> bool:
     dotfiles_path = str(PathExtended.home().joinpath("dotfiles"))
     from git import Repo

machineconfig/scripts/python/onetimeshare.py

@@ -6,7 +6,6 @@
 # # or use ots executable to do this job
 
 # import requests
-# import crocodile.file_management as fm
 # import base64
 # from typing import Optional
 

machineconfig/scripts/python/sessions.py

@@ -2,7 +2,7 @@
 from pathlib import Path
 from typing import Optional, Literal
 import typer
-
+from machineconfig.scripts.python.sessions_multiprocess import create_from_function
 
 def balance_load(layout_path: Path = typer.Argument(..., help="Path to the layout.json file"),
            max_thresh: int = typer.Option(..., help="Maximum tabs per layout"),
@@ -69,7 +69,7 @@ def find_layout_file(layout_path: str, ) -> Path:
     return choice_file
 
 
-def launch(ctx: typer.Context,
+def run(ctx: typer.Context,
            layout_path: Optional[str] = typer.Argument(None, help="Path to the layout.json file"),
         max_tabs: int = typer.Option(10, help="A Sanity checker that throws an error if any layout exceeds the maximum number of tabs to launch."),
         max_layouts: int = typer.Option(10, help="A Sanity checker that throws an error if the total number of layouts exceeds this number."),
@@ -133,14 +133,11 @@ def launch(ctx: typer.Context,
 
 
 def main_from_parser():
-    layouts_app = typer.Typer(help="Layouts management subcommands")
-    layouts_app.command("run")(launch)
-    layouts_app.command("balance-load")(balance_load)
-    import sys
-    if len(sys.argv) == 1:
-        layouts_app(["--help"])
-    else:
-        layouts_app()
+    layouts_app = typer.Typer(help="Layouts management subcommands", no_args_is_help=True)
+    layouts_app.command("create-from-function", no_args_is_help=True)(create_from_function)
+    layouts_app.command("run", no_args_is_help=True)(run)
+    layouts_app.command("balance-load", no_args_is_help=True)(balance_load)
+    layouts_app()
 
 
 if __name__ == "__main__":

machineconfig/scripts/python/sessions_multiprocess.py

@@ -0,0 +1,56 @@
+
+
+from typing import Optional
+from pathlib import Path
+import typer
+
+
+def create_from_function(
+        num_process: int = typer.Option(..., "--num-process", "-n", help="Number of parallel processes to run"),
+        path: str = typer.Option(".", "--path", "-p", help="Path to a Python or Shell script file or a directory containing such files"),
+        function: Optional[str] = typer.Option(None, "--function", "-f", help="Function to run from the Python file. If not provided, you will be prompted to choose."),
+):
+    from machineconfig.utils.ve import get_ve_activate_line, get_ve_path_and_ipython_profile
+    from machineconfig.utils.options import choose_from_options
+    from machineconfig.utils.path_helper import match_file_name, sanitize_path
+    from machineconfig.utils.path_extended import PathExtended
+    from machineconfig.utils.accessories import get_repo_root
+
+    path_obj = sanitize_path(path)
+    if not path_obj.exists():
+        suffixes = {".py"}
+        choice_file = match_file_name(sub_string=path, search_root=PathExtended.cwd(), suffixes=suffixes)
+    elif path_obj.is_dir():
+        from machineconfig.scripts.python.helpers.helpers4 import search_for_files_of_interest
+        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.")
+        choice_file = choose_from_options(multi=False, options=files, fzf=True, msg="Choose one option")
+        choice_file = PathExtended(choice_file)
+    else:
+        choice_file = path_obj
+
+
+    repo_root = get_repo_root(Path(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=ve_root_from_file or "$HOME/code/machineconfig/.venv")
+
+    # =========================  choosing function to run
+    if function is None or function.strip() == "":
+        from machineconfig.scripts.python.fire_jobs_route_helper import choose_function_or_lines
+        choice_function, choice_file, _kwargs_dict = choose_function_or_lines(choice_file, kwargs_dict={})
+    else:
+        choice_function = function
+
+    from machineconfig.cluster.sessions_managers.zellij_local import run_zellij_layout
+    from machineconfig.utils.schemas.layouts.layout_types import LayoutConfig
+    layout: LayoutConfig = {"layoutName": "fireNprocess", "layoutTabs": []}
+    for an_arg in range(num_process):
+        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={num_process}"})
+    print(layout)
+    run_zellij_layout(layout_config=layout)
+

machineconfig/setup_linux/repos.sh

@@ -1,34 +1,6 @@
 #!/usr/bin/bash
 
 
-echo """
-#=======================================================================
-🔄 REPOSITORIES SETUP | Cloning project codebases
-#=======================================================================
-"""
-
-echo """📥 Setting up repositories...
-   🐊 crocodile     - Main utility package
-   🔧 machineconfig - System configuration tools
-"""
-
-mkdir -p $HOME/code
-cd $HOME/code
-# Setup crocodile repository
-if [ -d "crocodile" ]; then
-    echo """🔄 crocodile directory exists, updating...
-    """
-    cd crocodile
-    git reset --hard
-    git pull
-    cd ..
-else
-    echo """⏳ Cloning crocodile repository...
-    """
-    git clone https://github.com/thisismygitrepo/crocodile.git --depth 4
-fi
-
-# Setup machineconfig repository
 cd $HOME/code
 if [ -d "machineconfig" ]; then
     echo """🔄 machineconfig directory exists, updating...
@@ -45,4 +17,4 @@ fi
 
 cd $HOME/code/machineconfig
 $HOME/.local/bin/uv sync --no-dev
-$HOME/.local/bin/uv cache clean
+# $HOME/.local/bin/uv cache clean

machineconfig/setup_windows/repos.ps1

@@ -9,18 +9,6 @@ if (-not (Get-Command git.exe -ErrorAction SilentlyContinue)) {
     $env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
 }
 
-# Setup crocodile repository
-if (Test-Path "crocodile") {
-    Write-Host "🔄 crocodile directory exists, updating..."
-    Set-Location crocodile
-    git reset --hard
-    git pull
-    Set-Location ..
-} else {
-    Write-Host "⏳ Cloning crocodile repository..."
-    git clone https://github.com/thisismygitrepo/crocodile.git --depth 4
-}
-
 # Setup machineconfig repository
 if (Test-Path "machineconfig") {
     Write-Host "🔄 machineconfig directory exists, updating..."

machineconfig/utils/files/read.py

@@ -12,12 +12,10 @@ class Read:
         suffix = Path(path).suffix[1:]
         if suffix == "": raise ValueError(f"File type could not be inferred from suffix. Suffix is empty. Path: {path}")
         if suffix in ("sqlite", "sqlite3", "db", "duckdb"):
-            # from crocodile.database import DBMS
-            # if suffix == "duckdb": pass
-            # res = DBMS.from_local_db(path=path)
-            # print(res.describe_db())
-            # return res
-            raise NotImplementedError("Reading database files is not implemented yet. Use `crocodile.database.DBMS` to connect to the database file.")
+            from machineconfig.utils.files.dbms import DBMS
+            res = DBMS.from_local_db(path=path)
+            print(res.describe_db())
+            return res
         try: return getattr(Read, suffix)(str(path), **kwargs)
         except AttributeError as err:
             if "type object 'Read' has no attribute" not in str(err): raise AttributeError(err) from err

machineconfig/utils/notifications.py

@@ -110,7 +110,7 @@ encryption = ssl
 
     def send_message(self, to: str, subject: str, body: str, txt_to_html: bool = True, attachments: Optional[list[Any]] = None):
         _ = attachments
-        body += "\n\nThis is an automated email sent via crocodile.comms script."
+        body += "\n\nThis is an automated email sent via machineconfig.comms script."
         # msg = message.EmailMessage()
         msg = MIMEMultipart("alternative")
         msg["subject"] = subject

machineconfig/utils/ssh.py

@@ -8,20 +8,9 @@ from machineconfig.utils.accessories import pprint
 # from machineconfig.utils.ve import get_ve_activate_line
 
 
-def get_header(wdir: OPLike, toolbox: bool):
-    if toolbox:
-        toobox_code = """
-try:
-from crocodile.toolbox import *
-except ImportError:
-print("Crocodile not found, skipping import.")
-pass
-"""
-    else:
-        toobox_code = "# No toolbox import."
+def get_header(wdir: OPLike):
     return f"""
 # >> Code prepended
-{toobox_code}
 {'''sys.path.insert(0, r'{wdir}') ''' if wdir is not None else "# No path insertion."}
 # >> End of header, start of script passed
 """
@@ -236,7 +225,7 @@ class SSH:  # inferior alternative: https://github.com/fabric/fabric
         assert '"' not in cmd, 'Avoid using `"` in your command. I dont know how to handle this when passing is as command to python in pwsh command.'
         if not return_obj:
             return self.run(
-                cmd=f"""uv run --no-dev --project $HOME/code/machineconfig -c "{get_header(wdir=None, toolbox=True)}{cmd}\n""" + '"',
+                cmd=f"""uv run --no-dev --project $HOME/code/machineconfig -c "{get_header(wdir=None)}{cmd}\n""" + '"',
                 desc=desc or f"run_py on {self.get_remote_repr()}",
                 verbose=verbose,
                 strict_err=strict_err,

{machineconfig-5.20.dist-info → machineconfig-5.22.dist-info}/METADATA

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