51 lines
1.6 KiB
Python
51 lines
1.6 KiB
Python
"""task_dir 在 DB 与文件系统两种形态之间的归一。
|
|
|
|
存储约定(DESIGN §7.4):
|
|
- task_dir 在 ROOT 内 → 相对 ROOT 的 posix 串(如 `workspace/tasks/abc-...`)
|
|
- task_dir 在 ROOT 外 → 绝对 str(如 `D:\\projects\\other\\proj` 或 `/home/u/proj`)
|
|
- 空串 → 空串(legacy / 未绑项目)
|
|
|
|
跨机器迁移 / 切 OS / 移 repo 后,ROOT-内路径仍能 resolve;ROOT-外仍存绝对是务实选择
|
|
—— 用户自指定的项目目录没有更好的归一基。
|
|
|
|
Read 端两种来源走两个入口:
|
|
- DB tasks.task_dir → `from_db_path(s)` → absolute Path
|
|
- 用户 CLI `--task-dir` / Web `/new` 表单 → `Path(arg).expanduser().resolve()`(原行为不变)
|
|
|
|
Write 端只通过 `to_db_path(absolute Path)` → DB 串。
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
from pathlib import Path
|
|
from typing import Union
|
|
|
|
ROOT: Path = Path(__file__).resolve().parent.parent
|
|
|
|
|
|
def to_db_path(p: Union[Path, str, None]) -> str:
|
|
"""absolute Path / str → DB 串。
|
|
|
|
输入应已是绝对路径(build_agent / web 路由那一层都 .resolve() 过)。
|
|
ROOT 内 → 相对 posix(`workspace/tasks/abc`)
|
|
ROOT 外 → str(Path)(保留 OS 原生分隔符)
|
|
空 → ""
|
|
"""
|
|
if not p:
|
|
return ""
|
|
pp = Path(p).resolve()
|
|
try:
|
|
return pp.relative_to(ROOT).as_posix()
|
|
except ValueError:
|
|
return str(pp)
|
|
|
|
|
|
def from_db_path(s: str) -> Path:
|
|
"""DB 串 → absolute Path。
|
|
|
|
相对串 → ROOT / s(再 resolve);绝对串 → resolve();空 → Path("")(调用方判)。
|
|
"""
|
|
if not s or not s.strip():
|
|
return Path("")
|
|
p = Path(s)
|
|
return p.resolve() if p.is_absolute() else (ROOT / p).resolve()
|