한 줄 뜻
무엇을 해야 하는지(메서드 이름과 꼴)만 부모에 정해 두고, 어떻게 할지는 자식에게 맡기는 방법이에요. 파이썬은 abc 모듈의 ABC 와 @abstractmethod 로 해요.
왜 필요한가
보고서 종류가 늘 때마다 제목줄과 줄 수 꼬리를 복사하면, 꼬리 꼴을 바꿀 때 모든 보고서를 고쳐야 해요. 그렇다고 부모 클래스 하나만 두면 "내용 만드는 메서드"를 빼먹은 자식이 생겨도 실행해 보기 전엔 몰라요.
부모가 render() 로 틀을 쥐고 body() 를 추상 메서드로 두면, 틀은 한 곳에서 고치고 body 를 안 채운 자식은 만들 때 걸려요.
일상 비유
이력서 양식을 떠올려 보세요. 칸 차례와 꾸밈은 양식이 정해 두고, 지원자는 경력 칸만 채워요. 경력 칸을 비우면 접수 창구에서 돌려보내죠. 양식이 추상 클래스, 경력 칸이 추상 메서드예요.
예제 코드
main.py · 45줄from abc import ABC, abstractmethod class Report(ABC): def __init__(self, title): self.title = title def render(self): lines = [f"== {self.title} =="] lines += self.body() lines.append(f"({len(lines) - 1} lines)") return "\n".join(lines) @abstractmethod def body(self): ... class SalesReport(Report): def __init__(self, sales): super().__init__("Sales") self.sales = sales def body(self): total = sum(self.sales.values()) return [f"{day}: {n}" for day, n in self.sales.items()] + [f"total: {total}"] class StockReport(Report): def __init__(self, stock, low=5): super().__init__("Stock") self.stock = stock self.low = low def body(self): return [f"{item} is low ({n})" for item, n in self.stock.items() if n < self.low] try: Report("Empty")except TypeError as e: print("TypeError:", e)sales = SalesReport({"mon": 120, "tue": 95})print(sales.render())print(StockReport({"pen": 3, "ink": 12, "tape": 1}).render())
고친 코드는 실행 단추로 돌려 볼 수 있어요. 한 줄씩 따라가기와 위 실행 결과는 원래 코드 기준이에요.
빠뜨리면 안 될 메서드를 정하는 세 가지 방법
| ABC + @abstractmethod | raise NotImplementedError | typing.Protocol |
|---|
물려받아야 하나 | O | O | X |
|---|
빠뜨리면 알게 되는 때 | 객체를 만들 때 | 그 메서드를 부를 때 | 타입 검사기(mypy 등)를 돌릴 때 |
|---|
공통 코드 넣기 | O | O | X |
|---|
어울리는 곳 | 틀과 순서를 부모가 쥘 때 | 작은 코드·빠른 시작 | 남이 만든 클래스도 받아야 할 때 |
|---|
typing.Protocol 은 파이썬 3.8 부터 있어요. 메서드 이름과 꼴만 맞으면 물려받지 않아도 같은 약속을 지켰다고 쳐요.
언제 사용하나
- 일의 순서는 같고 한두 단계만 종류마다 다를 때(보고서, 파일 읽기, 결제 절차)
- 여러 사람이 자식 클래스를 만들어 붙이는 구조일 때
- 있어야 할 메서드를 빠뜨리면 큰일 나는 곳
추상 클래스 오류 글 "without an implementation for abstract method" 는 파이썬 3.12 꼴이에요. 3.11 까지는 "with abstract method body" 라고 짧게 나와요.
자주 하는 실수
ABC 만 물려받고 @abstractmethod 를 안 붙임
ABC 를 물려받는 것만으로는 막는 게 없어요. 비어 있는 body 가 조용히 None 을 돌려줘요. 채워야 할 메서드에 @abstractmethod 를 붙여야 만들 때 막혀요.
틀린 코드
from abc import ABC class Report(ABC): def body(self): pass r = Report()print(r.body())
실행하면None
고친 코드
from abc import ABC, abstractmethod class Report(ABC): @abstractmethod def body(self): ... try: Report()except TypeError: print("make a subclass first")
실행하면make a subclass first
추상 메서드 이름을 틀리게 씀
bodyy 는 다른 메서드라 body 가 여전히 비어 있어요. 덕분에 객체를 만드는 순간 오류가 나서, 실행 한참 뒤가 아니라 그 자리에서 알아차려요.
틀린 코드
class DailyReport(Report): def bodyy(self): return ["ok"] DailyReport("Daily")
실행하면TypeError: Can't instantiate abstract class DailyReport without an implementation for abstract method 'body'
고친 코드
class DailyReport(Report): def body(self): return ["ok"] print(DailyReport("Daily").render())
실행하면== Daily ==
ok
(1 lines)
약속한 꼴과 다른 값을 돌려줌
부모는 body() 가 줄 목록을 준다고 믿고 lines += 로 이어 붙여요. 글자 하나를 돌려주면 글자가 한 자씩 쪼개져 붙어요. 메서드 이름뿐 아니라 돌려줄 값의 꼴도 약속의 일부예요.
틀린 코드
class NoteReport(Report): def body(self): return "ok" print(NoteReport("Notes").render())
실행하면== Notes ==
o
k
(2 lines)
고친 코드
class NoteReport(Report): def body(self): return ["ok"] print(NoteReport("Notes").render())
실행하면== Notes ==
ok
(1 lines)
확인 문제
문제 1
Report("X") 처럼 추상 클래스로 객체를 만들면?
답과 까닭 보기
답: 2. 객체를 만들 때 `TypeError` 가 나요 @abstractmethod 가 붙은 body 가 비어 있으니 만드는 순간 TypeError 가 나요.
문제 2
StockReport({"pen": 3, "ink": 2}, low=3).render() 를 찍으면 몇 줄이 나올까요?
print(StockReport({"pen": 3, "ink": 2}, low=3).render())
답과 까닭 보기
답: 2. 3 3보다 작은 것만 고르니 ink 한 줄이에요. 머리줄과 꼬리줄을 더해 모두 3줄이에요.
자주 묻는 것
추상 클래스로는 왜 객체를 만들 수 없나요?
@abstractmethod 로 표시한 메서드가 비어 있으면 파이썬이 객체 만들기를 막아요. 빠뜨린 메서드를 실행 전에 잡으려는 장치예요.
NotImplementedError 를 던지는 것과 뭐가 다른가요?
NotImplementedError 는 그 메서드를 부를 때에야 오류가 나요. ABC 는 객체를 만들 때 알려 줘요.
typing.Protocol 은 언제 사용하나요?
물려받지 않은 클래스도 메서드 꼴만 맞으면 받고 싶을 때요. 검사는 mypy 같은 타입 검사기가 해요.