jdeploy 0.1.0__py3-none-any.whl

jdeploy-0.1.0.dist-info/METADATA

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: jdeploy
+Version: 0.1.0
+Summary: 一键本地运行与远程部署工具 - 让Python项目部署更简单
+Author-email: bruce zhang <1195747247@qq.com>
+License: MIT
+Project-URL: Homepage, http://www.lingma.site/deploy/
+Project-URL: Repository, https://github.com/brucezhang/jdeploy
+Keywords: deploy,python,deployment,ssh,automation
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0.0
+Requires-Dist: cryptography>=3.3
+Requires-Dist: paramiko>=3.0.0
+Requires-Dist: requests>=2.25.0
+
+# JDeploy (简部署)
+
+一键本地运行与远程部署工具 - 让Python项目部署更简单
+
+## 功能特点
+
+- 🚀 **一键本地运行**：自动创建虚拟环境、安装依赖、启动项目
+- 🌐 **远程部署**：通过SSH自动部署到服务器
+- 🔧 **简单易用**：无需复杂的配置，开箱即用
+- 📦 **依赖管理**：智能检测并安装项目依赖
+
+## 安装
+
+```bash
+pip install jdeploy
+```
+
+## 使用方法
+
+### 激活产品
+
+```bash
+jdeploy activate <激活码>
+```
+
+### 查看激活状态
+
+```bash
+jdeploy status
+```
+
+### 演示模式（免费，无需激活）
+
+```bash
+jdeploy demo run
+```
+
+### 本地运行项目
+
+```bash
+jdeploy run .
+```
+
+### 远程部署
+
+```bash
+jdeploy deploy --host 服务器IP --user 用户名 [--password 密码]
+```
+
+## 要求
+
+- Python 3.8+
+- 服务器需支持SSH连接
+
+## 许可证
+
+MIT License
+
+## 作者
+
+bruce zhang (1195747247@qq.com)
+
+## 主页
+
+http://www.lingma.site/deploy/

jdeploy-0.1.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+pydeploy_cli/__init__.py,sha256=RfCZaTYnaZWMOB6zUEL1ObAv6oPfJhBLGZG-FMWmnVA,97
+pydeploy_cli/__main__.py,sha256=BcMl5HQA1PGwwN0oK9k2iKXCDVqcIDhbGo1FK7uZZbw,130
+pydeploy_cli/cli.py,sha256=UmBa0ZNYeN5y4USPrILsU60fJtYVnrEDGi7wXobfD1I,4033
+pydeploy_cli/demo.py,sha256=rK4_yBfMtrrQuYq4QSx6DuttCe9a9XZu1IaQWpYS8Ys,9675
+pydeploy_cli/license.py,sha256=RzvjjCX5GQI-V3MQdlXGiKIuZS_dWoOiK1x-6Pelcao,4183
+pydeploy_cli/local.py,sha256=BYuMNsprqJpXFl7YVL5w73LTiDDZRQ2_3LfrzcqsvSc,6876
+pydeploy_cli/remote.py,sha256=AT8iUctpSFXlBq1TSrj_YVO5cY-6ZxvjNIPOT71t92Y,7381
+pydeploy_cli/utils.py,sha256=pc2gXoR9jnvCpysYQDXiUxv-fbvzO1MF0ijh5Gqaf3k,14114
+pydeploy_cli/templates/start.sh,sha256=Bq1lxprRuDHVkAAooIBxVTjEiMzcP9xYeytn7zcyplY,460
+jdeploy-0.1.0.dist-info/METADATA,sha256=e0v3v3K4AZO0oRdz8lNG6OAn414PzlBEWAS109WSNEE,2031
+jdeploy-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+jdeploy-0.1.0.dist-info/entry_points.txt,sha256=yk2UOvl76Xf2K93AikDxBbGWdVopQPfRZJq4XzsFCJI,50
+jdeploy-0.1.0.dist-info/top_level.txt,sha256=aqweg8vUhsDv0NlVPIxWufuqWgIUFNxTDY3IrqWkcco,13
+jdeploy-0.1.0.dist-info/RECORD,,

