decpython 0.1.0__tar.gz

decpython-0.1.0/PKG-INFO

@@ -0,0 +1,55 @@
+Metadata-Version: 2.2
+Name: decpython
+Version: 0.1.0
+Summary: 跨平台、支持 Web 通信的 Python 终端工具
+Home-page: https://github.com/your-username/decpython_maskter
+Author: decpython
+Author-email: decrule@outlook.com
+License: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+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.9.0
+Description-Content-Type: text/markdown
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: ruff>=0.1; extra == "dev"
+Dynamic: author-email
+Dynamic: home-page
+Dynamic: requires-python
+
+# DecPython
+
+Run Python in a subprocess from your code and get string results, or open a Jupyter-style web terminal. Cross-platform, stdlib only.
+
+## Install
+
+```bash
+pip install -e .
+```
+
+## Quick start
+
+```python
+from decpython import DecPython
+
+dp = DecPython(gui=False, python='python')
+result = dp.send('a = 1\nb = 2\na + b')   # -> '3'
+dp.close()
+```
+
+With a web UI: use `gui=True` and optionally `python='python3.12'`. Code and results from `send()` appear in the browser. Press Shift+Enter or click Run in the page.
+
+## API
+
+- **`send(code)`** — Run code; returns the last expression as a string (or the error message).
+- **`close()`** — Stop the subprocess and, if used, the web server.
+
+## License
+
+MIT

decpython-0.1.0/README.md

@@ -0,0 +1,30 @@
+# DecPython
+
+Run Python in a subprocess from your code and get string results, or open a Jupyter-style web terminal. Cross-platform, stdlib only.
+
+## Install
+
+```bash
+pip install -e .
+```
+
+## Quick start
+
+```python
+from decpython import DecPython
+
+dp = DecPython(gui=False, python='python')
+result = dp.send('a = 1\nb = 2\na + b')   # -> '3'
+dp.close()
+```
+
+With a web UI: use `gui=True` and optionally `python='python3.12'`. Code and results from `send()` appear in the browser. Press Shift+Enter or click Run in the page.
+
+## API
+
+- **`send(code)`** — Run code; returns the last expression as a string (or the error message).
+- **`close()`** — Stop the subprocess and, if used, the web server.
+
+## License
+
+MIT

decpython-0.1.0/decpython/__init__.py

@@ -0,0 +1,8 @@
+"""
+decpython - 跨平台、支持 Web 通信的 Python 终端工具
+"""
+
+from decpython.core import DecPython
+
+__version__ = '1.0.0'
+__all__ = ["DecPython"]

decpython-0.1.0/decpython/core.py

