code: def deprecated_arg_values(
      date, instructions, warn_once=True, **deprecated_kwargs
  ):
      """Decorator for marking specific function argument values as deprecated.
  
      This decorator logs a deprecation warning whenever the decorated function is
      called with the deprecated argument values. It has the following format:
  
        Calling <function> (from <module>) with <arg>=<value> is deprecated and
        will be removed after <date>. Instructions for updating:
          <instructions>
  
      If `date` is None, 'after <date>' is replaced with 'in a future version'.
      <function> will include the class name if it is a method.
  
      It also edits the docstring of the function: ' (deprecated arguments)' is
      appended to the first line of the docstring and a deprecation notice is
      prepended to the rest of the docstring.
  
      Args:
        date: String or None. The date the function is scheduled to be removed. Must
          be ISO 8601 (YYYY-MM-DD), or None
        instructions: String. Instructions on how to update code using the
          deprecated function.
        warn_once: If `True`, warn only the first time this function is called with
          deprecated argument values. Otherwise, every call (with a deprecated
          argument value) will log a warning.
        **deprecated_kwargs: The deprecated argument values.
  
      Returns:
        Decorated function or method.
  
      Raises:
        ValueError: If date is not None or in ISO 8601 format, or instructions are
          empty.
      """
      _validate_deprecation_args(date, instructions)
      if not deprecated_kwargs:
          raise ValueError(
              "Specify which argument values are deprecated."
          )
  
      def deprecated_wrapper(func):
          """Deprecation decorator."""
          decorator_utils.validate_callable(
              func, "deprecated_arg_values"
          )
  
          @functools.wraps(func)
          def new_func(*args, **kwargs):
              """Deprecation wrapper."""
              if _PRINT_DEPRECATION_WARNINGS:
                  named_args = tf_inspect.getcallargs(
                      func, *args, **kwargs
                  )
                  for arg_name, arg_value in deprecated_kwargs.items():
                      if arg_name in named_args and _safe_eq(
                          named_args[arg_name], arg_value
                      ):
                          if (func, arg_name) not in _PRINTED_WARNING:
                              if warn_once:
                                  _PRINTED_WARNING[
                                      (func, arg_name)
                                  ] = True
                              _log_deprecation(
                                  "From %s: calling %s (from %s) with %s=%s is deprecated and "
                                  "will be removed %s.\nInstructions for updating:\n%s",
                                  _call_location(),
                                  decorator_utils.get_qualified_name(
                                      func
                                  ),
                                  func.__module__,
                                  arg_name,
                                  arg_value,
                                  "in a future version"
                                  if date is None
                                  else ("after %s" % date),
                                  instructions,
                              )
              return func(*args, **kwargs)
  
          doc = _add_deprecated_arg_value_notice_to_docstring(
              func.__doc__, date, instructions, deprecated_kwargs
          )
          return tf_decorator.make_decorator(
              func, new_func, "deprecated", doc
          )
  
      return deprecated_wrapper
  
imports: import collections
  import functools
  import inspect
  import re
  from tensorflow.python.framework import strict_mode
  from tensorflow.python.platform import tf_logging
  from tensorflow.python.util import decorator_utils
  from tensorflow.python.util import is_in_graph_mode
  from tensorflow.python.util import tf_contextlib
  from tensorflow.python.util import tf_decorator
  from tensorflow.python.util import tf_inspect
  from tensorflow.tools.docs import doc_controls
label_desc: Use image node_id 13 for calling a global function with example usage: deprecated_arg_values(date, instructions, warn_once) and returns: deprecated_wrapper, tf_decorator, func