jdeploy-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

jdeploy-0.1.0.dist-info/entry_points.txt

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

jdeploy-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+pydeploy_cli

pydeploy_cli/__init__.py

@@ -0,0 +1,3 @@
+"""JDeploy (简部署)：一键本地运行与远程部署工具。"""
+
+__version__ = "0.1.0"

pydeploy_cli/__main__.py

@@ -0,0 +1,6 @@
+"""支持 ``python -m pydeploy_cli`` 调用。"""
+
+from pydeploy_cli.cli import main
+
+if __name__ == "__main__":
+    main()

pydeploy_cli/cli.py

@@ -0,0 +1,149 @@
+"""JDeploy (简部署) 命令行入口。"""
+
+from __future__ import annotations
+
+import sys
+from typing import Optional
+
+import click
+
+from pydeploy_cli import __version__
+from pydeploy_cli import license as license_mod
+
+
+def _ensure_utf8_stdio() -> None:
+    """
+    在 Windows 等环境下尽量使用 UTF-8 标准输出，减少中文乱码。
+    """
+    if sys.platform != "win32":
+        return
+    for stream in (sys.stdout, sys.stderr):
+        try:
+            stream.reconfigure(encoding="utf-8")  # type: ignore[attr-defined]
+        except (AttributeError, OSError, ValueError):
+            pass
+
+
+@click.group()
+@click.version_option(version=__version__, prog_name="jdeploy")
+def cli() -> None:
+    """
+    简部署 - 一键本地运行与远程部署工具。
+    """
+    _ensure_utf8_stdio()
+
+
+@cli.command("activate")
+@click.argument("code", type=str)
+@click.option("--email", default=None, help="可选邮箱")
+def activate_cmd(code: str, email: Optional[str]) -> None:
+    """
+    使用激活码在本机激活（绑定设备标识）。
+    """
+    from pydeploy_cli import utils
+
+    try:
+        machine_id = utils.get_machine_id()
+        result = license_mod.activate_license(code.strip(), machine_id, email=email)
+    except OSError as exc:
+        click.echo(f"错误：激活过程出错: {exc}")
+        raise SystemExit(1) from exc
+
+    if not result.get("success"):
+        msg = result.get("message", "激活失败")
+        click.echo(f"错误：{msg}")
+        raise SystemExit(1)
+
+    perm = result.get("type", "unknown")
+    try:
+        license_mod.save_license(code.strip(), str(perm))
+    except OSError as exc:
+        click.echo(f"错误：保存许可证失败: {exc}")
+        raise SystemExit(1) from exc
+
+    click.echo(f"激活成功。权限类型: {perm}")
+
+
+@cli.command("status")
+def status_cmd() -> None:
+    """
+    查看当前激活状态与权限类型。
+    """
+    data = license_mod.load_license()
+    if not data or not data.get("code"):
+        click.echo("未激活")
+        return
+
+    suffix = license_mod.get_license_code_suffix(data)
+    perm = data.get("type", "unknown")
+    click.echo(f"已激活，权限类型：{perm}，激活码后四位：{suffix}")
+
+
+@cli.group()
+def demo() -> None:
+    """示例程序（免费，无需激活）。"""
+    pass
+
+
+@demo.command("run")
+def demo_run_cmd() -> None:
+    """创建示例项目并走完整流程：venv、pip（轻量 bottle）、启动服务。"""
+    from pydeploy_cli.demo import run_demo
+
+    run_demo()
+
+
+cli.add_command(demo)
+
+
+@cli.command("run")
+@click.argument(
+    "project_dir",
+    default=".",
+    type=click.Path(exists=True, file_okay=False, dir_okay=True),
+)
+def run_cmd(project_dir: str) -> None:
+    """
+    在虚拟环境中运行自己的项目（需要激活码）。
+    """
+    from pydeploy_cli.local import run_user_project
+
+    run_user_project(project_dir)
+
+
+@cli.command("deploy")
+@click.option("--host", required=True, help="服务器 IP 或域名")
+@click.option("--user", required=True, help="SSH 用户名")
+@click.option("--port", default=22, show_default=True, type=int, help="SSH 端口")
+@click.option("--key", "key_path", default=None, type=click.Path(exists=True), help="私钥路径")
+@click.option("--password", default=None, help="SSH 密码")
+def deploy_cmd(
+    host: str,
+    user: str,
+    port: int,
+    key_path: Optional[str],
+    password: Optional[str],
+) -> None:
+    """
+    将当前目录上传到服务器 /opt/<项目名>（需要 full 激活码）。
+    """
+    from pydeploy_cli.remote import deploy_to_server
+
+    deploy_to_server(
+        host=host,
+        user=user,
+        port=port,
+        key_path=key_path,
+        password=password,
+    )
+
+
+def main() -> None:
+    """
+    setuptools 控制台脚本 ``jdeploy`` 的入口函数。
+    """
+    cli()
+
+
+if __name__ == "__main__":
+    main()

