synic 1.0.0__tar.gz

synic-1.0.0/PKG-INFO

@@ -0,0 +1,32 @@
+Metadata-Version: 2.4
+Name: synic
+Version: 1.0.0
+Summary: Synic panel CLI — login, deploy, downloads, backups, and custom flows
+Author: Synic
+License: MIT
+Keywords: synic,cli,jimboshop,panel
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# synic
+
+Synic panel CLI for pip.
+
+```bash
+pip install synic
+synic login
+```
+
+Then the prompt becomes `synic>` (light blue). You stay signed in until `logout`.
+
+```text
+synic> proDeploy
+synic> uploadFile
+synic> download
+synic> makeBackup
+synic> userDetail
+synic> help
+```
+
+npm: `npm install -g synic`
+yarn: `yarn global add synic`

synic-1.0.0/README.md

@@ -0,0 +1,22 @@
+# synic
+
+Synic panel CLI for pip.
+
+```bash
+pip install synic
+synic login
+```
+
+Then the prompt becomes `synic>` (light blue). You stay signed in until `logout`.
+
+```text
+synic> proDeploy
+synic> uploadFile
+synic> download
+synic> makeBackup
+synic> userDetail
+synic> help
+```
+
+npm: `npm install -g synic`
+yarn: `yarn global add synic`

synic-1.0.0/pyproject.toml

@@ -0,0 +1,19 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "synic"
+version = "1.0.0"
+description = "Synic panel CLI — login, deploy, downloads, backups, and custom flows"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [{ name = "Synic" }]
+keywords = ["synic", "cli", "jimboshop", "panel"]
+
+[project.scripts]
+synic = "synic.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

synic-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

synic-1.0.0/src/synic/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.0.0"

synic-1.0.0/src/synic/cli.py