@@ -0,0 +1,250 @@
+"""
+核心执行器与 DecPython 终端类。
+"""
+
+import ast
+import os
+import sys
+import tempfile
+import threading
+import traceback
+import webbrowser
+from io import StringIO
+from subprocess import PIPE, Popen
+from typing import Optional
+
+# 子进程运行器：从 stdin 读代码（直到 __DECPYTHON_END_INPUT__），执行后向 stdout 写 __DECPYTHON_RESULT__<json>__DECPYTHON_END_RESULT__
+_RUNNER_SOURCE = r'''
+import ast
+import json
+import sys
+import traceback
+
+namespace = {"__name__": "__decpython__", "__builtins__": __import__("builtins").__dict__}
+DELIM = "__DECPYTHON_END_INPUT__"
+OUT_PREFIX = "__DECPYTHON_RESULT__"
+OUT_SUFFIX = "__DECPYTHON_END_RESULT__"
+
+def run(code):
+    code = code.strip()
+    if not code:
+        return "", ""
+    try:
+        tree = ast.parse(code)
+    except SyntaxError as e:
+        return "", "".join(traceback.format_exception_only(type(e), e))
+    if not tree.body:
+        return "", ""
+    try:
+        last = tree.body[-1]
+        if isinstance(last, ast.Expr):
+            if len(tree.body) == 1:
+                result = eval(compile(ast.Expression(body=last.value), "<decpython>", "eval"), namespace)
+            else:
+                exec(compile(ast.Module(body=tree.body[:-1], type_ignores=[]), "<decpython>", "exec"), namespace)
+                result = eval(compile(ast.Expression(body=last.value), "<decpython>", "eval"), namespace)
+            return (str(result) if result is not None else ""), ""
+        else:
+            exec(compile(tree, "<decpython>", "exec"), namespace)
+            return "", ""
+    except Exception as e:
+        return "", "".join(traceback.format_exception(type(e), e, e.__traceback__))
+
+while True:
+    lines = []
+    while True:
+        line = sys.stdin.readline()
+        if not line:
+            sys.exit(0)
+        if line.rstrip() == DELIM:
+            break
+        lines.append(line)
+    code = "".join(lines)
+    result, err = run(code)
+    out = OUT_PREFIX + json.dumps({"result": result, "error": err}, ensure_ascii=False) + OUT_SUFFIX + "\n"
+    sys.stdout.write(out)
+    sys.stdout.flush()
+'''
+
+
+class Executor:
+    """在独立命名空间中执行代码，支持多行与最后表达式求值。"""
+
+    def __init__(self) -> None:
+        self._namespace: dict = {}
+        self._init_builtins()
+
+    def _init_builtins(self) -> None:
+        import builtins
+        self._namespace = {
+            "__name__": "__decpython__",
+            "__builtins__": builtins.__dict__,
+        }
+
+    def run(self, code: str) -> tuple[str, str]:
+        """
+        执行代码，返回 (result, error)。
+        result 为最后一次表达式结果的 str，无表达式或仅为语句时为空字符串；
+        error 为执行出错时的错误信息，否则为空字符串。
+        """
+        code = code.strip()
+        if not code:
+            return "", ""
+
+        try:
+            tree = ast.parse(code)
+        except SyntaxError as e:
+            return "", "".join(traceback.format_exception_only(type(e), e))
+
+        if not tree.body:
+            return "", ""
+
+        try:
+            last = tree.body[-1]
+            if isinstance(last, ast.Expr):
+                if len(tree.body) == 1:
+                    result = self._eval_expr(last.value)
+                else:
+                    block = ast.Module(body=tree.body[:-1], type_ignores=[])
+                    exec(compile(block, "<decpython>", "exec"), self._namespace)
+                    result = self._eval_expr(last.value)
+                return self._repr_result(result), ""
+            else:
+                exec(compile(tree, "<decpython>", "exec"), self._namespace)
+                return "", ""
+        except Exception as e:
+            return "", "".join(traceback.format_exception(type(e), e, e.__traceback__))
+
+    def _eval_expr(self, node: ast.expr):  # noqa: ANN001
+        """在命名空间中求值单个表达式节点。"""
+        expr_ast = ast.Expression(body=node)
+        return eval(compile(expr_ast, "<decpython>", "eval"), self._namespace)
+
+    @staticmethod
+    def _repr_result(value) -> str:  # noqa: ANN001
+        """将执行结果转为字符串返回。"""
+        if value is None:
+            return ""
+        return str(value)
+
+    def reset(self) -> None:
+        """清空命名空间（保留 builtins）。"""
+        self._init_builtins()
+
+
+class SubprocessExecutor:
+    """使用指定终端命令（如 python / python3.12）在子进程中执行代码，保持独立命名空间。"""
+
+    _DELIM = "__DECPYTHON_END_INPUT__"
+    _OUT_PREFIX = "__DECPYTHON_RESULT__"
+    _OUT_SUFFIX = "__DECPYTHON_END_RESULT__"
+
+    def __init__(self, python_cmd: str) -> None:
+        self._python_cmd = python_cmd
+        self._process: Optional[Popen] = None
+        self._runner_path: Optional[str] = None
+        self._start()
+
+    def _start(self) -> None:
+        fd, self._runner_path = tempfile.mkstemp(suffix=".py", prefix="decpython_runner_")
+        try:
+            os.write(fd, _RUNNER_SOURCE.encode("utf-8"))
+        finally:
+            os.close(fd)
+        self._process = Popen(
+            [self._python_cmd, self._runner_path],
+            stdin=PIPE,
+            stdout=PIPE,
+            stderr=PIPE,
+            text=True,
+            bufsize=1,
+        )
+
+    def run(self, code: str) -> tuple[str, str]:
+        if self._process is None or self._process.poll() is not None:
+            return "", "子进程已退出"
+        try:
+            self._process.stdin.write(code)
+            self._process.stdin.write("\n" + self._DELIM + "\n")
+            self._process.stdin.flush()
+        except Exception as e:
+            return "", str(e)
+        while True:
+            line = self._process.stdout.readline()
+            if not line:
+                return "", "子进程意外结束"
+            if self._OUT_SUFFIX in line:
+                idx = line.find(self._OUT_PREFIX)
+                end = line.find(self._OUT_SUFFIX)
+                if idx != -1 and end != -1:
+                    import json
+                    raw = line[idx + len(self._OUT_PREFIX) : end]
+                    try:
+                        data = json.loads(raw)
+                        return data.get("result", ""), data.get("error", "")
+                    except Exception:
+                        return raw, ""
+                break
+        return "", ""
+
+    def close(self) -> None:
+        if self._process and self._process.poll() is None:
+            self._process.terminate()
+            self._process.wait()
+        self._process = None
+        if self._runner_path and os.path.exists(self._runner_path):
+            try:
+                os.unlink(self._runner_path)
+            except OSError:
+                pass
+        self._runner_path = None
+
+
+class DecPython:
+    """
+    跨平台、支持 Web 通信的 Python 终端。
+    - python: 终端中用于执行 Python 的命令，如 'python' 或 'python3.12'。
+    - gui=False：仅程序化调用 send(code) 获取 str 结果。
+    - gui=True：启动类 Jupyter 的 Web 界面，实时查看输入与输出（含通过 send 发送的内容与结果）。
+    """
+
+    def __init__(self, gui: bool = False, python: str = "python") -> None:
+        self._executor: SubprocessExecutor = SubprocessExecutor(python)
+        self._gui = gui
+        self._gui_server: Optional[object] = None
+        self._closed = False
+        self._last_result, self._last_error = "", ""
+        if gui:
+            from decpython.gui.server import start_gui_server
+            self._gui_server = start_gui_server(self)
+            threading.Timer(0.8, self._open_browser).start()
+
+    def _open_browser(self) -> None:
+        if self._gui_server and hasattr(self._gui_server, "url"):
+            webbrowser.open(self._gui_server.url)
+
+    def send(self, code: str) -> str:
+        """执行代码，返回 str(执行结果)；无表达式或仅语句时返回空字符串；出错时返回错误信息字符串。"""
+        if self._closed:
+            raise RuntimeError("DecPython terminal is already closed")
+        result, error = self._executor.run(code)
+        self._last_result, self._last_error = result, error
+        if self._gui_server is not None and hasattr(self._gui_server, "append_cell"):
+            self._gui_server.append_cell(code, result, error)
+        return result if not error else error
+
+    def close(self) -> None:
+        """关闭终端；若曾启动 GUI 则停止 Web 服务，并结束子进程。"""
+        if self._closed:
+            return
+        self._closed = True
+        if self._gui_server is not None and hasattr(self._gui_server, "shutdown"):
+            self._gui_server.shutdown()
+        if hasattr(self._executor, "close"):
+            self._executor.close()
+
+    def __enter__(self) -> "DecPython":
+        return self
+
+    def __exit__(self, *args: object) -> None:
+        self.close()

