symbol-tool 1.0.0.3__tar.gz

symbol_tool-1.0.0.3/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: symbol-tool
+Version: 1.0.0.3
+Summary: 符号管理工具
+Author-email: Vorga <qiujuncheng@up3dtech.com>
+Project-URL: Homepage, http://www.vorga.cn:8081/up3d/software/tool/symbol-tool
+Keywords: up3d,symbol,tool
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: requests
+Requires-Dist: symstore
+Requires-Dist: tqdm
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: pyinstaller; extra == "dev"
+Requires-Dist: pyinstaller-versionfile; extra == "dev"
+
+# symbol-tool
+
+用于管理符号文件仓库的命令行工具。
+
+## 快速开始
+
+```bash
+pip install -e .
+symbol-tool --version
+```
+
+## 打包
+
+```bash
+pyinstaller symbol_tool.spec --clean
+```
+
+## 命令示例
+
+```bash
+symbol-tool upload -t test -p "./**/*.pdb"
+symbol-tool fix -t test
+symbol-tool transfer --source test --target test
+symbol-tool clean -t test
+```
+
+`target` 是别名。每个别名对应“某个服务器 + 某个路径”，定义在 [symbol_tool/config.py](symbol_tool/config.py)。
+
+## 测试
+
+```bash
+pytest tests
+```

symbol_tool-1.0.0.3/README.md

@@ -0,0 +1,33 @@
+# symbol-tool
+
+用于管理符号文件仓库的命令行工具。
+
+## 快速开始
+
+```bash
+pip install -e .
+symbol-tool --version
+```
+
+## 打包
+
+```bash
+pyinstaller symbol_tool.spec --clean
+```
+
+## 命令示例
+
+```bash
+symbol-tool upload -t test -p "./**/*.pdb"
+symbol-tool fix -t test
+symbol-tool transfer --source test --target test
+symbol-tool clean -t test
+```
+
+`target` 是别名。每个别名对应“某个服务器 + 某个路径”，定义在 [symbol_tool/config.py](symbol_tool/config.py)。
+
+## 测试
+
+```bash
+pytest tests
+```

symbol_tool-1.0.0.3/pyproject.toml

@@ -0,0 +1,66 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "symbol-tool"
+description = "符号管理工具"
+readme = "README.md"
+requires-python = ">=3.10"
+dynamic = ["version"]
+authors = [
+  { name = "Vorga", email = "qiujuncheng@up3dtech.com" },
+]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.7",
+  "Programming Language :: Python :: 3.8",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Operating System :: OS Independent",
+]
+keywords = ["up3d", "symbol", "tool"]
+dependencies = [
+  "requests",
+  "symstore",
+  "tqdm",
+]
+
+[project.optional-dependencies]
+dev = [
+  "build",
+  "pytest",
+  "pytest-cov",
+  "pyinstaller",
+  "pyinstaller-versionfile",
+]
+
+[project.urls]
+Homepage = "http://www.vorga.cn:8081/up3d/software/tool/symbol-tool"
+
+[project.scripts]
+symbol-tool = "symbol_tool.main:main"
+
+[tool.setuptools]
+include-package-data = true
+zip-safe = false
+
+[tool.setuptools.packages.find]
+exclude = ["tests", "tests.*", "build", "dist", "log"]
+
+[tool.setuptools.dynamic]
+version = {attr = "symbol_tool.__version__"}
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.coverage.run]
+source = ["symbol_tool"]
+
+[tool.coverage.report]
+show_missing = true
+skip_covered = false

symbol_tool-1.0.0.3/setup.cfg

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

symbol_tool-1.0.0.3/symbol_tool/__init__.py

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

symbol_tool-1.0.0.3/symbol_tool/__main__.py

@@ -0,0 +1,4 @@
+from symbol_tool.main import main
+
+if __name__ == "__main__":
+    main()

symbol_tool-1.0.0.3/symbol_tool/clean.py

