最近在看《重構：改善既有程式的設計》，其中提到 Java 有 @Deprecated 這種 Marker annotation，用於標記某方法將會被廢棄。

找了一下發現 Python 也有 warnings 模組可用於同樣目的。

warnings.py 中定義了 DeprecationWarning、PendingDeprecationWarning 和其他警告可供使用。

https://docs.python.org/2/library/warnings.html