도구
로그인
한국어

코드 배우기파이썬

파이썬 이름 규칙과 접근 제어

파이썬 3.12 기준

파이썬의 name·_name·__name·__name__ 이 어떻게 다른지 사물함 예제와 표로 봐요.

한 줄 뜻

파이썬에는 public·private 같은 키워드가 없고, 이름 앞의 밑줄로 쓰임을 알려요. 밑줄 하나는 약속, 밑줄 둘은 이름 바꾸기예요.

왜 필요한가

사물함의 틀린 횟수를 아무나 0으로 돌릴 수 있으면 세 번 틀리면 잠그는 규칙이 무의미해져요. 그런데 파이썬은 값을 완전히 잠그는 방법을 주지 않아요.

그래서 이름으로 신호를 줘요. _tries 를 보면 "사용하지 말 것", __pin 은 자식 클래스가 같은 이름을 사용해도 덮이지 않게 이름이 바뀌어요. 팀 모두가 이 약속을 지켜야 의미가 있어요.

일상 비유

회사 탕비실 냉장고를 떠올려 보세요. 이름표가 없는 음료는 누구나 마셔도 되고(공개), "개발팀" 스티커가 붙은 건 팀 사람만 꺼내요(_). 자물쇠는 없지만 다들 지키죠. __ 는 같은 이름 음료가 섞이지 않게 팀 이름까지 사용해 둔 이름표예요.

예제 코드

main.py · 29줄
class Locker:    max_tries = 3     def __init__(self, number, pin):        self.number = number        self._tries = 0        self.__pin = pin        self.is_open = False     def open(self, pin):        if self._tries >= Locker.max_tries:            return f"Locker {self.number} is locked"        if pin != self.__pin:            self._tries += 1            return f"Wrong pin ({self._tries}/{Locker.max_tries})"        self._tries = 0        self.is_open = True        return f"Locker {self.number} opened"     def __repr__(self):        return f"Locker({self.number}, open={self.is_open})"  box = Locker(12, "4821")print(box.open("0000"))print(box.open("4821"))print(sorted(vars(box)))print(box._Locker__pin == "4821", hasattr(box, "__pin"))print(box)

파이썬 이름 규칙

뜻밖에서 쓰기자식 클래스에서자바에 가까운 것
name공개. 누구나 사용해도 되는 이름OOpublic
_name안쪽용이라는 약속. 파이썬이 막지는 않음되지만 사용하지 않기로 약속Oprotected
__name클래스 이름을 붙여 `_Locker__name` 으로 바뀜바뀐 이름으로만바로는 안 됨private
__name__파이썬이 정해 둔 특별 메서드(`__init__`, `__repr__`)OO없음

모듈 맨 위의 _helper 같은 이름은 from 모듈 import * 로 가져오지 않아요. 모듈에서 내보낼 이름을 정하려면 __all__ = ["이름", ...] 을 사용해요.

언제 사용하나

  • 클래스 밖에서 사용하라고 내놓는 이름은 밑줄 없이
  • 안에서만 사용하는 값·도우미 메서드는 _이름
  • 상속이 깊고 자식이 같은 이름을 사용할까 걱정될 때만 __이름

__이름 을 "자바의 private" 으로 여기고 마구 사용하면 자식 클래스에서 꺼내 사용하기 불편해져요. 대부분은 밑줄 하나면 충분해요.

자주 하는 실수

자식 클래스에서 부모의 __이름 을 씀

자식 안의 self.__pin 은 _SmartLocker__pin 으로 바뀌어서 부모가 만든 _Locker__pin 을 못 찾아요. 자식과 나눠 사용할 값은 밑줄 하나(_pin)로 둬요.

틀린 코드

class Locker:    def __init__(self):        self.__pin = "4821"  class SmartLocker(Locker):    def show(self):        return self.__pin  print(SmartLocker().show())

실행하면AttributeError: 'SmartLocker' object has no attribute '_SmartLocker__pin'. Did you mean: '_Locker__pin'?

고친 코드

class Locker:    def __init__(self):        self._pin = "4821"  class SmartLocker(Locker):    def show(self):        return self._pin  print(SmartLocker().show())

실행하면4821

밖에서 _이름 을 고쳐 규칙을 건너뜀

_tries 를 0으로 돌리면 세 번 틀려 잠긴 사물함이 다시 열려요. 밑줄 하나는 "안쪽 규칙이 걸린 값"이라는 표시라 밖에서는 읽지도 쓰지도 않는 게 좋아요.

틀린 코드

box = Locker(7, "1234")for _ in range(3):    box.open("0000")box._tries = 0print(box.open("1234"))

실행하면Locker 7 opened

고친 코드

box = Locker(7, "1234")for _ in range(3):    box.open("0000")print(box.open("1234"))

실행하면Locker 7 is locked

내 값에 앞뒤 밑줄 두 개를 붙임

__pin__ 처럼 뒤에도 밑줄 두 개가 있으면 이름이 바뀌지 않아 공개 값이에요. 이 꼴은 파이썬이 사용하는 특별 이름이라 내 값에는 사용하지 않아요.

틀린 코드

class Locker:    def __init__(self, pin):        self.__pin__ = pin  print(Locker("4821").__pin__)

실행하면4821

고친 코드

class Locker:    def __init__(self, pin):        self.__pin = pin  print(hasattr(Locker("4821"), "__pin"))

실행하면False

확인 문제

문제 1

hasattr(box, "_Locker__pin") 은?

box = Locker(3, "1111")print(hasattr(box, "_Locker__pin"))

답과 까닭 보기

답: 1. True self.__pin 은 _Locker__pin 이라는 이름으로 객체에 들어 있어요. 그래서 참이에요.

문제 2

클래스 안에서 사용했을 때 이름이 바뀌지 않는 것은?

답과 까닭 보기

답: 2. __pin__ 앞에 밑줄 둘, 뒤에 밑줄 둘이면 특별 이름이라 바꾸지 않아요. 앞에만 둘이면 _클래스__이름 으로 바뀌어요.

자주 묻는 것

밑줄 하나와 둘은 뭐가 다른가요?

하나(_name)는 안쪽용이라는 약속일 뿐이에요. 둘(__name)은 파이썬이 _클래스__name 으로 이름을 바꿔 자식 클래스와 겹치지 않게 해요.

__name 이면 밖에서 못 읽나요?

바뀐 이름 _클래스__name 을 알면 읽고 쓸 수 있어요. 막는 장치가 아니라 실수를 줄이는 장치예요.

__init__ 처럼 앞뒤 밑줄 이름은 뭔가요?

파이썬이 정해 둔 특별 메서드예요. 이름이 바뀌지 않고, 내 속성 이름에는 이 꼴을 사용하지 않아요.