@@ -0,0 +1,47 @@
+from .config import ArtifactoryClient, AqlResponseFileMeta, AqlRequestSearchData
+
+
+def process_clean_file(file_meta: AqlResponseFileMeta, client: ArtifactoryClient):
+    # 删除文件
+    file_url = client.get_url(f'{file_meta.repo}/{file_meta.path}/{file_meta.name}')
+    resp = client.delete(file_url)
+    if resp.status_code == 204:
+        print(f"{file_url} -> 删除成功")
+        process_clean_folder(file_meta, client)
+    else:
+        print(f"{file_url} -> 删除失败:{resp.status_code}")
+
+
+def process_clean_folder(file_meta: AqlResponseFileMeta, client: ArtifactoryClient):
+    # 获取文件所在目录是否为空, 如果为空, 那么删除这个目录
+    data = AqlRequestSearchData()
+    data.type = "file"
+    data.repo = file_meta.repo
+    data.path = file_meta.path
+    data.name = '*'
+    file_list = client.get_list(data)
+    if len(file_list.results) != 0:
+        return
+
+    folder_url = client.get_url(f'{file_meta.repo}/{file_meta.path}')
+    resp = client.delete(folder_url)
+    if resp.status_code == 204:
+        print(f"{folder_url} -> 删除成功")
+    else:
+        print(f"{folder_url} -> 删除失败:{resp.status_code}")
+
+
+def process_repository(client: ArtifactoryClient):
+    # 查询所有文件
+    data = AqlRequestSearchData()
+    data.repo = client.repo
+    data.name = 'UP*'
+    data.updated_before = '180d'
+    
+    result = client.get_list(data)
+    print(f"共找到 {len(result.results)} 个文件")
+
+    for item in result.results:
+        if item.name.startswith("UP"):
+            continue
+        process_clean_file(item, client)

symbol_tool-1.0.0.3/symbol_tool/config.py

