pysvnlite 0.2.0__tar.gz

pysvnlite-0.2.0/.gitignore

@@ -0,0 +1,7 @@
+**/__pycache__/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.venv/
+dist/
+.release-smoke/

pysvnlite-0.2.0/LICENSE

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

pysvnlite-0.2.0/PKG-INFO

@@ -0,0 +1,92 @@
+Metadata-Version: 2.4
+Name: pysvnlite
+Version: 0.2.0
+Summary: Lightweight, non-interactive Subversion CLI wrapper and XML parsers
+Project-URL: Homepage, https://github.com/narutozb/pysvnlite
+Project-URL: Documentation, https://github.com/narutozb/pysvnlite/tree/main/docs
+Project-URL: Repository, https://github.com/narutozb/pysvnlite.git
+Project-URL: Issues, https://github.com/narutozb/pysvnlite/issues
+Author: yuanzhen qiao
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.9
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: mypy<2.0,>=1.11; extra == 'dev'
+Requires-Dist: packaging>=23.2; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Requires-Dist: tomli>=2.0.1; (python_version < '3.11') and extra == 'dev'
+Provides-Extra: release
+Requires-Dist: build>=1.2; extra == 'release'
+Requires-Dist: packaging>=23.2; extra == 'release'
+Requires-Dist: tomli>=2.0.1; (python_version < '3.11') and extra == 'release'
+Requires-Dist: twine>=5.1; extra == 'release'
+Description-Content-Type: text/markdown
+
+# pysvnlite
+
+轻量、非交互的 Subversion 命令行封装和 XML 解析库，适合自动化脚本、资产历史查询和工作副本管理。
+
+要求 Python >=3.9，并在 PATH 中提供原生 `svn` 客户端。库本身没有第三方运行时依赖，也不安装 `svnpypi` CLI。
+
+```bash
+python -m pip install pysvnlite
+```
+
+```python
+from pysvnlite import SVNRepo
+
+repo = SVNRepo("https://svn.example.com/project/trunk", timeout=30)
+for entry in repo.log(limit=10, verbose=True):
+    print(entry.revision, entry.author, entry.changed_paths)
+```
+
+## 能力与边界
+
+- `info/log/list/status/blame` 等结构化读取，返回类型化模型。
+- 工作副本检出、更新、增删、属性、提交、冲突检查；URL `mkdir/delete` 支持提交信息。
+- 历史 peg revision、二进制读取、原子文件下载。
+- 可选超时，有界日志滚盘、增量 XML 与路径事件；通过 `CAPABILITIES` 检查 `bounded_verbose_log_v1`。
+- 所有 SVN 调用添加 `--non-interactive`；认证、ACL、传输安全和凭据缓存由原生 SVN 管理。
+- 不提供服务端、Web UI、依赖解析器或自动删除策略。
+
+完整示例见 [API 使用指南](https://github.com/narutozb/pysvnlite/blob/main/docs/basic-usage.md)，平台限制见 [Windows 路径说明](https://github.com/narutozb/pysvnlite/blob/main/docs/windows-paths.md)。
+
+## 从旧版 svnpypi 迁移
+
+本库从 `narutozb/svnpypi` 的 `v0.1.7`（提交 `ce6191be4122eb54bbfbbed16bad46413f222e62`）拆出，保留 MIT 许可和作者信息。独立发行从 `0.2.0` 开始，`from pysvnlite import SVNRepo` 等现有导入保持不变。
+
+**不要对旧捆绑版本直接执行普通升级。** 本机已验证：从 `svnpypi 0.1.7` 直接升级时，pip 先安装新依赖，再卸载旧包，会删除新库的同名文件并导致导入失败。`pip check` 仅检查元数据，不能证明文件完整。旧 `svnpypi<=0.1.7` 曾直接拥有 `pysvnlite/` 文件；不要混装或在拆分后降级安装旧发行包。推荐新建虚拟环境；需要原地迁移时，先卸载旧发行包，再重新安装：
+
+```bash
+python -m pip uninstall -y svnpypi pysvnlite
+python -m pip install "pysvnlite==0.2.0"
+python -m pip check
+```
+
+仍需要包注册 CLI 时，最后安装 `svnpypi>=0.2.0`，由其依赖声明安装本库。维护人员应先发布本库，再发布依赖它的 `svnpypi`。
+
+## 开发与发布
+
+```bash
+python -m pip install -e ".[dev,release]"
+python -m ruff check src tests scripts
+python -m mypy src scripts
+python -m pytest -q
+python scripts/release_pypi.py
+```
+
+测试仅写入临时 `file://` SVN 仓库；缺少 `svn` 或 `svnadmin` 时集成测试跳过。CI 覆盖 Linux Python 3.9/3.12/3.14 与 Windows Python 3.12。Python 3.9 仅保留兼容性，生产使用仍受官方维护的运行时。
+
+发布脚本默认不上传，检查 wheel/sdist 内容白名单、`py.typed`、Twine 元数据，并通过 `python -I -S` 从临时安装目录导入，避免本机环境掩盖漏包。AI 文件、测试、CI、发布脚本和 `svnpypi` 源码均不进入构建包；sdist 允许 Hatchling 为重建附带的 `.gitignore`。
+
+正式上传必须具有干净工作区、完整检查和已原样推送的 annotated 标签：
+
+```bash
+git tag -a v0.2.0 -m "pysvnlite 0.2.0"
+git push origin v0.2.0
+python scripts/release_pypi.py --upload --repository pypi --confirm-version 0.2.0
+```
+
+首次发布建议先用独立的 TestPyPI 凭据验证：`python scripts/release_pypi.py --upload --repository testpypi`。正式 PyPI token 不能用于 TestPyPI。只在隐藏密码提示中输入 token，不写入源码、命令行或日志。

pysvnlite-0.2.0/README.md

@@ -0,0 +1,66 @@
+# pysvnlite
+
+轻量、非交互的 Subversion 命令行封装和 XML 解析库，适合自动化脚本、资产历史查询和工作副本管理。
+
+要求 Python >=3.9，并在 PATH 中提供原生 `svn` 客户端。库本身没有第三方运行时依赖，也不安装 `svnpypi` CLI。
+
+```bash
+python -m pip install pysvnlite
+```
+
+```python
+from pysvnlite import SVNRepo
+
+repo = SVNRepo("https://svn.example.com/project/trunk", timeout=30)
+for entry in repo.log(limit=10, verbose=True):
+    print(entry.revision, entry.author, entry.changed_paths)
+```
+
+## 能力与边界
+
+- `info/log/list/status/blame` 等结构化读取，返回类型化模型。
+- 工作副本检出、更新、增删、属性、提交、冲突检查；URL `mkdir/delete` 支持提交信息。
+- 历史 peg revision、二进制读取、原子文件下载。
+- 可选超时，有界日志滚盘、增量 XML 与路径事件；通过 `CAPABILITIES` 检查 `bounded_verbose_log_v1`。
+- 所有 SVN 调用添加 `--non-interactive`；认证、ACL、传输安全和凭据缓存由原生 SVN 管理。
+- 不提供服务端、Web UI、依赖解析器或自动删除策略。
+
+完整示例见 [API 使用指南](https://github.com/narutozb/pysvnlite/blob/main/docs/basic-usage.md)，平台限制见 [Windows 路径说明](https://github.com/narutozb/pysvnlite/blob/main/docs/windows-paths.md)。
+
+## 从旧版 svnpypi 迁移
+
+本库从 `narutozb/svnpypi` 的 `v0.1.7`（提交 `ce6191be4122eb54bbfbbed16bad46413f222e62`）拆出，保留 MIT 许可和作者信息。独立发行从 `0.2.0` 开始，`from pysvnlite import SVNRepo` 等现有导入保持不变。
+
+**不要对旧捆绑版本直接执行普通升级。** 本机已验证：从 `svnpypi 0.1.7` 直接升级时，pip 先安装新依赖，再卸载旧包，会删除新库的同名文件并导致导入失败。`pip check` 仅检查元数据，不能证明文件完整。旧 `svnpypi<=0.1.7` 曾直接拥有 `pysvnlite/` 文件；不要混装或在拆分后降级安装旧发行包。推荐新建虚拟环境；需要原地迁移时，先卸载旧发行包，再重新安装：
+
+```bash
+python -m pip uninstall -y svnpypi pysvnlite
+python -m pip install "pysvnlite==0.2.0"
+python -m pip check
+```
+
+仍需要包注册 CLI 时，最后安装 `svnpypi>=0.2.0`，由其依赖声明安装本库。维护人员应先发布本库，再发布依赖它的 `svnpypi`。
+
+## 开发与发布
+
+```bash
+python -m pip install -e ".[dev,release]"
+python -m ruff check src tests scripts
+python -m mypy src scripts
+python -m pytest -q
+python scripts/release_pypi.py
+```
+
+测试仅写入临时 `file://` SVN 仓库；缺少 `svn` 或 `svnadmin` 时集成测试跳过。CI 覆盖 Linux Python 3.9/3.12/3.14 与 Windows Python 3.12。Python 3.9 仅保留兼容性，生产使用仍受官方维护的运行时。
+
+发布脚本默认不上传，检查 wheel/sdist 内容白名单、`py.typed`、Twine 元数据，并通过 `python -I -S` 从临时安装目录导入，避免本机环境掩盖漏包。AI 文件、测试、CI、发布脚本和 `svnpypi` 源码均不进入构建包；sdist 允许 Hatchling 为重建附带的 `.gitignore`。
+
+正式上传必须具有干净工作区、完整检查和已原样推送的 annotated 标签：
+
+```bash
+git tag -a v0.2.0 -m "pysvnlite 0.2.0"
+git push origin v0.2.0
+python scripts/release_pypi.py --upload --repository pypi --confirm-version 0.2.0
+```
+
+首次发布建议先用独立的 TestPyPI 凭据验证：`python scripts/release_pypi.py --upload --repository testpypi`。正式 PyPI token 不能用于 TestPyPI。只在隐藏密码提示中输入 token，不写入源码、命令行或日志。

pysvnlite-0.2.0/pyproject.toml

@@ -0,0 +1,43 @@
+[build-system]
+requires = ["hatchling>=1.21"]
+build-backend = "hatchling.build"
+
+[project]
+name = "pysvnlite"
+version = "0.2.0"
+description = "Lightweight, non-interactive Subversion CLI wrapper and XML parsers"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [{ name = "yuanzhen qiao" }]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/narutozb/pysvnlite"
+Documentation = "https://github.com/narutozb/pysvnlite/tree/main/docs"
+Repository = "https://github.com/narutozb/pysvnlite.git"
+Issues = "https://github.com/narutozb/pysvnlite/issues"
+
+[project.optional-dependencies]
+dev = ["build>=1.2", "mypy>=1.11,<2.0", "pytest>=8.0", "ruff>=0.6", "packaging>=23.2", "tomli>=2.0.1; python_version < '3.11'"]
+release = ["build>=1.2", "twine>=5.1", "packaging>=23.2", "tomli>=2.0.1; python_version < '3.11'"]
+
+[tool.hatch.build.targets.wheel]
+core-metadata-version = "2.4"
+packages = ["src/pysvnlite"]
+
+[tool.hatch.build.targets.sdist]
+core-metadata-version = "2.4"
+include = ["/LICENSE", "/README.md", "/pyproject.toml", "/src/pysvnlite"]
+
+[tool.ruff]
+target-version = "py39"
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E4", "E7", "E9", "F"]
+
+[tool.mypy]
+python_version = "3.9"
+check_untyped_defs = true
+files = ["src", "scripts"]

pysvnlite-0.2.0/src/pysvnlite/__init__.py

@@ -0,0 +1,35 @@
+from .repo import CAPABILITIES, SVNRepo
+from .models import (
+    BlameLine,
+    CommitResult,
+    CommitSummary,
+    ListEntry,
+    LogEntry,
+    LogEntryEnd,
+    LogEntryStart,
+    LogEvent,
+    LogPathChange,
+    LogPathChangeEvent,
+    RepoInfo,
+    StatusItem,
+)
+from .exceptions import SVNCommandError, SVNOutputLimitError
+
+__all__ = [
+    "SVNRepo",
+    "CAPABILITIES",
+    "RepoInfo",
+    "LogEntry",
+    "LogEvent",
+    "LogEntryStart",
+    "LogPathChangeEvent",
+    "LogEntryEnd",
+    "LogPathChange",
+    "CommitResult",
+    "CommitSummary",
+    "StatusItem",
+    "ListEntry",
+    "BlameLine",
+    "SVNCommandError",
+    "SVNOutputLimitError",
+]

pysvnlite-0.2.0/src/pysvnlite/exceptions.py

@@ -0,0 +1,184 @@
+from __future__ import annotations
+
+import re
+from dataclasses import dataclass
+from typing import List
+
+
+_URL_USERINFO_RE = re.compile(
+    r"(?i)([a-z][a-z0-9+.-]*://)([^/@\s]+)@"
+)
+
+
+def redact_url_credentials(text: str) -> str:
+    """Hide URL userinfo before text is written to logs or records."""
+    return _URL_USERINFO_RE.sub(r"\1***@", text)
+
+
+def _contains_any(text: str, patterns: tuple[str, ...]) -> bool:
+    lowered = text.lower()
+    return any(pattern in lowered for pattern in patterns)
+
+
+@dataclass
+class SVNCommandError(RuntimeError):
+    """
+    在调用 svn 子进程时，如果返回码 != 0，用这个异常包装。
+    """
+
+    cmd: List[str]
+    returncode: int
+    stdout: str
+    stderr: str
+
+    @property
+    def output_text(self) -> str:
+        return f"{self.stderr}\n{self.stdout}"
+
+    @property
+    def is_path_not_found(self) -> bool:
+        return self.is_local_repository_not_found or _contains_any(
+            self.output_text,
+            (
+                "e160013",
+                "e200009",
+                "path not found",
+                "file not found",
+                "not found in repository",
+                "non-existent in revision",
+                "doesn't exist",
+                "does not exist",
+                "not a valid url",
+                "could not list all targets because some targets don't exist",
+            ),
+        )
+
+    @property
+    def is_local_repository_not_found(self) -> bool:
+        combined_text = "\n".join([*self.cmd, self.output_text]).lower()
+        return "file://" in combined_text and _contains_any(
+            self.output_text,
+            (
+                "e180001",
+                "unable to open repository",
+            ),
+        )
+
+    @property
+    def is_authentication_error(self) -> bool:
+        return _contains_any(
+            self.output_text,
+            (
+                "e215004",
+                "authentication failed",
+                "could not authenticate",
+                "authorization failed: could not authenticate",
+                "no more credentials",
+            ),
+        )
+
+    @property
+    def is_authorization_error(self) -> bool:
+        if self.is_authentication_error:
+            return False
+        return _contains_any(
+            self.output_text,
+            (
+                "e170001",
+                "authorization failed",
+                "not authorized",
+                "access denied",
+                "forbidden",
+                "permission denied",
+            ),
+        )
+
+    @property
+    def is_network_error(self) -> bool:
+        return _contains_any(
+            self.output_text,
+            (
+                "e000110",
+                "e670002",
+                "e730061",
+                "unable to connect",
+                "could not resolve hostname",
+                "name or service not known",
+                "connection refused",
+                "connection timed out",
+                "network connection closed",
+                "no route to host",
+            ),
+        )
+
+    @property
+    def is_timeout_error(self) -> bool:
+        return "svn command timed out after" in self.output_text.lower()
+
+    @property
+    def is_already_exists_error(self) -> bool:
+        return _contains_any(
+            self.output_text,
+            (
+                "e160020",
+                "already exists",
+                "already exist",
+                "file already exists",
+                "path already exists",
+                "is already under version control",
+            ),
+        )
+
+    @property
+    def is_out_of_date_error(self) -> bool:
+        return _contains_any(
+            self.output_text,
+            (
+                "e155011",
+                "e160028",
+                "out of date",
+                "out-of-date",
+                "working copy is out of date",
+                "base checksum mismatch",
+            ),
+        )
+
+    @property
+    def is_property_not_found(self) -> bool:
+        lowered = self.output_text.lower()
+        return "w200017" in lowered or (
+            "property" in lowered and "not found" in lowered
+        )
+
+    @property
+    def category(self) -> str:
+        if self.is_timeout_error:
+            return "timeout"
+        if self.is_authentication_error:
+            return "authentication"
+        if self.is_authorization_error:
+            return "authorization"
+        if self.is_local_repository_not_found:
+            return "not_found"
+        if self.is_network_error:
+            return "network"
+        if self.is_property_not_found:
+            return "property_not_found"
+        if self.is_path_not_found:
+            return "not_found"
+        return "unknown"
+
+    def __str__(self) -> str:
+        return redact_url_credentials(
+            f"svn command failed (code {self.returncode}): {self.cmd}\n"
+            f"STDERR:\n{self.stderr}\n"
+            f"STDOUT:\n{self.stdout}"
+        )
+
+
+class SVNOutputLimitError(SVNCommandError):
+    """Raised when a bounded SVN stdout stream exceeds its configured limit."""
+
+    @property
+    def category(self) -> str:
+        return "output_limit"

pysvnlite-0.2.0/src/pysvnlite/models.py

@@ -0,0 +1,143 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from datetime import datetime
+from pathlib import Path
+from typing import List, Optional, Union
+
+
+@dataclass
+class RepoInfo:
+    """结构化的 svn info 结果"""
+
+    url: str
+    repo_root_url: Optional[str]
+    repo_uuid: Optional[str]
+
+    wc_root: Optional[Path]          # 如果是工作拷贝路径则会有
+    revision: Optional[int]
+    node_kind: Optional[str]         # 'dir' / 'file'
+    last_changed_rev: Optional[int]
+    last_changed_author: Optional[str]
+    last_changed_date: Optional[datetime]
+
+
+@dataclass
+class LogPathChange:
+    """单条日志中某个文件/路径的变更信息"""
+    action: str                      # 'A' 'M' 'D' 'R' ...
+    path: str
+    copy_from_path: Optional[str] = None
+    copy_from_rev: Optional[int] = None
+
+
+@dataclass
+class LogEntry:
+    """svn log 的一条提交记录"""
+    revision: int
+    author: Optional[str]
+    date: Optional[datetime]
+    message: str
+    changed_paths: List[LogPathChange] = field(default_factory=list)
+
+
+@dataclass
+class LogEntryStart:
+    """Marks the beginning of one revision in a path-level log stream."""
+
+    revision: int
+
+
+@dataclass
+class LogPathChangeEvent:
+    """One changed path associated with a streamed revision."""
+
+    revision: int
+    change: LogPathChange
+
+
+@dataclass
+class LogEntryEnd:
+    """Completes one revision after all of its path events were emitted."""
+
+    revision: int
+    author: Optional[str]
+    date: Optional[datetime]
+    message: str
+    changed_paths_count: int
+
+
+LogEvent = Union[LogEntryStart, LogPathChangeEvent, LogEntryEnd]
+
+
+@dataclass
+class CommitSummary:
+    """提交前的变更摘要（来自 svn status --xml）"""
+    added: List[str] = field(default_factory=list)
+    modified: List[str] = field(default_factory=list)
+    deleted: List[str] = field(default_factory=list)
+    missing: List[str] = field(default_factory=list)
+    conflicted: List[str] = field(default_factory=list)
+    tree_conflicted: List[str] = field(default_factory=list)
+    unversioned: List[str] = field(default_factory=list)
+
+@dataclass
+class CommitResult:
+    """
+    svn commit 的结果（增强版）。
+    - success: returncode==0
+    - revision: 解析到的修订号；可能为 None（本地化导致解析失败时）
+    - pre_summary: 提交前的状态摘要
+    - changed_paths: 若成功，来自 `svn log -v --xml -r <rev>` 的本次变更路径
+    """
+    success: bool
+    revision: Optional[int]
+    stdout: str
+    stderr: str
+    returncode: int
+    pre_summary: CommitSummary = field(default_factory=CommitSummary)
+    changed_paths: List["LogPathChange"] = field(default_factory=list)
+
+
+@dataclass
+class StatusItem:
+    """
+    一条工作拷贝状态信息（对应 svn status --xml 的 <entry>）
+    """
+    path: str                             # 本地路径
+    wc_status: str                        # item 的内容变更状态: 'modified'|'added'|'deleted'|'unversioned'|'missing'|'conflicted'|'external'|...
+    repos_status: Optional[str]           # 远端对该项的状态（可能 None）
+    locked: bool                          # 是否被 WC 锁定
+    switched: bool                        # 是否切换到非相对 URL
+    copied: bool                          # 是否 copy 来的
+    tree_conflicted: bool                 # 是否树冲突
+    revision: Optional[int]               # 本地工作拷贝记录的 rev
+    commit_rev: Optional[int]             # 最后一次提交 rev（来自 <commit revision=...>）
+    commit_author: Optional[str]          # 最后一次提交作者
+    commit_date: Optional["datetime"]     # 最后一次提交时间（aware, UTC）
+
+
+@dataclass
+class ListEntry:
+    """svn list 的一条记录"""
+    kind: str                        # 'file' or 'dir'
+    name: str                        # 文件名/目录名
+    size: Optional[int]              # 文件大小（目录无）
+    commit_rev: Optional[int]        # 最后一次提交 rev
+    commit_author: Optional[str]     # 最后一次提交作者
+    commit_date: Optional[datetime]  # 最后一次提交时间
+
+
+@dataclass
+class BlameLine:
+    """svn blame 的一行信息"""
+    line_number: int            # 行号
+    revision: int               # 该行最后修改的版本号
+    author: str                 # 该行最后修改的作者
+    date: Optional[datetime]    # 该行最后修改的时间
+    content: str                # 行内容（注意：blame --xml 不含内容，需结合 cat 才能拼出完整信息，或仅返回元数据）
+    # 注：svn blame --xml 输出不包含行内容本身！只包含 rev, author, date。
+    # 通常 blame 还需要展示内容，但 svn blame --xml 确实不给。
+    # 如果要像 IDE 那样展示，需要另外 cat 文件内容并合并。
+    # 这里我们暂且只存储元数据，或者在 parser 里尝试读取文件内容（成本较高）。
+    # 按照轻量级原则，我们先只解析 XML 返回的元数据。

pysvnlite-0.2.0/src/pysvnlite/parser_blame.py

@@ -0,0 +1,64 @@
+from __future__ import annotations
+
+import xml.etree.ElementTree as ET
+from typing import List, Optional
+
+from .models import BlameLine
+from .utils import parse_svn_datetime
+
+
+def parse_blame_xml(xml_text: str) -> List[BlameLine]:
+    """
+    解析 `svn blame --xml` 的输出。
+    XML 结构：
+    <target path="...">
+        <entry line-number="1">
+            <commit revision="2">
+                <author>user</author>
+                <date>...</date>
+            </commit>
+        </entry>
+        ...
+    </target>
+
+    注意：XML 输出不包含行内容，只有元数据！
+    """
+    try:
+        root = ET.fromstring(xml_text)
+    except ET.ParseError:
+        return []
+
+    lines: List[BlameLine] = []
+
+    # 通常只有一个 target
+    for target in root.findall("target"):
+        for entry in target.findall("entry"):
+            line_str = entry.get("line-number")
+            line_number = int(line_str) if line_str else 0
+
+            commit_el = entry.find("commit")
+            rev = -1
+            author = ""
+            date_dt = None
+
+            if commit_el is not None:
+                rev_str = commit_el.get("revision")
+                rev = int(rev_str) if rev_str else -1
+                author = _text(commit_el.find("author")) or ""
+                date_str = _text(commit_el.find("date"))
+                if date_str:
+                    date_dt = parse_svn_datetime(date_str)
+
+            lines.append(BlameLine(
+                line_number=line_number,
+                revision=rev,
+                author=author,
+                date=date_dt,
+                content=""  # XML output doesn't include content
+            ))
+
+    return lines
+
+
+def _text(el: Optional[ET.Element]) -> Optional[str]:
+    return el.text if (el is not None and el.text is not None) else None