Pythonでデータを隠す方法：プライベート属性とネームマングリングの基本

オブジェクトの属性（アトリビュート）は、クラス定義の外部から見える場合と見えない場合があります。Pythonでは、属性名の先頭にアンダースコア2つ（__）を付けることで、その属性をクラス外から直接参照できないようにできます。これがPythonにおける「データ隠蔽（カプセル化）」の基本的な手法です。

サンプルコード

#!/usr/bin/python
class JustCounter:
    __secretCount = 0

    def count(self):
        self.__secretCount += 1
        print(self.__secretCount)

counter = JustCounter()
counter.count()
counter.count()
print(counter.__secretCount)

実行結果

上記のコードを実行すると、次のような結果になります。

1
2
Traceback (most recent call last):
  File "test.py", line 12, in <module>
    print(counter.__secretCount)
AttributeError: 'JustCounter' object has no attribute '__secretCount'

クラスの外側からプライベート属性へアクセスしようとすると、このように AttributeError が発生します。これは、Pythonが内部的に属性名を書き換えて保護しているためです。この仕組みは「ネームマングリング」と呼ばれ、属性名は自動的に _クラス名__属性名 という形式に変換されます。

ネームマングリングされた属性へのアクセス方法

変換後の名前を使えば、object._className__attrName の形式で外部からでもアクセス可能です。先ほどのコードの最終行を次のように置き換えてみましょう。

.........................
print(counter._JustCounter__secretCount)

実行結果：

1
2
2

補足：シングルアンダースコアとの違い

先頭にアンダースコア1つだけを付けた属性（_attr）は、言語レベルでの制限はなく、「外部から使用しないでほしい」という開発者間の慣習的な合図です。一方、アンダースコア2つ（__attr）を付けると、前述のネームマングリングによって名前が書き換えられるため、サブクラスでの属性名の衝突を防ぐ効果もあります。

ただし、これらの仕組みはあくまでアクセスを「難しくする」ためのものであり、他の言語のような厳密な private 機構ではない点には注意してください。実際の開発では、外部公開するAPIとして意図していない属性には、この命名規則を適切に使い分けることが推奨されています。