# 디렉터리 {#directories}

Tuist는 [XDG Base Directory Specification](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html)을 따라 시스템의 여러 디렉터리에 파일을 정리합니다. 이를 통해 구성, 캐시 및 상태 파일을 깔끔하고 표준화된 방식으로 관리할 수 있습니다.

## 지원되는 환경 변수 {#supported-environment-variables}

Tuist는 표준 XDG 변수와 Tuist 전용 접두사 변형을 모두 지원합니다. Tuist 전용 변형(`TUIST_` 접두사)이 우선 적용되므로 다른 애플리케이션과 별도로 Tuist를 구성할 수 있습니다.

### 구성 디렉터리 {#configuration-directory}

**환경 변수:**
- `TUIST_XDG_CONFIG_HOME` (우선 적용)
- `XDG_CONFIG_HOME`

**기본값:** `~/.config/tuist`

**사용 용도:**
- 서버 자격 증명 (`credentials/{host}.json`)

**예시:**
```bash
# Set Tuist-specific config directory
export TUIST_XDG_CONFIG_HOME=/custom/config
tuist auth login

# Or use standard XDG variable
export XDG_CONFIG_HOME=/custom/config
tuist auth login
```

### 캐시 디렉터리 {#cache-directory}

**환경 변수:**
- `TUIST_XDG_CACHE_HOME` (우선 적용)
- `XDG_CACHE_HOME`

**기본값:** `~/.cache/tuist`

**사용 용도:**
- **Plugins**: 다운로드 및 컴파일된 플러그인 캐시
- **ProjectDescriptionHelpers**: 컴파일된 프로젝트 설명 헬퍼
- **Manifests**: 캐시된 매니페스트 파일
- **Projects**: 생성된 자동화 프로젝트 캐시
- **EditProjects**: edit 명령어용 캐시
- **Runs**: 테스트 및 빌드 실행 분석 데이터
- **Binaries**: 빌드 아티팩트 바이너리(환경 간 공유 불가)
- **SelectiveTests**: 선택적 테스팅 캐시

**예시:**
```bash
# Set Tuist-specific cache directory
export TUIST_XDG_CACHE_HOME=/tmp/tuist-cache
tuist cache

# Or use standard XDG variable
export XDG_CACHE_HOME=/tmp/cache
tuist cache
```

### 상태 디렉터리 {#state-directory}

**환경 변수:**
- `TUIST_XDG_STATE_HOME` (우선 적용)
- `XDG_STATE_HOME`

**기본값:** `~/.local/state/tuist`

**사용 용도:**
- **Sessions**: 세션 로그 및 네트워크 기록 (`sessions/{uuid}/`)
- **Locks**: 인증 잠금 파일 (`{handle}.sock`)

**예시:**
```bash
# Set Tuist-specific state directory
export TUIST_XDG_STATE_HOME=/var/log/tuist
tuist generate

# Or use standard XDG variable
export XDG_STATE_HOME=/var/log
tuist generate
```

## 우선순위 순서 {#precedence-order}

사용할 디렉터리를 결정할 때 Tuist는 다음 순서로 환경 변수를 확인합니다:

1. **Tuist 전용 변수** (예: `TUIST_XDG_CONFIG_HOME`)
2. **표준 XDG 변수** (예: `XDG_CONFIG_HOME`)
3. **기본 위치** (예: `~/.config/tuist`)

이를 통해 다음과 같이 할 수 있습니다:
- 표준 XDG 변수를 사용하여 모든 애플리케이션을 일관되게 정리
- Tuist에 다른 위치가 필요할 경우 Tuist 전용 변수로 재정의
- 추가 구성 없이 합리적인 기본값 활용

## 일반적인 사용 사례 {#common-use-cases}

### 프로젝트별 Tuist 격리 {#isolating-tuist-per-project}

프로젝트별로 Tuist의 캐시와 상태를 격리하려면 다음과 같이 설정하세요:

```bash
# In your project's .envrc (using direnv)
export TUIST_XDG_CACHE_HOME="$PWD/.tuist/cache"
export TUIST_XDG_STATE_HOME="$PWD/.tuist/state"
export TUIST_XDG_CONFIG_HOME="$PWD/.tuist/config"
```

### CI/CD 환경 {#ci-cd-environments}

CI 환경에서는 임시 디렉터리를 사용할 수 있습니다:

```yaml
# GitHub Actions example
env:
  TUIST_XDG_CACHE_HOME: /tmp/tuist-cache
  TUIST_XDG_STATE_HOME: /tmp/tuist-state

jobs:
  build:
    runs-on: macos-latest
    steps:
      - uses: actions/checkout@v4
      - run: tuist generate
      - name: Upload logs
        if: failure()
        uses: actions/upload-artifact@v4
        with:
          name: tuist-logs
          path: /tmp/tuist-state/logs/*.log
```

### 격리된 디렉터리로 디버깅하기 {#debugging-with-isolated-directories}

문제를 디버깅할 때 깨끗한 상태에서 시작하려면:

```bash
# Create temporary directories for debugging
export TUIST_XDG_CACHE_HOME=$(mktemp -d)
export TUIST_XDG_STATE_HOME=$(mktemp -d)
export TUIST_XDG_CONFIG_HOME=$(mktemp -d)

# Run Tuist commands
tuist generate

# Clean up when done
rm -rf $TUIST_XDG_CACHE_HOME $TUIST_XDG_STATE_HOME $TUIST_XDG_CONFIG_HOME
```