mirror of
https://github.com/zebrajr/pytorch.git
synced 2025-12-06 12:20:52 +01:00
538647fe1f
Summary: Pull Request resolved: https://github.com/pytorch/pytorch/pull/63888 Test Plan: Imported from OSS Reviewed By: pbelevich Differential Revision: D30523133 Pulled By: jamesr66a fbshipit-source-id: b04cc0d842a74862f42ecba98b757310cd2ec7b0
35 lines
1000 B
Python
35 lines
1000 B
Python
from typing import Any, Dict
|
|
import textwrap
|
|
|
|
_BACK_COMPAT_OBJECTS : Dict[Any, None] = {}
|
|
_MARKED_WITH_COMATIBLITY : Dict[Any, None] = {}
|
|
|
|
def compatibility(is_backward_compatible : bool):
|
|
if is_backward_compatible:
|
|
|
|
def mark_back_compat(fn):
|
|
docstring = textwrap.dedent(getattr(fn, '__doc__', None) or '')
|
|
docstring += """
|
|
.. note::
|
|
Backwards-compatibility for this API is guaranteed.
|
|
"""
|
|
fn.__doc__ = docstring
|
|
_BACK_COMPAT_OBJECTS.setdefault(fn)
|
|
_MARKED_WITH_COMATIBLITY.setdefault(fn)
|
|
return fn
|
|
|
|
return mark_back_compat
|
|
else:
|
|
|
|
def mark_not_back_compat(fn):
|
|
docstring = textwrap.dedent(getattr(fn, '__doc__', None) or '')
|
|
docstring += """
|
|
.. warning::
|
|
This API is experimental and is *NOT* backward-compatible.
|
|
"""
|
|
fn.__doc__ = docstring
|
|
_MARKED_WITH_COMATIBLITY.setdefault(fn)
|
|
return fn
|
|
|
|
return mark_not_back_compat
|