파이썬 표준 라이브러리 완벽 정복: 꼭 알아야 할 핵심 모듈 6가지

표준 라이브러리만 제대로 써도,
파이썬 장인이 될 수 있다는 사실, 알고 계셨나요?

안녕하세요, 여러분 😊

오늘은 초보 개발자라면 반드시 알고 넘어가야 할 주제, 바로 파이썬 표준 라이브러리에 대해 이야기해보려 해요.

사실 저도 파이썬을 처음 접했을 때는 대부분 외부 라이브러리에만 의존했는데요, 알고 보니 파이썬에는 이미 너무 유용하고 강력한 기능들이 기본으로 내장돼 있더라고요!

특히 datetime, time, random, os, json 등은 파이썬을 진짜 실무에 활용하려면 꼭 익혀야 할 필수템이에요.

이 글에서는 각 라이브러리가 어떤 상황에서 유용한지, 그리고 어떤 방식으로 사용하는지 예제 중심으로 친절하게 알려드릴게요.

01. 날짜 계산을 쉽게! datetime 모듈 활용법

날짜와 시간을 다뤄야 하는 상황, 생각보다 정말 자주 오지 않나요?

예를 들어,

회원가입 일자부터 오늘까지 며칠이 지났는지 계산하거나, 특정 날짜 이후의 유효기간을 체크하는 기능 등에서 datetime 모듈은 필수예요.

✅ datetime 모듈로 할 수 있는 일

• 현재 날짜 및 시간 가져오기
• 날짜 덧셈 및 뺄셈 (예: 7일 후 날짜 계산)
• 특정 날짜 사이의 간격 계산 (D-day 등)

📋 기본 사용법 예제

import datetime

# 오늘 날짜 가져오기
today = datetime.date.today()
print("오늘 날짜:", today)

# 특정 날짜 생성
start_date = datetime.date(2021, 12, 14)
print("시작일:", start_date)

# 날짜 차이 계산
delta = today - start_date
print("만난 지 며칠?:", delta.days, "일")

위 코드처럼 날짜 객체끼리의 뺄셈은 자동으로 timedelta 객체를 반환하고, .days 속성을 통해 간단하게 일 수를 뽑을 수 있어요.

이런 기능 덕분에 무언가 날짜 계산을 자동화하려는 모든 프로젝트에서 datetime 모듈은 매우 유용하답니다.

📅 날짜를 포맷팅해 보기

# 날짜와 시간 포맷 지정
now = datetime.datetime.now()
print("현재:", now.strftime("%Y-%m-%d %H:%M:%S"))

strftime() 함수는 날짜와 시간을 보기 좋은 문자열로 바꿔줄 때 아주 편리해요.

특히 보고서나 로그를 작성할 때 포맷을 지정해서 출력하면 훨씬 깔끔하고 전문적으로 보인답니다.

정리하자면,

datetime 모듈은 날짜 계산, 기간 측정, 포맷 변환 등 정말 다양한 작업을 쉽게 해주는 파이썬 기본 기능 중 하나예요.

실무에 가까운 연습을 하다 보면 점점 더 자주 쓰게 될 거예요!

02. 시간 측정과 지연 처리 time 모듈

어떤 작업이 얼마나 걸리는지 알고 싶거나, 프로그램 흐름을 잠깐 멈추고 싶을 때 여러분은 어떻게 하나요?

이럴 땐 time 모듈만큼 든든한 도구가 없어요.

타이머 만들기, 진행률 애니메이션 구현, 간단한 시간 기반 조건 처리 등에 널리 사용됩니다.

🕒 time 모듈의 주요 함수

• time.time() – 현재 시간을 초 단위로 반환 (Epoch time)
• time.sleep() – 일정 시간 동안 코드 실행 일시 중지
• time.strftime() – 날짜 및 시간을 포맷팅된 문자열로 반환

⏱ 실행 시간 측정 예제

import time

start = time.time()

# 예시: 1~1000000 합계 계산
total = 0
for i in range(1000000):
    total += i

end = time.time()
print("실행 시간:", end - start, "초")

위처럼 time.time()으로 시작 시간과 종료 시간을 기록하고 빼주면 간단하게 실행 시간 측정이 가능해요. 프로파일링이나 알고리즘 성능 비교에 아주 유용하죠.

😴 시간 지연 예제: 진행률 애니메이션

