message: Add api documentation for `tf.io.gfile.exists`.
diff: @@ -233,26 +233,35 @@ class FileIO(object):
  return True
  -@tf_export(v1=["gfile.Exists"])
  -def file_exists(filename):
  +@tf_export("io.gfile.exists")
  +def file_exists_v2(path):
  """Determines whether a path exists or not.
  - Args:
  - filename: string, a path
  + >>> with open("/tmp/x", "w") as f:
  + ... f.write("asdf")
  + ...
  + 4
  + >>> tf.io.gfile.exists("/tmp/x")
  + True
  - Returns:
  - True if the path exists, whether it's a file or a directory.
  - False if the path does not exist and there are no filesystem errors.
  + You can also specify the URI scheme for selecting a different filesystem:
  - Raises:
  - errors.OpError: Propagates any errors reported by the FileSystem API.
  - """
  - return file_exists_v2(filename)
  + >>> # for a GCS filesystem path:
  + >>> # tf.io.gfile.exists("gs://bucket/file")
  + >>> # for a local filesystem:
  + >>> with open("/tmp/x", "w") as f:
  + ... f.write("asdf")
  + ...
  + 4
  + >>> tf.io.gfile.exists("file:///tmp/x")
  + True
  + This currently returns `True` for existing directories but don't rely on this
  + behavior, especially if you are using cloud filesystems (e.g., GCS, S3,
  + Hadoop):
  -@tf_export("io.gfile.exists")
  -def file_exists_v2(path):
  - """Determines whether a path exists or not.
  + >>> tf.io.gfile.exists("/tmp")
  + True
  Args:
  path: string, a path
  @@ -271,6 +280,14 @@ def file_exists_v2(path):
  return True
  +@tf_export(v1=["gfile.Exists"])
  +def file_exists(filename):
  + return file_exists_v2(filename)
  +
  +
  +file_exists.__doc__ = file_exists_v2.__doc__
  +
  +
  @tf_export(v1=["gfile.Remove"])
  def delete_file(filename):
  """Deletes the file located at 'filename'.
  