@lazycatcloud/lzc-cli 1.3.17 → 2.0.0-pre.1

package/template/python/Dockerfile.dev

@@ -0,0 +1,18 @@
+FROM registry.lazycat.cloud/lzc/lzcapp:3.20.3
+
+RUN apk add --no-cache python3 py3-pip
+WORKDIR /app
+
+ENV LZC_PY_DEV=1
+ENV PYTHONUNBUFFERED=1
+
+COPY requirements.txt /app/requirements.txt
+RUN pip3 install --no-cache-dir -r /app/requirements.txt --break-system-packages
+
+COPY app.py /app/app.py
+COPY run.sh /app/run.sh
+RUN chmod +x /app/run.sh
+COPY web /app/web
+
+EXPOSE 3000
+CMD ["/app/run.sh"]

package/template/python/README.md

@@ -0,0 +1,50 @@
+# Lazycat Python Todo App
+
+## First Deploy
+```bash
+lzc-cli project deploy
+lzc-cli project info
+```
+
+By default, project commands use `lzc-build.dev.yml` when it exists.
+Each command prints the active `Build config`.
+Use `--release` if you want to operate on `lzc-build.yml`.
+
+Open the app first.
+In dev mode, the Python service starts automatically.
+If the page still shows the backend dev guide, it will tell you the expected port and next step.
+
+## Recommended Backend Dev Loop
+```bash
+lzc-cli project sync --watch
+```
+
+The dev image starts the Python service automatically and reloads on source changes.
+If you changed dependencies or need to restart the process manually:
+
+```bash
+lzc-cli project exec /bin/sh
+/app/run.sh
+```
+
+You can also build locally and use `lzc-cli project cp` instead of `project sync --watch`.
+
+## Troubleshooting
+```bash
+lzc-cli project log -f
+lzc-cli project exec /bin/sh
+```
+
+## API
+```text
+GET /api/health
+GET /api/todos
+POST /api/todos
+PUT /api/todos/{id}/toggle
+DELETE /api/todos/{id}
+```
+
+## Data Path
+```text
+/lzcapp/var/todos.json
+```

package/template/python/_gitignore

@@ -0,0 +1,3 @@
+__pycache__/
+*.pyc
+.venv/

package/template/python/_lzcdevignore

@@ -0,0 +1,21 @@
+.git
+.git/**
+node_modules
+node_modules/**
+.venv
+.venv/**
+dist
+dist/**
+build
+build/**
+__pycache__
+__pycache__/**
+.idea
+.idea/**
+.vscode
+.vscode/**
+.DS_Store
+.lzc-cli-*
+.lzc-cli-*/**
+*.lpk
+*.lpk.tar

package/template/python/app.py

