aliceadv 0.1.0__tar.gz

aliceadv-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 aliceADV authors
+
+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.

aliceadv-0.1.0/MANIFEST.in

@@ -0,0 +1,15 @@
+# aliceADV 打包清单（sdist 包含项）
+# 引擎运行时模板是纯数据，必须与编译器一起发布，供 `aliceadv create` 复制。
+
+# 模板目录（index.html / style / gui / images / audio / story / documents 等）
+recursive-include src/aliceadv/template *
+
+# 引擎模板标记文件（隐藏文件，recursive-include 的 * 不会匹配点文件，需单独声明）
+include src/aliceadv/template/.aliceadv_engine
+
+# 许可证与说明（PyPI 元数据引用）
+include LICENSE
+include README.md
+
+# 测试（仅进入 sdist，不进入 wheel）
+recursive-include tests *.py

aliceadv-0.1.0/PKG-INFO

@@ -0,0 +1,128 @@
+Metadata-Version: 2.4
+Name: aliceadv
+Version: 0.1.0
+Summary: aliceADV — a Ren'Py-style web ADV (visual novel) game engine: project template + create/build compiler
+Author: AliceDrop
+Maintainer: AliceDrop
+License: MIT License
+        
+        Copyright (c) 2026 aliceADV authors
+        
+        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.
+        
+Project-URL: Homepage, https://github.com/aliceadv/engine
+Project-URL: Repository, https://github.com/aliceadv/engine
+Project-URL: Documentation, https://github.com/aliceadv/engine#readme
+Keywords: adv,visual-novel,renpy,game-engine,web,visual-novel-engine
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+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
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Games/Entertainment
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# AliceADV
+
+aliceADV is a web-based ADV (visual novel) game engine that follows the design
+language of Ren'Py. Scenes, dialogue, characters, and branching are described in
+JSON, and the engine compiles them into a static web game that runs in any browser
+with no server or runtime dependency — you can open `index.html` directly over
+`file://` or host it as a static site.
+
+The engine ships as a Python package providing a `create` / `build` command-line
+tool, plus the engine template (HTML/CSS/JS) that is assembled into each project
+at build time.
+
+> 中文说明见仓库根目录 `README_zh-CN.md`。
+
+## Installation
+
+Requires Python >= 3.9.
+
+```bash
+pip install aliceadv          # from PyPI
+# or, from a local checkout of this package directory:
+pip install ./aliceadv
+```
+
+Verify:
+
+```bash
+aliceadv --version
+# aliceADV 0.1.0 (engine v0.1)
+```
+
+## Quick start
+
+```bash
+# 1. Create a project (copies the engine template into a new directory)
+aliceadv create my_game --name "My Game"
+
+# 2. Edit theme.json (styling) and story/*.json (script)
+
+# 3. Build → <project>/dist/web/
+aliceadv build my_game
+
+# 4. Play: open my_game/dist/web/index.html, or serve it
+python3 -m http.server -d my_game/dist/web 8000
+```
+
+## Game version & engine version
+
+The game version comes from your project's `info.json` (`version` field, authored by
+you). The **engine version** is stamped by the packaged engine itself at build time
+(`aliceadv/__init__.py` → `ENGINE_NAME` / `ENGINE_VERSION`) and injected into the
+built `index.html` as `window.__ENGINE__`. Both are shown on the title page and the
+About page after a build — so you no longer maintain the engine version by hand.
+
+## Command-line reference
+
+| Command | Purpose |
+|---|---|
+| `aliceadv create <dir> [--name NAME] [--force]` | Create a project by copying the engine template. |
+| `aliceadv build <dir>` | Build a project into `<dir>/dist/web/`. |
+| `aliceadv rpy2adv <script.rpy> <images_dir> <out_dir>` | Convert a Ren'Py script into `story/` JSON. |
+| `aliceadv gui2theme <gui.rpy> <theme.json> [--apply]` | Convert Ren'Py `gui.rpy` layout into `theme.json`. |
+
+The build command refuses to run against the engine template directory itself (it
+contains the `.aliceadv_engine` marker). The engine runtime (`index.html`, `style/`)
+is **not** stored in your project — it is assembled from the engine template on every
+build, so upgrading the engine takes effect by simply rebuilding.
+
+## License
+
+Released under the [MIT License](./LICENSE).

aliceadv-0.1.0/README.md

