nova-forge 0.1.0__tar.gz

nova_forge-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 单保录 (eagleye-china)
+
+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.

nova_forge-0.1.0/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: nova-forge
+Version: 0.1.0
+Summary: The ultimate project forging tool for PySide6 ecosystems. Scaffold enterprise-grade architectures in seconds.
+Author-email: eagleye-china <zdt168@sina.cn>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/eagleye-china/Nova-Forge
+Project-URL: Repository, https://github.com/eagleye-china/Nova-Forge
+Project-URL: Issues, https://github.com/eagleye-china/Nova-Forge/issues
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: build>=1.0.0
+Requires-Dist: twine>=5.0.0
+Dynamic: license-file
+
+# Nova-Forge 🛠️
+
+> **The ultimate project forging tool for PySide6 ecosystems. Scaffold enterprise-grade architectures in seconds.**
+
+**English** | [简体中文](https://github.com/eagleye-china/Nova-Forge/blob/main/README_zh.md)
+
+[![PyPI version](https://img.shields.io/pypi/v/nova-forge?color=blue&label=PyPI)](https://pypi.org/project/nova-forge/)
+[![Python Version](https://img.shields.io/pypi/pyversions/nova-forge)](https://pypi.org/project/nova-forge/)
+[![License](https://img.shields.io/badge/license-MIT-green)](https://github.com/eagleye-china/Nova-Forge/blob/main/LICENSE)
+[![GitHub Stars](https://img.shields.io/github/stars/eagleye-china/Nova-Forge?style=social)](https://github.com/eagleye-china/Nova-Forge)
+
+**Nova-Forge** is a blazing-fast CLI scaffolding tool designed to eliminate the boilerplate of modern Python desktop applications. 
+
+Stop copying and pasting `pyproject.toml`, fumbling with MIT licenses, or manually creating hundreds of folders. With a single command, Nova-Forge generates a complete, production-ready `src-layout` project equipped with CI/CD, bilingual docs, and PyPI packaging scripts.
+
+## ✨ Features
+
+- 🚀 **`nova-forge init`**: Generates `pyproject.toml`, bilingual `README.md`, `LICENSE`, and a GitHub Actions workflow for automatic PyPI publishing.
+- 🌲 **`nova-forge tree`**: Builds an entire directory structure instantly from a simple text-based tree diagram.
+- 🤖 **AI-Ready**: Perfect for pairing with AI coding assistants (like DeepSeek or ChatGPT) to instantly materialize AI-generated architectures.
+
+## 📦 Installation
+
+```bash
+pip install nova-forge
+```
+
+## 🛠️ Usage
+
+### 1. Initialize Project Configuration
+Run this in your empty project folder. It will interactively ask for your project details and generate all necessary metadata.
+
+```bash
+nova-forge init
+```
+
+### 2. Build Directory Structure
+Got a project layout from your AI architect? Paste it into `project_structure.txt`:
+
+```text
+my-awesome-app/
+├── src/
+│   └── my_awesome_app/
+│       ├── __init__.py
+│       └── main.py
+└── examples/
+```
+
+Then run:
+
+```bash
+nova-forge tree
+```
+
+*Boom! Your entire folder structure is created with auto-generated `__init__.py` and boilerplate code.*
+
+## 📜 License
+
+MIT License. See [LICENSE](https://github.com/eagleye-china/Nova-Forge/blob/main/LICENSE) for details.

nova_forge-0.1.0/README.md

@@ -0,0 +1,59 @@
+# Nova-Forge 🛠️
+
+> **The ultimate project forging tool for PySide6 ecosystems. Scaffold enterprise-grade architectures in seconds.**
+
+**English** | [简体中文](https://github.com/eagleye-china/Nova-Forge/blob/main/README_zh.md)
+
+[![PyPI version](https://img.shields.io/pypi/v/nova-forge?color=blue&label=PyPI)](https://pypi.org/project/nova-forge/)
+[![Python Version](https://img.shields.io/pypi/pyversions/nova-forge)](https://pypi.org/project/nova-forge/)
+[![License](https://img.shields.io/badge/license-MIT-green)](https://github.com/eagleye-china/Nova-Forge/blob/main/LICENSE)
+[![GitHub Stars](https://img.shields.io/github/stars/eagleye-china/Nova-Forge?style=social)](https://github.com/eagleye-china/Nova-Forge)
+
+**Nova-Forge** is a blazing-fast CLI scaffolding tool designed to eliminate the boilerplate of modern Python desktop applications. 
+
+Stop copying and pasting `pyproject.toml`, fumbling with MIT licenses, or manually creating hundreds of folders. With a single command, Nova-Forge generates a complete, production-ready `src-layout` project equipped with CI/CD, bilingual docs, and PyPI packaging scripts.
+
+## ✨ Features
+
+- 🚀 **`nova-forge init`**: Generates `pyproject.toml`, bilingual `README.md`, `LICENSE`, and a GitHub Actions workflow for automatic PyPI publishing.
+- 🌲 **`nova-forge tree`**: Builds an entire directory structure instantly from a simple text-based tree diagram.
+- 🤖 **AI-Ready**: Perfect for pairing with AI coding assistants (like DeepSeek or ChatGPT) to instantly materialize AI-generated architectures.
+
+## 📦 Installation
+
+```bash
+pip install nova-forge
+```
+
+## 🛠️ Usage
+
+### 1. Initialize Project Configuration
+Run this in your empty project folder. It will interactively ask for your project details and generate all necessary metadata.
+
+```bash
+nova-forge init
+```
+
+### 2. Build Directory Structure
+Got a project layout from your AI architect? Paste it into `project_structure.txt`:
+
+```text
+my-awesome-app/
+├── src/
+│   └── my_awesome_app/
+│       ├── __init__.py
+│       └── main.py
+└── examples/
+```
+
+Then run:
+
+```bash
+nova-forge tree
+```
+
+*Boom! Your entire folder structure is created with auto-generated `__init__.py` and boilerplate code.*
+
+## 📜 License
+
+MIT License. See [LICENSE](https://github.com/eagleye-china/Nova-Forge/blob/main/LICENSE) for details.

nova_forge-0.1.0/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["setuptools>=68.2", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "nova-forge"
+version = "0.1.0"
+description = "The ultimate project forging tool for PySide6 ecosystems. Scaffold enterprise-grade architectures in seconds."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [{ name = "eagleye-china", email = "zdt168@sina.cn" }]
+classifiers = [
+    "Programming Language :: Python :: 3.10",
+    "Operating System :: OS Independent",
+    "Environment :: Console",
+    "Topic :: Software Development :: Code Generators",
+]
+# ✅ 补全依赖，因为生成的脚本需要 build 和 twine 来发版
+dependencies = [
+    "build>=1.0.0",
+    "twine>=5.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/eagleye-china/Nova-Forge"
+Repository = "https://github.com/eagleye-china/Nova-Forge"
+Issues = "https://github.com/eagleye-china/Nova-Forge/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["nova_forge*"]
+
+# ✅ 核心：注册全局命令
+[project.scripts]
+nova-forge = "nova_forge.cli:main"

nova_forge-0.1.0/setup.cfg

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

nova_forge-0.1.0/src/nova_forge/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

nova_forge-0.1.0/src/nova_forge/cli.py

@@ -0,0 +1,30 @@
+import argparse
+from pathlib import Path
+
+from .core.scaffolder import run_scaffolder
+from .core.tree_builder import run_tree_builder
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Nova-Forge: 企业级项目锻造炉")
+    subparsers = parser.add_subparsers(dest="command", help="可用命令")
+
+    # 命令 1: 初始化配置 (原来的 nova_forge)
+    subparsers.add_parser("init", help="初始化项目配置文件 (pyproject, README, LICENSE 等)")
+
+    # 命令 2: 根据 txt 生成目录树 (原来的 nova_tree)
+    tree_parser = subparsers.add_parser("tree", help="根据 project_structure.txt 生成项目目录")
+    tree_parser.add_argument("-f", "--file", default="project_structure.txt", help="指定结构树文件")
+
+    args = parser.parse_args()
+
+    if args.command == "init":
+        run_scaffolder()
+    elif args.command == "tree":
+        run_tree_builder(Path(args.file))
+    else:
+        parser.print_help()
+
+
+if __name__ == "__main__":
+    main()

nova_forge-0.1.0/src/nova_forge/core/scaffolder.py

@@ -0,0 +1,91 @@
+# src/nova_forge/core/scaffolder.py
+import datetime
+import os
+from string import Template
+
+# ✅ 从 templates.py 导入所有模版
+from .templates import (
+    DEFAULT_GITHUB_USER, DEFAULT_REAL_NAME, DEFAULT_DESC_EN, DEFAULT_DESC_ZH, DEFAULT_DEPS,
+    PYPROJECT_TMPL, LICENSE_TMPL, README_EN_TMPL, README_ZH_TMPL,
+    CHANGELOG_TMPL, INIT_PY_TMPL, WORKFLOW_TMPL, GITIGNORE_TMPL,
+    INIT_GIT_TMPL, BUILD_PROD_TMPL, CB
+)
+
+
+def ask(prompt, default):
+    res = input(f"{prompt} [{default}]: ").strip()
+    return res if res else default
+
+
+def run_scaffolder():
+    print("🔥 欢迎使用 Nova-Forge 终极项目锻造炉\n")
+
+    # 1. 收集信息
+    project_name = ask("📦 项目名 (PyPI包名, 如 nova-chat)", "my-awesome-project")
+    repo_name = ask("📁 GitHub仓库名 (如 Nova-Agent)", project_name)
+    github_user = ask("👤 GitHub用户名", DEFAULT_GITHUB_USER)
+    real_name = ask("✍️ 真实姓名 (用于 LICENSE)", DEFAULT_REAL_NAME)
+    desc_en = ask("🇬🇧 英文描述", DEFAULT_DESC_EN)
+    desc_zh = ask("🇨🇳 中文描述", DEFAULT_DESC_ZH)
+
+    year = datetime.datetime.now().year
+    month = datetime.datetime.now().strftime("%m")
+    day = datetime.datetime.now().strftime("%d")
+    module_name = project_name.replace('-', '_')
+
+    # 用于注入的全局字典
+    context = {
+        "PROJECT_NAME": project_name,
+        "REPO_NAME": repo_name,
+        "GITHUB_USER": github_user,
+        "REAL_NAME": real_name,
+        "DESC_EN": desc_en,
+        "DESC_ZH": desc_zh,
+        "YEAR": year,
+        "MONTH": month,
+        "DAY": day,
+        "MODULE_NAME": module_name,
+        "DEPS": DEFAULT_DEPS,
+        "CB": CB  # ✅ 核心：将防截断的反引号传入
+    }
+
+    def write_file(path, tmpl_string, custom_context=None):
+        """通用写文件函数"""
+        ctx = {**context, **(custom_context or {})}
+        content = Template(tmpl_string).safe_substitute(ctx)
+        path = Template(path).safe_substitute(ctx)
+
+        if not path.endswith("/"):
+            os.makedirs(os.path.dirname(path) or ".", exist_ok=True)
+        else:
+            os.makedirs(path, exist_ok=True)
+
+        if not path.endswith("/"):
+            with open(path, "w", encoding="utf-8") as f:
+                f.write(content)
+            print(f"✅ 已生成: {path}")
+
+    # 2. 执行生成
+    write_file("pyproject.toml", PYPROJECT_TMPL)
+    write_file("LICENSE", LICENSE_TMPL)
+    write_file("README.md", README_EN_TMPL)
+    write_file("README_zh.md", README_ZH_TMPL)
+    write_file("CHANGELOG.md", CHANGELOG_TMPL)
+    write_file(".gitignore", GITIGNORE_TMPL)
+
+    # 骨架文件
+    os.makedirs("src", exist_ok=True)
+    write_file("src/$MODULE_NAME/__init__.py", INIT_PY_TMPL)
+
+    # 工具脚本
+    write_file("init_git.py", INIT_GIT_TMPL)
+    write_file("build_prod.bat", BUILD_PROD_TMPL)
+    write_file(".github/workflows/publish.yml", WORKFLOW_TMPL)
+
+    # 空的 project_structure.txt
+    with open("project_structure.txt", "w", encoding="utf-8") as f:
+        pass
+    print("✅ 已生成: project_structure.txt (空文件)")
+
+    print("\n🎉 企业级全家桶生成完毕！")
+    print("👉 已包含：动态版本号、CHANGELOG、GitHub Actions 自动发版！")

nova_forge-0.1.0/src/nova_forge/core/templates.py

@@ -0,0 +1,332 @@
+# -*- coding: utf-8 -*-
+"""
+Nova-Forge 模版库
+集中管理所有的文件生成模版，保持 scaffolder.py 的整洁。
+"""
+
+# ==================== 默认配置 ====================
+DEFAULT_GITHUB_USER = "eagleye-china"
+DEFAULT_REAL_NAME = "单保录"
+DEFAULT_DESC_EN = "A stunning, GPU-accelerated desktop application for PySide6."
+DEFAULT_DESC_ZH = "基于 PySide6 和 QML 打造的炫酷桌面级应用框架。"
+DEFAULT_DEPS = '["PySide6>=6.6", "openai>=1.0", "markdown>=3.5"]'
+
+# ✅ 核心防截断变量
+CB = "`" * 3
+
+# ==================== pyproject.toml ====================
+PYPROJECT_TMPL = """# ==========================================================
+# 🚀 $PROJECT_NAME 企业级打包配置
+# ==========================================================
+[build-system]
+requires = ["setuptools>=68.2", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "$PROJECT_NAME"
+version = "0.1.0"
+description = "$DESC_EN"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [{ name = "$GITHUB_USER", email = "zdt168@sina.cn" }]
+dependencies = $DEPS
+
+[project.urls]
+Homepage = "https://github.com/$GITHUB_USER/$REPO_NAME"
+Repository = "https://github.com/$GITHUB_USER/$REPO_NAME"
+Issues = "https://github.com/$GITHUB_USER/$REPO_NAME/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+"$MODULE_NAME" = [
+    "ui/*.qml",
+    "qml/*.qml",
+    "resources/*"
+]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "W", "UP", "B", "C4", "SIM"]
+ignore = ["N802", "E501"]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+ignore_missing_imports = true
+"""
+
+# ==================== LICENSE ====================
+LICENSE_TMPL = """MIT License
+
+Copyright (c) $YEAR $REAL_NAME ($GITHUB_USER)
+
+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.
+"""
+
+# ==================== README.md ====================
+README_EN_TMPL = """# $PROJECT_NAME 🌟
+
+> **$DESC_EN**
+
+**English** | [简体中文](https://github.com/$GITHUB_USER/$REPO_NAME/blob/main/README_zh.md)
+
+[![PyPI version](https://img.shields.io/pypi/v/$PROJECT_NAME?color=blue&label=PyPI)](https://pypi.org/project/$PROJECT_NAME/)
+[![Python Version](https://img.shields.io/pypi/pyversions/$PROJECT_NAME)](https://pypi.org/project/$PROJECT_NAME/)
+[![License](https://img.shields.io/badge/license-MIT-green)](https://github.com/$GITHUB_USER/$REPO_NAME/blob/main/LICENSE)
+[![GitHub Stars](https://img.shields.io/github/stars/$GITHUB_USER/$REPO_NAME?style=social)](https://github.com/$GITHUB_USER/$REPO_NAME)
+
+## 🤔 Why $PROJECT_NAME?
+
+- 🚀 **Blazing Fast**: Built with pure PySide6 and QML.
+- 🎨 **Stunning UI**: Native dark mode, smooth animations.
+
+## 📦 Installation
+
+${CB}bash
+pip install $PROJECT_NAME
+${CB}
+
+## 🚀 Quick Start
+
+${CB}python
+from $MODULE_NAME import __version__
+print(f"Version: {__version__}")
+${CB}
+
+## 📜 License
+
+MIT License. See [LICENSE](https://github.com/$GITHUB_USER/$REPO_NAME/blob/main/LICENSE).
+"""
+
+# ==================== README_zh.md ====================
+README_ZH_TMPL = """# $PROJECT_NAME 🌟
+
+> **$DESC_ZH**
+
+[English](https://github.com/$GITHUB_USER/$REPO_NAME/blob/main/README.md) | **简体中文**
+
+[![PyPI version](https://img.shields.io/pypi/v/$PROJECT_NAME?color=blue&label=PyPI)](https://pypi.org/project/$PROJECT_NAME/)
+[![Python Version](https://img.shields.io/pypi/pyversions/$PROJECT_NAME)](https://pypi.org/project/$PROJECT_NAME/)
+[![License](https://img.shields.io/badge/license-MIT-green)](https://github.com/$GITHUB_USER/$REPO_NAME/blob/main/LICENSE)
+[![GitHub Stars](https://img.shields.io/github/stars/$GITHUB_USER/$REPO_NAME?style=social)](https://github.com/$GITHUB_USER/$REPO_NAME)
+
+## 🤔 为什么选择 $PROJECT_NAME？
+
+- 🚀 **极致性能**：基于原生 PySide6 和 QML，拒绝笨重的 WebView。
+- 🎨 **顶级颜值**：原生暗黑模式，丝滑动画，像素级布局。
+
+## 📦 安装
+
+${CB}bash
+pip install $PROJECT_NAME
+${CB}
+
+## 📜 开源协议
+
+MIT License。
+"""
+
+# ==================== CHANGELOG.md ====================
+CHANGELOG_TMPL = """# Changelog
+所有版本变更记录，遵循 [Semantic Versioning](https://semver.org/) 规范。
+
+## [0.1.0] - $YEAR-$MONTH-$DAY
+### ✨ Features
+- 初始版本发布，搭建完整的企业级工程骨架。
+- 完成 PyPI 和 GitHub 的发版流水线配置。
+"""
+
+# ==================== __init__.py ====================
+INIT_PY_TMPL = """# -*- coding: utf-8 -*-
+from importlib.metadata import version, PackageNotFoundError
+
+try:
+    __version__: str = version("$PROJECT_NAME")
+except PackageNotFoundError:
+    __version__ = "0.1.0"
+
+__all__ = ["__version__"]
+"""
+
+# ==================== GitHub Actions ====================
+WORKFLOW_TMPL = """name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.10'
+    - name: Build package
+      run: |
+        python -m pip install --upgrade pip
+        pip install build
+        python -m build
+    - name: Publish to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+"""
+
+# ==================== .gitignore ====================
+GITIGNORE_TMPL = """# Python
+__pycache__/
+*.py[cod]
+build/
+dist/
+*.egg-info/
+
+# IDE
+.idea/
+.vscode/
+.DS_Store
+
+# Environments
+.env
+.venv
+venv/
+"""
+
+# ==================== init_git.py ====================
+INIT_GIT_TMPL = """import os
+import re
+import subprocess
+import sys
+from pathlib import Path
+
+GITHUB_USER = "$GITHUB_USER"
+
+def run(cmd, ignore_error=False):
+    print(f"👉 正在执行: {' '.join(cmd)}")
+    result = subprocess.run(cmd, capture_output=True, text=True)
+    if result.returncode != 0 and not ignore_error:
+        print(f"❌ 错误: {result.stderr}")
+        raise RuntimeError(result.stderr)
+    if result.stdout.strip():
+        print(result.stdout.strip())
+    return result
+
+def get_project_info():
+    current_dir = Path.cwd()
+    # ✅ 修复：直接使用生成时写死的 REPO_NAME，防止路径错乱
+    repo_name = "$REPO_NAME"
+    project_name = "$PROJECT_NAME"
+    version = "0.1.0"
+    toml_path = current_dir / "pyproject.toml"
+    if toml_path.exists():
+        with open(toml_path, "r", encoding="utf-8") as f:
+            content = f.read()
+            # ✅ 修复正则转义问题
+            name_match = re.search(r'name\s*=\s*["\']([^"\']+)["\']', content)
+            if name_match: project_name = name_match.group(1)
+
+            version_match = re.search(r'version\s*=\s*["\']([^"\']+)["\']', content)
+            if version_match: version = version_match.group(1)
+    return repo_name, project_name, version
+
+def main():
+    repo_name, project_name, version = get_project_info()
+    remote_url = f"git@github.com:{GITHUB_USER}/{repo_name}.git"
+    tag_name = f"v{version}"
+
+    print(f"🚀 开始自动初始化并发布【{project_name}】 (v{version})...")
+
+    if not os.path.exists(".git"):
+        run(["git", "init"])
+        run(["git", "branch", "-M", "main"])
+        run(["git", "config", "core.autocrlf", "false"])
+        run(["git", "add", "."])
+        run(["git", "commit", "-m", f"feat: initial release of {project_name} v{version}"])
+        print("✅ 本地 Git 初始化完成！")
+    else:
+        print("✅ 已检测到 Git 仓库，跳过初始化。")
+
+    try:
+        remotes = subprocess.run(["git", "remote"], capture_output=True, text=True).stdout
+        if "origin" not in remotes:
+            run(["git", "remote", "add", "origin", remote_url])
+            print(f"✅ 已关联远程仓库: {remote_url}")
+        else:
+            current_url = subprocess.run(["git", "remote", "get-url", "origin"], capture_output=True, text=True).stdout.strip()
+            if current_url != remote_url:
+                run(["git", "remote", "set-url", "origin", remote_url])
+                print(f"✅ 已更新远程仓库地址: {remote_url}")
+            else:
+                print(f"✅ 远程仓库已配置正确，无需修改。")
+    except Exception as e:
+        print(f"❌ 配置远程仓库失败: {e}")
+
+    print("\\n📤 正在推送代码到 GitHub...")
+    try:
+        run(["git", "push", "-f", "-u", "origin", "main"])
+        print("✅ 代码推送成功！")
+    except RuntimeError:
+        print("❌ 推送失败，请检查 SSH Key 或网络连接！")
+        sys.exit(1)
+
+    print(f"\\n🏷️ 准备发布版本 {tag_name}...")
+    try:
+        tags = subprocess.run(["git", "tag"], capture_output=True, text=True).stdout
+        if tag_name not in tags.split():
+            run(["git", "tag", tag_name])
+            print(f"✅ 标签 {tag_name} 创建成功。")
+        else:
+            print(f"✅ 标签 {tag_name} 已存在。")
+        run(["git", "push", "origin", tag_name])
+        print(f"🚀 标签 {tag_name} 推送成功！GitHub Actions 发版流水线已触发！")
+    except Exception as e:
+        print(f"❌ 标签推送失败: {e}")
+
+    print("\\n🎉 全自动发布流程结束！请前往 GitHub 的 Actions 页面查看发版进度。")
+
+if __name__ == "__main__":
+    main()
+"""
+
+# ==================== build_prod.bat ====================
+BUILD_PROD_TMPL = """@echo off
+chcp 65001 >nul
+echo =========================================
+echo       $PROJECT_NAME 打包与发布
+echo =========================================
+
+if exist dist rmdir /s /q dist
+if exist build rmdir /s /q build
+if exist src\\*.egg-info rmdir /s /q src\\*.egg-info
+
+python -m build
+python -m twine check dist/*
+python -m twine upload dist/*
+pause
+"""

nova_forge-0.1.0/src/nova_forge/core/tree_builder.py

@@ -0,0 +1,248 @@
+# -*- coding: utf-8 -*-
+"""
+Nova Tree 🌲
+============
+项目目录结构生成器 (完美防套娃、智能识别版)
+根据同目录下的 `project_structure.txt`，一键生成完整的工程目录。
+"""
+import re
+from dataclasses import dataclass, field
+from pathlib import Path
+
+
+# ==========================================
+# 📦 数据模型
+# ==========================================
+@dataclass(slots=True)
+class Node:
+    name: str
+    is_dir: bool
+    level: int = 0
+    children: list["Node"] = field(default_factory=list)
+
+    def add_child(self, child: "Node") -> None:
+        self.children.append(child)
+
+
+@dataclass(slots=True)
+class BuildResult:
+    created_dirs: list[Path] = field(default_factory=list)
+    created_files: list[Path] = field(default_factory=list)
+    skipped: list[Path] = field(default_factory=list)
+    failed: list[tuple[Path, str]] = field(default_factory=list)
+
+    def summary(self) -> str:
+        return (
+            f"📁 新建目录: {len(self.created_dirs)} | "
+            f"📄 新建文件: {len(self.created_files)} | "
+            f"⏭️ 跳过已存在: {len(self.skipped)} | "
+            f"❌ 失败: {len(self.failed)}"
+        )
+
+
+# ==========================================
+# 🔍 结构解析器
+# ==========================================
+class StructureParser:
+    _TREE_MARKERS = ("├── ", "└── ", "├─ ", "└─ ", "|--- ", "|-- ", "└─ ")
+    _INDENT_CHARS = set("│ ├└─|")
+
+    def parse(self, text: str) -> list[Node]:
+        roots: list[Node] = []
+        stack: list[tuple[int, Node]] = []
+
+        for raw in text.splitlines():
+            parsed = self._parse_line(raw)
+            if parsed is None:
+                continue
+
+            level, name, is_dir = parsed
+            node = Node(name=name, is_dir=is_dir, level=level)
+
+            while stack and stack[-1][0] >= level:
+                stack.pop()
+
+            if stack:
+                stack[-1][1].add_child(node)
+            else:
+                roots.append(node)
+
+            stack.append((level, node))
+
+        return roots
+
+    def _parse_line(self, line: str) -> tuple[int, str, bool] | None:
+        line = line.rstrip()
+        if not line.strip() or all(c in "│ ├└─|" for c in line.strip()):
+            return None
+        if "|" in line and not any(m in line for m in self._TREE_MARKERS):
+            return None
+        if line.lstrip().startswith(("```", "---", "===")):
+            return None
+
+        for marker in self._TREE_MARKERS:
+            idx = line.find(marker)
+            if idx >= 0:
+                prefix = line[:idx]
+                if all(ch in self._INDENT_CHARS for ch in prefix):
+                    level = idx // 4 + 1
+                    name = line[idx + len(marker):]
+                    clean_name = self._clean_name(name)
+                    if clean_name:
+                        return level, clean_name, self._is_dir(name)
+
+        if line[0].isspace() and not line.lstrip().startswith(("def ", "class ", "import ", "from ", "@")):
+            stripped = line.lstrip()
+            level = (len(line) - len(stripped)) // 4
+            clean_name = self._clean_name(stripped)
+            if clean_name:
+                return level, clean_name, self._is_dir(stripped)
+
+        clean_name = self._clean_name(line)
+        if clean_name:
+            return 0, clean_name, self._is_dir(line)
+
+        return None
+
+    @staticmethod
+    def _clean_name(name: str) -> str:
+        name = name.split("#")[0].strip()
+        name = name.rstrip("/\\:").strip()
+        name = re.sub(r'[<>:"|?*]', '_', name)
+        return name.strip()
+
+    @staticmethod
+    def _is_dir(name: str) -> bool:
+        name = name.rstrip()
+        if name.endswith(("/", "\\")):
+            return True
+        last = name.split("/")[-1].split("\\")[-1]
+        return "." not in last
+
+
+# ==========================================
+# 🛠️ 项目构建器
+# ==========================================
+class ProjectBuilder:
+    def build(self, roots: list[Node], target: Path):
+        result = BuildResult()
+        target = Path(target).resolve()
+
+        current_dir_name = target.name
+        nodes_to_walk = []
+        real_root = target
+
+        # ✅ 核心逻辑 1：智能防套娃
+        if len(roots) == 1 and roots[0].is_dir:
+            if roots[0].name == current_dir_name:
+                print(f"🔍 检测到当前目录名与根节点名一致 ('{current_dir_name}')，跳过根目录创建，直接生成子结构。")
+                nodes_to_walk = roots[0].children
+            else:
+                print(f"🔍 根节点名 ('{roots[0].name}') 与当前目录 ('{current_dir_name}') 不一致，将创建新根节点。")
+                real_root = target / roots[0].name
+                real_root.mkdir(parents=True, exist_ok=True)
+                nodes_to_walk = roots[0].children
+        else:
+            print(f"🔍 检测到多个顶级节点或散落文件，直接在当前目录生成。")
+            nodes_to_walk = roots
+
+        # 1. 递归生成节点
+        for node in nodes_to_walk:
+            self._create_node(node, real_root, result)
+
+        return result
+
+    def _create_node(self, node: Node, parent: Path, result: BuildResult):
+        path = parent / node.name
+
+        if node.is_dir:
+            if not path.exists():
+                path.mkdir(parents=True, exist_ok=True)
+                result.created_dirs.append(path)
+            else:
+                result.skipped.append(path)
+
+            # 自动补全 __init__.py (如果是 Python 包且有子节点)
+            if node.children and not any(c.name == "__init__.py" for c in node.children):
+                init_file = path / "__init__.py"
+                self._write_file(init_file, "", result)
+
+            for child in node.children:
+                self._create_node(child, path, result)
+        else:
+            self._write_file(path, "", result)
+
+    def _write_file(self, path: Path, content: str, result: BuildResult):
+        if path.exists():
+            result.skipped.append(path)
+            return
+
+        path.parent.mkdir(parents=True, exist_ok=True)
+        if not content:
+            content = self._default_content(path)
+
+        try:
+            path.write_text(content, encoding="utf-8")
+            result.created_files.append(path)
+        except Exception as e:
+            result.failed.append((path, str(e)))
+
+    @staticmethod
+    def _default_content(path: Path) -> str:
+        name = path.name
+        suffix = path.suffix.lower()
+
+        if name == "__init__.py": return ""
+        if suffix == ".py":
+            return f'# -*- coding: utf-8 -*-\n# {path.stem}.py\n\n'
+        if suffix == ".md":
+            return f"# {path.stem}\n\n> 文档生成中...\n"
+        if suffix == ".qrc":
+            return '<RCC>\n    <qresource prefix="/">\n    </qresource>\n</RCC>\n'
+        if suffix == ".qml":
+            return 'import QtQuick\n\nItem {\n    width: 100\n    height: 100\n}\n'
+        return ""
+
+
+# ==========================================
+# 🚀 主程序入口
+# ==========================================
+# ==========================================
+# 🚀 主程序入口 (改造为可传参函数)
+# ==========================================
+def run_tree_builder(file_path: Path):
+    # 确保传入的是 Path 对象
+    file_path = Path(file_path)
+
+    # ✅ 核心逻辑 2：空文件与缺失检测
+    if not file_path.exists():
+        print(f"❌ 错误: 找不到 [{file_path.name}] 文件！")
+        print("💡 请先创建该文件并填入目录树。")
+        return
+
+    content = file_path.read_text(encoding="utf-8").strip()
+    if not content:
+        print(f"❌ 错误: [{file_path.name}] 文件内容为空！")
+        print("💡 请写入类似以下的格式：\n项目名/\n├── src/\n│   └── main.py")
+        return
+
+    print("🔥 启动 Nova Tree 终极结构生成器...\n")
+
+    parser = StructureParser()
+    roots = parser.parse(content)
+
+    if not roots:
+        print("❌ 错误: 未能解析出有效目录，请检查 txt 语法格式。")
+        return
+
+    builder = ProjectBuilder()
+    result = builder.build(roots, target=Path.cwd())
+
+    print("\n" + "=" * 40)
+    print("🎉 构建执行完毕！")
+    print(result.summary())
+    if result.failed:
+        print("\n❌ 失败列表:")
+        for path, err in result.failed:
+            print(f"  - {path}: {err}")
+    print("=" * 40)

nova_forge-0.1.0/src/nova_forge.egg-info/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: nova-forge
+Version: 0.1.0
+Summary: The ultimate project forging tool for PySide6 ecosystems. Scaffold enterprise-grade architectures in seconds.
+Author-email: eagleye-china <zdt168@sina.cn>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/eagleye-china/Nova-Forge
+Project-URL: Repository, https://github.com/eagleye-china/Nova-Forge
+Project-URL: Issues, https://github.com/eagleye-china/Nova-Forge/issues
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: build>=1.0.0
+Requires-Dist: twine>=5.0.0
+Dynamic: license-file
+
+# Nova-Forge 🛠️
+
+> **The ultimate project forging tool for PySide6 ecosystems. Scaffold enterprise-grade architectures in seconds.**
+
+**English** | [简体中文](https://github.com/eagleye-china/Nova-Forge/blob/main/README_zh.md)
+
+[![PyPI version](https://img.shields.io/pypi/v/nova-forge?color=blue&label=PyPI)](https://pypi.org/project/nova-forge/)
+[![Python Version](https://img.shields.io/pypi/pyversions/nova-forge)](https://pypi.org/project/nova-forge/)
+[![License](https://img.shields.io/badge/license-MIT-green)](https://github.com/eagleye-china/Nova-Forge/blob/main/LICENSE)
+[![GitHub Stars](https://img.shields.io/github/stars/eagleye-china/Nova-Forge?style=social)](https://github.com/eagleye-china/Nova-Forge)
+
+**Nova-Forge** is a blazing-fast CLI scaffolding tool designed to eliminate the boilerplate of modern Python desktop applications. 
+
+Stop copying and pasting `pyproject.toml`, fumbling with MIT licenses, or manually creating hundreds of folders. With a single command, Nova-Forge generates a complete, production-ready `src-layout` project equipped with CI/CD, bilingual docs, and PyPI packaging scripts.
+
+## ✨ Features
+
+- 🚀 **`nova-forge init`**: Generates `pyproject.toml`, bilingual `README.md`, `LICENSE`, and a GitHub Actions workflow for automatic PyPI publishing.
+- 🌲 **`nova-forge tree`**: Builds an entire directory structure instantly from a simple text-based tree diagram.
+- 🤖 **AI-Ready**: Perfect for pairing with AI coding assistants (like DeepSeek or ChatGPT) to instantly materialize AI-generated architectures.
+
+## 📦 Installation
+
+```bash
+pip install nova-forge
+```
+
+## 🛠️ Usage
+
+### 1. Initialize Project Configuration
+Run this in your empty project folder. It will interactively ask for your project details and generate all necessary metadata.
+
+```bash
+nova-forge init
+```
+
+### 2. Build Directory Structure
+Got a project layout from your AI architect? Paste it into `project_structure.txt`:
+
+```text
+my-awesome-app/
+├── src/
+│   └── my_awesome_app/
+│       ├── __init__.py
+│       └── main.py
+└── examples/
+```
+
+Then run:
+
+```bash
+nova-forge tree
+```
+
+*Boom! Your entire folder structure is created with auto-generated `__init__.py` and boilerplate code.*
+
+## 📜 License
+
+MIT License. See [LICENSE](https://github.com/eagleye-china/Nova-Forge/blob/main/LICENSE) for details.

nova_forge-0.1.0/src/nova_forge.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+LICENSE
+README.md
+pyproject.toml
+src/nova_forge/__init__.py
+src/nova_forge/cli.py
+src/nova_forge.egg-info/PKG-INFO
+src/nova_forge.egg-info/SOURCES.txt
+src/nova_forge.egg-info/dependency_links.txt
+src/nova_forge.egg-info/entry_points.txt
+src/nova_forge.egg-info/requires.txt
+src/nova_forge.egg-info/top_level.txt
+src/nova_forge/assets/__init__.py
+src/nova_forge/core/__init__.py
+src/nova_forge/core/scaffolder.py
+src/nova_forge/core/templates.py
+src/nova_forge/core/tree_builder.py

nova_forge-0.1.0/src/nova_forge.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

nova_forge-0.1.0/src/nova_forge.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+nova-forge = nova_forge.cli:main

nova_forge-0.1.0/src/nova_forge.egg-info/requires.txt

@@ -0,0 +1,2 @@
+build>=1.0.0
+twine>=5.0.0

nova_forge-0.1.0/src/nova_forge.egg-info/top_level.txt

@@ -0,0 +1 @@
+nova_forge