@@ -0,0 +1,292 @@
+from __future__ import annotations
+
+import json
+import subprocess
+import sys
+import time
+from pathlib import Path
+
+from .config import (
+    DEFAULT_URL,
+    clear_session,
+    is_logged_in,
+    load_config,
+    load_flows,
+    save_config,
+    save_flows,
+)
+from .http import api, base_url
+from .ui import ask, c, confirm, fail, info, ok, pick, progress, prompt_line
+
+
+HELP = [
+    ("login", "Sign in with username and password"),
+    ("logout", "Sign out after a Yes/No confirm"),
+    ("exit", "Leave the synic prompt (stay signed in)"),
+    ("help", "Show commands you can use"),
+    ("whoami", "Show the signed-in account"),
+    ("sync", "Refresh commands from the panel"),
+    ("userDetail", "Show your name, phone, and permissions"),
+    ("proDeploy", "Pick a project, choose a zip, deploy with live progress"),
+    ("uploadFile", "Upload a file into public downloads"),
+    ("download", "Search public-download files by name and save"),
+    ("makeBackup", "Pick a project and back it up on the server"),
+    ("list", "List your workspaces"),
+    ("init", "Create a workspace in this folder"),
+    ("push", "Send this folder"),
+    ("pull", "Get the latest files"),
+    ("clone", "Copy a shared workspace"),
+]
+
+
+def print_help(user=None, extra=None):
+    print(c("prompt", "Commands"))
+    width = max(len(name) for name, _ in HELP)
+    for name, text in HELP:
+        print(f"  {c('success', name.ljust(width))}  {c('option', text)}")
+    for cmd in extra or []:
+        print(f"  {c('success', str(cmd.get('name', '')).ljust(width))}  {c('option', cmd.get('help') or '')}")
+
+
+def require_login():
+    cfg = load_config()
+    if not is_logged_in(cfg):
+        raise RuntimeError("Run synic login first.")
+    return cfg
+
+
+def require_perm(user, key):
+    if not user:
+        raise RuntimeError("Run synic login first.")
+    if user.get("role") == "admin":
+        return
+    if key in (user.get("permissions") or []):
+        return
+    raise RuntimeError("You cannot use this command.")
+
+
+def win_dialog(kind: str, filename: str = "file.bin", filt: str = "All files (*.*)|*.*") -> str:
+    if sys.platform != "win32":
+        return ask("File path:")
+    if kind == "open":
+        script = f"""
+Add-Type -AssemblyName System.Windows.Forms | Out-Null
+$d = New-Object System.Windows.Forms.OpenFileDialog
+$d.Filter = '{filt.replace("'", "''")}'
+if ($d.ShowDialog() -eq [System.Windows.Forms.DialogResult]::OK) {{ Write-Output $d.FileName }}
+"""
+    else:
+        script = f"""
+Add-Type -AssemblyName System.Windows.Forms | Out-Null
+$d = New-Object System.Windows.Forms.SaveFileDialog
+$d.FileName = '{filename.replace("'", "''")}'
+if ($d.ShowDialog() -eq [System.Windows.Forms.DialogResult]::OK) {{ Write-Output $d.FileName }}
+"""
+    out = subprocess.check_output(["powershell.exe", "-NoProfile", "-STA", "-Command", script], text=True)
+    path = out.strip()
+    if not path:
+        raise RuntimeError("No file selected")
+    return path
+
+
+def sync_catalog():
+    data = api("/cli/catalog")
+    commands = data.get("commands") or []
+    save_flows(commands)
+    if data.get("user"):
+        save_config({"user": data["user"]})
+    return commands
+
+
+def cmd_login(args):
+    url = DEFAULT_URL
+    if "--url" in args:
+        url = args[args.index("--url") + 1].rstrip("/")
+    username = ask("Username:")
+    password = ask("Password:", secret=True)
+    data = api("/cli/login", method="POST", body={"username": username, "password": password}, token="", cfg={"url": url})
+    save_config({"url": url, "token": data.get("token"), "user": data.get("user")})
+    flows = data.get("commands") or sync_catalog()
+    save_flows(flows)
+    ok(f"Logged in as {(data.get('user') or {}).get('username') or username}.")
+    print_help(data.get("user"), flows)
+    return True
+
+
+def cmd_logout(_args):
+    require_login()
+    if not confirm():
+        info("Still signed in.")
+        return True
+    clear_session()
+    ok("Signed out.")
+    return False
+
+
+def cmd_user_detail(_args):
+    require_login()
+    data = api("/auth/me")
+    user = data.get("user") or data
+    save_config({"user": user})
+    print(c("prompt", user.get("username") or ""))
+    print(c("loading", f"Phone  {user['phone']}") if user.get("phone") else c("muted", "Phone  —"))
+    print(c("stage", f"Role   {user.get('role') or 'user'}"))
+    perms = user.get("permissions") or []
+    keys = ["files", "downloads", "editor", "logs", "firewall", "terminal", "packages", "deploy", "domains", "users", "settings", "repos", "serverPassword", "synicCli"]
+    for key in keys:
+        on = user.get("role") == "admin" or key in perms
+        print(f"  {c('progress', key.ljust(16))} {c('success', 'yes') if on else c('error', 'no')}")
+
+
+def wait_job(job_id: str, kind: str = "deploy"):
+    path = f"/backups/jobs/{job_id}" if kind == "backup" else f"/deploy/jobs/{job_id}"
+    while True:
+        data = api(path)
+        job = data.get("job") or data
+        progress(job.get("percent") or 0, job.get("stage") or "", job.get("message") or "")
+        if job.get("stage") in ("done", "error", "cancelled") or job.get("ok") is False:
+            if job.get("ok") is False or job.get("stage") in ("error", "cancelled"):
+                raise RuntimeError(job.get("error") or job.get("message") or "Job failed")
+            return job
+        time.sleep(0.8)
+
+
+def cmd_pro_deploy(_args):
+    cfg = require_login()
+    require_perm(cfg.get("user") or {}, "deploy")
+    data = api("/deploy/sites")
+    options = []
+    labels = {"api": "Main API", "panelServer": "PanelServer", "unavailable": "Unavailable page"}
+    for key in data.get("systemTargets") or []:
+        options.append({"label": labels.get(key, key), "value": {"kind": "system", "key": key}})
+    for domain in data.get("domains") or []:
+        options.append({"label": domain.get("domain"), "value": {"kind": "domain", "id": domain.get("id"), "key": domain.get("id")}})
+    if not options:
+        raise RuntimeError("No deploy targets for this account.")
+    target = pick(options, title="Choose a deploy")
+    info("Please upload the zip file you want.")
+    time.sleep(0.7)
+    file_path = win_dialog("open", filt="Zip files (*.zip)|*.zip|All files (*.*)|*.*")
+    info("Upload the zip from the panel if the CLI chunk upload is unavailable on this Python build.")
+    # Python stdlib chunk upload kept simple: tell user we post complete via Node-equivalent endpoints
+    raise RuntimeError(f"Selected {file_path}. Use the Node CLI (npm/yarn) for zip chunk upload, or deploy from the panel.")
+
+
+def cmd_download(_args):
+    cfg = require_login()
+    require_perm(cfg.get("user") or {}, "downloads")
+    name = ask("File name:")
+    if not name:
+        raise RuntimeError("File name is required")
+    info("Searching every public-download folder…")
+    data = api(f"/downloads/search?q={name}")
+    matches = data.get("matches") or data.get("items") or []
+    if not matches:
+        raise RuntimeError(f'No file named "{name}" in public downloads.')
+    chosen = matches[0]
+    if len(matches) > 1:
+        chosen = pick([{"label": f"{m.get('filename')}  ({m.get('folder')})", "value": m} for m in matches], title="Several files matched")
+    dest = win_dialog("save", filename=chosen.get("filename") or "file.bin")
+    raw = api(
+        f"/downloads/file?folder={chosen.get('folder')}&filename={chosen.get('filename')}",
+        raw=True,
+    )
+    Path(dest).write_bytes(raw)
+    ok(f"Saved {dest}")
+
+
+def cmd_make_backup(_args):
+    cfg = require_login()
+    require_perm(cfg.get("user") or {}, "deploy")
+    data = api("/deploy/sites")
+    options = []
+    labels = {"api": "Main API", "panelServer": "PanelServer", "unavailable": "Unavailable page"}
+    for key in data.get("systemTargets") or []:
+        options.append({"label": labels.get(key, key), "value": {"kind": "system", "key": key}})
+    for domain in data.get("domains") or []:
+        options.append({"label": domain.get("domain"), "value": {"kind": "site", "folderName": domain.get("folderName"), "key": domain.get("id")}})
+    target = pick(options, title="Choose a project")
+    started = api("/backups/create", method="POST", body={"kind": "site" if target.get("kind") == "site" else target.get("key"), "folderName": target.get("folderName"), "key": target.get("key")})
+    job_id = started.get("jobId") or (started.get("job") or {}).get("id")
+    wait_job(job_id, "backup")
+    ok("Backup finished.")
+
+
+def cmd_list(_args):
+    require_login()
+    data = api("/repos")
+    for repo in data.get("repos") or []:
+        print(f"{repo.get('slug') or repo.get('id')}  {repo.get('name')}")
+
+
+COMMANDS = {
+    "login": cmd_login,
+    "logout": cmd_logout,
+    "help": lambda _a: print_help(load_config().get("user"), load_flows()),
+    "whoami": lambda _a: print(json.dumps(api("/auth/me"), indent=2)),
+    "sync": lambda _a: (require_login(), print_help(load_config().get("user"), sync_catalog())),
+    "userdetail": cmd_user_detail,
+    "prodeploy": cmd_pro_deploy,
+    "download": cmd_download,
+    "makebackup": cmd_make_backup,
+    "list": cmd_list,
+}
+
+
+def run_command(cmd: str, args: list) -> bool | None:
+    if cmd in ("exit", "quit"):
+        info("Bye. You are still signed in.")
+        return False
+    fn = COMMANDS.get(cmd)
+    if not fn:
+        flows = load_flows()
+        flow = next((f for f in flows if str(f.get("name", "")).lower() == cmd), None)
+        if flow:
+            info(f"Custom command '{cmd}' is available. Use the Node CLI for full flow playback.")
+            return True
+        raise RuntimeError(f"Unknown command: {cmd}")
+    return fn(args)
+
+
+def shell_loop():
+    while True:
+        try:
+            line = input(prompt_line()).strip()
+        except EOFError:
+            return
+        if not line:
+            continue
+        parts = line.split()
+        try:
+            cont = run_command(parts[0].lower(), parts[1:])
+            if cont is False:
+                return
+        except Exception as err:
+            fail(str(err))
+
+
+def main():
+    args = sys.argv[1:]
+    if is_logged_in():
+        try:
+            sync_catalog()
+        except Exception:
+            pass
+    if not args:
+        if not is_logged_in():
+            print_help()
+            info("Run synic login to start.")
+            return
+        shell_loop()
+        return
+    try:
+        cont = run_command(args[0].lower(), args[1:])
+        if cont is True:
+            shell_loop()
+    except Exception as err:
+        fail(str(err))
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