@@ -0,0 +1,110 @@
+import json
+import os
+import time
+from flask import Flask, send_from_directory, request
+
+app = Flask(__name__, static_folder="/app/web", static_url_path="")
+DATA_FILE = "/lzcapp/var/todos.json"
+todos = []
+next_id = 1
+
+
+def now_ms():
+    return int(time.time() * 1000)
+
+def load_todos():
+    global todos, next_id
+    os.makedirs(os.path.dirname(DATA_FILE), exist_ok=True)
+    if not os.path.exists(DATA_FILE):
+        return
+    with open(DATA_FILE, "r", encoding="utf-8") as fp:
+        raw = fp.read().strip()
+    if not raw:
+        return
+    loaded = json.loads(raw)
+    if not isinstance(loaded, list):
+        raise ValueError("todos data must be a list")
+    todos = loaded
+    max_id = 0
+    for item in todos:
+        if isinstance(item, dict):
+            max_id = max(max_id, int(item.get("id", 0)))
+    next_id = max_id + 1
+
+def save_todos():
+    os.makedirs(os.path.dirname(DATA_FILE), exist_ok=True)
+    tmp_file = DATA_FILE + ".tmp"
+    with open(tmp_file, "w", encoding="utf-8") as fp:
+        json.dump(todos, fp, ensure_ascii=False, indent=2)
+    os.replace(tmp_file, DATA_FILE)
+
+load_todos()
+
+
+@app.get("/")
+def index():
+    return send_from_directory(app.static_folder, "index.html")
+
+
+@app.get('/api/health')
+def health():
+    return {'status': 'ok'}
+
+
+@app.get("/api/todos")
+def list_todos():
+    sorted_todos = sorted(todos, key=lambda item: item["updatedAt"], reverse=True)
+    return {"items": sorted_todos}
+
+
+@app.post("/api/todos")
+def add_todo():
+    global next_id
+    payload = request.get_json(silent=True) or {}
+    title = str(payload.get("title", "")).strip()
+    if not title:
+        return {"error": "title is required"}, 400
+    todo = {
+        "id": next_id,
+        "title": title,
+        "done": False,
+        "updatedAt": now_ms(),
+    }
+    next_id += 1
+    todos.append(todo)
+    try:
+        save_todos()
+    except Exception:
+        return {"error": "failed to persist todos"}, 500
+    return todo
+
+
+@app.put("/api/todos/<int:todo_id>/toggle")
+def toggle_todo(todo_id):
+    for todo in todos:
+        if todo["id"] == todo_id:
+            todo["done"] = not todo["done"]
+            todo["updatedAt"] = now_ms()
+            try:
+                save_todos()
+            except Exception:
+                return {"error": "failed to persist todos"}, 500
+            return todo
+    return {"error": "todo not found"}, 404
+
+
+@app.delete("/api/todos/<int:todo_id>")
+def delete_todo(todo_id):
+    for index, todo in enumerate(todos):
+        if todo["id"] == todo_id:
+            todos.pop(index)
+            try:
+                save_todos()
+            except Exception:
+                return {"error": "failed to persist todos"}, 500
+            return {"ok": True}
+    return {"error": "todo not found"}, 404
+
+
+if __name__ == '__main__':
+    app.run(host='0.0.0.0', port=3000)

package/template/python/lzc-build.dev.yml

@@ -0,0 +1,12 @@
+# 开发态覆盖配置
+
+# pkg_id_suffix: append an extra package id segment for dev deploys
+pkg_id_suffix: dev
+
+envs:
+  - DEV_MODE=1
+
+images:
+  app-runtime:
+    context: ./
+    dockerfile: ./Dockerfile.dev

package/template/python/lzc-build.yml

@@ -0,0 +1,16 @@
+# manifest: 指定 lpk 的 manifest 文件
+manifest: ./lzc-manifest.yml
+
+# pkgout: lpk 输出目录
+pkgout: ./
+
+# icon: 应用图标（png）
+icon: ./lzc-icon.png
+
+# images: 构建容器镜像并写入 lpk v2 的 images 目录
+images:
+  app-runtime:
+    # context: Docker 构建上下文目录
+    context: ./
+    # dockerfile: 镜像构建文件
+    dockerfile: ./Dockerfile

package/template/python/manifest.dev.page.js

@@ -0,0 +1,25 @@
+function renderDevPage(port) {
+  const title = "Python dev service is not ready";
+  const subtitle = "This app starts the Python dev service automatically in dev mode. If the page still shows this guide, the process is still starting or needs attention.";
+  const pageTitle = "Backend Dev";
+  const steps = [
+    "Sync your latest code into the container with <code>lzc-cli project sync --watch</code> or copy it with <code>lzc-cli project cp</code>.",
+    "Check the service log with <code>lzc-cli project log -f</code>.",
+    "If you need to restart the process manually, open <code>lzc-cli project exec /bin/sh</code> and run <code>/app/run.sh</code>.",
+    "Refresh this page after port <code>" + String(port) + "</code> is ready.",
+  ];
+  const portText = port === undefined || port === null ? "" : String(port);
+  const items = steps.map(function (step) {
+    return "<li>" + step + "</li>";
+  }).join("");
+  const portBadge = portText ? "<div class=\"pill\">Expected local port: " + portText + "</div>" : "";
+  return [
+    "<!doctype html>",
+    "<html lang=\"en\"><head><meta charset=\"UTF-8\"><meta name=\"viewport\" content=\"width=device-width,initial-scale=1\"><title>", pageTitle, "</title><style>",
+    "body{margin:0;padding:32px;font-family:ui-sans-serif,system-ui,sans-serif;background:#f5f8fc;color:#112033}",
+    ".card{max-width:760px;margin:0 auto;background:#fff;border:1px solid #d9e4f2;border-radius:18px;padding:24px;box-shadow:0 16px 40px rgba(17,32,51,.08)}",
+    "h1{margin:0 0 12px;font-size:32px}.muted{color:#51627a}.pill{display:inline-block;margin:16px 0 0;padding:6px 10px;border-radius:999px;background:#eef5ff;color:#0c5dd6;font-weight:600}",
+    "ol{margin:18px 0 0;padding-left:20px;line-height:1.8}code{background:#f2f6fb;border-radius:8px;padding:2px 6px}button{margin-top:20px;border:0;border-radius:10px;padding:10px 14px;background:#112033;color:#fff;cursor:pointer}",
+    "</style></head><body><main class=\"card\"><h1>", title, "</h1><p class=\"muted\">", subtitle, "</p>", portBadge, "<ol>", items, "</ol><button onclick=\"location.reload()\">Refresh</button></main></body></html>",
+  ].join("");
+}

