【Python】プロパティとは？実務で使える活用法を初心者向けに解説

プログラミング言語•2025/2/18

Python

はじめに

Pythonでクラスを定義するときに、属性へのアクセス方法を工夫したいと思ったことはありませんか。

具体的には、外部から値を取得・設定できる仕組みを用意したい場合や、値を変更するたびに自動でチェックを挟みたいケースがあるでしょう。

そのようなときに便利なのが、Python プロパティという仕組みです。

プロパティを使うと、メソッドのような柔軟な動きをもたせつつ、属性を扱うのと同じ記法が可能になります。

少し抽象的に聞こえるかもしれませんが、実務の現場で「値のバリデーションをする」「外部からは読み取り専用にしておく」といった場面でよく利用されます。

これから、プロパティとは何なのか、そしてなぜ使うのかをわかりやすく解説していきます。

この記事を読むとわかること

Pythonプロパティの概要とメリット
プロパティを定義するための具体的な方法
実務レベルでの活用シーンや注意点

Pythonプロパティとは？

Pythonのクラスで属性を定義するとき、多くの場合は単純に self.xxx のように代入して済ませます。

しかし、本格的な開発をするうえでは、値の受け取りや書き込みを慎重にコントロールしたい場面があるかもしれません。

例えば、数値データを属性に設定するときに、負の値は許容しないようにしたいケースや、あるいは外部から値を上書きされないようにしたいケースがあります。

そのような制御をシンプルな方法で実装できるのが プロパティ (property)です。

プロパティを活用すると、メソッドの呼び出しを意識せずに、あたかも普通の属性にアクセスしているかのような書き方ができます。

実際のコードでは、例えば obj.name のような書き方で値を取得し、 obj.name = "Tom" のように値をセットできます。

しかしその背後では、getterやsetterと呼ばれるメソッドが実行されるため、バリデーションや読み取り専用など、柔軟な制御が可能になります。

プロパティと単なるメソッドとの違いは、見た目のシンプルさと直感的な書き方ができる点です。

大規模なシステムや複数人で開発を行うプロジェクトでは「属性へのアクセス方法を将来的に変えたい」という状況がよく起こりますが、プロパティであれば、呼び出し側のコードを書き換えずに内部の実装を変えられるため、保守性も向上します。

なぜプロパティを使うのか？

クラスの属性に対し、追加の処理が必要なときはメソッドを別途作る方法も考えられます。

例えば、get_name() と set_name() のようなメソッドを用意してデータを操作するのです。

しかし実際にコードを書いてみると、次のような悩みが起きるかもしれません。

1つ目は、呼び出し側が get_ や set_ のような書き方を毎回しなければならないという点です。

単なる属性アクセスと違いが大きく、見通しが悪くなることがあります。

2つ目は、将来的に「メソッド」から「単純な属性」へ変更したい場合、呼び出し側を大幅に書き換える必要がある点です。

これは開発現場での保守や拡張を煩雑にする原因にもなりがちです。

そこで登場するのが、プロパティです。

プロパティを使えば、呼び出し側には obj.attribute のような普通の属性アクセスを提供しつつ、内部では必要な処理（バリデーションやエラーチェックなど）を実行できます。

そのため、「呼び出す側のコードをシンプルに保ちたい」「後から処理を変えたくなる可能性が高い」という場合に非常に有用です。

さらに、プロパティは読み取り専用や書き込み専用といった形にも設定できるため、誤った値の変更を避けたり、不用意な参照を阻止したりできます。

これはチームでの開発において、安全性を確保するうえでも大きなメリットになります。

Pythonプロパティの基本的な使い方

Pythonでプロパティを作る方法としては、大きく分けて2通りあります。

1つは property() 関数を使う方法、もう1つはデコレータ（@property）を使う方法です。

いずれの方法でも、getter・setter・deleter といった概念を用いながら、属性アクセスを細かく制御できます。

property() 関数を使った方法

まずは property() 関数を使うパターンです。

クラスの中で、getter・setterに対応するメソッドを用意して、それらを property(getter, setter, deleter) のようにまとめます。

コード例としては、次のようになります。


class Person:
    def __init__(self, name):
        self._name = name  # 実際の属性は先頭にアンダースコアを付けて管理することが多い

    def get_name(self):
        return self._name

    def set_name(self, value):
        if not value:
            raise ValueError("名前は空文字にはできません。")
        self._name = value

    def del_name(self):
        # 実務では削除を許可しない場合もある
        del self._name

    name = property(get_name, set_name, del_name)


person = Person("Alice")
print(person.name)  # "Alice" が表示される

person.name = "Bob"  # setterメソッドを内部的に呼び出している
print(person.name)  # "Bob" が表示される

# person.name = ""  空文字をセットしようとすると ValueError が発生

この例では、_name という実際の属性を内部で保持しています。

外部からは person.name という形でアクセスできるため、見た目はあくまで属性操作のように見えます。

