도구
로그인
한국어

코드 배우기파이썬

파이썬 추상화

파이썬 3.12 기준abstract method error text · 파이썬 3.12 부터

ABC 와 @abstractmethod 로 보고서 틀을 만들어요. Protocol 과 무엇이 다른지도 표로 봐요.

한 줄 뜻

무엇을 해야 하는지(메서드 이름과 꼴)만 부모에 정해 두고, 어떻게 할지는 자식에게 맡기는 방법이에요. 파이썬은 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 + @abstractmethodraise NotImplementedErrortyping.Protocol
물려받아야 하나OOX
빠뜨리면 알게 되는 때객체를 만들 때그 메서드를 부를 때타입 검사기(mypy 등)를 돌릴 때
공통 코드 넣기OOX
어울리는 곳틀과 순서를 부모가 쥘 때작은 코드·빠른 시작남이 만든 클래스도 받아야 할 때

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 같은 타입 검사기가 해요.