decpython-0.1.0/decpython/gui/__init__.py

@@ -0,0 +1 @@
+# GUI 模块：Web 界面与本地服务

decpython-0.1.0/decpython/gui/server.py

@@ -0,0 +1,395 @@
+"""
+本地 Web 服务：提供 Jupyter 风格的页面、/run 执行接口与 SSE 推送（使 send() 与页面同步）。
+仅使用标准库，跨平台。
+"""
+
+import json
+import queue
+import socket
+import threading
+from http.server import HTTPServer, BaseHTTPRequestHandler, ThreadingHTTPServer
+
+# 内嵌的 HTML 页面（科技感界面：深色终端风、霓虹高亮、玻璃拟态、流畅动效）
+INDEX_HTML = """<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>DecPython</title>
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">
+  <style>
+    :root {
+      --bg: #0a0e14;
+      --bg-panel: rgba(12, 18, 28, 0.85);
+      --surface: rgba(18, 26, 38, 0.9);
+      --border: rgba(0, 212, 255, 0.25);
+      --text: #e6e6e6;
+      --text-dim: #7a8a99;
+      --accent: #00d4ff;
+      --accent-glow: rgba(0, 212, 255, 0.4);
+      --success: #00ff9f;
+      --success-glow: rgba(0, 255, 159, 0.25);
+      --error: #ff3366;
+      --error-glow: rgba(255, 51, 102, 0.25);
+      --radius: 10px;
+      --font: 'JetBrains Mono', 'Consolas', monospace;
+    }
+    * { box-sizing: border-box; }
+    body {
+      font-family: var(--font);
+      font-size: 14px;
+      background: var(--bg);
+      color: var(--text);
+      margin: 0;
+      min-height: 100vh;
+      overflow-x: hidden;
+    }
+    body::before {
+      content: '';
+      position: fixed;
+      inset: 0;
+      background-image:
+        linear-gradient(rgba(0, 212, 255, 0.03) 1px, transparent 1px),
+        linear-gradient(90deg, rgba(0, 212, 255, 0.03) 1px, transparent 1px);
+      background-size: 24px 24px;
+      pointer-events: none;
+      z-index: 0;
+    }
+    .app {
+      position: relative;
+      z-index: 1;
+      max-width: 900px;
+      margin: 0 auto;
+      padding: 24px 20px 40px;
+    }
+    .header {
+      display: flex;
+      align-items: center;
+      gap: 12px;
+      margin-bottom: 24px;
+      padding-bottom: 16px;
+      border-bottom: 1px solid var(--border);
+    }
+    .logo {
+      font-weight: 600;
+      font-size: 1.35rem;
+      letter-spacing: 0.08em;
+      color: var(--accent);
+      text-shadow: 0 0 20px var(--accent-glow);
+    }
+    .logo span { color: var(--text-dim); font-weight: 400; }
+    .live-dot {
+      width: 8px;
+      height: 8px;
+      border-radius: 50%;
+      background: var(--success);
+      box-shadow: 0 0 12px var(--success-glow);
+      animation: pulse 2s ease-in-out infinite;
+    }
+    .live-label { font-size: 0.75rem; color: var(--text-dim); text-transform: uppercase; letter-spacing: 0.1em; }
+    @keyframes pulse { 0%, 100% { opacity: 1; } 50% { opacity: 0.5; } }
+
+    .input-panel {
+      background: var(--bg-panel);
+      border: 1px solid var(--border);
+      border-radius: var(--radius);
+      padding: 4px 4px 4px 16px;
+      margin-bottom: 24px;
+      box-shadow: 0 4px 24px rgba(0, 0, 0, 0.3), inset 0 1px 0 rgba(255,255,255,0.03);
+      transition: box-shadow 0.2s, border-color 0.2s;
+    }
+    .input-panel:focus-within {
+      border-color: rgba(0, 212, 255, 0.5);
+      box-shadow: 0 0 0 1px rgba(0, 212, 255, 0.15), 0 4px 24px rgba(0, 0, 0, 0.3);
+    }
+    .input-wrap {
+      display: flex;
+      gap: 12px;
+      align-items: flex-end;
+    }
+    .prompt {
+      color: var(--accent);
+      font-size: 0.9rem;
+      padding-bottom: 12px;
+      flex-shrink: 0;
+      text-shadow: 0 0 8px var(--accent-glow);
+    }
+    textarea {
+      flex: 1;
+      min-height: 100px;
+      background: transparent;
+      color: var(--text);
+      border: none;
+      padding: 10px 0 12px;
+      font-family: var(--font);
+      font-size: 13px;
+      line-height: 1.55;
+      resize: vertical;
+      outline: none;
+    }
+    textarea::placeholder { color: var(--text-dim); }
+    .run-wrap { flex-shrink: 0; }
+    .run-btn {
+      background: linear-gradient(135deg, rgba(0, 212, 255, 0.2), rgba(0, 212, 255, 0.08));
+      color: var(--accent);
+      border: 1px solid rgba(0, 212, 255, 0.4);
+      padding: 10px 20px;
+      border-radius: 8px;
+      font-family: var(--font);
+      font-size: 13px;
+      font-weight: 500;
+      cursor: pointer;
+      transition: all 0.2s;
+      box-shadow: 0 0 16px rgba(0, 212, 255, 0.1);
+    }
+    .run-btn:hover {
+      background: linear-gradient(135deg, rgba(0, 212, 255, 0.3), rgba(0, 212, 255, 0.15));
+      box-shadow: 0 0 24px var(--accent-glow);
+      border-color: var(--accent);
+    }
+    .run-btn:active { transform: scale(0.98); }
+
+    .outputs-title {
+      font-size: 0.7rem;
+      text-transform: uppercase;
+      letter-spacing: 0.12em;
+      color: var(--text-dim);
+      margin-bottom: 12px;
+    }
+    #outputs {
+      display: flex;
+      flex-direction: column;
+      gap: 16px;
+    }
+    .cell {
+      animation: cellIn 0.35s ease-out;
+      border-radius: var(--radius);
+      overflow: hidden;
+      border: 1px solid var(--border);
+      background: var(--surface);
+      box-shadow: 0 4px 20px rgba(0, 0, 0, 0.2);
+    }
+    @keyframes cellIn {
+      from { opacity: 0; transform: translateY(-8px); }
+      to { opacity: 1; transform: translateY(0); }
+    }
+    .cell-in {
+      padding: 12px 16px;
+      border-left: 3px solid var(--accent);
+      background: rgba(0, 212, 255, 0.04);
+      box-shadow: inset 0 1px 0 rgba(255,255,255,0.02);
+    }
+    .cell-in pre { margin: 0; white-space: pre-wrap; word-break: break-word; font-size: 13px; line-height: 1.5; }
+    .cell-out {
+      margin: 0;
+      padding: 12px 16px;
+      min-height: 24px;
+      border-left: 3px solid transparent;
+    }
+    .cell-out.result {
+      background: rgba(0, 255, 159, 0.06);
+      border-left-color: var(--success);
+      box-shadow: inset 0 0 20px var(--success-glow);
+    }
+    .cell-out.error {
+      background: rgba(255, 51, 102, 0.06);
+      border-left-color: var(--error);
+      box-shadow: inset 0 0 20px var(--error-glow);
+    }
+    .cell-out pre { margin: 0; white-space: pre-wrap; word-break: break-word; font-size: 13px; line-height: 1.5; }
+    .cell-out.error pre { color: #ff6b8a; }
+  </style>
+</head>
+<body>
+  <div class="app">
+    <header class="header">
+      <div class="logo">Dec<span>Python</span></div>
+      <div class="live-dot" title="已连接"></div>
+      <span class="live-label">Live</span>
+    </header>
+    <div class="input-panel">
+      <div class="input-wrap">
+        <span class="prompt">&gt;&gt;&gt;</span>
+        <textarea id="code" placeholder="# 输入代码，Shift+Enter 运行" spellcheck="false"></textarea>
+        <div class="run-wrap"><button type="button" class="run-btn" id="run">Run</button></div>
+      </div>
+    </div>
+    <div class="outputs-title">Output</div>
+    <div id="outputs"></div>
+  </div>
+  <script>
+    const codeEl = document.getElementById('code');
+    const runBtn = document.getElementById('run');
+    const outputsEl = document.getElementById('outputs');
+
+    function addCell(input, result, error) {
+      const cell = document.createElement('div');
+      cell.className = 'cell';
+      const text = error ? error : (result || '');
+      const isError = !!error;
+      cell.innerHTML = '<div class="cell-in"><pre>' + escapeHtml(input) + '</pre></div><div class="cell-out ' + (isError ? 'error' : 'result') + '"><pre>' + escapeHtml(text) + '</pre></div>';
+      outputsEl.appendChild(cell);
+      outputsEl.scrollTop = outputsEl.scrollHeight;
+    }
+    function escapeHtml(s) {
+      if (s == null) return '';
+      const div = document.createElement('div');
+      div.textContent = s;
+      return div.innerHTML;
+    }
+    // SSE：同步历史与后续通过 send() 或页面运行产生的新 cell
+    const evtSource = new EventSource('/stream');
+    evtSource.addEventListener('history', function(e) {
+      const cells = JSON.parse(e.data || '[]');
+      cells.forEach(function(c) { addCell(c.code, c.result, c.error); });
+    });
+    evtSource.addEventListener('cell', function(e) {
+      const c = JSON.parse(e.data || '{}');
+      addCell(c.code, c.result, c.error);
+    });
+    evtSource.onerror = function() { evtSource.close(); };
+
+    async function run() {
+      const code = codeEl.value.trim();
+      if (!code) return;
+      codeEl.value = '';
+      try {
+        await fetch('/run', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ code }) });
+      } catch (e) {
+        addCell(code, null, String(e));
+      }
+    }
+    runBtn.addEventListener('click', run);
+    codeEl.addEventListener('keydown', function(e) {
+      if (e.key === 'Enter' && e.shiftKey) { e.preventDefault(); run(); }
+    });
+  </script>
+</body>
+</html>
+"""
+
+
+def _find_free_port() -> int:
+    with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+        s.bind(("", 0))
+        s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
+        return s.getsockname()[1]
+
+
+def _sse_send(wfile, event: str, data: str) -> None:
+    wfile.write(f"event: {event}\ndata: {data}\n\n".encode("utf-8"))
+    wfile.flush()
+
+
+class _DecPythonHandler(BaseHTTPRequestHandler):
+    decpython_instance = None  # 由服务器注入
+
+    def log_message(self, format: str, *args: object) -> None:
+        pass
+
+    def do_GET(self) -> None:
+        if self.path == "/" or self.path == "/index.html":
+            self.send_response(200)
+            self.send_header("Content-Type", "text/html; charset=utf-8")
+            self.end_headers()
+            self.wfile.write(INDEX_HTML.encode("utf-8"))
+            return
+        if self.path == "/stream":
+            state = getattr(self.server, "state", None)
+            if not state:
+                self.send_response(500)
+                self.end_headers()
+                return
+            self.send_response(200)
+            self.send_header("Content-Type", "text/event-stream")
+            self.send_header("Cache-Control", "no-cache")
+            self.send_header("Connection", "keep-alive")
+            self.end_headers()
+            client_queue = queue.Queue()
+            state["queues"].append(client_queue)
+            try:
+                history_json = json.dumps(state["cells"], ensure_ascii=False)
+                _sse_send(self.wfile, "history", history_json)
+                while True:
+                    item = client_queue.get()
+                    if item is None:
+                        break
+                    _sse_send(self.wfile, "cell", json.dumps(item, ensure_ascii=False))
+            except (BrokenPipeError, ConnectionResetError, OSError):
+                pass
+            finally:
+                try:
+                    state["queues"].remove(client_queue)
+                except ValueError:
+                    pass
+            return
+        self.send_response(404)
+        self.end_headers()
+
+    def do_POST(self) -> None:
+        if self.path == "/run":
+            length = int(self.headers.get("Content-Length", 0))
+            body = self.rfile.read(length).decode("utf-8") if length else "{}"
+            try:
+                data = json.loads(body)
+                code = data.get("code", "")
+            except Exception:
+                code = ""
+            result = ""
+            err = ""
+            dp = _DecPythonHandler.decpython_instance
+            if dp and not getattr(dp, "_closed", True):
+                try:
+                    dp.send(code)
+                    result = getattr(dp, "_last_result", "")
+                    err = getattr(dp, "_last_error", "")
+                except Exception as e:
+                    err = str(e)
+            else:
+                err = "终端已关闭"
+            # dp.send() already calls append_cell(); do not append/push again here
+            self.send_response(200)
+            self.send_header("Content-Type", "application/json; charset=utf-8")
+            self.end_headers()
+            self.wfile.write(json.dumps({"result": result, "error": err}, ensure_ascii=False).encode("utf-8"))
+            return
+        self.send_response(404)
+        self.end_headers()
+
+
+class _GUIServer:
+    def __init__(self, decpython_instance: object, port: int) -> None:
+        self._server = ThreadingHTTPServer(("127.0.0.1", port), _DecPythonHandler)
+        self._server.state = {"cells": [], "queues": []}
+        _DecPythonHandler.decpython_instance = decpython_instance
+        self._decpython = decpython_instance
+        self.port = port
+        self.url = f"http://127.0.0.1:{port}/"
+        self._thread = threading.Thread(target=self._server.serve_forever, daemon=True)
+        self._thread.start()
+
+    def append_cell(self, code: str, result: str, error: str) -> None:
+        cell = {"code": code, "result": result or "", "error": error or ""}
+        self._server.state["cells"].append(cell)
+        for q in self._server.state["queues"]:
+            try:
+                q.put(cell)
+            except Exception:
+                pass
+
+    def shutdown(self) -> None:
+        if self._server:
+            for q in self._server.state.get("queues", []):
+                try:
+                    q.put(None)
+                except Exception:
+                    pass
+            self._server.shutdown()
+            self._server = None
+
+
+def start_gui_server(decpython_instance: object) -> _GUIServer:
+    port = _find_free_port()
+    return _GUIServer(decpython_instance, port)

