| 12345678910111213141516171819202122232425262728293031323334 |
- 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
|
