Python UUID v4 생성하기

import uuid

# UUID v4 생성
request_id = uuid.uuid4()

print(request_id)           # 3b1f8a9d-2c4e-4f6a-8b0d-5e7c9f1a3d2e
print(type(request_id))     # <class 'uuid.UUID'>
print(request_id.version)   # 4

# JSON / HTTP 헤더를 위해 문자열로 변환
print(str(request_id))      # "3b1f8a9d-2c4e-4f6a-8b0d-5e7c9f1a3d2e"
print(request_id.hex)       # "3b1f8a9d2c4e4f6a8b0d5e7c9f1a3d2e" (대시 없음)
print(request_id.bytes)     # b';...' (16 바이트 원시 데이터)

import uuid
import requests

def call_api(endpoint: str, payload: dict) -> dict:
    trace_id = str(uuid.uuid4())
    headers = {
        "X-Request-ID": trace_id,
        "Content-Type": "application/json",
    }
    response = requests.post(endpoint, json=payload, headers=headers, timeout=10)
    response.raise_for_status()
    return {"trace_id": trace_id, "data": response.json()}

# result["trace_id"]로 모든 서비스 로그에서 정확한 요청을 grep할 수 있습니다
result = call_api("https://api.example.com/v1/orders", {"product_id": "prod_7x2k", "qty": 3})
print(result["trace_id"])  # e.g. "3b1f8a9d-2c4e-4f6a-8b0d-5e7c9f1a3d2e"

import uuid

# 텔레메트리 이벤트 1000개를 위한 ID 미리 생성
event_ids = [str(uuid.uuid4()) for _ in range(1000)]
print(f"Generated {len(event_ids)} unique IDs")
print(event_ids[0])   # e.g. "a1c2e3f4-..."
print(event_ids[-1])  # 매번 다른 값

import uuid

u = uuid.uuid4()

print(str(u))         # "3b1f8a9d-2c4e-4f6a-8b0d-5e7c9f1a3d2e"  (36자)
print(u.hex)          # "3b1f8a9d2c4e4f6a8b0d5e7c9f1a3d2e"      (32자, 대시 없음)
print(u.bytes)        # b';Š...'                       (16바이트, 빅엔디언)
print(u.bytes_le)     # b'Š...'                       (16바이트, 리틀엔디언)
print(u.int)          # 78823... (128비트 정수)
print(u.version)      # 4
print(u.variant)      # 'specified in RFC 4122'

# 라운드트립: 문자열에서 재구성
reconstructed = uuid.UUID("3b1f8a9d-2c4e-4f6a-8b0d-5e7c9f1a3d2e")
print(reconstructed == u)  # True (u가 해당 값인 경우)

import uuid

def parse_uuid4(raw: str) -> uuid.UUID:
    """
    UUID v4 문자열을 파싱하고 유효성을 검사합니다.
    잘못된 형식이거나 버전이 다른 경우 ValueError를 발생시킵니다.
    """
    try:
        u = uuid.UUID(raw)
    except ValueError as exc:
        raise ValueError(f"Invalid UUID format: {raw!r}") from exc

    if u.version != 4:
        raise ValueError(f"Expected UUID v4, got v{u.version}: {raw!r}")

    return u

# FastAPI / Flask 라우트 핸들러에서의 사용법
def get_order(order_id: str):
    try:
        uid = parse_uuid4(order_id)
    except ValueError as exc:
        return {"error": str(exc)}, 400

    # 이제 DB 쿼리에서 uid를 안전하게 사용할 수 있습니다
    return {"order_id": str(uid), "status": "processing"}

import json
import uuid
from datetime import datetime

class ApiEncoder(json.JSONEncoder):
    """JSON 응답에서 UUID 및 datetime 객체를 직렬화합니다."""
    def default(self, obj):
        if isinstance(obj, uuid.UUID):
            return str(obj)
        if isinstance(obj, datetime):
            return obj.isoformat()
        return super().default(obj)

# 중첩된 UUID가 포함된 실제 API 응답
api_response = {
    "request_id": uuid.uuid4(),
    "created_at": datetime(2026, 3, 14, 9, 41, 0),
    "order": {
        "id": uuid.uuid4(),
        "customer_id": uuid.uuid4(),
        "items": [
            {"product_id": uuid.uuid4(), "sku": "NVX-9000", "qty": 2},
        ],
    },
}

print(json.dumps(api_response, indent=2, cls=ApiEncoder))
# {
#   "request_id": "3b1f8a9d-2c4e-4f6a-8b0d-5e7c9f1a3d2e",
#   "created_at": "2026-03-14T09:41:00",
#   "order": {
#     "id": "a1c2e3f4-...",
#     ...
#   }
# }