pydeploy_cli/demo.py

@@ -0,0 +1,246 @@
+"""示例程序：流程与 ``jdeploy run`` 一致（venv + pip + 启动），依赖使用轻量 Bottle。"""
+
+from __future__ import annotations
+
+import os
+import re
+import shutil
+import subprocess
+import sys
+import webbrowser
+from datetime import datetime
+
+import click
+
+from pydeploy_cli import license as license_mod
+from pydeploy_cli import utils
+
+DEMO_DIR = ".jdeploy_demo"
+
+# 端口冲突检测正则（Windows）
+_PORT_CONFLICT_PATTERN = re.compile(
+    r"(?:(?:Errno\s*10048)|(?:WinError\s*10048)).*?\(\s*'0\.0\.0\.0'\s*,\s*(\d+)\s*\)",
+    re.IGNORECASE,
+)
+DEMO_URL = "http://127.0.0.1:5000/"
+
+# Bottle 体积小、wheel 安装快，适合演示「真实跑项目」流程而不拉 Flask 全家桶
+REQUIREMENTS = "bottle>=0.12.0\n"
+
+# 使用 wsgiref 托管 Bottle，绑定端口后再打印 READY，便于父进程判断可访问
+# 写入文件时将 {{OFFICIAL_SITE}} 替换为与工具一致的官网地址
+DEMO_APP = '''"""JDeploy 演示应用（Bottle，轻量依赖）。"""
+from bottle import Bottle, response
+from wsgiref.simple_server import WSGIRequestHandler, make_server
+
+app = Bottle()
+
+_HTML = """<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>JDeploy 演示</title>
+<style>
+body{font-family:Segoe UI,Microsoft YaHei,sans-serif;max-width:640px;margin:48px auto;padding:0 20px;line-height:1.6;color:#222;}
+h1{font-size:1.5rem;margin-bottom:0.5rem;color:#0d47a1;}
+.lead{color:#444;margin-bottom:1.25rem;}
+ul{padding-left:1.2rem;}
+li{margin:0.35rem 0;}
+.cta{margin-top:1.5rem;padding:1rem;background:#e3f2fd;border-radius:8px;}
+a{color:#1565c0;}
+.footer{margin-top:2rem;font-size:0.9rem;color:#666;}
+</style>
+</head>
+<body>
+<h1>您正在使用 JDeploy (简部署) 自动生成的演示应用</h1>
+<p class="lead">当前页面由 <strong>jdeploy demo run</strong> 一键创建并启动。
+它与正式运行您自己项目时的流程一致：检测 Python、创建虚拟环境、按 requirements.txt 安装依赖、再启动服务。</p>
+<p>这说明 JDeploy 在本地开发场景下<strong>可靠、可复现</strong>，适合希望少踩环境坑、快速验证效果的团队与个人。</p>
+<ul>
+<li><strong>本地运行</strong>：激活后可对任意项目目录执行相同流程，专注写代码而不是配环境。</li>
+<li><strong>远程部署</strong>：专业版支持将当前项目上传至服务器并生成启动脚本，部署路径清晰、可运维。</li>
+<li><strong>持续使用</strong>：从演示到真实项目，同一套命令习惯，降低从「能跑」到「能上线」的心智成本。</li>
+</ul>
+<div class="cta">
+<strong>下一步建议</strong>：若体验符合预期，可前往官网了解激活与版本权益，把 JDeploy 用进日常开发与发布流程。
+<p style="margin:0.75rem 0 0 0;"><a href="{{OFFICIAL_SITE}}">访问 JDeploy 官网</a></p>
+</div>
+<p class="footer">感谢试用。关闭本页后，在运行 demo 的命令行窗口按 Ctrl+C 即可停止服务。</p>
+</body>
+</html>"""
+
+
+@app.route("/")
+def hello():
+    response.content_type = "text/html; charset=utf-8"
+    return _HTML
+
+
+class _QuietHandler(WSGIRequestHandler):
+    """关闭访问日志，避免终端刷屏。"""
+
+    def log_message(self, format, *args):
+        return
+
+
+if __name__ == "__main__":
+    httpd = make_server("0.0.0.0", 5000, app, handler_class=_QuietHandler)
+    print("JDEPLOY_DEMO_READY http://127.0.0.1:5000/", flush=True)
+    httpd.serve_forever()
+'''
+
+
+def run_demo() -> None:
+    """
+    在当前目录下创建 ``.jdeploy_demo``，按与 ``run_user_project`` 相同顺序执行：
+
+    检测 Python、创建虚拟环境、存在 ``requirements.txt`` 则 ``pip install``、
+    启动固定入口 ``demo_app.py``；就绪后展示地址并尝试打开浏览器。
+    """
+    cwd = os.getcwd()
+    demo_path = os.path.join(cwd, DEMO_DIR)
+    cleanup_done = False
+
+    def do_cleanup() -> None:
+        nonlocal cleanup_done
+        if cleanup_done:
+            return
+        cleanup_done = True
+        click.echo("\n正在清理临时目录...")
+        utils.safe_rmtree(demo_path)
+        click.echo("已清理 .jdeploy_demo")
+
+    # 如果目录已存在，直接删除重建（参考桌面版实现）
+    if os.path.exists(demo_path):
+        click.echo("检测到 Demo 目录残留，正在清理...")
+        try:
+            shutil.rmtree(demo_path)
+        except OSError:
+            # 清理失败（通常是被占用）则换一个目录名
+            suffix = datetime.now().strftime("%Y%m%d_%H%M%S")
+            demo_path = os.path.join(cwd, f"{DEMO_DIR}_{suffix}")
+            click.echo(f"提示：目录被占用（可能有进程在运行），将使用新目录: {os.path.basename(demo_path)}")
+
+    try:
+        os.makedirs(demo_path, exist_ok=True)
+        app_path = os.path.join(demo_path, "demo_app.py")
+        req_path = os.path.join(demo_path, "requirements.txt")
+        with open(app_path, "w", encoding="utf-8") as f:
+            f.write(DEMO_APP.replace("{{OFFICIAL_SITE}}", license_mod.OFFICIAL_SITE))
+        with open(req_path, "w", encoding="utf-8") as f:
+            f.write(REQUIREMENTS)
+
+        click.echo("正在检测 Python...", nl=False)
+        ok, msg = utils.check_python_installed()
+        if not ok:
+            click.echo(" 失败")
+            click.echo(msg)
+            click.echo("请前往 https://www.python.org 下载并安装 Python。")
+            raise SystemExit(1)
+        click.echo(f" 完成 ({msg})")
+
+        py_cmd = utils.get_python_executable_for_venv()
+        click.echo("正在创建虚拟环境...", nl=False)
+        try:
+            subprocess.run(
+                [py_cmd, "-m", "venv", "venv"],
+                cwd=demo_path,
+                check=True,
+                timeout=120,
+            )
+        except (subprocess.CalledProcessError, subprocess.TimeoutExpired, FileNotFoundError) as exc:
+            click.echo(" 失败")
+            click.echo(f"创建虚拟环境失败: {exc}")
+            raise SystemExit(1) from exc
+        click.echo(" 完成")
+
+        venv_python = utils.get_venv_python(demo_path)
+        click.echo("正在安装依赖...")
+        try:
+            # 显示包名，省略下载详情
+            def _pip_line(s: str) -> None:
+                if s.startswith("Collecting ") or s.startswith("Installing") or s.startswith("Successfully installed"):
+                    click.echo(s)
+                elif "error" in s.lower() or "failed" in s.lower():
+                    click.echo(s)
+
+            utils.pip_install_with_mirror_first(
+                venv_python=venv_python,
+                work_dir=demo_path,
+                requirements_file="requirements.txt",
+                handle_line=_pip_line,
+                stall_seconds=10.0,
+                timeout_seconds=600.0,
+            )
+        except SystemExit:
+            raise
+        click.echo("安装依赖: 完成")
+
+        venv_python = utils.get_venv_python(demo_path)
+        click.echo("正在启动服务（本窗口 Ctrl+C 停止）...")
+
+        proc = subprocess.Popen(
+            [venv_python, "demo_app.py"],
+            cwd=demo_path,
+            stdin=subprocess.DEVNULL,
+            stdout=subprocess.PIPE,
+            stderr=subprocess.STDOUT,
+            text=True,
+            bufsize=1,
+        )
+
+        assert proc.stdout is not None
+        try:
+            first_line = proc.stdout.readline()
+            if not first_line.strip() and proc.poll() is not None:
+                click.echo("错误：服务未能启动（子进程已退出）。请检查 5000 端口是否被占用。")
+                raise SystemExit(1)
+
+            click.echo(f"访问: {DEMO_URL}")
+
+            opened = False
+            try:
+                opened = bool(webbrowser.open(DEMO_URL))
+            except OSError:
+                opened = False
+            if opened:
+                click.echo(
+                    "已尝试自动打开浏览器。若未弹出窗口，请手动复制上面地址到浏览器打开。"
+                )
+            else:
+                click.echo(
+                    "未能自动打开浏览器，请手动复制上面地址到浏览器地址栏访问。"
+                )
+
+            # 后台读管道 + 主线程短超时等待，避免 Windows 上阻塞读导致 Ctrl+C 无效
+            def handle_demo_line(s: str) -> None:
+                click.echo(s)
+                # 检测端口冲突
+                m = _PORT_CONFLICT_PATTERN.search(s)
+                if m:
+                    port = int(m.group(1))
+                    click.echo(f"错误：端口 {port} 已被占用，请关闭占用该端口的程序后重试。")
+
+            utils.pump_subprocess_stdout(proc, handle_demo_line)
+        except KeyboardInterrupt:
+            click.echo("\n收到中断信号，正在停止...")
+            proc.terminate()
+            try:
+                proc.wait(timeout=10)
+            except subprocess.TimeoutExpired:
+                proc.kill()
+            do_cleanup()
+            sys.exit(0)
+
+        proc.wait()
+    except KeyboardInterrupt:
+        do_cleanup()
+        sys.exit(0)
+    except SystemExit:
+        utils.safe_rmtree(demo_path)
+        raise
+    except Exception as exc:
+        click.echo(f"错误：运行异常: {exc}")
+        utils.safe_rmtree(demo_path)
+        raise SystemExit(1) from exc

