hohu 0.1.3__tar.gz

hohu-0.1.3/.github/ISSUE_TEMPLATE/bug_report_en.md

@@ -0,0 +1,27 @@
+---
+name: 🐛 Bug Report (English)
+about: Create a report to help us improve
+title: "[BUG] <short description>"
+labels: bug
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Call endpoint '...'
+3. See error '...'
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Environment**
+- OS: [e.g. macOS]
+- Python version: [e.g. 3.11]
+- FastAPI version: [e.g. 0.110.0]
+- uv version: [e.g. 0.1.10]
+
+**Additional context/Screenshots**
+Add any other context about the problem or error logs here.

hohu-0.1.3/.github/ISSUE_TEMPLATE/bug_report_zh.md

@@ -0,0 +1,29 @@
+---
+name: 🐛 Bug 报告 (Chinese)
+about: 报告程序中的错误，帮助我们改进
+title: "[BUG] <简短描述错误>"
+labels: bug
+---
+
+**错误描述**
+请清晰、简要地描述该 Bug 是什么。
+
+**复现步骤**
+1. 进入 '...'
+2. 调用接口 '...'
+3. 看到错误 '...'
+
+**预期行为**
+你希望发生什么？
+
+**运行环境**
+- OS: [例如: Windows 11, macOS]
+- Python 版本: [例如: 3.11]
+- FastAPI 版本: [例如: 0.110.0]
+- uv 版本: [例如: 0.1.10]
+
+**错误日志/截图**
+如果有错误堆栈信息或截图，请在此处贴出。
+
+**补充信息**
+关于此问题的其他任何上下文信息。

hohu-0.1.3/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false # 禁止创建空白 Issue，强制使用模板
+contact_links:
+  - name: 📖 Documentation
+    url: https://your-docs-link.com
+    about: 请先查阅文档
+  - name: 💬 Discussions
+    url: https://github.com/your-username/your-repo/discussions
+    about: 如果只是咨询问题，请前往讨论区

hohu-0.1.3/.github/ISSUE_TEMPLATE/feature_request_en.md

@@ -0,0 +1,18 @@
+---
+name: 🚀 Feature Request (English)
+about: Suggest an idea for this project
+title: "[FEATURE] <feature name>"
+labels: enhancement
+---
+
+**Is your feature request related to a problem?**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

hohu-0.1.3/.github/ISSUE_TEMPLATE/feature_request_zh.md

@@ -0,0 +1,18 @@
+---
+name: 🚀 功能建议 (Chinese)
+about: 为本项目提出新想法或改进建议
+title: "[FEATURE] <功能名称>"
+labels: enhancement
+---
+
+**你的需求是否与某个问题有关？**
+请清晰描述，例如“当我在做...时，我感到很不方便”。
+
+**描述你想要的解决方案**
+描述你希望实现的功能。
+
+**描述你考虑过的替代方案**
+描述你考虑过的任何替代方案或绕过方法。
+
+**其他背景**
+在此处添加关于功能请求的任何其他背景、参考资料或截图。

hohu-0.1.3/.github/pull_request_template.md

@@ -0,0 +1,17 @@
+## 📝 Description / 描述
+Fixes # (issue number)
+
+## 🛠️ Type of Change / 修改类型
+- [ ] 🐛 Bug fix (non-breaking change which fixes an issue) / Bug 修复
+- [ ] ✨ New feature (non-breaking change which adds functionality) / 新功能
+- [ ] 💥 Breaking change (fix or feature that would cause existing functionality to not work as expected) / 重大变更（破坏性修改）
+- [ ] 📝 Documentation update / 文档更新
+- [ ] ⚡ Performance improvement / 性能优化
+
+## ✅ Checklist / 检查清单
+- [ ] I have performed a self-review of my own code / 我已完成代码自检
+- [ ] I have run `uv run ruff format .` / 我已运行 Ruff 格式化
+- [ ] I have run `uv run ruff check --fix .` / 我已运行 Ruff 修复 Lint
+- [ ] My changes generate no new warnings / 我的修改没有产生新的警告
+- [ ] I have added tests that prove my fix is effective or that my feature works / 我已添加相关测试
+- [ ] New and existing unit tests pass locally with my changes / 本地所有测试均已通过

hohu-0.1.3/.github/workflows/ci.yml

@@ -0,0 +1,32 @@
+name: CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  ruff:
+    name: Ruff
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "0.9.18"
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install
+
+      - name: Install dependencies
+        run: uv sync --all-extras --dev
+
+      - name: Lint with Ruff
+        run: uv run ruff check . --output-format=github
+
+      - name: Check Formatting
+        run: uv run ruff format --check .

hohu-0.1.3/.github/workflows/release.yml

