> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Files

[View source](https://github.com/wandb/wandb/blob/main/wandb/apis/public/files.py#L79)

## 클래스 wandb.apis.public.Files

`File` 객체 컬렉션에 대한 지연 이터레이터입니다.

run 중 W\&B에 업로드된 파일에 액세스하고 관리합니다. 대량의 파일 컬렉션을 반복할 때 페이지 매김을
자동으로 처리합니다.

```python theme={"system"}
(service_api: 'ServiceApi',
run: 'Run',
names: 'list[str] | None' = None,
per_page: 'int' = 50,
upload: 'bool' = False,
pattern: 'str | None' = None)
```

## 인수

**service\_api** `ServiceApi`

W\&B를 쿼리하는 데 사용할 서비스 API 인스턴스입니다.

**run** `Run`

파일을 포함하는 run 객체입니다.

**names** `list[str] | None`

파일을 필터링할 파일 이름의 목록입니다.

**per\_page** `int`

페이지당 가져올 파일 수입니다.

**upload** `bool`

`True`인 경우 각 파일의 업로드 URL을 가져옵니다.

**pattern** `str | None`

W\&B에서 파일을 반환할 때 일치시킬 패턴입니다. 이 패턴은 mySQL의 LIKE 구문을 사용하므로 .json으로 끝나는 모든 파일과 일치시키려면 "%.json"을 사용하세요. names와 pattern이 모두 제공되면 ValueError가 발생합니다.

## 예시

```python theme={"system"}
from wandb.apis.public.files import Files
from wandb.apis.public.api import Api

# 예시 run 객체
run = Api().run("entity/project/run-id")

# run의 파일을 조회
files = run.files()

# 파일을 순회
for file in files:
    print(file.name)
    print(file.url)
    print(file.size)

    # 파일을 다운로드
    file.download(root="download_directory", replace=True)
```

## 메서드

### 방법 Paginator.**next**()

```python theme={"system"}
self
```

이터레이터의 다음 항목을 반환합니다. 더 이상 항목이 없으면 StopIteration을 발생시킵니다.
