도구
로그인
한국어

코드 배우기파이썬

파이썬 캡슐화

파이썬 3.12 기준

은행 계좌 잔액을 __이름과 @property 로 감춰요. 감추지 않았을 때 생기는 버그부터 봐요.

한 줄 뜻

객체 안의 값은 밑줄 이름으로 감추고, 바꾸는 일은 검사를 거치는 메서드에만 맡기는 방법이에요. 읽기만 필요하면 @property 를 사용해요.

왜 필요한가

아래 버그 코드처럼 acc.balance -= 3500 을 아무 데서나 사용할 수 있으면 잔액이 모자라도 돈이 빠져나가요. 검사 코드를 넣으려 해도 잔액을 건드리는 줄이 여기저기 있어서 하나라도 빠뜨리면 그만이에요.

잔액을 __balance 로 감추고 deposit, withdraw 안에서만 바꾸게 하면 검사와 기록이 한 곳에 모여요. 출금 규칙이 바뀌어도 메서드 하나만 고쳐요.

일상 비유

편의점 무인 계산대를 생각해 보세요. 손님은 돈통을 직접 열지 않고, 계산대 화면에서 "결제"를 누를 뿐이에요. 금액이 맞는지는 계산대가 확인해요. 돈통이 감춘 값, 화면 단추가 메서드예요.

캡슐화를 안 하면 생기는 버그

class Account:    def __init__(self, owner, balance):        self.owner = owner        self.balance = balance  acc = Account("Jisoo", 2000)acc.balance -= 3500acc.balance += -400print(acc.owner, acc.balance)

실행하면

Jisoo -1900

balance 를 아무 줄에서나 바꿀 수 있어서 2000원 계좌에서 3500원이 빠져나갔어요. 잔액이 모자라도 막는 코드가 없어요.

-400원을 "더하는" 줄도 걸리지 않고 통과해 잔액이 -1900원이 됐어요. 이런 줄이 파일 열 곳에 흩어져 있으면 어느 줄이 범인인지 찾기 어려워요.

예제 코드

main.py · 47줄
class Account:    def __init__(self, owner, start=0):        if start < 0:            raise ValueError("start must be 0 or more")        self._owner = owner        self.__balance = start        self._log = []     @property    def owner(self):        return self._owner     @property    def balance(self):        return self.__balance     def deposit(self, amount):        if amount <= 0:            print(f"Refused: deposit {amount}")            return False        self.__balance += amount        self._log.append(f"+{amount}")        return True     def withdraw(self, amount):        if amount <= 0 or amount > self.__balance:            print(f"Refused: withdraw {amount}")            return False        self.__balance -= amount        self._log.append(f"-{amount}")        return True     def history(self):        return list(self._log)  acc = Account("Jisoo", 2000)acc.deposit(800)acc.withdraw(5000)acc.deposit(-400)acc.withdraw(1300)try:    acc.balance = 99999except AttributeError as e:    print("Blocked:", e)print(f"{acc.owner}: {acc.balance}")print("History:", acc.history())

언제 사용하나

  • 틀린 값이 들어가면 안 되는 속성(잔액, 재고, 점수, 나이)
  • 값이 바뀔 때 함께 해야 할 일이 있을 때(기록, 알림, 다시 계산)
  • 안에 든 목록·사전을 밖에 보여 줄 때. 복사본을 돌려줘요.

파이썬에는 자바의 private 처럼 막는 키워드가 없어요. _이름 은 "안쪽용이니 사용하지 마세요"라는 약속이고, __이름 은 이름을 바꿔 실수로 덮어쓰는 일을 줄여요.

읽기 전용 속성 오류 글 "has no setter" 는 파이썬 3.11 부터 이렇게 나와요. 그 전 버전은 "can't set attribute" 라고 나와요.

자주 하는 실수

__이름 이면 절대 못 바꾼다고 믿음

__balance 는 이름만 _Account__balance 로 바뀔 뿐 잠기지 않아요. 바뀐 이름을 알면 밖에서도 고쳐져요. 파이썬의 숨기기는 약속이라, 정해 둔 메서드를 사용하는 습관이 지켜 줘요.

틀린 코드

acc = Account("Jisoo", 2000)acc._Account__balance = -1print(acc.balance)

실행하면-1

고친 코드

acc = Account("Jisoo", 2000)acc.withdraw(2001)print(acc.balance)

실행하면Refused: withdraw 2001 2000

@property 와 저장할 값에 같은 이름을 씀

self.balance = start 가 속성 balance 에 값을 넣으려다 setter 가 없어 멈춰요. 값은 _balance 처럼 다른 이름에 담고, @property 는 그 값을 읽어 주게 해요.

틀린 코드

class Account:    def __init__(self, start):        self.balance = start     @property    def balance(self):        return self.balance  Account(100)

실행하면AttributeError: property 'balance' of 'Account' object has no setter

고친 코드

class Account:    def __init__(self, start):        self._balance = start     @property    def balance(self):        return self._balance  print(Account(100).balance)

실행하면100

setter 를 만들고 검사는 안 넣음

@balance.setter 를 붙여도 받은 값을 검사 없이 담으면 열린 속성과 다를 게 없어요. setter 를 둔다면 그 안에서 틀린 값을 막아야 해요.

틀린 코드

class Account:    def __init__(self):        self._balance = 0     @property    def balance(self):        return self._balance     @balance.setter    def balance(self, value):        self._balance = value  acc = Account()acc.balance = -999print(acc.balance)

실행하면-999

고친 코드

class Account:    def __init__(self):        self._balance = 0     @property    def balance(self):        return self._balance     @balance.setter    def balance(self, value):        if value < 0:            raise ValueError("balance cannot be negative")        self._balance = value  acc = Account()try:    acc.balance = -999except ValueError as e:    print(e)print(acc.balance)

실행하면balance cannot be negative 0

확인 문제

문제 1

예제의 Account 에서 acc.balance = 0 이라고 쓰면 어떻게 될까요?

답과 까닭 보기

답: 2. `AttributeError` 가 나요 balance 는 @property 로 읽기만 열어 두었어요. setter 가 없으니 값을 넣으려 하면 AttributeError 가 나요.

문제 2

vars(acc) 에 _Account__balance 라는 열쇠가 있을까요?

acc = Account("Joon", 500)print("_Account__balance" in vars(acc))

답과 까닭 보기

답: 1. True 클래스 안에서 사용한 self.__balance 는 저장될 때 _Account__balance 로 이름이 바뀌어요. 그래서 열쇠가 있어요.

자주 묻는 것

파이썬에도 private 이 있나요?

키워드는 없어요. _이름 은 안쪽용이라는 약속이고, __이름 은 _클래스__이름 으로 바뀔 뿐 밖에서 완전히 막지는 않아요.

@property 는 언제 사용하나요?

밖에서 값을 읽게만 하고 싶을 때, 또는 읽거나 넣을 때 검사·계산을 끼우고 싶을 때 사용해요. 부르는 쪽은 괄호 없이 속성처럼 읽어요.

getter·setter 메서드를 모두 만들어야 하나요?

아니요. 파이썬은 보통 평범한 속성으로 두고, 검사가 필요해질 때 @property 로 바꿔요. 부르는 코드는 고치지 않아도 돼요.