# filesystem_utils

Python API: `modelconverter.utils.filesystem_utils`

modelconverter 读取的本地和远程路径的解析。

模型、配置和校准数据可以作为本地路径或存储桶存储的 URL 提供。这里的辅助函数会下载远程文件，将结果上传回去，并根据活动配置文件的目录和共享根目录（容器内的缓存目录，主机上的工作目录）解析相对本地路径。

## 函数

### download_from_remote

```python
def 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
def get_input_bases() -> list[Path]:
```

返回按顺序尝试的基目录，用于不存在的相对本地路径。

活动配置的目录优先，然后是默认根目录。默认目录必须作为备用：从远程存储下载的配置会进入缓存，因此它引用的相对于共享根目录的路径否则将无法解析。

### get_protocol

```python
def get_protocol(url: str) -> str:
```

返回 LuxonisFileSystem 协议。

### resolve_input_path

```python
def resolve_input_path(string: str) -> Path | None:
```

根据输入基目录解析相对本地路径。

如果路径在任何基目录下都不存在，则返回 `None`。

### resolve_path

```python
def resolve_path(string: str, dest: Path) -> Path:
```

从远程下载文件或返回路径。

### set_input_base

```python
def set_input_base(base: Path | None):
```

设置用于解析相对本地路径的基目录。

传入 `None` 以重置为默认值。

### upload_to_remote

```python
def upload_to_remote(local_path: PathType, url: str, put_file_plugin: str | None = None):
```

将文件或目录上传到远程存储桶。