import time

for i in range(5):
    print(f"{i+1}초 경과 중...")
    time.sleep(1)

print("완료!")

time.sleep()은 초 단위로 코드를 일시 정지시키는 함수인데요, 진행률 애니메이션, API 호출 제한, 또는 자동화 스크립트에서 시간 간격을 둘 때 필수입니다.

너무 자주 호출하지 않도록 지연이 필요할 때 꼭 사용해 보세요.

🧠 활용 팁

• 시간 기록은 밀리초 단위로도 가능하니 정밀 측정 시 유용해요.
• 웹 크롤링할 때 sleep()으로 서버 부하를 줄여주세요.

한 마디로,

time 모듈은 단순히 시간을 출력하는 도구가 아니라,

성능 측정부터 흐름 제어까지 다재다능한 타임 매니저 역할을 해주는 파이썬 기본기예요!

03. 무작위 데이터 만들기 random 모듈

"무작위"라는 말, 들어본 적 있으시죠? 뭔가 랜덤하게 뽑는다든가, 게임에서 확률을 적용한다든가, 그런 상황이요.

random 모듈은 그런 무작위 처리에 딱 맞는 파이썬 기본 도구입니다.

확률 시뮬레이션, 데이터 샘플링, 보안용 임시코드 생성, AI 훈련 데이터 섞기 등 다양한 곳에서 쓰여요.

🎲 자주 쓰는 random 함수들

🧪 실습 예제: 간단한 추첨기 만들기

import random

names = ['Alice', 'Bob', 'Charlie', 'David', 'Emma']

# 무작위 한 명 뽑기
winner = random.choice(names)
print("당첨자:", winner)

# 무작위 2명 추첨 (중복 없음)
winners = random.sample(names, 2)
print("2명 추첨:", winners)

choice()는 단 한 명을 뽑을 때, sample()은 여러 명을 중복 없이 뽑을 때 사용돼요.

이벤트 추첨이나 학생 발표자 랜덤 선정 등에 딱이죠!

💡 활용 팁

• random.seed(n)를 사용하면 결과를 재현할 수 있어 테스트에 유용해요.
• 머신러닝에서 훈련 데이터를 무작위로 섞을 때 자주 활용됩니다.

결론적으로, random 모듈은 "랜덤성"을 구현하는 데 없어서는 안 될 도구예요.

간단하지만 강력하죠.

상황에 따라 유연하게 활용하는 연습을 꼭 해보세요!

04. 파일과 시스템 제어의 핵심 os 모듈

os 모듈은 파이썬에서 운영체제와 상호작용할 수 있도록 해주는 아주 중요한 도구입니다.

디렉터리 탐색, 파일 이름 변경, 경로 확인, 시스템 명령어 실행 등 파일/디렉터리 자동화 작업에 필수예요.

특히 백업 스크립트, 로그 정리, 자동 배포 작업 등에 자주 사용됩니다.

📁 자주 쓰는 os 함수

🔍 예제: 파일 이름 일괄 변경

import os

folder = "./images"
files = os.listdir(folder)

for i, filename in enumerate(files):
    new_name = f"photo_{i+1}.jpg"
    os.rename(os.path.join(folder, filename), os.path.join(folder, new_name))

이미지 파일들이 'IMG123.jpg', 'IMG456.jpg' 같은 이름으로 섞여 있다면,

위 예제처럼 번호 순서대로 깔끔하게 정리할 수 있어요.

자동화 스크립트 짤 때 유용하겠죠?

🧠 팁과 주의사항

• 디렉터리 조작 전에는 항상 존재 여부를 확인하세요 (os.path.exists() 활용)
• 파일을 삭제하거나 이름을 바꾸기 전에 꼭 백업해두는 습관을 들이세요!

os 모듈은 말 그대로 파이썬으로 "운영체제와 대화"하게 해주는 창구예요.

반복적인 작업을 자동화하고 싶다면 반드시 익혀두세요!

05. 딕셔너리를 JSON으로 변환하는 json 모듈

요즘 시대에 데이터를 주고받을 때 가장 많이 쓰는 포맷이 뭘까요?

바로 JSON (JavaScript Object Notation)입니다.

그런데 JSON 형식은 문자열이고, 파이썬은 딕셔너리 같은 자료형을 쓰죠.