decpython-0.1.0/decpython.egg-info/PKG-INFO

@@ -0,0 +1,55 @@
+Metadata-Version: 2.2
+Name: decpython
+Version: 0.1.0
+Summary: 跨平台、支持 Web 通信的 Python 终端工具
+Home-page: https://github.com/your-username/decpython_maskter
+Author: decpython
+Author-email: decrule@outlook.com
+License: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+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.9.0
+Description-Content-Type: text/markdown
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: ruff>=0.1; extra == "dev"
+Dynamic: author-email
+Dynamic: home-page
+Dynamic: requires-python
+
+# DecPython
+
+Run Python in a subprocess from your code and get string results, or open a Jupyter-style web terminal. Cross-platform, stdlib only.
+
+## Install
+
+```bash
+pip install -e .
+```
+
+## Quick start
+
+```python
+from decpython import DecPython
+
+dp = DecPython(gui=False, python='python')
+result = dp.send('a = 1\nb = 2\na + b')   # -> '3'
+dp.close()
+```
+
+With a web UI: use `gui=True` and optionally `python='python3.12'`. Code and results from `send()` appear in the browser. Press Shift+Enter or click Run in the page.
+
+## API
+
+- **`send(code)`** — Run code; returns the last expression as a string (or the error message).
+- **`close()`** — Stop the subprocess and, if used, the web server.
+
+## License
+
+MIT

