Python3 で property decorator の仕様が知りたい

Question

python はメインの言語ではなく経験が浅いです。

下記の ['', setter, deleter] ような、property decrator の種類が知りたいです。
PEP562, EPE549 あたりに少し記述があるのを確認したのですが、まとめられた物はないのでしょうか？
できれば、個人の調査でなく PEP の番号を教えていただけるた助かります。

追記: PEP318 の記載で全てでしょうか？

# https://qiita.com/Sylba2050/items/d6f23ac13a0cc5da0c17より引用

class MyProperty(object):
    def __init__(self, x):
        self._x = x

    @property # propertyの時は　x.getterと同義
    def x(self):
        return self._x

    @x.setter
    def x(self, v):
        self._x = abs(v) # 更新前に何らかの処理をはさめる

    @x.deleter
    def x(self):
        self._x = None

Answer 1

propertyはdecoratorとして使える組み込みのクラスの一つです。

Pythonで言語レベルで機能しているのはdecoratorの方であり、decoratorとして機能する関数やクラスを自分で定義して使ったりすることもできます。

それに比べればpropertyクラスなどは一つの応用に過ぎず、仮に組み込みになかったとしても、同様に機能するものをpure Pythonで書くのは原理的には可能……と思ったけど、恐らく属性アクセスの仕組みの側でpropertyオブジェクトへの参照を特別扱いにしているので、mypropertyを作るのは難しいかもしれない……。

いずれにせよ、Pythonの「プロパティ」関連の機能は、けっきょくこれがすべてです。基本的には、クラスという仕組みとデコレータという仕組みの上に「プロパティのように使えるもの」を実装しているだけです。

同じような応用として、classmethodなどが組み込みで定義されています。こちらも同じような位置づけです。

組み込みの「デコレータとして使えるもの」は「組み込み関数」のページにまとめて書かれています（それでぜんぶ、のはず）。@でページ検索するとわかりますが、

• classmethod
• property
• staticmethod

だけです。なお、他に組み込みモジュール内に定義されているデコレータも存在します（functools.lru_cacheなど）。

---

……という関係性がよくわからなくて混乱していそうな気がしたので、書いてみました。違っていたらすみません。

Comments

[yosukesan]

検索のやり方を教えていただきありがとうございました。

pep-3129 に decorator の EBNF があるの見逃がしていました。class decorator と(member) function decorator で別の型として AST を構成しているようです。つまり、言語仕様だと思います。なお、コードでの実装までは確認していません。decorator 型はこの 2 種類しか定義されていないので、ユーザー定義の property は定義できないということですね。理解しました。

Answer 2

公式ドキュメントのclass propertyに書かれている以上の何を知りたいのでしょう？

Comments

[yosukesan]

上記の class property に記載で全てなのですか？ @classmethod なども見かけるのですが、関数に対しての decorator ではないのでしょうか？