PhotoWall 0.1.0__tar.gz

photowall-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,35 @@
+name: Upload Python Package
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      # 🔐 必须：用于 PyPI 的可信发布 (Trusted Publishing) 免密认证
+      id-token: write
+
+    steps:
+      # 1. 拉取代码
+      - uses: actions/checkout@v4
+
+      # 2. 安装并配置 uv
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v8.2.0
+        with:
+          enable-cache: true
+
+      # 3. 使用 uv 构建包 (生成 dist/)
+      - name: Build release distributions
+        run: uv build
+
+      # 4. 使用 uv 直接发布到 PyPI
+      # uv 会自动识别 GitHub 的 id-token 并与 PyPI 完成 OIDC 握手，无需任何 Token
+      - name: Publish to PyPI
+        run: uv publish

photowall-0.1.0/.gitignore

@@ -0,0 +1,11 @@
+/index.html
+assets/
+assets.js
+tags.json
+.cache/
+.photowall/
+__pycache__/
+.pytest_cache/
+.ruff_cache/
+.venv/
+dist/

photowall-0.1.0/.python-version

@@ -0,0 +1 @@
+3.14

photowall-0.1.0/AGENTS.md

@@ -0,0 +1,7 @@
+# AGENTS.md
+
+一个生成照片元数据让后显示的照片墙工具。
+
+## 开发环境
+
+使用`uv`管理，`ruff`进行代码规范检查，`pytest`进行单元测试。

photowall-0.1.0/LICENSE

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

photowall-0.1.0/PKG-INFO

@@ -0,0 +1,43 @@
+Metadata-Version: 2.5
+Name: PhotoWall
+Version: 0.1.0
+Summary: 一款基于预生成元数据的轻量级照片墙
+Project-URL: Homepage, https://github.com/ecator/PhotoWall
+Project-URL: Repository, https://github.com/ecator/PhotoWall
+Author-email: Martin <qule520@126.com>
+License-File: LICENSE
+Requires-Python: >=3.14
+Requires-Dist: huggingface-hub>=2.3.0
+Requires-Dist: numpy>=2.5.4
+Requires-Dist: onnxruntime-directml>=1.24.4
+Requires-Dist: onnxruntime-gpu>=1.31.0
+Requires-Dist: pillow>=13.0.0
+Requires-Dist: tqdm>=4.70.1
+Description-Content-Type: text/markdown
+
+# 照片墙
+
+这是一个纯本地单页`index.html`+`assets.js`的照片墙应用，通过`photowall index`子命令扫描相册目录生成`tags.json`、`assets.js`并输出`index.html`，无需服务端即可在浏览器中展示照片。
+
+## 常用命令
+
+- `photowall index`：一键全量索引。从指定相册根目录（`--home`，默认为当前工作目录）查找 `assets/` 媒体文件，自动进行 AI 打标生成 `tags.json`、提取元数据生成 `assets.js`，并输出 `index.html` 网页文件。
+  - `--home`：相册根目录路径（可选，默认当前目录）。
+  - `--title`：相册标题（可选，默认使用相册文件夹名）。
+  - `--force`：强制重新推理 AI 标签并重新解析所有媒体文件。
+  - `--skip-tags`：跳过 AI 标签生成步骤。
+- `photowall tags`：仅使用 WD14 Tagger 自动为图片打标并生成 `tags.json`。
+- `photowall assets`：仅扫描 `assets/` 目录并融合标签生成 `assets.js`。
+
+## 快速开始
+
+1. 安装 `photowall`：
+   ```bash
+   uv tool install photowall
+   ```
+2. 把图片和视频放进 `assets` 文件夹，不需要特别分门别类，直接扔进去就行。
+   > 最开始没有 `assets` 文件夹需要手动创建。
+3. 运行 `photowall index` 生成相册索引。
+4. 打开生成的 `index.html` 即可。
+   > 如果更新了 `assets` 的内容则再次运行 `photowall index` 即可。
+5. 如果想启动本地服务器也可以直接运行 `start.bat`，会自动启动本地服务器并使用浏览器打开。

photowall-0.1.0/README.md

@@ -0,0 +1,26 @@
+# 照片墙
+
+这是一个纯本地单页`index.html`+`assets.js`的照片墙应用，通过`photowall index`子命令扫描相册目录生成`tags.json`、`assets.js`并输出`index.html`，无需服务端即可在浏览器中展示照片。
+
+## 常用命令
+
+- `photowall index`：一键全量索引。从指定相册根目录（`--home`，默认为当前工作目录）查找 `assets/` 媒体文件，自动进行 AI 打标生成 `tags.json`、提取元数据生成 `assets.js`，并输出 `index.html` 网页文件。
+  - `--home`：相册根目录路径（可选，默认当前目录）。
+  - `--title`：相册标题（可选，默认使用相册文件夹名）。
+  - `--force`：强制重新推理 AI 标签并重新解析所有媒体文件。
+  - `--skip-tags`：跳过 AI 标签生成步骤。
+- `photowall tags`：仅使用 WD14 Tagger 自动为图片打标并生成 `tags.json`。
+- `photowall assets`：仅扫描 `assets/` 目录并融合标签生成 `assets.js`。
+
+## 快速开始
+
+1. 安装 `photowall`：
+   ```bash
+   uv tool install photowall
+   ```
+2. 把图片和视频放进 `assets` 文件夹，不需要特别分门别类，直接扔进去就行。
+   > 最开始没有 `assets` 文件夹需要手动创建。
+3. 运行 `photowall index` 生成相册索引。
+4. 打开生成的 `index.html` 即可。
+   > 如果更新了 `assets` 的内容则再次运行 `photowall index` 即可。
+5. 如果想启动本地服务器也可以直接运行 `start.bat`，会自动启动本地服务器并使用浏览器打开。

photowall-0.1.0/pyproject.toml

@@ -0,0 +1,43 @@
+[project]
+name = "PhotoWall"
+dynamic = ["version"]
+description = "一款基于预生成元数据的轻量级照片墙"
+readme = "README.md"
+authors = [{ name = "Martin", email = "qule520@126.com" }]
+requires-python = ">=3.14"
+dependencies = [
+    "huggingface-hub>=2.3.0",
+    "numpy>=2.5.4",
+    "onnxruntime-directml>=1.24.4",
+    "onnxruntime-gpu>=1.31.0",
+    "pillow>=13.0.0",
+    "tqdm>=4.70.1",
+]
+
+[project.scripts]
+photowall = "photowall.cli:main"
+
+
+[build-system]
+requires = ["hatchling", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+source = "vcs"
+
+[project.urls]
+Homepage = "https://github.com/ecator/PhotoWall"
+Repository = "https://github.com/ecator/PhotoWall"
+
+[dependency-groups]
+dev = ["pytest>=9.1.1", "ruff>=0.17.2"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff.lint]
+ignore = [
+    "BLE001", # Do not catch blind exception: `Exception`
+    "S110",   # `try`-`except`-`pass` detected
+    "S112",   # `try`-`except`-`continue` detected
+]

photowall-0.1.0/src/photowall/__init__.py

@@ -0,0 +1,4 @@
+from photowall import assets, index, tags
+from photowall.cli import main
+
+__all__ = ["assets", "index", "main", "tags"]