decpython-0.1.0/decpython.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+README.md
+pyproject.toml
+setup.py
+decpython/__init__.py
+decpython/core.py
+decpython.egg-info/PKG-INFO
+decpython.egg-info/SOURCES.txt
+decpython.egg-info/dependency_links.txt
+decpython.egg-info/requires.txt
+decpython.egg-info/top_level.txt
+decpython/gui/__init__.py
+decpython/gui/server.py

decpython-0.1.0/decpython.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

decpython-0.1.0/decpython.egg-info/requires.txt

@@ -0,0 +1,4 @@
+
+[dev]
+pytest>=7
+ruff>=0.1

decpython-0.1.0/decpython.egg-info/top_level.txt

@@ -0,0 +1 @@
+decpython

decpython-0.1.0/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["setuptools>=61", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "decpython"
+version = "0.1.0"
+description = "跨平台、支持 Web 通信的 Python 终端工具"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [{ name = "decpython" }]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+dependencies = []
+
+[project.optional-dependencies]
+dev = ["pytest>=7", "ruff>=0.1"]
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["decpython*"]

decpython-0.1.0/setup.cfg

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

decpython-0.1.0/setup.py

@@ -0,0 +1,91 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+# Publish to PyPI: pip install twine && python setup.py upload
+
+import io
+import os
+import sys
+from shutil import rmtree
+from setuptools import find_packages, setup, Command
+
+NAME = 'decpython'
+DESCRIPTION = 'Run Python in a subprocess from your code and get string results, or open a Jupyter-style web terminal. Cross-platform, stdlib only.'
+URL = 'https://github.com/your-username/decpython_maskter'
+EMAIL = 'decrule@outlook.com'
+AUTHOR = 'DecRule'
+REQUIRES_PYTHON = '>=3.9.0'
+VERSION = '1.0.0'
+
+REQUIRED = []
+EXTRAS = {'dev': ['pytest>=7', 'ruff>=0.1']}
+
+here = os.path.abspath(os.path.dirname(__file__))
+try:
+    with io.open(os.path.join(here, 'README.md'), encoding='utf-8') as f:
+        long_description = '\n' + f.read()
+except FileNotFoundError:
+    long_description = DESCRIPTION
+
+about = {'__version__': VERSION}
+
+
+class UploadCommand(Command):
+    """Support setup.py upload."""
+
+    description = 'Build and publish the package.'
+    user_options = []
+
+    @staticmethod
+    def status(s):
+        print('\033[1m{0}\033[0m'.format(s))
+
+    def initialize_options(self):
+        pass
+
+    def finalize_options(self):
+        pass
+
+    def run(self):
+        try:
+            self.status('Removing previous builds…')
+            rmtree(os.path.join(here, 'dist'))
+        except OSError:
+            pass
+        self.status('Building Source and Wheel distribution…')
+        os.system('{0} setup.py sdist bdist_wheel'.format(sys.executable))
+        self.status('Uploading the package to PyPI via Twine…')
+        os.system('twine upload dist/*')
+        self.status('Pushing git tags…')
+        os.system('git tag v{0}'.format(about['__version__']))
+        os.system('git push --tags')
+        sys.exit()
+
+
+setup(
+    name=NAME,
+    version=about['__version__'],
+    description=DESCRIPTION,
+    long_description=long_description,
+    long_description_content_type='text/markdown',
+    author=AUTHOR,
+    author_email=EMAIL,
+    python_requires=REQUIRES_PYTHON,
+    url=URL,
+    packages=find_packages(exclude=['tests', '*.tests', '*.tests.*', 'tests.*']),
+    install_requires=REQUIRED,
+    extras_require=EXTRAS,
+    include_package_data=True,
+    license='MIT',
+    classifiers=[
+        'Development Status :: 3 - Alpha',
+        'Intended Audience :: Developers',
+        'License :: OSI Approved :: MIT License',
+        'Programming Language :: Python :: 3',
+        'Programming Language :: Python :: 3.9',
+        'Programming Language :: Python :: 3.10',
+        'Programming Language :: Python :: 3.11',
+        'Programming Language :: Python :: 3.12',
+    ],
+    cmdclass={'upload': UploadCommand},
+)