一方で、読み取りや書き込みを行うと自動的に get_name() や set_name() が呼び出されるため、バリデーションやエラーチェックなどの処理を挟むことができます。

デコレータを使った方法

もう1つの書き方として、デコレータを使った表現はより簡潔です。

Pythonでは @property を使ったデコレータの構文を使うと、getter・setterをわかりやすくまとめることができます。

次の例をご覧ください。


class Employee:
    def __init__(self, salary):
        self._salary = salary

    @property
    def salary(self):
        return self._salary

    @salary.setter
    def salary(self, value):
        if value < 0:
            raise ValueError("給与を負の値にすることはできません。")
        self._salary = value

    @salary.deleter
    def salary(self):
        # 削除が必要なケースは稀ですが、例として記述
        del self._salary


emp = Employee(300000)
print(emp.salary)  # 値が取り出せる

emp.salary = 350000  # setterが呼ばれる
print(emp.salary)

# emp.salary = -100  これは負の値のためエラーになる

上記のように、@property のデコレータを付けたメソッドがgetter扱いになります。

そして同名のメソッドに @xxx.setter というデコレータを付けると、そのメソッドがsetterになります。

@xxx.deleter を付けるとdeleterとして機能します。

このデコレータ方式は、property() 関数を使うパターンに比べて記述量が少なく、分かりやすいのが特徴です。

クラスの実装者にとっては、どちらの書き方も最終的にやっていることは同じなので、好みに応じて選ぶことが多いです。

実務で使いそうな活用シーン

プロパティは、規模の大きいソフトウェアや複数人での開発の際に特に役に立ちます。

実務でよくある活用例としては、次のようなケースが挙げられます。

例：データのバリデーション

金融関係や在庫管理など、数値の入力や更新が多いシステムでは、数値が正しい範囲内であるかをチェックする必要があります。

例えば、商品の単価を設定するときに0未満や桁数が極端に大きい値が入らないようにしたい場合があります。


class Product:
    def __init__(self, name, price):
        self.name = name
        self._price = price

    @property
    def price(self):
        return self._price

    @price.setter
    def price(self, value):
        if value < 0:
            raise ValueError("価格を0未満に設定することはできません。")
        self._price = value

このようにしておくと、外部から product.price = -100 のような無効な値をセットしようとした場合にエラーを発生させられます。

これによって、誤った値がシステムに混入するのを防げるでしょう。

例：読み取り専用の属性

一部の情報は、外部から上書きされると困るケースがあります。

そのような属性は読み取り専用にしておくと安心です。

プロパティを使うと、getterだけを定義してsetterを定義しない、という方法で読み取り専用の属性を実現できます。


class Student:
    def __init__(self, student_id, name):
        self._student_id = student_id
        self.name = name

    @property
    def student_id(self):
        return self._student_id

# setterがないため、student_id は読み取れるが変更できない
s = Student(12345, "Mike")
print(s.student_id)  # 12345 が表示される

# s.student_id = 99999  これはエラーになる

外部から誤って上書きされることを防ぎたいデータについては、こうした形でプロパティを使い、読み取り専用にしておくのがよくあるパターンです。

Pythonプロパティを使う際の注意点

プロパティは便利ですが、使いすぎるとコードが複雑になる可能性もあります。

たとえば、属性が多すぎるクラスに対して何十個もプロパティを定義すると、メソッドが大量に増えて可読性が落ちるかもしれません。

また、setterを使って複雑なロジックを組み込みすぎると、メソッドの役割と境界線があいまいになる場合があります。

クラス設計としては、単純な属性アクセスだけで十分な場面まであえてプロパティを導入する必要はありません。

必要な箇所だけに限定して使うことで、保守性や可読性を高めながら、柔軟な拡張性も確保できます。

Pythonプロパティは、後から実装を変更したい場合にも強みがあります。
最初は単なる属性にしておき、必要に応じてプロパティに切り替えれば、呼び出し側のコードはそのままで内部実装を差し替えできます。

一方で、プロパティはクラスの外部からは「単純な属性のように見える」という特徴があります。

そのため、呼び出し側では「裏で何か特殊なロジックが動いている」と気づかないまま使う人がいるかもしれません。

ドキュメントやコメントで、プロパティの役割を明示しておくと親切です。

あまりに多くのメソッドをプロパティに変換すると、メソッドの意図や目的が見えにくくなることがあります。
ただシンプルにメソッドを定義したほうが可読性が高い場合もあるので、設計段階で検討してください。

まとめ

Python プロパティは、クラスの属性管理を柔軟にするうえでとても便利な機能です。

バリデーションや読み取り専用の設定など、実際の現場でも利用価値が高いでしょう。

普通の属性アクセスのように書ける
getter、setter、deleterを通じて内部の動きをコントロールできる
後から実装を変更しても、呼び出し側のコードを大きく変える必要がない

こういったメリットを押さえたうえで、クラスの設計や保守を見通し良くしたい場合に、ぜひプロパティを導入してみてください。