package/template/python/requirements.txt

@@ -0,0 +1 @@
+flask==3.0.3

package/template/python/run.sh

@@ -0,0 +1,14 @@
+#!/bin/sh
+set -e
+
+mirror_root="/lzcapp/cache/project-mirror"
+app_file="/app/app.py"
+if [ -f "$mirror_root/app.py" ]; then
+	app_file="$mirror_root/app.py"
+fi
+
+if [ "${LZC_PY_DEV:-}" = "1" ]; then
+	exec python3 -m flask --app "$app_file" run --debug --host 0.0.0.0 --port 3000
+fi
+
+exec python3 "$app_file"

package/template/python/web/index.html

@@ -0,0 +1,238 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Lazycat Python Todo Template</title>
+    <style>
+      :root {
+        --bg-1: #f8fbff;
+        --bg-2: #ecf6ff;
+        --card: #ffffff;
+        --text: #142033;
+        --muted: #4e617b;
+        --line: #d8e4f2;
+        --brand: #0076d6;
+        --brand-2: #00a5a5;
+      }
+      * { box-sizing: border-box; }
+      body {
+        margin: 0;
+        min-height: 100vh;
+        display: grid;
+        place-items: center;
+        padding: 24px;
+        font-family: 'Segoe UI', 'Helvetica Neue', Arial, sans-serif;
+        background: radial-gradient(circle at top right, var(--bg-2), var(--bg-1) 42%);
+        color: var(--text);
+      }
+      .card {
+        width: min(920px, 100%);
+        background: var(--card);
+        border: 1px solid var(--line);
+        border-radius: 22px;
+        padding: 26px;
+        box-shadow: 0 18px 48px rgba(20, 32, 51, 0.08);
+      }
+      .tag {
+        margin: 0;
+        color: var(--brand);
+        font-weight: 700;
+        letter-spacing: .08em;
+        text-transform: uppercase;
+        font-size: .85rem;
+      }
+      h1 { margin: 10px 0 12px; font-size: clamp(1.8rem, 3.2vw, 2.7rem); }
+      p { margin: 0; color: var(--muted); }
+      .btns {
+        margin-top: 18px;
+        display: flex;
+        gap: 10px;
+        flex-wrap: wrap;
+      }
+      a {
+        display: inline-flex;
+        align-items: center;
+        justify-content: center;
+        text-decoration: none;
+        border-radius: 10px;
+        padding: 10px 14px;
+        border: 1px solid var(--line);
+        color: var(--text);
+        font-weight: 600;
+      }
+      a.primary {
+        color: #fff;
+        border-color: transparent;
+        background: linear-gradient(135deg, var(--brand), var(--brand-2));
+      }
+      .panel {
+        margin-top: 22px;
+        border: 1px solid var(--line);
+        border-radius: 14px;
+        padding: 14px;
+        background: #fbfdff;
+      }
+      .sync-note {
+        margin-top: 8px;
+        font-size: .92rem;
+      }
+      .form {
+        margin-top: 12px;
+        display: flex;
+        gap: 10px;
+      }
+      .form input {
+        flex: 1;
+        border: 1px solid var(--line);
+        border-radius: 10px;
+        padding: 10px 12px;
+        min-width: 0;
+      }
+      button {
+        border: 1px solid var(--line);
+        border-radius: 10px;
+        padding: 9px 12px;
+        cursor: pointer;
+        background: #fff;
+      }
+      ul {
+        margin: 12px 0 0;
+        padding: 0;
+        list-style: none;
+        display: grid;
+        gap: 10px;
+      }
+      li {
+        border: 1px solid var(--line);
+        border-radius: 10px;
+        padding: 10px 12px;
+        display: flex;
+        justify-content: space-between;
+        align-items: center;
+        gap: 8px;
+        background: #fff;
+      }
+      label {
+        display: flex;
+        align-items: center;
+        gap: 8px;
+      }
+      .done {
+        text-decoration: line-through;
+        color: var(--muted);
+      }
+      .danger {
+        color: #a63e37;
+      }
+      @media (max-width: 640px) {
+        .form {
+          flex-direction: column;
+        }
+        li {
+          flex-direction: column;
+          align-items: flex-start;
+        }
+      }
+    </style>
+  </head>
+  <body>
+    <main class="card">
+      <p class="tag">Python Version</p>
+      <h1>Todo demo powered by Flask API</h1>
+      <p>
+        This template includes a Python backend and a simple Todo app to help you start fast.
+      </p>
+
+      <div class="btns">
+        <a class="primary" href="https://lazycat.cloud/" target="_blank" rel="noreferrer">Visit lazycat.cloud</a>
+        <a href="https://developer.lazycat.cloud/" target="_blank" rel="noreferrer">Open Developer Docs</a>
+      </div>
+
+      <section class="panel">
+        <strong>Todo quick demo</strong>
+        <p class="sync-note">Data syncs automatically across devices when opened with the same app account.</p>
+        <div class="form">
+          <input id="todoInput" placeholder="Add a task for your app kickoff" />
+          <button id="addBtn" type="button">Add</button>
+        </div>
+        <ul id="todoList"></ul>
+      </section>
+    </main>
+    <script>
+      const todoInput = document.getElementById('todoInput');
+      const addBtn = document.getElementById('addBtn');
+      const todoList = document.getElementById('todoList');
+
+      async function fetchTodos() {
+        const resp = await fetch('/api/todos');
+        const data = await resp.json();
+        return Array.isArray(data.items) ? data.items : [];
+      }
+
+      function renderTodos(items) {
+        todoList.innerHTML = '';
+        for (const todo of items) {
+          const li = document.createElement('li');
+
+          const label = document.createElement('label');
+          const checkbox = document.createElement('input');
+          checkbox.type = 'checkbox';
+          checkbox.checked = !!todo.done;
+          checkbox.addEventListener('change', async () => {
+            await fetch(`/api/todos/${todo.id}/toggle`, { method: 'PUT' });
+            await refreshTodos();
+          });
+
+          const span = document.createElement('span');
+          span.textContent = todo.title;
+          if (todo.done) {
+            span.className = 'done';
+          }
+          label.append(checkbox, span);
+
+          const delBtn = document.createElement('button');
+          delBtn.type = 'button';
+          delBtn.className = 'danger';
+          delBtn.textContent = 'Delete';
+          delBtn.addEventListener('click', async () => {
+            await fetch(`/api/todos/${todo.id}`, { method: 'DELETE' });
+            await refreshTodos();
+          });
+
+          li.append(label, delBtn);
+          todoList.appendChild(li);
+        }
+      }
+
+      async function refreshTodos() {
+        const items = await fetchTodos();
+        renderTodos(items);
+      }
+
+      async function addTodo() {
+        const title = todoInput.value.trim();
+        if (!title) return;
+        await fetch('/api/todos', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ title }),
+        });
+        todoInput.value = '';
+        await refreshTodos();
+      }
+
+      addBtn.addEventListener('click', addTodo);
+      todoInput.addEventListener('keyup', async (event) => {
+        if (event.key === 'Enter') {
+          await addTodo();
+        }
+      });
+
+      refreshTodos();
+      setInterval(refreshTodos, 2500);
+      document.addEventListener('visibilitychange', refreshTodos);
+      window.addEventListener('focus', refreshTodos);
+    </script>
+  </body>
+</html>