이 둘을 자유롭게 오가게 해주는 게 바로 json 모듈이에요!

🔁 변환 기본 함수 정리

📦 예제: 딕셔너리를 JSON 문자열로 변환

import json

data = {
    "name": "홍길동",
    "age": 30,
    "city": "Seoul"
}

# 딕셔너리를 JSON 문자열로 변환
json_str = json.dumps(data, ensure_ascii=False, indent=2)
print(json_str)

ensure_ascii=False를 설정하면 한글이 깨지지 않고 출력되고, indent=2는 들여쓰기로 JSON을 예쁘게 보여줍니다.

API 응답값을 직접 확인하거나 저장할 때 정말 유용하죠.

📂 예제: JSON 파일을 읽고 쓰기

# 저장
with open("user.json", "w", encoding="utf-8") as f:
    json.dump(data, f, ensure_ascii=False, indent=2)

# 읽기
with open("user.json", "r", encoding="utf-8") as f:
    loaded = json.load(f)
    print(loaded)

JSON 데이터를 파일로 저장하고 다시 불러오는 건 데이터 공유, 로그 저장, 설정 파일 등에 아주 유용해요.

머신러닝 학습 파라미터 저장할 때도 자주 쓰인답니다.

🌍 JSON 모듈은 어디에 쓸까?

• API 요청/응답 데이터 처리
• 웹 서비스에서 사용자 설정 저장
• 프론트엔드와 백엔드 간 데이터 통신

데이터를 저장하거나 주고받을 일이 많다면, json 모듈은 정말 자주 만나게 될 친구예요.

딕셔너리를 다룰 줄 안다면, JSON도 충분히 쉽게 배울 수 있어요!

06. 표준 라이브러리, 언제 어디서 써야 할까?

지금까지 파이썬 표준 라이브러리 중 가장 많이 사용되는 핵심 모듈 5가지를 함께 살펴봤어요.

사실 처음엔 "이게 뭐지?" 싶을 수 있지만, 조금만 익숙해지면 개발 생산성이 3배 이상 올라간답니다!

정리하자면,

아래처럼 쓰면 됩니다:

• 날짜 계산이 필요할 때 👉 datetime
• 타이머나 지연 처리 👉 time
• 무작위 추첨, 샘플링 👉 random
• 파일 관리, 디렉터리 제어 👉 os
• JSON 처리, API 응답 파싱 👉 json

이 글을 통해 표준 라이브러리가 얼마나 강력하고, 얼마나 실무에 가까운지 느끼셨길 바랍니다~

앞으로는 외부 라이브러리보다 먼저 표준 라이브러리에 무엇이 있는지를 먼저 떠올려보는 습관을 가져보세요! 😊

파이썬 모듈과 패키지 완전 정복 🔍

파이썬 코드를 깔끔하게 정리하고 재사용성을 높이는 핵심 기술,
'모듈'과 '패키지'! 지금 바로 마스터해보세요.

안녕하세요, 여러분 😊

오늘은 파이썬을 조금 더 효율적으로, 조금 더 체계적으로 사용하는 방법에 대해 이야기해 보려고 해요.

바로 모듈과 패키지라는 개념인데요.

처음엔 생소하게 느껴질 수도 있지만, 실제로 코드를 여러 개로 나눠서 재사용하고 관리하려면 꼭 알아야 할 개념이랍니다.

예를 들어,

여러분이 자주 사용하는 함수들을 한 파일에 모아두고 다른 코드에서 불러와 쓰고 싶다면?

바로 이 모듈을 활용하면 됩니다.

그리고 여러 모듈들을 하나로 묶어 관리할 수 있는 단위가 패키지구요!

이 글에서는 모듈과 패키지를 처음 접하는 분들도 쉽게 이해할 수 있도록 예제를 통해 차근차근 설명드릴게요.

그럼 바로 시작해볼까요? 🐍

1. 모듈이란? 📁

파이썬으로 프로젝트를 하다 보면 공통으로 사용하는 함수나 클래스가 많아져요.

이럴 때 유용한 개념이 바로 모듈(Module)입니다.

모듈은 쉽게 말해 "파이썬 코드가 들어 있는 파일(.py)"로,

자주 사용하는 코드들을 함수, 변수, 클래스 등으로 정의해두고

필요할 때마다 가져다 쓸 수 있도록 만들어 둔 파일이에요.

