import requests

# 그냥 작동합니다.
# SSL 검증: 켜짐. 리다이렉트: 따라감.
# 인코딩: 자동 감지. 타임아웃: 합리적 수준.
# 사용자는 이 중 어느 것도 고민할 필요가 없습니다.
response = requests.get('https://example.com')

# 초기 시절: 프로토콜 불일치
kenneth_default = "내부적으로 처리하고 나중에 응답하기"
sarah_default = "지금 당장 대화로 풀기"

# 결과: 아내는 내가 자신을 밀어낸다고 생각하고,
# 나는 아내가 나에게 생각할 여유를 주지 않는다고 생각합니다.
# 두 해석 모두 타당하지만,
# 어느 쪽도 전체 그림은 아닙니다.

response = requests.get('https://api.example.com/data')

# 계약은 명확합니다:
# - response.status_code는 무슨 일이 일어났는지 알려줍니다.
# - response.text는 디코딩된 콘텐츠를 제공합니다.
# - response.json()은 JSON인 경우 이를 파싱합니다.
# - response.ok는 성공 여부를 알려줍니다.
# 깜짝 놀랄 일도, 숨겨진 상태도, 추측할 필요도 없습니다.

try:
    response = requests.get('https://example.com', timeout=5)
    response.raise_for_status()
except requests.ConnectionError:
    # 명확함: 연결 실패.
    # 무엇이 잘못되었는지 알고 적절히 대응할 수 있습니다.
    print("연결할 수 없습니다. 네트워크를 확인하세요.")
except requests.Timeout:
    # 명확함: 시간이 너무 오래 걸림.
    # 다른 문제, 다른 대응.
    print("요청 시간이 초과되었습니다. 다시 시도하거나 타임아웃을 늘리세요.")
except requests.HTTPError as e:
    # 명확함: 서버가 에러를 응답함.
    # 상태 코드가 어떤 종류의 에러인지 정확히 알려줍니다.
    print(f"서버 에러: {e.response.status_code}")

# 잘 형식화된 관계 에러
class RelationshipError(Exception):
    def __init__(self, feeling, trigger, need):
        self.feeling = feeling
        self.trigger = trigger
        self.need = need
        super().__init__(
            f"{trigger}할 때 내 기분은 {feeling}해. "
            f"나에게는 {need}이 필요해."
        )

# vs. 스택 트레이스 덤프
raise Exception(
    "모든 게 다 잘못됐어! 당신은 내 말을 전혀 안 들어! "
    "이건 2019년 그때랑 똑같아! "
    "당신 어머니도 똑같이 행동하신다고!"
)
# 밤 11시에 이걸 파싱하느라 행운을 빕니다.

response = requests.get('https://api.example.com/data')

# 이런 방식이 아니라 (기술적으로는 완전하지만 가공되지 않은 바이트):
raw = response.content  # b'{"name": "Kenneth", "status": "tired"}'

# 이런 방식입니다 (디코딩되고 파싱되어 인간이 바로 쓸 수 있는 형태):
data = response.json()  # {'name': 'Kenneth', 'status': 'tired'}

# 또는 간단하게:
text = response.text  # 이미 디코딩됨. 이미 읽을 수 있음.

# 세션이 없는 경우: 모든 요청이 0에서 시작합니다.
requests.get('https://api.example.com/users')    # 새로운 연결.
requests.get('https://api.example.com/posts')    # 새로운 연결.
requests.get('https://api.example.com/comments') # 새로운 연결.

# 세션이 있는 경우: 컨텍스트 공유, 상태 유지.
session = requests.Session()
session.headers.update({'Authorization': 'Bearer 수년간-쌓아온-신뢰'})

session.get('https://api.example.com/users')    # 연결 재사용.
session.get('https://api.example.com/posts')    # 컨텍스트 공유.
session.get('https://api.example.com/comments') # 재협상 없음.