zeal-builder 0.1.0__tar.gz

zeal_builder-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 stoday
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

zeal_builder-0.1.0/PKG-INFO

@@ -0,0 +1,92 @@
+Metadata-Version: 2.4
+Name: zeal-builder
+Version: 0.1.0
+Summary: Create and configure a LINE Messaging API echo bot from your terminal.
+Author: stoday
+Author-email: stoday <stoday@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Requires-Dist: playwright>=1.55,<2
+Requires-Python: >=3.11
+Project-URL: Repository, https://github.com/stoday/ZEAL
+Project-URL: Issues, https://github.com/stoday/ZEAL/issues
+Description-Content-Type: text/markdown
+
+# ZEAL
+
+[繁體中文](https://github.com/stoday/ZEAL/blob/main/README.zh-TW.md) | English
+
+ZEAL (**Zona's Easy Adapter for Lin-bot**) helps you quickly create and
+configure a LINE Bot.
+
+Inspired by [Zona](https://github.com/zonawang), ZEAL aims to help anyone who
+wants to build a LINE Bot finish the basic setup quickly, so they can spend
+their time developing the Bot itself.
+
+## Before you begin
+
+- Python 3.11 or later
+- [uv](https://docs.astral.sh/uv/)
+- A LINE account that can sign in to LINE Business
+- An ngrok account and authtoken
+
+## Install
+
+Install the published package from PyPI:
+
+```powershell
+uv tool install zeal-builder
+```
+
+To work from the source checkout instead:
+
+```powershell
+git clone https://github.com/stoday/ZEAL.git
+cd ZEAL
+uv sync
+```
+
+## Run
+
+```powershell
+zeal line-bot setup
+```
+
+From the source checkout, use:
+
+```powershell
+uv run zeal line-bot setup
+```
+
+Follow the terminal prompts to enter the required account information. When
+LINE opens a browser and asks you to sign in, enter an OTP/MFA code, or confirm
+that you are human, complete that step yourself. ZEAL performs the remaining
+supported setup automatically.
+
+At the end, scan the QR code, send the Bot a message, and confirm the reply.
+ZEAL creates `line-bot-<account-name>/`; edit `app.py` there to change the
+Bot's reply. Keep `.env` private.
+
+## Other commands
+
+```powershell
+# Keep the local Bot and ngrok running after setup
+zeal line-bot setup --keep-running
+
+# Set up a local Bot project for an existing LINE Messaging API channel
+zeal line-bot resume
+
+# View all available options
+zeal line-bot setup --help
+zeal line-bot resume --help
+```
+
+When working from the source checkout, prefix these commands with `uv run`.
+
+After setup, use [LINE Official Account Manager](https://manager.line.biz/) to
+edit account details and automatic replies. Use the
+[LINE Developers Console](https://developers.line.biz/console/) to edit the
+Webhook and Messaging API settings.
+
+For a detailed manual walkthrough in Traditional Chinese, see
+[line-bot-apply.md](https://github.com/stoday/ZEAL/blob/main/line-bot-apply.md).

zeal_builder-0.1.0/README.md

@@ -0,0 +1,78 @@
+# ZEAL
+
+[繁體中文](https://github.com/stoday/ZEAL/blob/main/README.zh-TW.md) | English
+
+ZEAL (**Zona's Easy Adapter for Lin-bot**) helps you quickly create and
+configure a LINE Bot.
+
+Inspired by [Zona](https://github.com/zonawang), ZEAL aims to help anyone who
+wants to build a LINE Bot finish the basic setup quickly, so they can spend
+their time developing the Bot itself.
+
+## Before you begin
+
+- Python 3.11 or later
+- [uv](https://docs.astral.sh/uv/)
+- A LINE account that can sign in to LINE Business
+- An ngrok account and authtoken
+
+## Install
+
+Install the published package from PyPI:
+
+```powershell
+uv tool install zeal-builder
+```
+
+To work from the source checkout instead:
+
+```powershell
+git clone https://github.com/stoday/ZEAL.git
+cd ZEAL
+uv sync
+```
+
+## Run
+
+```powershell
+zeal line-bot setup
+```
+
+From the source checkout, use:
+
+```powershell
+uv run zeal line-bot setup
+```
+
+Follow the terminal prompts to enter the required account information. When
+LINE opens a browser and asks you to sign in, enter an OTP/MFA code, or confirm
+that you are human, complete that step yourself. ZEAL performs the remaining
+supported setup automatically.
+
+At the end, scan the QR code, send the Bot a message, and confirm the reply.
+ZEAL creates `line-bot-<account-name>/`; edit `app.py` there to change the
+Bot's reply. Keep `.env` private.
+
+## Other commands
+
+```powershell
+# Keep the local Bot and ngrok running after setup
+zeal line-bot setup --keep-running
+
+# Set up a local Bot project for an existing LINE Messaging API channel
+zeal line-bot resume
+
+# View all available options
+zeal line-bot setup --help
+zeal line-bot resume --help
+```
+
+When working from the source checkout, prefix these commands with `uv run`.
+
+After setup, use [LINE Official Account Manager](https://manager.line.biz/) to
+edit account details and automatic replies. Use the
+[LINE Developers Console](https://developers.line.biz/console/) to edit the
+Webhook and Messaging API settings.
+
+For a detailed manual walkthrough in Traditional Chinese, see
+[line-bot-apply.md](https://github.com/stoday/ZEAL/blob/main/line-bot-apply.md).

zeal_builder-0.1.0/pyproject.toml

@@ -0,0 +1,33 @@
+[project]
+name = "zeal-builder"
+version = "0.1.0"
+description = "Create and configure a LINE Messaging API echo bot from your terminal."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.11"
+dependencies = ["playwright>=1.55,<2"]
+
+[[project.authors]]
+name = "stoday"
+email = "stoday@gmail.com"
+
+[project.urls]
+Repository = "https://github.com/stoday/ZEAL"
+Issues = "https://github.com/stoday/ZEAL/issues"
+
+[project.scripts]
+zeal = "zeal:main"
+
+[build-system]
+requires = ["uv_build>=0.12.17,<0.13.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "zeal"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[dependency-groups]
+dev = ["pytest>=9.1.1"]

zeal_builder-0.1.0/pyproject.toml.orig

@@ -0,0 +1,36 @@
+[project]
+name = "zeal-builder"
+version = "0.1.0"
+description = "Create and configure a LINE Messaging API echo bot from your terminal."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "stoday", email = "stoday@gmail.com" }
+]
+requires-python = ">=3.11"
+dependencies = [
+    "playwright>=1.55,<2",
+]
+
+[project.urls]
+Repository = "https://github.com/stoday/ZEAL"
+Issues = "https://github.com/stoday/ZEAL/issues"
+
+[project.scripts]
+zeal = "zeal:main"
+
+[build-system]
+requires = ["uv_build>=0.12.17,<0.13.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "zeal"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.1.1",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

zeal_builder-0.1.0/src/zeal/__init__.py

@@ -0,0 +1,5 @@
+"""ZEAL command-line tools."""
+
+from zeal.cli import main
+
+__all__ = ["main"]

zeal_builder-0.1.0/src/zeal/cli.py

@@ -0,0 +1,113 @@
+"""The public command-line interface for ZEAL."""
+
+from __future__ import annotations
+
+import argparse
+from pathlib import Path
+from typing import Sequence
+
+from zeal.line_bot import run_resume, run_setup
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="zeal",
+        description="Bootstrap small developer workflows safely.",
+    )
+    commands = parser.add_subparsers(dest="command", required=True)
+
+    line_bot = commands.add_parser(
+        "line-bot",
+        help="Create and configure a LINE Messaging API echo bot.",
+    )
+    line_bot_commands = line_bot.add_subparsers(dest="line_bot_command", required=True)
+    setup = line_bot_commands.add_parser(
+        "setup",
+        help="Create a local project, ngrok tunnel, and assist LINE Console setup.",
+    )
+    setup.add_argument(
+        "--output",
+        type=Path,
+        help="Directory in which to create line-bot-<account-name> (default: current directory).",
+    )
+    setup.add_argument(
+        "--port",
+        type=int,
+        default=8000,
+        help="Local port for the generated Flask app (default: 8000).",
+    )
+    setup.add_argument(
+        "--ngrok-authtoken",
+        help="ngrok authtoken. Prefer NGROK_AUTHTOKEN or the hidden prompt instead.",
+    )
+    setup.add_argument(
+        "--skip-browser-install",
+        action="store_true",
+        help="Do not download Playwright Chromium; fail if it is unavailable.",
+    )
+    setup.add_argument(
+        "--browser-profile",
+        type=Path,
+        help="保存 LINE 登入狀態的 Playwright profile 目錄（預設為使用者的 ZEAL 資料目錄）。",
+    )
+    setup.add_argument(
+        "--keep-running",
+        action="store_true",
+        help="Keep ngrok and the Flask app running after the final confirmation.",
+    )
+    setup.set_defaults(handler=run_setup)
+
+    resume = line_bot_commands.add_parser(
+        "resume",
+        help="Finish local setup for an existing LINE Messaging API channel.",
+    )
+    resume.add_argument(
+        "--name",
+        help="Existing LINE Official Account name (asked interactively when omitted).",
+    )
+    resume.add_argument(
+        "--output",
+        type=Path,
+        help="Directory in which to create line-bot-<account-name> (default: current directory).",
+    )
+    resume.add_argument(
+        "--port",
+        type=int,
+        default=8000,
+        help="Local port for the generated Flask app (default: 8000).",
+    )
+    resume.add_argument(
+        "--webhook-url",
+        help="Reuse this public HTTPS URL instead of detecting or starting ngrok.",
+    )
+    resume.add_argument(
+        "--ngrok-authtoken",
+        help="ngrok authtoken, used only when ZEAL must start ngrok.",
+    )
+    resume.add_argument(
+        "--channel-id",
+        help="LINE Developers Console 的數字 Channel ID；提供後可自動設定 Webhook。",
+    )
+    resume.add_argument(
+        "--skip-browser-install",
+        action="store_true",
+        help="不下載 Playwright Chromium；瀏覽器尚未存在時會失敗。",
+    )
+    resume.add_argument(
+        "--browser-profile",
+        type=Path,
+        help="保存 LINE 登入狀態的 Playwright profile 目錄（預設為使用者的 ZEAL 資料目錄）。",
+    )
+    resume.add_argument(
+        "--no-browser",
+        action="store_true",
+        help="不要開啟瀏覽器，僅印出 Webhook URL 供手動設定。",
+    )
+    resume.set_defaults(handler=run_resume)
+    return parser
+
+
+def main(argv: Sequence[str] | None = None) -> None:
+    parser = build_parser()
+    args = parser.parse_args(argv)
+    args.handler(args)