모듈의 정의와 구조

모듈은 단 하나의 `.py` 파일입니다.

예를 들어,

아래와 같은 파일이 있다고 해볼게요.

# mod1.py
def add(a, b):
    return a + b

def sub(a, b):
    return a - b

이 파일을 mod1이라는 이름의 모듈로 다른 파일에서 불러와서 사용할 수 있어요.

모듈을 사용하는 이유

• 코드의 재사용이 쉬워져요 (한 번 만든 함수를 여러 곳에서 재활용)
• 코드가 더 깔끔하고 관리하기 쉬워져요 (기능별로 파일을 분리)
• 협업할 때 각자 맡은 부분을 모듈 단위로 분리해서 작업할 수 있어요

내장 모듈 vs 사용자 정의 모듈

이처럼 파이썬에서 모듈은 정말 자주 쓰이고 꼭 알아둬야 하는 기본 중의 기본이에요.

특히 큰 프로젝트를 할 때 파일을 잘게 나눠야 관리가 쉬워지는데, 이럴 때 모듈이 진짜 진가를 발휘하죠.

2. 모듈 불러오기 방법들 🧲

모듈을 만들었으면, 이제 그걸 어떻게 불러와 사용하는지가 중요하겠죠?

파이썬에서는 다양한 방식으로 모듈을 불러올 수 있어요.

상황에 맞게 선택해서 쓰면 되는데, 각각의 차이를 정확히 아는 게 중요해요!

기본적인 import 사용법

# 모듈 전체를 불러오는 방법
import mod1

print(mod1.add(3, 4))  # 7

이 방법은 모듈 이름을 앞에 붙여서 함수나 변수에 접근해요.

다소 길어지지만, 어떤 모듈의 함수인지 명확하게 보여준다는 장점이 있어요.

from ~ import 방식

# 특정 함수만 불러오기
from mod1 import add

print(add(3, 4))  # 7

• 필요한 함수만 불러올 수 있어 메모리 낭비를 줄일 수 있음
• 함수 이름을 짧게 쓰고 싶을 때도 유용함

from ~ import * 방식

from mod1 import *

print(add(3, 4))
print(sub(7, 2))

이 방식은 모든 함수나 변수를 불러오지만,

어떤 함수가 어디서 왔는지 혼동될 수 있기 때문에 권장되지 않아요.

특히 다른 모듈에서 같은 이름의 함수가 있을 경우 충돌 위험이 있어요.

as 키워드로 별칭 주기

import mod1 as m

print(m.add(5, 6))

모듈 이름이 너무 길거나 자주 사용할 경우 as 키워드를 이용해 별칭을 붙이면 더 짧게 쓸 수 있어서 편리해요.

모듈 불러오기 요약

여기까지 다양한 모듈 불러오기 방법을 정리해봤어요.

다음 파트에서는 모듈이 실행될 때 발생하는 중요한 조건인 __name__ == "__main__"의 의미를 알아볼게요!

3. if __name__ == "__main__"의 의미 🧠

파이썬 모듈을 만들다 보면 꼭 한 번은 만나게 되는 코드가 있어요.

바로 if __name__ == "__main__"이라는 조건문이죠.

이게 도대체 무슨 뜻일까?

왜 넣어야 할까?

한 번 차근차근 살펴볼게요!

__name__ 변수란?

파이썬 파일이 실행될 때, 파이썬은 특별한 변수 __name__을 자동으로 정의해요.

그리고 파일을 직접 실행하면 이 __name__의 값은 "__main__"이 됩니다.

하지만 다른 파일에서 import되면 __name__에는 그 파일명이 들어가요.

이 코드가 필요한 이유

어떤 모듈을 직접 실행할 때는 테스트 코드를 실행하고 싶고, 다른 파일에서 import할 때는 실행하지 않고 싶을 때가 있잖아요?

그럴 때 바로 아래와 같이 코드를 작성하면 됩니다:

# mod1.py

def add(a, b):
    return a + b

if __name__ == "__main__":
    print("add(3, 4) =", add(3, 4))

이렇게 작성하면 mod1.py를 직접 실행했을 때만 결과가 출력되고,

다른 파일에서 import해서 쓸 때는 print문이 실행되지 않아요.

딱 우리가 원하는 조건이죠!

사용 예시 비교