import json, uuid

event_id = uuid.uuid4()
payload = {"event_id": event_id, "action": "checkout"}

# json이 처리할 수 없는 타입에 대해서만 호출되는 callable을 전달합니다
json_str = json.dumps(payload, default=str)
print(json_str)  # {"event_id": "3b1f8a9d-...", "action": "checkout"}

import json
import uuid
import requests

def fetch_shipment(shipment_id: str) -> dict:
    """배송 정보를 가져와 타입이 지정된 UUID 필드와 함께 반환합니다."""
    response = requests.get(
        f"https://api.logistics.example.com/v2/shipments/{shipment_id}",
        headers={"Accept": "application/json"},
        timeout=10,
    )
    response.raise_for_status()
    data = response.json()

    # UUID 필드를 다시 uuid.UUID 객체로 파싱
    try:
        data["id"] = uuid.UUID(data["id"])
        data["carrier_id"] = uuid.UUID(data["carrier_id"])
    except (KeyError, ValueError) as exc:
        raise RuntimeError(f"Malformed shipment response: {exc}") from exc

    return data

import json, uuid

def rotate_correlation_id(path: str) -> str:
    """JSON 파일의 'correlation_id'를 교체하거나 추가합니다. 새 UUID를 반환합니다."""
    try:
        with open(path) as f:
            data = json.load(f)
    except FileNotFoundError:
        data = {}
    except json.JSONDecodeError as exc:
        raise ValueError(f"Invalid JSON in {path!r}: {exc}") from exc

    new_id = str(uuid.uuid4())
    data["correlation_id"] = new_id

    with open(path, "w") as f:
        json.dump(data, f, indent=2)

    return new_id

# 단일 UUID v4
python3 -c "import uuid; print(uuid.uuid4())"
# 3b1f8a9d-2c4e-4f6a-8b0d-5e7c9f1a3d2e

# 대시 없는 (hex) 형식 — 파일명과 환경 변수에 유용
python3 -c "import uuid; print(uuid.uuid4().hex)"
# 3b1f8a9d2c4e4f6a8b0d5e7c9f1a3d2e

# 배치 시드 스크립트를 위한 UUID 5개 생성
python3 -c "import uuid; [print(uuid.uuid4()) for _ in range(5)]"

# 셸 변수에서 사용
DEPLOY_ID=$(python3 -c "import uuid; print(uuid.uuid4())")
echo "Deploying with ID: $DEPLOY_ID"

pip install uuid-utils

# uuid_utils는 stdlib uuid 모듈의 드롭인 대체제입니다
import uuid_utils as uuid

# stdlib와 동일한 API
request_id = uuid.uuid4()
print(request_id)           # 3b1f8a9d-2c4e-4f6a-8b0d-5e7c9f1a3d2e
print(str(request_id))      # 표준 문자열
print(request_id.hex)       # 대시 없는 hex
print(request_id.version)   # 4

# v7도 지원 (시간 순서, DB 기본 키에 적합)
time_ordered_id = uuid.uuid7()
print(time_ordered_id)      # 현재 타임스탬프 접두사로 시작

from dataclasses import dataclass, field
import uuid

@dataclass
class WorkerJob:
    job_id: uuid.UUID = field(default_factory=uuid.uuid4)
    worker_id: str = "worker-01"
    payload: dict = field(default_factory=dict)

job1 = WorkerJob(payload={"task": "resize_image", "src": "uploads/img_4932.png"})
job2 = WorkerJob(payload={"task": "send_email",   "to":  "ops@example.com"})

print(job1.job_id)  # 인스턴스마다 고유
print(job2.job_id)  # job1.job_id와 다름
print(job1.job_id == job2.job_id)  # False

from pydantic import BaseModel, Field
import uuid

class OrderEvent(BaseModel):
    event_id: uuid.UUID = Field(default_factory=uuid.uuid4)
    order_id: uuid.UUID
    status: str
    amount_cents: int

event = OrderEvent(
    order_id=uuid.UUID("a1c2e3f4-5b6d-4e7f-8c9d-0a1b2c3d4e5f"),
    status="payment_confirmed",
    amount_cents=4995,
)

print(event.model_dump_json(indent=2))
# {
#   "event_id": "3b1f8a9d-2c4e-4f6a-8b0d-5e7c9f1a3d2e",
#   "order_id": "a1c2e3f4-5b6d-4e7f-8c9d-0a1b2c3d4e5f",
#   "status": "payment_confirmed",
#   "amount_cents": 4995
# }
# Pydantic v2는 uuid.UUID를 자동으로 문자열로 직렬화합니다