@@ -0,0 +1,71 @@
+# AliceADV
+
+aliceADV is a web-based ADV (visual novel) game engine that follows the design
+language of Ren'Py. Scenes, dialogue, characters, and branching are described in
+JSON, and the engine compiles them into a static web game that runs in any browser
+with no server or runtime dependency — you can open `index.html` directly over
+`file://` or host it as a static site.
+
+The engine ships as a Python package providing a `create` / `build` command-line
+tool, plus the engine template (HTML/CSS/JS) that is assembled into each project
+at build time.
+
+> 中文说明见仓库根目录 `README_zh-CN.md`。
+
+## Installation
+
+Requires Python >= 3.9.
+
+```bash
+pip install aliceadv          # from PyPI
+# or, from a local checkout of this package directory:
+pip install ./aliceadv
+```
+
+Verify:
+
+```bash
+aliceadv --version
+# aliceADV 0.1.0 (engine v0.1)
+```
+
+## Quick start
+
+```bash
+# 1. Create a project (copies the engine template into a new directory)
+aliceadv create my_game --name "My Game"
+
+# 2. Edit theme.json (styling) and story/*.json (script)
+
+# 3. Build → <project>/dist/web/
+aliceadv build my_game
+
+# 4. Play: open my_game/dist/web/index.html, or serve it
+python3 -m http.server -d my_game/dist/web 8000
+```
+
+## Game version & engine version
+
+The game version comes from your project's `info.json` (`version` field, authored by
+you). The **engine version** is stamped by the packaged engine itself at build time
+(`aliceadv/__init__.py` → `ENGINE_NAME` / `ENGINE_VERSION`) and injected into the
+built `index.html` as `window.__ENGINE__`. Both are shown on the title page and the
+About page after a build — so you no longer maintain the engine version by hand.
+
+## Command-line reference
+
+| Command | Purpose |
+|---|---|
+| `aliceadv create <dir> [--name NAME] [--force]` | Create a project by copying the engine template. |
+| `aliceadv build <dir>` | Build a project into `<dir>/dist/web/`. |
+| `aliceadv rpy2adv <script.rpy> <images_dir> <out_dir>` | Convert a Ren'Py script into `story/` JSON. |
+| `aliceadv gui2theme <gui.rpy> <theme.json> [--apply]` | Convert Ren'Py `gui.rpy` layout into `theme.json`. |
+
+The build command refuses to run against the engine template directory itself (it
+contains the `.aliceadv_engine` marker). The engine runtime (`index.html`, `style/`)
+is **not** stored in your project — it is assembled from the engine template on every
+build, so upgrading the engine takes effect by simply rebuilding.
+
+## License
+
+Released under the [MIT License](./LICENSE).

aliceadv-0.1.0/pyproject.toml

@@ -0,0 +1,63 @@
+[build-system]
+requires = ["setuptools>=64"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "aliceadv"
+version = "0.1.0"
+description = "aliceADV — a Ren'Py-style web ADV (visual novel) game engine: project template + create/build compiler"
+readme = "README.md"
+requires-python = ">=3.6"
+license = { file = "LICENSE" }
+keywords = ["adv", "visual-novel", "renpy", "game-engine", "web", "visual-novel-engine"]
+authors = [
+    { name = "AliceDrop" },
+]
+maintainers = [
+    { name = "AliceDrop" },
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Web Environment",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.6",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Games/Entertainment",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/aliceadv/engine"
+Repository = "https://github.com/aliceadv/engine"
+Documentation = "https://github.com/aliceadv/engine#readme"
+
+[project.optional-dependencies]
+dev = ["pytest", "build", "twine"]
+
+[project.scripts]
+aliceadv = "aliceadv.cli:main"
+
+# 模板（index.html / style / gui / images / audio / story / documents 等）
+# 是纯数据，与编译器实现解耦：将来用其他语言重写编译器时直接复用该目录。
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools]
+include-package-data = true
+
+# 显式声明包内数据文件，确保 wheel 与 sdist 都带上模板（含隐藏标记文件）。
+[tool.setuptools.package-data]
+aliceadv = [
+    "template/**/*",
+    "template/.aliceadv_engine",
+]

aliceadv-0.1.0/setup.cfg

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

aliceadv-0.1.0/src/aliceadv/__init__.py

@@ -0,0 +1,50 @@
+# =========================================================
+# aliceADV — 网页 ADV 游戏引擎（工程模板 + 创建/构建编译器）
+#
+# 包结构（模板与编译器实现分离）：
+#   aliceadv/template/   引擎模板（纯数据：index.html / style / gui / story / ...）
+#   aliceadv/creator.py  工程创建：模板 → 用户工程目录
+#   aliceadv/builder.py  构建：工程目录 → <工程>/dist/web/
+#   aliceadv/cli.py      `aliceadv` 命令行入口（create / build / rpy2adv / gui2theme）
+#
+# 模板目录单独存放、不含任何 Python 代码：将来若把编译器移植到其他语言，
+# 只需复用 template/ 目录与同一套 CLI 语义，不必动模板内容。
+# 模板位置可通过环境变量 ALICEADV_TEMPLATE 覆盖（指向任意的模板目录）。
+# =========================================================
+import os
+
+__version__ = "0.1.0"
+ENGINE_VERSION = "v0.1"
+ENGINE_NAME = "aliceADV"
+
+# 引擎（模板）目录标记：存在该文件的目录是引擎模板本身，禁止对其直接 build。
+ENGINE_MARKER = ".aliceadv_engine"
+
+# 引擎运行时文件：只存在于模板中，不复制进用户工程目录。
+# 构建时由 builder 从模板装配到 dist/web/。
+ENGINE_RUNTIME = ("index.html", "style")
+
+
+def template_path():
+    """返回引擎模板目录。
+
+    优先读环境变量 ALICEADV_TEMPLATE（允许外部指定另一份模板，
+    供其他语言实现的编译器或自定义模板复用）；缺省用包内 template/。
+    """
+    env = os.environ.get("ALICEADV_TEMPLATE")
+    if env:
+        return os.path.abspath(env)
+    return os.path.join(os.path.dirname(os.path.abspath(__file__)), "template")
+
+
+from .creator import create_project
+from .builder import build_project
+
+__all__ = [
+    "create_project",
+    "build_project",
+    "template_path",
+    "__version__",
+    "ENGINE_VERSION",
+    "ENGINE_NAME",
+]

aliceadv-0.1.0/src/aliceadv/__main__.py

@@ -0,0 +1,5 @@
+import sys
+
+from .cli import main
+
+sys.exit(main())