__name__ == "__main__"은 모듈을 잘 활용하기 위한 필수 도구예요.

코드 테스트용으로도 정말 많이 쓰이고, 큰 프로젝트에서는 꼭 필요한 패턴이기도 하죠!

4. 모듈 실습 예제 🎯

자, 이쯤에서 한번 직접 모듈을 만들어 보고 사용하는 연습을 해볼까요?

실습을 통해 어떻게 동작하는지 익히면 기억에도 오래 남고, 실전에서도 바로 쓸 수 있어요! 😎

1단계: 모듈 파일 만들기

먼저 calculator.py라는 파일을 하나 만들어 아래 코드를 작성해 보세요.

# calculator.py

def add(a, b):
    return a + b

def sub(a, b):
    return a - b

def mul(a, b):
    return a * b

def div(a, b):
    return a / b

2단계: 모듈 사용하기

이번엔 같은 폴더에 main.py라는 파일을 만들어 아래처럼 작성해 보세요.

# main.py

import calculator

print("덧셈:", calculator.add(3, 5))
print("뺄셈:", calculator.sub(10, 4))
print("곱셈:", calculator.mul(2, 3))
print("나눗셈:", calculator.div(8, 2))

이렇게 calculator 모듈을 불러와서 다양한 연산을 해볼 수 있어요.

결과는 각각 함수에 따라 숫자가 계산되어 출력됩니다.

3단계: __main__ 조건 추가

calculator.py에 테스트용 코드도 추가해봅시다!

if __name__ == "__main__":
    print("테스트용 계산 결과:")
    print("add(2, 2) =", add(2, 2))

• calculator.py를 직접 실행하면 테스트 결과가 출력되고,
• main.py에서 불러오면 테스트 코드는 무시돼요.

💡 정리

직접 모듈을 만들어 보고 불러와서 사용하는 연습은 매우 중요해요.

이 과정을 통해 파이썬의 모듈 구조가 어떻게 작동하는지 명확히 이해할 수 있거든요.

나중에 프로젝트를 할 때 모듈을 나누는 기준이나 코드 관리 측면에서도 큰 도움이 될 거예요.

5. 패키지란 무엇인가? 📦

모듈이 하나의 파이썬 파일이라면, 패키지(Package)는 여러 모듈을 폴더 단위로 묶어 구성한 디렉터리 구조입니다.

즉, 관련된 모듈들을 체계적으로 정리하고 관리할 수 있도록 만들어진 구조예요.

패키지 구조 예시

아래는 간단한 계산기 패키지를 구성한 예예요:

mycalcpkg/
├── __init__.py
├── add.py
├── sub.py

• __init__.py는 해당 디렉터리를 패키지로 인식하게 만드는 파일이에요.
• 그 외 파일들은 각각의 모듈 역할을 해요. (add.py는 덧셈, sub.py는 뺄셈 담당)

패키지 사용 예시

main.py 파일에서 아래와 같이 사용해볼 수 있어요.

from mycalcpkg import add, sub

print(add.add(5, 3))
print(sub.sub(9, 2))

💡 패키지의 장점

패키지는 프로젝트가 커질수록 반드시 필요해지는 개념이에요.

여러 기능을 깔끔하게 모듈로 나누고, 이를 폴더 단위로 묶어서 재사용성과 유지보수성을 높이는 데 정말 효과적이죠.

마무리 ✨

여기까지 파이썬의 모듈과 패키지에 대해 차근차근 살펴보았습니다.

처음에는 파일을 나누고 불러오는 개념이 복잡하게 느껴질 수 있지만, 실습을 해보면 생각보다 어렵지 않다는 걸 느끼실 거예요 😊

파이썬은 이런 구조화된 코드 작성을 적극적으로 장려하고 있어서, 프로젝트가 커질수록 모듈과 패키지를 잘 활용하는 게 핵심입니다.

이제 여러분도 자신 있게 자신만의 모듈을 만들고, 필요한 기능을 패키지로 관리할 수 있을 거예요.

다음에는 표준 라이브러리나 서드파티 패키지를 이용해 더 풍부한 기능을 구현해보는 것도 추천드려요.

그럼 다음 포스팅에서 또 만나요!

감사합니다 🙏

파이썬 매직 메서드(Magic Method) 완전 정복 🧙‍♂️