@@ -0,0 +1,46 @@
+name: Release
+
+on:
+  release:
+    types: [published] # 仅在您手动点击“Publish Release”按钮后触发
+
+jobs:
+  deploy:
+    name: Build and Publish to PyPI
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write  # 允许修改 Release 内容并上传附件
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # 获取完整历史以生成详细日志
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "0.9.18"
+          enable-cache: true
+
+      - name: Set up Python
+        # uv 会根据 pyproject.toml 自动安装正确的 Python 版本
+        run: uv python install
+
+      - name: Build project
+        # uv 会自动生成 .tar.gz (sdist) 和 .whl (wheel)
+        run: uv build
+
+    #   - name: Publish to PyPI
+    #     env:
+    #       # 必须在 GitHub Repo Settings -> Secrets 中配置此 Token
+    #       UV_PUBLISH_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
+    #     run: |
+    #       uv publish
+
+      - name: Upload artifacts to GitHub Release
+        # 将构建好的包也作为附件挂载到 GitHub Release 页面上
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

hohu-0.1.3/.gitignore

@@ -0,0 +1,28 @@
+__pycache__
+app.egg-info
+*.pyc
+.mypy_cache
+.coverage
+htmlcov
+.cache
+.venv
+.conda
+alembic/versions/*
+.env
+.env.prod
+alembic.ini
+.DS_Store
+myapp
+DEV_README.md
+
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+.python-version
+.pytest_cache
+.ruff_cache
+

hohu-0.1.3/.vscode/launch.json

@@ -0,0 +1,20 @@
+{
+    // 使用 IntelliSense 了解相关属性。 
+    // 悬停以查看现有属性的描述。
+    // 欲了解更多信息，请访问: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+
+        {
+            "name": "Debug Pancake (app/main.py)",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "uvicorn",
+            "args": [
+                "app.main:app",
+                "--reload"
+            ],
+            "jinja": true
+        }
+    ]
+}

hohu-0.1.3/.vscode/settings.json

@@ -0,0 +1,16 @@
+{
+    "[python]": {
+        "editor.formatOnSave": true,
+        "editor.defaultFormatter": "charliermarsh.ruff",
+        "editor.codeActionsOnSave": {
+            "source.fixAll.ruff": "explicit",
+            "source.organizeImports.ruff": "explicit"
+        }
+    },
+    "ruff.nativeServer": true,
+    "python.testing.pytestArgs": [
+        "tests"
+    ],
+    "python.testing.unittestEnabled": false,
+    "python.testing.pytestEnabled": true
+}

hohu-0.1.3/LICENSE

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

hohu-0.1.3/PKG-INFO

@@ -0,0 +1,269 @@
+Metadata-Version: 2.4
+Name: hohu
+Version: 0.1.3
+Summary: A full-stack project management CLI tool for Hohu Admin ecosystem.
+Project-URL: Homepage, https://github.com/aihohu/hohu-cli
+Project-URL: Issues, https://github.com/aihohu/hohu-cli/issues
+Author-email: hohu <hohu@hohu.org>
+License: MIT License
+        
+        Copyright (c) 2026 HoHu
+        
+        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.
+License-File: LICENSE
+Keywords: admin-system,ai,api,cli,fastapi,hohu,mcp,openapi,tools
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: gitpython>=3.1.46
+Requires-Dist: questionary>=2.1.1
+Requires-Dist: rich>=14.2.0
+Requires-Dist: ruff>=0.14.10
+Requires-Dist: typer>=0.21.0
+Description-Content-Type: text/markdown
+
+# 📦 HoHu CLI
+
+**HoHu CLI** 是一款为 `hohu-admin` 生态量身打造的现代化命令行工具。它集成了项目脚手架生成、自动化环境初始化和多语言切换功能，旨在提升全栈开发者的生产力。
+
+---
+
+## ✨ 特性
+
+* 🚀 **极速启动**：基于 `uv` 开发，响应速度极快。
+* 🛠️ **智能初始化**：后端自动执行 `uv sync`，前端及 APP 自动执行 `pnpm install`。
+* 📂 **上下文感知**：通过项目级 `.hohu` 配置，在项目内任何路径执行 `init` 均可识别。
+* 🌍 **多语言支持**：完美支持中英文切换，自动跟随系统语言。
+* 🎨 **精美交互**：基于 `Rich` 和 `Questionary` 打造，提供极致的视觉与交互体验。
+
+---
+
+## 🏗️ 项目架构流
+
+## 📥 安装
+
+使用 `uv` (推荐) 或 `pip` 进行全局安装：
+
+```bash
+# 使用 uv
+uv tool install hohu
+
+# 或使用 pip
+pip install hohu
+
+```
+
+---
+
+## 🚀 快速开始
+
+### 1. 创建新项目
+
+你可以直接运行 `create`。如果不提供名称，将默认创建名为 `hohu-admin` 的文件夹。
+
+```bash
+hohu admin create my-project
+
+```
+
+系统会提示你选择需要安装的组件（后端、前端、APP）。
+
+### 2. 初始化环境
+
+进入项目目录后，直接运行 `init`。工具会自动识别项目配置并安装所有依赖。
+
+```bash
+cd my-project
+hohu admin init
+
+```
+
+### 3. 切换语言
+
+随时随地切换你偏好的交互语言：
+
+```bash
+hohu lang
+
+```
+
+---
+
+## 🚀 hohu admin dev 指令指南
+
+`hohu admin dev` 是 Hohu CLI 的核心开发指令。它能一键启动全栈开发环境，并将多个服务的日志流合并输出，提供极致的联调体验。
+
+### 📖 基本语法
+
+```bash
+hohu admin dev [OPTIONS]
+```
+
+---
+
+### 🛠️ 核心特性
+
+#### 1. 彩色分流日志 (Multi-stream Logging)
+
+无需开启多个终端窗口。`hohu admin dev` 会为每个组件分配专属颜色，并实时合并日志：
+
+* **[Backend]** (绿色): FastAPI 后端日志。
+* **[Frontend]** (青色): Vite/React/Vue 前端日志。
+* **[App]** (黄色): Uni-app/H5 移动端日志。
+
+#### 2. 智能组件过滤 (Only / Skip)
+
+支持通过 `--only (-o)` 或 `--skip (-s)` 精确控制启动项，且支持**忽略大小写**与**语义简写**。
+
+| 简写 | 对应组件 |
+| --- | --- |
+| `be`, `backend` | Backend |
+| `fe`, `web`, `frontend` | Frontend |
+| `app` | App |
+
+#### 3. 多端运行目标 (App Target)
+
+针对移动端项目，支持一键切换预览环境。
+
+---
+
+### 💡 使用示例
+
+#### ✅ 全栈启动 (默认)
+
+启动项目内定义的所有组件（App 默认为 H5 模式）：
+
+```bash
+hohu admin dev
+```
+
+#### ✅ 仅启动后端 (简写模式)
+
+当你只想调试接口时：
+
+```bash
+hohu admin dev -o be
+```
+
+#### ✅ 启动前后端，跳过 APP
+
+```bash
+hohu admin dev -o be -o fe
+# 或者使用排除法
+hohu admin dev -s app
+```
+
+#### ✅ 启动并在微信小程序中预览 APP
+
+```bash
+hohu admin dev -t mp
+```
+
+---
+
+### ⚙️ 参数详解
+
+| 长参数 | 短参数 | 默认值 | 描述 |
+| --- | --- | --- | --- |
+| `--app-target` | `-t` | `h5` | APP 端启动目标：`h5`, `mp` (小程序), `app` (原生) |
+| `--only` | `-o` | `None` | **仅启动**指定组件。可多次使用，支持 `be`, `fe`, `app` 等简写。 |
+| `--skip` | `-s` | `None` | **跳过**指定组件。可多次使用。 |
+
+---
+
+### 🛑 安全退出
+
+按下 **`Ctrl + C`** 时，Hohu CLI 会：
+
+1. 捕获中断信号。
+2. 优雅地向所有后台进程（FastAPI, Vite 等）发送 `Terminate` 信号。
+3. 确保所有端口（8000, 9527 等）被正确释放，防止进程残留。
+
+---
+
+### 📂 原理说明
+
+`hohu admin dev` 依赖于项目根目录下的 `.hohu/project.json` 文件。
+
+* 如果你在非项目目录执行，工具会报错。
+* 工具会根据该文件中的 `components` 列表，自动匹配本地目录（如 `hohu-admin/`）并执行对应的开发指令（如 `uv run fastapi dev`）。
+
+## 🛠️ 命令详解
+
+| 命令 | 描述 |
+| --- | --- |
+| `hohu admin create [NAME]` | 创建项目目录并克隆选定的仓库模板 |
+| `hohu admin init` | 自动化安装子项目的依赖 (uv/pnpm) |
+| `hohu admin dev` | 运行项目 |
+| `hohu lang`,`hohu system lang`| 切换 CLI 显示语言 (zh/en/auto) |
+| `hohu info`,`hohu system info`| 查看 CLI 当前详细配置信息 |
+| `hohu --version`,`-v` | 显示当前版本号 |
+| `hohu --help` | 查看帮助信息 |
+
+---
+
+## 📂 推荐目录结构
+
+执行 `hohu admin create` 后的项目结构：
+
+```text
+my-project/
+├── .hohu/            # HoHu 项目追踪配置
+├── hohu-admin/       # 后端项目 (FastAPI/uv)
+├── hohu-admin-web/   # 前端项目 (Vue3/pnpm)
+└── hohu-admin-app/   # APP 项目 (Uni-app/pnpm)
+
+```
+
+---
+
+## 🤝 贡献指南
+
+我们非常欢迎 Issue 和 Pull Request！
+
+1. Fork 本仓库。
+2. 创建你的特性分支 (`git checkout -b feature/AmazingFeature`)。
+3. 提交你的更改 (`git commit -m 'Add some AmazingFeature'`)。
+4. 推送到分支 (`git push origin feature/AmazingFeature`)。
+5. 开启一个 Pull Request。
+
+---
+
+## 📄 开源协议
+
+本项目采用 [MIT](https://www.google.com/search?q=LICENSE) 协议。
+
+---
+
+### 💡 开发者备注
+
+如果你在发布到 PyPI 时遇到资源文件（JSON）丢失的问题，请确保你的 `pyproject.toml` 包含以下配置：
+
+```toml
+[tool.hatch.build]
+artifacts = ["hohu/locales/*.json"]
+
+```