FastAPI 개발 환경 구축

# FastAPI 개발 환경 구축

## 요구사항

- Python 3.8 이상 (3.11+ 권장)
- pip 또는 uv (패키지 관리자)

---

## 가상환경 생성

```bash
# Python 내장 venv 사용
python -m venv .venv

# 활성화
# Windows PowerShell
.venv\Scripts\Activate.ps1

# macOS/Linux
source .venv/bin/activate
```

---

## 패키지 설치

```bash
# 핵심 패키지
pip install fastapi uvicorn[standard]

# 추가 (권장)
pip install pydantic[email]   # 이메일 검증
pip install httpx             # 비동기 HTTP 클라이언트 (테스트용)
pip install python-dotenv     # .env 파일 로드
```

---

## 첫 번째 앱 실행

```python
# main.py
from fastapi import FastAPI

app = FastAPI()

@app.get("/")
async def root():
    return {"message": "Hello, nullvuild!"}

@app.get("/health")
async def health():
    return {"status": "ok"}
```

```bash
# 개발 서버 실행 (자동 리로드)
uvicorn main:app --reload --port 8000

# 실행 확인
# http://127.0.0.1:8000/
# http://127.0.0.1:8000/docs
```

---

## 프로젝트 구조 (권장)

```
my-api/
├── .venv/
├── .env                  # 환경변수 (gitignore!)
├── main.py               # 앱 진입점
├── requirements.txt
├── app/
│   ├── __init__.py
│   ├── config.py         # 설정 (pydantic-settings)
│   ├── database.py       # DB 연결
│   ├── models/           # DB 모델 (SQLAlchemy)
│   │   └── user.py
│   ├── schemas/          # Pydantic 스키마
│   │   └── user.py
│   ├── routers/          # APIRouter 모음
│   │   ├── users.py
│   │   └── items.py
│   └── services/         # 비즈니스 로직
│       └── user_service.py
└── tests/
    └── test_users.py
```

---

## requirements.txt

```
fastapi>=0.110.0
uvicorn[standard]>=0.27.0
pydantic[email]>=2.0.0
python-dotenv>=1.0.0
sqlalchemy>=2.0.0
httpx>=0.27.0
pytest>=8.0.0
pytest-asyncio>=0.23.0
```

```bash
pip install -r requirements.txt
```

---

## .env 파일

```env
APP_NAME=My API
APP_VERSION=1.0.0
DEBUG=true
DATABASE_URL=sqlite:///./dev.db
SECRET_KEY=your-secret-key-here
```

```python
# app/config.py
from pydantic_settings import BaseSettings

class Settings(BaseSettings):
    app_name: str = "My API"
    debug: bool = False
    database_url: str
    secret_key: str

class Config:
        env_file = ".env"

settings = Settings()
```

FastAPI 개발 환경 구축

// COMMENTS

ON THIS PAGE