여러분,
__init__, __str__, __add__ 같은 이상한 이름의 메서드들,
한 번쯤 보셨죠?
이거 그냥 넘어가면 진짜 손해예요!

안녕하세요!

이번 글에서는 파이썬 객체지향 프로그래밍에서 빼놓을 수 없는 매직 메서드에 대해 알아보려고 해요.

이름부터 범상치 않죠?

마법 같아 보이는 이 메서드들은 사실 객체의 동작을 정의해주는 파이썬의 핵심 기능이에요.

예를 들어

우리가 print(객체)를 했을 때 예쁘게 출력되거나, 객체1 + 객체2가 가능해지는 것도 모두 매직 메서드 덕분이랍니다.

이 글에서는 기초부터 실전 활용까지 하나하나 친절하게 알려드릴게요.

특히 개발 초보자분들이 이해하기 쉽도록 예제 위주로 설명드리니, 걱정하지 마시고 끝까지 함께 해요!

1. __init__ 생성자의 진짜 역할 🛠

__init__ 메서드는 클래스의 객체가 만들어질 때 자동으로 호출되는 생성자 메서드예요.

객체를 초기화할 때 사용되며, 인스턴스를 만들자마자 실행되죠.

마치 입학식에서 이름표를 붙여주는 느낌이랄까요?

기본 구조와 사용법

class Person:
    def __init__(self, name, age):
        self.name = name
        self.age = age

p1 = Person("철수", 30)
print(p1.name)  # 철수
print(p1.age)   # 30

객체 p1을 만들자마자 __init__이 실행돼서 self.name과 self.age에 값을 할당한 거예요.

이게 없으면 객체가 '텅 빈 상태'로 만들어지겠죠!

왜 꼭 필요할까요?

• 객체 생성과 동시에 필요한 데이터를 초기화할 수 있어요.
• 오류 방지에도 효과적이에요. 값이 없는 상태에서 메서드를 호출하면 AttributeError가 발생할 수 있거든요.
• 프로그램의 구조와 흐름을 명확하게 만들 수 있어요.

Tip! 꼭 기억하세요

__init__의 첫 번째 매개변수는 반드시 self여야 해요.

이건 객체 자신을 가리키는 약속된 이름이거든요.

다른 이름으로 바꿔도 되긴 하지만... 안 쓰는 게 좋아요.

혼란만 생기니까요 😅

정리해볼까요?

2. __str__로 객체를 예쁘게 출력하기 💬

__str__ 메서드는 객체를 문자열로 표현할 때 호출되는 매직 메서드예요.

우리가 print(객체)를 했을 때 보이는 결과, 그게 바로 __str__ 덕분이죠.

이 메서드를 정의하지 않으면 기본값으로 <__main__.클래스명 object at 0x~~~>처럼 딱딱하고 보기 힘든 문자열이 출력돼요.

예제로 이해하는 __str__

class Book:
    def __init__(self, title, author):
        self.title = title
        self.author = author

    def __str__(self):
        return f"『{self.title}』 by {self.author}"

book1 = Book("파이썬 마스터", "홍길동")
print(book1)

위 코드에서 __str__ 메서드는 책 정보를 예쁘게 문자열로 포장해서 보여주고 있어요.

print(book1)을 하면 “『파이썬 마스터』 by 홍길동”이 출력되죠.

완전 깔끔하죠? 😎

__repr__과의 차이점은?

• __str__은 사용자 친화적인 설명용, 즉 ‘보기 좋게’ 출력되는 문자열
• __repr__은 디버깅이나 로그용, ‘개발자용’ 정보 중심 출력

예를 들어 리스트를 출력할 때 내부 객체에 __str__이 없으면 __repr__이 호출돼요.

실제 개발에서는 __str__과 __repr__을 모두 정의해두는 게 좋아요.

보너스 팁 💡

__str__ 안에서는 꼭 문자열을 반환해야 해요!

print()를 해도 None이 뜬다면 return이 빠졌는지 확인해보세요.

정리 요약 📌

3. __add__로 객체끼리 덧셈 구현하기 ➕

__add__ 메서드는 우리가 흔히 쓰는 + 연산자를 객체끼리 사용할 수 있게 해주는 매직 메서드예요.

예를 들어,

두 개의 숫자형 객체 또는 좌표 객체를 + 연산으로 결합하고 싶다면 이 메서드를 활용하면 됩니다!

기본 사용 예제

