utils.deprecated
================

.. py:module:: utils.deprecated

.. autoapi-nested-parse::

   通用装饰器集合。



Functions
---------

.. autoapisummary::

   utils.deprecated.legacy_only


Module Contents
---------------

.. py:function:: legacy_only(func)

   标记仅作遗留参考的函数，调用时打印 DeprecationWarning。

   与 typing_extensions.deprecated 不同，此装饰器明确表示函数
   不再维护、不应被新代码调用，仅保留作参考或单元测试对照组。

   用法:
       @legacy_only
       def old_function():
           ...