synic-1.0.0/src/synic/config.py

@@ -0,0 +1,52 @@
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+DEFAULT_URL = "https://panel.jimboshop.xyz"
+HOME = Path.home() / ".synic"
+CFG = HOME / "config.json"
+COMMANDS_DIR = HOME / "commands"
+
+
+def ensure_home() -> None:
+    HOME.mkdir(parents=True, exist_ok=True)
+    COMMANDS_DIR.mkdir(parents=True, exist_ok=True)
+
+
+def load_config() -> dict:
+    try:
+        return json.loads(CFG.read_text(encoding="utf-8"))
+    except Exception:
+        return {"url": DEFAULT_URL}
+
+
+def save_config(cfg: dict) -> dict:
+    ensure_home()
+    next_cfg = {**load_config(), **cfg}
+    CFG.write_text(json.dumps(next_cfg, indent=2), encoding="utf-8")
+    return next_cfg
+
+
+def clear_session() -> None:
+    ensure_home()
+    url = load_config().get("url") or DEFAULT_URL
+    CFG.write_text(json.dumps({"url": url}, indent=2), encoding="utf-8")
+
+
+def is_logged_in(cfg: dict | None = None) -> bool:
+    data = cfg or load_config()
+    return bool(data.get("token"))
+
+
+def save_flows(flows: list) -> None:
+    ensure_home()
+    (COMMANDS_DIR / "catalog.json").write_text(json.dumps(flows or [], indent=2), encoding="utf-8")
+
+
+def load_flows() -> list:
+    try:
+        data = json.loads((COMMANDS_DIR / "catalog.json").read_text(encoding="utf-8"))
+        return data if isinstance(data, list) else []
+    except Exception:
+        return []