class Point:
    def __init__(self, x, y):
        self.x = x
        self.y = y

    def __add__(self, other):
        return Point(self.x + other.x, self.y + other.y)

    def __str__(self):
        return f"({self.x}, {self.y})"

p1 = Point(2, 3)
p2 = Point(4, 1)
print(p1 + p2)  # (6, 4)

p1 + p2는 사실 p1.__add__(p2)로 호출돼요.

즉, __add__는 + 기호의 비밀 통로 같은 존재죠. 덕분에 코드가 훨씬 읽기 쉬워집니다.

주의할 점

• other는 반드시 같은 클래스의 인스턴스라는 보장이 없어요. 타입 체크 필수!
• 반환 값은 가급적 새로운 인스턴스로 만들어야 해요. 원본을 수정하는 건 좋지 않아요.

타입 확인 예제

def __add__(self, other):
    if not isinstance(other, Point):
        return NotImplemented
    return Point(self.x + other.x, self.y + other.y)

NotImplemented를 반환하면 파이썬이 다른 방법으로 연산을 시도하게 돼요.

(예: other.__radd__() 호출)

정리 요약 🔁

4. __eq__로 객체 비교 가능하게 만들기 🔍

__eq__는 객체끼리 == 연산을 할 수 있도록 만들어주는 매직 메서드예요.

기본적으로 객체는 동일한 인스턴스일 때만 같다고 판단하지만, __eq__를 재정의하면 속성 값 기준으로 비교할 수 있어요.

예를 들어, 두 책 객체의 제목과 저자가 같다면 동일한 책으로 판단할 수 있게 되는 거죠!

기본 사용 예제

class Book:
    def __init__(self, title, author):
        self.title = title
        self.author = author

    def __eq__(self, other):
        return self.title == other.title and self.author == other.author

book1 = Book("파이썬 기초", "홍길동")
book2 = Book("파이썬 기초", "홍길동")
book3 = Book("파이썬 고급", "홍길동")

print(book1 == book2)  # True
print(book1 == book3)  # False

보셨죠? __eq__ 덕분에 == 연산이 단순히 메모리 주소 비교가 아니라 내용 기반 비교로 바뀌었어요.

정말 강력한 기능이에요!

주의할 점 💡

• 타입 검사는 필수입니다! 다른 클래스와 비교할 경우 오류가 날 수 있어요.
• __eq__만 정의하면 != 연산자는 자동 지원되지 않아요. __ne__도 같이 정의하면 좋아요.

타입 검사 버전 예시

def __eq__(self, other):
    if not isinstance(other, Book):
        return NotImplemented
    return self.title == other.title and self.author == other.author

정리 요약 📑

5. 자주 쓰는 매직 메서드 리스트 🧾

지금까지 배운 __init__, __str__, __add__, __eq__ 외에도 파이썬에는 다양한 매직 메서드(Magic Method)들이 있어요.

이 메서드들을 활용하면 클래스를 파이썬스럽게 쓰는 멋진 코드를 만들 수 있습니다.

여기서는 자주 쓰이는 매직 메서드들을 분야별로 정리해봤어요!

💡 생성 및 초기화 관련

🖨 출력 및 표현 관련

➕ 연산자 오버로딩 관련

✅ 비교 관련 메서드

이 외에도 __len__, __getitem__, __call__ 등 정말 많은 매직 메서드들이 있어요.

하지만 걱정 마세요. 상황에 맞게 하나씩만 잘 써도 충분히 파이썬 고수가 될 수 있어요! 😉

마무리 🎯

파이썬의 매직 메서드, 처음 보면 좀 낯설고 복잡해 보일 수 있어요.

이름도 특이하고 동작 방식도 조금은 추상적이죠.

그런데 한 번만 제대로 이해하고 나면, 객체지향 프로그래밍이 훨씬 자연스럽고 재밌어져요.

오늘 배운 __init__, __str__, __add__, __eq__부터 시작해서 다양한 연산자 오버로딩 메서드들까지, 실제 실무에서 자주 등장하는 개념들이니 꼭 익혀두시면 좋아요.

혹시 지금도 이해가 100% 안 된다면 괜찮아요.

직접 클래스를 만들어보고 print도 해보고, 덧셈도 해보고 하면서 연습해보세요.

그게 가장 빠른 학습법이랍니다! 😊