package/template/springboot/Dockerfile

@@ -0,0 +1,20 @@
+FROM registry.lazycat.cloud/lzc/lzcapp:3.20.3 AS builder
+
+RUN apk add --no-cache openjdk17 maven
+WORKDIR /workspace
+
+COPY pom.xml ./
+COPY src ./src
+RUN mvn -DskipTests package
+
+FROM registry.lazycat.cloud/lzc/lzcapp:3.20.3
+
+RUN apk add --no-cache openjdk17-jre-headless
+WORKDIR /app
+
+COPY --from=builder /workspace/target/*.jar /app/app.jar
+COPY run.sh /app/run.sh
+RUN chmod +x /app/run.sh
+
+EXPOSE 8080
+CMD ["/app/run.sh"]

package/template/springboot/Dockerfile.dev

@@ -0,0 +1,20 @@
+FROM registry.lazycat.cloud/lzc/lzcapp:3.20.3 AS builder
+
+RUN apk add --no-cache openjdk17 maven
+WORKDIR /workspace
+
+COPY pom.xml ./
+COPY src ./src
+RUN mvn -DskipTests package
+
+FROM registry.lazycat.cloud/lzc/lzcapp:3.20.3
+
+RUN apk add --no-cache openjdk17 maven
+WORKDIR /app
+
+COPY --from=builder /workspace/target/*.jar /app/app.jar
+COPY run.sh /app/run.sh
+RUN chmod +x /app/run.sh
+
+EXPOSE 8080
+CMD ["sh", "-lc", "trap : TERM INT; sleep infinity & wait"]

package/template/springboot/README.md

@@ -0,0 +1,44 @@
+# Lazycat Java Spring Boot Todo App
+
+## First Deploy
+```bash
+lzc-cli project deploy
+lzc-cli project info
+```
+
+By default, project commands use `lzc-build.dev.yml` when it exists.
+Each command prints the active `Build config`.
+Use `--release` if you want to operate on `lzc-build.yml`.
+
+Open the app first.
+If the backend dev service is not ready yet, the app page will show the expected port and what to do next.
+In dev mode, the Spring Boot service is started manually inside the app container.
+
+## Recommended Backend Dev Loop
+```bash
+lzc-cli project sync --watch
+lzc-cli project exec /bin/sh
+/app/run.sh
+```
+
+You can also build locally and use `lzc-cli project cp` instead of `project sync --watch`.
+
+## Troubleshooting
+```bash
+lzc-cli project log -f
+lzc-cli project exec /bin/sh
+```
+
+## API
+```text
+GET /api/health
+GET /api/todos
+POST /api/todos
+PUT /api/todos/{id}/toggle
+DELETE /api/todos/{id}
+```
+
+## Data Path
+```text
+/lzcapp/var/todos.json
+```

package/template/springboot/_gitignore

@@ -0,0 +1,3 @@
+/target/
+/.idea/
+*.iml

package/template/springboot/_lzcdevignore

@@ -0,0 +1,21 @@
+.git
+.git/**
+node_modules
+node_modules/**
+.venv
+.venv/**
+dist
+dist/**
+build
+build/**
+__pycache__
+__pycache__/**
+.idea
+.idea/**
+.vscode
+.vscode/**
+.DS_Store
+.lzc-cli-*
+.lzc-cli-*/**
+*.lpk
+*.lpk.tar

package/template/springboot/lzc-build.dev.yml

@@ -0,0 +1,12 @@
+# 开发态覆盖配置
+
+# pkg_id_suffix: append an extra package id segment for dev deploys
+pkg_id_suffix: dev
+
+envs:
+  - DEV_MODE=1
+
+images:
+  app-runtime:
+    context: ./
+    dockerfile: ./Dockerfile.dev

package/template/springboot/lzc-build.yml

@@ -0,0 +1,16 @@
+# manifest: 指定 lpk 的 manifest 文件
+manifest: ./lzc-manifest.yml
+
+# pkgout: lpk 输出目录
+pkgout: ./
+
+# icon: 应用图标（png）
+icon: ./lzc-icon.png
+
+# images: 构建容器镜像并写入 lpk v2 的 images 目录
+images:
+  app-runtime:
+    # context: Docker 构建上下文目录
+    context: ./
+    # dockerfile: 镜像构建文件
+    dockerfile: ./Dockerfile