@@ -0,0 +1,185 @@
+from dataclasses import dataclass, field, asdict
+from typing import Any
+
+import requests
+import json
+
+
+class AqlRequestSearchData:
+    type: str = "file"
+    repo: str | None = None
+    path: str | None = None
+    name: str | None = None
+    nname: str | None = None
+    created_before: str | None = None
+    updated_before: str | None = None
+    limit: int | None = None
+
+    def build(self):
+        find_json: dict[str, Any] = {}
+        find_json["type"] = self.type
+        if self.repo:
+            find_json["repo"] = {"$match": self.repo}
+        if self.path:
+            find_json["path"] = {"$match": self.path}
+        if self.name:
+            find_json["name"] = {"$match": self.name}
+        if self.nname:
+            find_json["name"] = {"$nmatch": self.nname}
+        if self.created_before:
+            find_json["created"] = {"$before": self.created_before}
+        if self.updated_before:
+            find_json["updated"] = {"$before": self.updated_before}
+        aql = f'items.find({find_json}).include("repo", "path", "name", "created", "updated")'
+        if self.limit:
+            aql += f".limit({self.limit})"
+        return aql
+
+
+@dataclass(frozen=True)
+class AqlResponseFileMeta:
+    repo: str | None = None
+    path: str | None = None
+    name: str | None = None
+    created: str | None = None
+    updated: str | None = None
+
+    def to_path(self) -> str:
+        if self.path and self.name:
+            return f"{self.path}/{self.name}"
+        if self.name:
+            return f"{self.name}"
+        return ""
+
+
+@dataclass(frozen=True)
+class AqlResponseFileRange:
+    start_pos: int = 0
+    end_pos: int = 0
+    total: int = 0
+    limit: int = 0
+
+
+@dataclass(frozen=True)
+class AqlResponseSearch:
+    results: list[AqlResponseFileMeta]
+    range: AqlResponseFileRange
+
+    @classmethod
+    def from_dict(cls, data: dict) -> "AqlResponseSearch":
+        """从字典反序列化"""
+        parsed_results = [
+            AqlResponseFileMeta(**item) for item in data.get("results", [])
+        ]
+        parsed_range = AqlResponseFileRange(**data.get("range", {}))
+        return cls(results=parsed_results, range=parsed_range)
+
+    def to_dict(self) -> dict:
+        """序列化为字典"""
+        return asdict(self)
+
+    @classmethod
+    def from_json(cls, json_str: str) -> "AqlResponseSearch":
+        """从JSON字符串反序列化"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_json(self) -> str:
+        """序列化为JSON字符串"""
+        return json.dumps(self.to_dict(), ensure_ascii=False, indent=2)
+
+
+@dataclass(frozen=True)
+class ArtifactoryClient:
+    base: str
+    repo: str
+    username: str
+    password: str
+    session: requests.Session
+
+    def __post_init__(self):
+        self.session.auth = (self.username, self.password)
+
+    def get_url(self, path):
+        return f"{self.base}/{self.repo}/{path}"
+
+    def get_list(self, data: AqlRequestSearchData) -> AqlResponseSearch:
+        request_url = f"{self.base}/api/search/aql"
+        request_data = data.build().replace("'", '"')
+        print(f"Requesting AQL: {request_data}")
+        response = self.post(request_url, data=request_data)
+        if response.status_code != 200:
+            return AqlResponseSearch(results=[], range=AqlResponseFileRange())
+        return AqlResponseSearch.from_dict(response.json())
+
+    def request(self, method, url, **kwargs):
+        return self.session.request(method=method, url=url, **kwargs)
+
+    def get(self, url, **kwargs):
+        return self.request("GET", url, **kwargs)
+
+    def post(self, url, **kwargs):
+        return self.request("POST", url, **kwargs)
+
+    def put(self, url, **kwargs):
+        return self.request("PUT", url, **kwargs)
+
+    def head(self, url, **kwargs):
+        return self.request("HEAD", url, **kwargs)
+
+    def delete(self, url, **kwargs):
+        return self.request("DELETE", url, **kwargs)
+
+
+CLIENTS = dict[str, ArtifactoryClient](
+    {
+        "local": ArtifactoryClient(
+            base="http://192.168.1.250:8081/artifactory",
+            repo="symbol-local",
+            username="qiujuncheng",
+            password="Qq1966409103",
+            session=requests.Session(),
+        ),
+        "cam": ArtifactoryClient(
+            base="http://192.168.1.250:8081/artifactory",
+            repo="symbol-cam",
+            username="qiujuncheng",
+            password="Qq1966409103",
+            session=requests.Session(),
+        ),
+        "chair": ArtifactoryClient(
+            base="http://192.168.1.250:8081/artifactory",
+            repo="symbol-chair",
+            username="qiujuncheng",
+            password="Qq1966409103",
+            session=requests.Session(),
+        ),
+        "cad": ArtifactoryClient(
+            base="http://192.168.1.250:8081/artifactory",
+            repo="symbol-cad",
+            username="qiujuncheng",
+            password="Qq1966409103",
+            session=requests.Session(),
+        ),
+        "sdk": ArtifactoryClient(
+            base="http://192.168.1.250:8081/artifactory",
+            repo="symbol-sdk",
+            username="qiujuncheng",
+            password="Qq1966409103",
+            session=requests.Session(),
+        ),
+        "model-scan": ArtifactoryClient(
+            base="http://192.168.1.250:8081/artifactory",
+            repo="symbol-model-scan",
+            username="qiujuncheng",
+            password="Qq1966409103",
+            session=requests.Session(),
+        ),
+        "other": ArtifactoryClient(
+            base="http://192.168.1.250:8081/artifactory",
+            repo="symbol-other",
+            username="qiujuncheng",
+            password="Qq1966409103",
+            session=requests.Session(),
+        ),
+    },
+)

symbol_tool-1.0.0.3/symbol_tool/fileio.py

@@ -0,0 +1,15 @@
+def sanitize_path_fragment(value):
+    return value.replace("/", "_").replace("\\", "_")
+
+
+def build_temp_filename(value, name=None, suffix=".tmp"):
+    safe_value = sanitize_path_fragment(value)
+    if name:
+        return f"{safe_value}_{name}{suffix}"
+    return f"{safe_value}{suffix}"
+
+
+def write_stream_to_file(response, file_path, chunk_size=8192):
+    with open(file_path, "wb") as file_handle:
+        for chunk in response.iter_content(chunk_size=chunk_size):
+            file_handle.write(chunk)

symbol_tool-1.0.0.3/symbol_tool/fix.py

@@ -0,0 +1,63 @@
+import os
+import tqdm
+
+from .config import ArtifactoryClient, AqlResponseFileMeta, AqlRequestSearchData
+from .fileio import build_temp_filename, write_stream_to_file
+from .symbols import file_hash
+
+
+def fix_artifact(file_meta: AqlResponseFileMeta, client: ArtifactoryClient):
+    source_url = client.get_url(f'{file_meta.repo}/{file_meta.path}/{file_meta.name}')
+    source_response = client.get(source_url, stream=True)
+    if source_response.status_code != 200:
+        return f"Failed: get file, code={source_response.status_code}"
+
+    temp_name = build_temp_filename(file_meta.path, name=file_meta.name)
+
+    write_stream_to_file(source_response, temp_name)
+
+    # 获取文件的真实路径
+    target_hash = file_hash(temp_name)
+    target_url = client.get_url(f'{file_meta.repo}/{file_meta.name}/{target_hash}/{file_meta.name}')
+
+    # 如果路径相同, 那么不需要任何操作
+    if target_url == source_url:
+        os.remove(temp_name)
+        return f"Skipped: {file_meta.path}"
+
+    # 删除文件
+    client.delete(client.get_url(f'{file_meta.repo}/{file_meta.path}/{file_meta.name}'))
+    client.delete(client.get_url(f'{file_meta.repo}/{file_meta.path}'))
+
+    # 上传文件
+    with open(temp_name, 'rb') as f:
+        target_response = client.head(target_url)
+        if target_response.status_code == 200:
+            os.remove(temp_name)
+            return f"Skipped: target exists {target_hash}/{file_meta.name}"
+        target_response = client.put(target_url, data=f)
+        if target_response.status_code not in (200, 201):
+            os.remove(temp_name)
+            return f"Failed: upload file, code={target_response.status_code}"
+
+    os.remove(temp_name)
+    return f"Fixed: {file_meta.path} -> {target_hash}"
+
+
+def process_artifacts(client: ArtifactoryClient):
+    # 目标为重新计算文件的实际路径, 并进行重命名
+    data = AqlRequestSearchData()
+    data.repo = client.repo
+    
+    result = client.get_list(data)
+    print(f"共找到 {len(result.results)} 个文件在仓库 '{client.repo}' 中...")
+
+    tqdm_bar = tqdm.tqdm(total=len(result.results), unit="file")
+
+    for file in result.results:
+        msg = fix_artifact(file, client)
+        if msg.startswith("Fixed"):
+            tqdm_bar.set_description(f"{msg:50}")
+        tqdm_bar.update(1)
+
+    tqdm_bar.close()

symbol_tool-1.0.0.3/symbol_tool/main.py

@@ -0,0 +1,99 @@
+import argparse
+
+from . import __version__
+from . import clean, fix, query, transfer, upload
+from .config import CLIENTS
+
+
+def build_parser():
+    parser = argparse.ArgumentParser(description="symbol-tool 命令行工具")
+    parser.add_argument(
+        "-V", "--version", action="version", version=f"%(prog)s {__version__}"
+    )
+
+    options = tuple(CLIENTS.keys())
+
+    subparsers = parser.add_subparsers(dest="command", required=True)
+
+    upload_parser = subparsers.add_parser("upload", help="上传符号文件")
+    upload_parser.add_argument(
+        "-t", "--target", choices=options, required=True, help="目标别名"
+    )
+    upload_parser.add_argument(
+        "-p", "--pattern", required=True, help="文件匹配模式，例如 ../Bin/*.pdb"
+    )
+    upload_parser.set_defaults(handler=handle_upload_command)
+
+    fix_parser = subparsers.add_parser("fix", help="修复仓库中的符号路径")
+    fix_parser.add_argument(
+        "-t", "--target", choices=options, required=True, help="目标别名"
+    )
+    fix_parser.set_defaults(handler=handle_fix_command)
+
+    transfer_parser = subparsers.add_parser("transfer", help="迁移仓库中的符号文件")
+    transfer_parser.add_argument(
+        "-s", "--source", choices=options, required=True, help="源别名"
+    )
+    transfer_parser.add_argument(
+        "-t", "--target", choices=options, required=True, help="目标别名"
+    )
+    transfer_parser.set_defaults(handler=handle_transfer_command)
+
+    clean_parser = subparsers.add_parser("clean", help="清理仓库中的历史文件")
+    clean_parser.add_argument(
+        "-t", "--target", choices=options, required=True, help="目标别名"
+    )
+    clean_parser.set_defaults(handler=handle_clean_command)
+
+    query_parser = subparsers.add_parser("query", help="查询仓库中的符号文件")
+    query_parser.add_argument(
+        "-t", "--target", choices=options, required=True, help="目标别名"
+    )
+    query_parser.add_argument("-n", "--name", help="按文件名匹配，例如 *.pdb")
+    query_parser.add_argument("-nn", "--nname", help="按文件名排除匹配，例如 UP*")
+    query_parser.add_argument("-p", "--path", help="按路径匹配，例如 */release/*")
+    query_parser.add_argument(
+        "-cb", "--created-before", help="按创建时间经过多久匹配，例如 180d"
+    )
+    query_parser.add_argument(
+        "-ub", "--updated-before", help="按更新时间经过多久匹配，例如 180d"
+    )
+    query_parser.add_argument("-l", "--limit", type=int, help="限制返回的结果数量")
+
+    query_parser.set_defaults(handler=handle_query_command)
+
+    return parser
+
+
+def handle_upload_command(args):
+    return upload.process_upload(args.pattern, CLIENTS[args.target])
+
+
+def handle_fix_command(args):
+    return fix.process_artifacts(CLIENTS[args.target])
+
+
+def handle_transfer_command(args):
+    return transfer.process_artifacts(CLIENTS[args.source], CLIENTS[args.target])
+
+
+def handle_clean_command(args):
+    return clean.process_repository(CLIENTS[args.target])
+
+
+def handle_query_command(args):
+    return query.process_query(
+        CLIENTS[args.target],
+        name=args.name,
+        nname=args.nname,
+        created=args.created_before,
+        updated=args.updated_before,
+        path=args.path,
+        limit=args.limit,
+    )
+
+
+def main(argv=None):
+    parser = build_parser()
+    args = parser.parse_args(argv)
+    return args.handler(args)

symbol_tool-1.0.0.3/symbol_tool/query.py

@@ -0,0 +1,30 @@
+from .config import ArtifactoryClient, AqlRequestSearchData
+
+
+def process_query(
+    client: ArtifactoryClient,
+    *,
+    name: str | None = None,
+    nname: str | None = None,
+    created: str | None = None,
+    updated: str | None = None,
+    path: str | None = None,
+    limit: int = 100,
+):
+    data = AqlRequestSearchData()
+    data.repo = client.repo
+    data.path = path
+    data.name = name
+    data.nname = nname
+    data.created_before = created
+    data.updated_before = updated
+    data.limit = limit or 100
+    result = client.get_list(data)
+
+    print(f"共找到 {len(result.results)} 个符号文件")
+    for item in result.results:
+        print(item.to_path())
+        print(f"  created: {item.created}")
+        print(f"  updated: {item.updated}")
+
+    return result

symbol_tool-1.0.0.3/symbol_tool/symbols.py

@@ -0,0 +1,32 @@
+from symstore import pe, pdb
+
+
+def probe_pe_hash(file_name):
+    try:
+        pefile = pe.PEFile(file_name)
+    except pe.PESignatureNotFoundError:
+        return None
+
+    return "%.8X%.4x" % (pefile.TimeDateStamp, pefile.SizeOfImage)
+
+
+def probe_pdb_hash(file_name):
+    try:
+        pdbfile = pdb.PDBFile(file_name)
+    except pdb.PDBInvalidSignature:
+        return None
+
+    age_str = "" if pdbfile.age is None else "%x" % pdbfile.age
+    return "%s%s" % (pdbfile.guid, age_str)
+
+
+def file_hash(file_name):
+    pe_hash = probe_pe_hash(file_name)
+    if pe_hash is not None:
+        return pe_hash
+
+    pdb_hash = probe_pdb_hash(file_name)
+    if pdb_hash is not None:
+        return pdb_hash
+
+    raise ValueError("Unknown file type")

symbol_tool-1.0.0.3/symbol_tool/transfer.py

@@ -0,0 +1,77 @@
+from concurrent.futures import ThreadPoolExecutor, as_completed
+import os
+import tqdm
+
+from .config import ArtifactoryClient, AqlResponseFileMeta, AqlRequestSearchData
+from .fileio import build_temp_filename, write_stream_to_file
+
+
+def transfer_artifact(
+    file_meta: AqlResponseFileMeta,
+    source: ArtifactoryClient,
+    target: ArtifactoryClient,
+):
+    file_path = file_meta.to_path()
+    source_url = source.get_url(file_path)
+    target_url = target.get_url(file_path)
+
+    source_response = source.head(source_url)
+    if source_response.status_code != 200:
+        return f"Failed: Source response is {source_response.status_code}"
+
+    target_response = target.head(target_url)
+    if target_response.status_code == 200:
+        # 如果目标已存在, 那么删除source中的文件
+        delete_response = source.session.delete(source_url)
+        if delete_response.status_code in (200, 204):
+            return f"Deleted: {file_path}"
+        return f"Skipped: {file_path}"
+
+    source_response = source.get(source_url, stream=True)
+    if source_response.status_code != 200:
+        return f"Failed: Source response is {source_response.status_code}"
+
+    temp_filename = build_temp_filename(file_path)
+
+    write_stream_to_file(source_response, temp_filename)
+
+    # 上传文件，使用原始文件路径
+    with open(temp_filename, "rb") as f:
+        target_response = target.put(target_url, data=f)
+        if target_response.status_code not in (200, 201):
+            os.remove(temp_filename)
+            return f"Failed: Target response is {target_response.status_code}"
+
+    os.remove(temp_filename)
+    # 如果转移成功, 那么删除source中的文件
+    delete_response = source.session.delete(source_url)
+    if delete_response.status_code not in (200, 204):
+        return f"Cannot Delete: {file_path}"
+    return f"Success: {file_path}"
+
+
+def process_artifacts(source: ArtifactoryClient, target: ArtifactoryClient):
+    data = AqlRequestSearchData()
+    data.repo = source.repo
+    data.nname = "UP*"
+
+    result = source.get_list(data)
+    print(f"Transferring {len(result.results)} files from '{source.repo}' to '{target.repo}'...")
+
+    tqdm_bar = tqdm.tqdm(total=len(result.results), desc="Transferring files", unit="file")
+
+    with ThreadPoolExecutor(max_workers=8) as executor:
+        # 提交所有下载任务
+        futures = {}
+
+        for file in result.results:
+            future = executor.submit(transfer_artifact, file, source, target)
+            futures[future] = file
+
+        # 等待所有任务完成并处理结果
+        for future in as_completed(futures):
+            if future.result():
+                tqdm_bar.set_description(f"{future.result():50}")
+            tqdm_bar.update(1)
+
+    tqdm_bar.close()

symbol_tool-1.0.0.3/symbol_tool/upload.py

@@ -0,0 +1,44 @@
+import os
+import glob
+import pathlib
+from concurrent.futures import ThreadPoolExecutor, as_completed
+
+from .config import ArtifactoryClient
+from .symbols import file_hash
+
+MAX_WORKERS = 16
+
+
+def process_upload_file(path, client: ArtifactoryClient):
+    hash = file_hash(path)
+    name = os.path.basename(path)
+
+    file_url = client.get_url(f"{name}/{hash}/{name}")
+    head_resp = client.head(file_url)
+    if head_resp.status_code == 200:
+        print(f"跳过 (已存在): {path}")
+        return
+
+    with open(path, "rb") as f:
+        response = client.put(file_url, data=f)
+        if response.status_code in (200, 201):
+            print(f"上传成功: {path} -> {file_url}")
+        else:
+            print(f"上传失败: {path} -> {response.status_code}")
+
+
+def process_upload(pattern: str, client: ArtifactoryClient):
+    files = [
+        pathlib.Path(f).resolve().as_posix()
+        for f in glob.glob(pattern, recursive=True)
+        if f.lower().endswith((".pdb", ".dll", ".exe"))
+    ]
+
+    if not files:
+        print(f"没有匹配的文件: {pattern}")
+        return
+
+    with ThreadPoolExecutor(max_workers=MAX_WORKERS) as executor:
+        futures = [executor.submit(process_upload_file, path, client) for path in files]
+        for future in as_completed(futures):
+            future.result()

symbol_tool-1.0.0.3/symbol_tool.egg-info/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: symbol-tool
+Version: 1.0.0.3
+Summary: 符号管理工具
+Author-email: Vorga <qiujuncheng@up3dtech.com>
+Project-URL: Homepage, http://www.vorga.cn:8081/up3d/software/tool/symbol-tool
+Keywords: up3d,symbol,tool
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: requests
+Requires-Dist: symstore
+Requires-Dist: tqdm
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: pyinstaller; extra == "dev"
+Requires-Dist: pyinstaller-versionfile; extra == "dev"
+
+# symbol-tool
+
+用于管理符号文件仓库的命令行工具。
+
+## 快速开始
+
+```bash
+pip install -e .
+symbol-tool --version
+```
+
+## 打包
+
+```bash
+pyinstaller symbol_tool.spec --clean
+```
+
+## 命令示例
+
+```bash
+symbol-tool upload -t test -p "./**/*.pdb"
+symbol-tool fix -t test
+symbol-tool transfer --source test --target test
+symbol-tool clean -t test
+```
+
+`target` 是别名。每个别名对应“某个服务器 + 某个路径”，定义在 [symbol_tool/config.py](symbol_tool/config.py)。
+
+## 测试
+
+```bash
+pytest tests
+```

symbol_tool-1.0.0.3/symbol_tool.egg-info/SOURCES.txt

@@ -0,0 +1,22 @@
+README.md
+pyproject.toml
+symbol_tool/__init__.py
+symbol_tool/__main__.py
+symbol_tool/clean.py
+symbol_tool/config.py
+symbol_tool/fileio.py
+symbol_tool/fix.py
+symbol_tool/main.py
+symbol_tool/query.py
+symbol_tool/symbols.py
+symbol_tool/transfer.py
+symbol_tool/upload.py
+symbol_tool.egg-info/PKG-INFO
+symbol_tool.egg-info/SOURCES.txt
+symbol_tool.egg-info/dependency_links.txt
+symbol_tool.egg-info/entry_points.txt
+symbol_tool.egg-info/not-zip-safe
+symbol_tool.egg-info/requires.txt
+symbol_tool.egg-info/top_level.txt
+tests/test_query.py
+tests/test_upload.py

symbol_tool-1.0.0.3/symbol_tool.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

symbol_tool-1.0.0.3/symbol_tool.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+symbol-tool = symbol_tool.main:main

symbol_tool-1.0.0.3/symbol_tool.egg-info/not-zip-safe

@@ -0,0 +1 @@
+

symbol_tool-1.0.0.3/symbol_tool.egg-info/requires.txt

@@ -0,0 +1,10 @@
+requests
+symstore
+tqdm
+
+[dev]
+build
+pytest
+pytest-cov
+pyinstaller
+pyinstaller-versionfile

symbol_tool-1.0.0.3/symbol_tool.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+assets
+symbol_tool

symbol_tool-1.0.0.3/tests/test_query.py

@@ -0,0 +1,85 @@
+from unittest.mock import Mock
+
+from symbol_tool import query
+from symbol_tool.config import AqlResponseFileMeta, AqlResponseFileRange, AqlResponseSearch
+
+
+class TestQueryRequest:
+    def test_build_query_request_uses_client_repo_by_default(self):
+        client = Mock()
+        client.repo = "symbol-local"
+
+        data = query.build_query_request(client)
+
+        assert data.repo == "symbol-local"
+        assert data.path == "*"
+        assert data.name == "*"
+        assert data.created_before == "*"
+        assert data.updated_before == "*"
+
+    def test_build_query_request_accepts_all_filters(self):
+        client = Mock()
+        client.repo = "symbol-local"
+
+        data = query.build_query_request(
+            client,
+            name="*.pdb",
+            created="2026-04-01*",
+            updated="2026-04-02*",
+            path="*/release/*",
+            repo="symbol-*",
+        )
+
+        assert data.repo == "symbol-*"
+        assert data.name == "*.pdb"
+        assert data.created_before == "2026-04-01*"
+        assert data.updated_before == "2026-04-02*"
+        assert data.path == "*/release/*"
+
+
+class TestQueryProcess:
+    def test_process_query_prints_results(self, capsys):
+        client = Mock()
+        client.repo = "symbol-local"
+        client.get_list.return_value = AqlResponseSearch(
+            results=[
+                AqlResponseFileMeta(
+                    repo="symbol-local",
+                    path="demo.pdb/ABC123",
+                    name="demo.pdb",
+                    created="2026-04-01T10:00:00.000Z",
+                    updated="2026-04-01T10:05:00.000Z",
+                )
+            ],
+            range=AqlResponseFileRange(total=1),
+        )
+
+        result = query.process_query(client, name="demo.pdb")
+
+        assert result.range.total == 1
+        output = capsys.readouterr().out
+        assert "共找到 1 个符号文件" in output
+        assert "symbol-local/demo.pdb/ABC123/demo.pdb" in output
+        assert "created: 2026-04-01T10:00:00.000Z" in output
+        assert "updated: 2026-04-01T10:05:00.000Z" in output
+
+    def test_process_query_passes_filters_to_client(self):
+        client = Mock()
+        client.repo = "symbol-local"
+        client.get_list.return_value = AqlResponseSearch(results=[], range=AqlResponseFileRange())
+
+        query.process_query(
+            client,
+            name="*.dll",
+            created="2026-04-*",
+            updated="2026-04-*",
+            path="*/bin/*",
+            repo="symbol-cam",
+        )
+
+        request = client.get_list.call_args.args[0]
+        assert request.repo == "symbol-cam"
+        assert request.name == "*.dll"
+        assert request.created == "2026-04-*"
+        assert request.updated == "2026-04-*"
+        assert request.path == "*/bin/*"

symbol_tool-1.0.0.3/tests/test_upload.py

@@ -0,0 +1,113 @@
+from pathlib import Path
+from unittest.mock import Mock
+
+from symbol_tool import upload
+
+
+class DummyResponse:
+    def __init__(self, status_code=200):
+        self.status_code = status_code
+
+
+class ImmediateExecutor:
+    def __init__(self, *args, **kwargs):
+        self.submitted = []
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        return False
+
+    def submit(self, func, *args, **kwargs):
+        result = func(*args, **kwargs)
+        future = Mock()
+        future.result.return_value = result
+        self.submitted.append((func, args, kwargs))
+        return future
+
+
+class TestUploadFile:
+    def test_process_upload_file_skips_existing(self, tmp_path, monkeypatch, capsys):
+        file_path = tmp_path / "demo.pdb"
+        file_path.write_bytes(b"data")
+
+        monkeypatch.setattr(upload, "file_hash", lambda _: "HASH")
+
+        client = Mock()
+        client.get_url.return_value = "http://repo/symbol-local/demo.pdb/HASH/demo.pdb"
+        client.head.return_value = DummyResponse(status_code=200)
+
+        upload.process_upload_file(str(file_path), client)
+
+        client.put.assert_not_called()
+        assert "跳过 (已存在)" in capsys.readouterr().out
+
+    def test_process_upload_file_upload_success(self, tmp_path, monkeypatch, capsys):
+        file_path = tmp_path / "demo.pdb"
+        file_path.write_bytes(b"data")
+
+        monkeypatch.setattr(upload, "file_hash", lambda _: "HASH")
+
+        client = Mock()
+        client.get_url.return_value = "http://repo/symbol-local/demo.pdb/HASH/demo.pdb"
+        client.head.return_value = DummyResponse(status_code=404)
+        client.put.return_value = DummyResponse(status_code=201)
+
+        upload.process_upload_file(str(file_path), client)
+
+        client.put.assert_called_once()
+        assert "上传成功" in capsys.readouterr().out
+
+    def test_process_upload_file_upload_failed(self, tmp_path, monkeypatch, capsys):
+        file_path = tmp_path / "demo.pdb"
+        file_path.write_bytes(b"data")
+
+        monkeypatch.setattr(upload, "file_hash", lambda _: "HASH")
+
+        client = Mock()
+        client.get_url.return_value = "http://repo/symbol-local/demo.pdb/HASH/demo.pdb"
+        client.head.return_value = DummyResponse(status_code=404)
+        client.put.return_value = DummyResponse(status_code=500)
+
+        upload.process_upload_file(str(file_path), client)
+
+        assert "上传失败" in capsys.readouterr().out
+
+
+class TestUploadPattern:
+    def test_process_upload_reports_when_no_files(self, monkeypatch, capsys):
+        monkeypatch.setattr(upload.glob, "glob", lambda pattern, recursive: [])
+
+        client = Mock()
+        upload.process_upload("./*.pdb", client)
+
+        assert "没有匹配的文件" in capsys.readouterr().out
+
+    def test_process_upload_filters_extensions_and_submits_jobs(self, monkeypatch, tmp_path):
+        pdb_file = tmp_path / "a.pdb"
+        dll_file = tmp_path / "b.dll"
+        txt_file = tmp_path / "c.txt"
+        pdb_file.write_bytes(b"pdb")
+        dll_file.write_bytes(b"dll")
+        txt_file.write_bytes(b"txt")
+
+        monkeypatch.setattr(
+            upload.glob,
+            "glob",
+            lambda pattern, recursive: [str(pdb_file), str(dll_file), str(txt_file)],
+        )
+        monkeypatch.setattr(upload, "ThreadPoolExecutor", ImmediateExecutor)
+        monkeypatch.setattr(upload, "as_completed", lambda futures: futures)
+
+        submitted = []
+
+        def fake_process_upload_file(file_path, client):
+            submitted.append(Path(file_path).name)
+
+        monkeypatch.setattr(upload, "process_upload_file", fake_process_upload_file)
+
+        client = Mock()
+        upload.process_upload("./**/*", client)
+
+        assert submitted == ["a.pdb", "b.dll"]