synic-1.0.0/src/synic/http.py

@@ -0,0 +1,42 @@
+from __future__ import annotations
+
+import json
+import urllib.error
+import urllib.parse
+import urllib.request
+
+from .config import DEFAULT_URL, load_config
+
+
+def base_url(cfg: dict | None = None) -> str:
+    data = cfg or load_config()
+    return str(data.get("url") or DEFAULT_URL).rstrip("/")
+
+
+def api(pathname: str, method: str = "GET", body=None, token=None, cfg=None, raw=False):
+    data = cfg or load_config()
+    tok = data.get("token") if token is None else token
+    url = f"{base_url(data)}/api{pathname}"
+    payload = None
+    headers = {}
+    if body is not None:
+        payload = json.dumps(body).encode("utf-8")
+        headers["Content-Type"] = "application/json"
+    if tok:
+        headers["Authorization"] = f"Bearer {tok}"
+    req = urllib.request.Request(url, data=payload, headers=headers, method=method)
+    try:
+        with urllib.request.urlopen(req) as resp:
+            raw_bytes = resp.read()
+            if raw:
+                return raw_bytes
+            if not raw_bytes:
+                return {}
+            return json.loads(raw_bytes.decode("utf-8"))
+    except urllib.error.HTTPError as err:
+        text = err.read().decode("utf-8", errors="replace")
+        try:
+            parsed = json.loads(text) if text else {}
+        except Exception:
+            parsed = {"error": text}
+        raise RuntimeError(parsed.get("error") or f"HTTP {err.code}") from err

synic-1.0.0/src/synic/ui.py