pydeploy_cli/license.py

@@ -0,0 +1,131 @@
+"""激活码管理：本地配置读写与验证。"""
+
+from __future__ import annotations
+
+import json
+import os
+from datetime import datetime
+from typing import Any, Dict, Optional
+
+import requests
+
+# 后端API地址
+API_BASE_URL = "https://api.lingma.site/jiandeploy"
+VERIFY_URL = f"{API_BASE_URL}/api/verifyLicense"
+ACTIVATE_URL = f"{API_BASE_URL}/api/activateLicense"
+OFFICIAL_SITE = "http://www.lingma.site/deploy/"
+
+
+def get_license_config_path() -> str:
+    """
+    返回本机激活配置文件路径 ``~/.jdeploy/license.json``。
+    """
+    home = os.path.expanduser("~")
+    return os.path.join(home, ".jdeploy", "license.json")
+
+
+def ensure_config_dir() -> str:
+    """
+    确保 ``~/.jdeploy`` 目录存在，并返回该目录路径。
+    """
+    d = os.path.join(os.path.expanduser("~"), ".jdeploy")
+    os.makedirs(d, exist_ok=True)
+    return d
+
+
+def load_license() -> Optional[Dict[str, Any]]:
+    """
+    读取本地 ``license.json``；文件不存在或解析失败时返回 None。
+    """
+    path = get_license_config_path()
+    if not os.path.isfile(path):
+        return None
+    try:
+        with open(path, "r", encoding="utf-8") as f:
+            data = json.load(f)
+        if isinstance(data, dict) and data.get("code"):
+            return data
+    except (OSError, json.JSONDecodeError):
+        return None
+    return None
+
+
+def save_license(code: str, perm_type: str) -> None:
+    """
+    将激活码与权限类型写入 ``license.json``。
+    """
+    ensure_config_dir()
+    path = get_license_config_path()
+    payload = {
+        "code": code,
+        "type": perm_type,
+        "activated_at": datetime.now().strftime("%Y-%m-%d %H:%M:%S"),
+    }
+    with open(path, "w", encoding="utf-8") as f:
+        json.dump(payload, f, ensure_ascii=False, indent=4)
+
+
+def verify_license(code: str, machine_id: str) -> Dict[str, Any]:
+    """
+    向服务端校验激活码是否有效。
+
+    Args:
+        code: 激活码字符串
+        machine_id: 设备唯一标识
+
+    Returns:
+        形如 ``{"valid": bool, "type": "local"|"full", "message": "..."}`` 的字典
+    """
+    try:
+        resp = requests.post(
+            VERIFY_URL,
+            json={"code": code, "machine_id": machine_id},
+            timeout=30,
+        )
+        data = resp.json()
+        if data.get("code") == 0 and data.get("data", {}).get("valid"):
+            return {"valid": True, "type": data["data"].get("type", "local")}
+        return {"valid": False, "message": data.get("message", "验证失败")}
+    except requests.RequestException as exc:
+        return {"valid": False, "message": f"网络错误: {exc}"}
+    except (KeyError, ValueError) as exc:
+        return {"valid": False, "message": f"响应解析错误: {exc}"}
+
+
+def activate_license(
+    code: str, machine_id: str, email: Optional[str] = None
+) -> Dict[str, Any]:
+    """
+    激活设备。
+
+    Args:
+        code: 激活码
+        machine_id: 设备标识
+        email: 可选邮箱
+
+    Returns:
+        形如 ``{"success": bool, "type": "local"|"full", "message": "..."}``
+    """
+    payload = {"code": code, "machine_id": machine_id}
+    if email:
+        payload["email"] = email
+    try:
+        resp = requests.post(ACTIVATE_URL, json=payload, timeout=30)
+        data = resp.json()
+        if data.get("code") == 0:
+            return {"success": True, "type": data.get("data", {}).get("type", "local")}
+        return {"success": False, "message": data.get("message", "激活失败")}
+    except requests.RequestException as exc:
+        return {"success": False, "message": f"网络错误: {exc}"}
+    except (KeyError, ValueError) as exc:
+        return {"success": False, "message": f"响应解析错误: {exc}"}
+
+
+def get_license_code_suffix(data: Optional[Dict[str, Any]], n: int = 4) -> str:
+    """
+    返回激活码后 n 位，用于状态展示；无激活码时返回空字符串。
+    """
+    if not data or not data.get("code"):
+        return ""
+    code = str(data["code"])
+    return code[-n:] if len(code) >= n else code