此页面由 AI 自动翻译。查看英文原版
最后更新

本页目录

  • 函数
  • download_from_remote
  • get_input_bases
  • get_protocol
  • resolve_input_path
  • resolve_path
  • set_input_base
  • upload_to_remote
Claude CodeCodexCursor
Luxonis 智能体工具包为你常用的编程智能体加载 Luxonis 上下文与技能,更快地基于 OAK 开发应用。
安装工具包

filesystem_utils

最后更新
Python API: modelconverter.utils.filesystem_utilsmodelconverter 读取的本地和远程路径的解析。模型、配置和校准数据可以作为本地路径或存储桶存储的 URL 提供。这里的辅助函数会下载远程文件,将结果上传回去,并根据活动配置文件的目录和共享根目录(容器内的缓存目录,主机上的工作目录)解析相对本地路径。

函数

download_from_remote

Python
1def download_from_remote(url: str, dest: PathType, max_files: int = -1) -> Path:
从远程存储桶下载文件。它可以是单个文件、整个目录,或目录中的 max_files。参数
  • url (str): 要下载的文件或目录的 URL。
  • dest (PathType): 下载到的本地目录。
  • max_files (int): 从目录下载的最大文件数。负数表示无限制。
返回
  • Path: 下载的文件或目录的路径。

get_input_bases

Python
1def get_input_bases() -> list[Path]:
返回按顺序尝试的基目录,用于不存在的相对本地路径。活动配置的目录优先,然后是默认根目录。默认目录必须作为备用:从远程存储下载的配置会进入缓存,因此它引用的相对于共享根目录的路径否则将无法解析。

get_protocol

Python
1def get_protocol(url: str) -> str:
返回 LuxonisFileSystem 协议。

resolve_input_path

Python
1def resolve_input_path(string: str) -> Path | None:
根据输入基目录解析相对本地路径。如果路径在任何基目录下都不存在,则返回 None。

resolve_path

Python
1def resolve_path(string: str, dest: Path) -> Path:
从远程下载文件或返回路径。

set_input_base

Python
1def set_input_base(base: Path | None):
设置用于解析相对本地路径的基目录。传入 None 以重置为默认值。

upload_to_remote

Python
1def upload_to_remote(local_path: PathType, url: str, put_file_plugin: str | None = None):
将文件或目录上传到远程存储桶。