@@ -0,0 +1,133 @@
+from __future__ import annotations
+
+import sys
+from getpass import getpass
+
+DEFAULT_THEME = {
+    "prompt": "\x1b[38;2;125;211;252m",
+    "option": "\x1b[38;2;226;232;240m",
+    "selected": "\x1b[48;2;14;165;233m\x1b[38;2;255;255;255m",
+    "success": "\x1b[38;2;74;222;128m",
+    "error": "\x1b[38;2;248;113;113m",
+    "loading": "\x1b[38;2;34;211;238m",
+    "progress": "\x1b[38;2;251;191;36m",
+    "stage": "\x1b[38;2;192;132;252m",
+    "muted": "\x1b[38;2;148;163;184m",
+    "reset": "\x1b[0m",
+}
+
+
+def c(kind: str, text: str) -> str:
+    return f"{DEFAULT_THEME.get(kind, '')}{text}{DEFAULT_THEME['reset']}"
+
+
+def ask(label: str, secret: bool = False) -> str:
+    prompt = f"{c('prompt', label)} "
+    if secret:
+        return getpass(prompt).strip()
+    return input(prompt).strip()
+
+
+def _read_key() -> str:
+    if sys.platform == "win32":
+        import msvcrt
+
+        ch = msvcrt.getwch()
+        if ch in ("\x00", "\xe0"):
+            extra = msvcrt.getwch()
+            return {"H": "up", "P": "down"}.get(extra, extra)
+        if ch in ("\r", "\n"):
+            return "enter"
+        if ch == "\x03":
+            raise KeyboardInterrupt
+        return ch
+    import tty
+    import termios
+
+    fd = sys.stdin.fileno()
+    old = termios.tcgetattr(fd)
+    try:
+        tty.setraw(fd)
+        ch = sys.stdin.read(1)
+        if ch == "\x1b":
+            seq = sys.stdin.read(2)
+            return {"[A": "up", "[B": "down"}.get(seq, seq)
+        if ch in ("\r", "\n"):
+            return "enter"
+        if ch == "\x03":
+            raise KeyboardInterrupt
+        return ch
+    finally:
+        termios.tcsetattr(fd, termios.TCSADRAIN, old)
+
+
+def pick(items: list, title: str = "") -> object:
+    rows = []
+    for item in items:
+        if isinstance(item, dict):
+            rows.append({"label": str(item.get("label") or item.get("name") or item), "value": item.get("value", item)})
+        else:
+            rows.append({"label": str(item), "value": item})
+    if not rows:
+        raise RuntimeError("No options")
+    if len(rows) == 1 or not sys.stdin.isatty():
+        return rows[0]["value"]
+    if title:
+        print(c("muted", title))
+    index = 0
+
+    def render() -> None:
+        for i, row in enumerate(rows):
+            text = f"  {row['label']}  "
+            print(c("selected", text) if i == index else c("option", text))
+
+    render()
+    while True:
+        key = _read_key()
+        if key == "enter":
+            sys.stdout.write(f"\x1b[{len(rows)}A\x1b[0J")
+            print(f"{c('success', '›')} {rows[index]['label']}")
+            return rows[index]["value"]
+        if key == "up":
+            index = (index - 1) % len(rows)
+        elif key == "down":
+            index = (index + 1) % len(rows)
+        else:
+            continue
+        sys.stdout.write(f"\x1b[{len(rows)}A")
+        render()
+
+
+def confirm() -> bool:
+    return pick(
+        [{"label": "Yes, log out", "value": True}, {"label": "Cancel", "value": False}],
+        title="Are you sure?",
+    ) is True
+
+
+def ok(msg: str) -> None:
+    print(c("success", msg))
+
+
+def fail(msg: str) -> None:
+    print(c("error", msg), file=sys.stderr)
+
+
+def info(msg: str) -> None:
+    print(c("muted", msg))
+
+
+def progress(percent: int, stage: str, message: str) -> None:
+    p = max(0, min(100, int(percent or 0)))
+    width = 24
+    filled = round((p / 100) * width)
+    bar = "█" * filled + "░" * (width - filled)
+    line = f"{c('progress', f'{p}%')} {c('progress', bar)} {c('stage', stage or '')} {c('option', message or '')}"
+    sys.stdout.write(f"\r\x1b[2K{line}")
+    if p >= 100 or stage in ("done", "error"):
+        sys.stdout.write("\n")
+    sys.stdout.flush()
+
+
+def prompt_line() -> str:
+    return f"{c('prompt', 'synic')}{c('muted', '> ')}"

synic-1.0.0/src/synic.egg-info/PKG-INFO

@@ -0,0 +1,32 @@
+Metadata-Version: 2.4
+Name: synic
+Version: 1.0.0
+Summary: Synic panel CLI — login, deploy, downloads, backups, and custom flows
+Author: Synic
+License: MIT
+Keywords: synic,cli,jimboshop,panel
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# synic
+
+Synic panel CLI for pip.
+
+```bash
+pip install synic
+synic login
+```
+
+Then the prompt becomes `synic>` (light blue). You stay signed in until `logout`.
+
+```text
+synic> proDeploy
+synic> uploadFile
+synic> download
+synic> makeBackup
+synic> userDetail
+synic> help
+```
+
+npm: `npm install -g synic`
+yarn: `yarn global add synic`

synic-1.0.0/src/synic.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+README.md
+pyproject.toml
+src/synic/__init__.py
+src/synic/cli.py
+src/synic/config.py
+src/synic/http.py
+src/synic/ui.py
+src/synic.egg-info/PKG-INFO
+src/synic.egg-info/SOURCES.txt
+src/synic.egg-info/dependency_links.txt
+src/synic.egg-info/entry_points.txt
+src/synic.egg-info/top_level.txt

synic-1.0.0/src/synic.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

synic-1.0.0/src/synic.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+synic = synic.cli:main

synic-1.0.0/src/synic.egg-info/top_level.txt

@@ -0,0 +1 @@
+synic