Object

sbt.io

IO

Related Doc: package io

Permalink

object IO

A collection of File, URL, and I/O utility methods.

Linear Supertypes
AnyRef, Any
Ordering
  1. Alphabetic
  2. By inheritance
Inherited
  1. IO
  2. AnyRef
  3. Any
  1. Hide All
  2. Show all
Visibility
  1. Public
  2. All

Value Members

  1. final def !=(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  2. final def ##(): Int

    Permalink
    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  4. val Newline: String

    Permalink

    The newline string for this system, as obtained by the line.separator system property.

  5. def append(file: File, bytes: Array[Byte]): Unit

    Permalink

    Appends bytes to the existing contents of file.

    Appends bytes to the existing contents of file. If file does not exist, it is created, as are any parent directories.

  6. def append(file: File, content: String, charset: Charset = defaultCharset): Unit

    Permalink

    Appends content to the existing contents of file using charset or UTF-8 if charset is not explicitly specified.

    Appends content to the existing contents of file using charset or UTF-8 if charset is not explicitly specified. If file does not exist, it is created, as are any parent directories.

  7. def asFile(url: URL): File

    Permalink

    Converts the given URL to a File.

    Converts the given URL to a File. If the URL is for an entry in a jar, the File for the jar is returned.

  8. final def asInstanceOf[T0]: T0

    Permalink
    Definition Classes
    Any
  9. def assertAbsolute(uri: URI): Unit

    Permalink
  10. def assertAbsolute(f: File): Unit

    Permalink
  11. def assertDirectories(file: File*): Unit

    Permalink
  12. def assertDirectory(file: File): Unit

    Permalink
  13. def classLocation[T](implicit mf: Manifest[T]): URL

    Permalink

    Returns a URL for the directory or jar containing the class file for type T (as determined by an implicit Manifest).

    Returns a URL for the directory or jar containing the class file for type T (as determined by an implicit Manifest). If the location cannot be determined, an error is generated. Note that Java standard library classes typically do not have a location associated with them.

  14. def classLocation(cl: Class[_]): URL

    Permalink

    Returns a URL for the directory or jar containing the the class file cl.

    Returns a URL for the directory or jar containing the the class file cl. If the location cannot be determined, an error is generated. Note that Java standard library classes typically do not have a location associated with them.

  15. def classLocationFile[T](implicit mf: Manifest[T]): File

    Permalink

    Returns the directory or jar file containing the the class file for type T (as determined by an implicit Manifest).

    Returns the directory or jar file containing the the class file for type T (as determined by an implicit Manifest). If the location cannot be determined, an error is generated. Note that Java standard library classes typically do not have a location associated with them.

  16. def classLocationFile(cl: Class[_]): File

    Permalink

    Returns the directory or jar file containing the the class file cl.

    Returns the directory or jar file containing the the class file cl. If the location cannot be determined or it is not a file, an error is generated. Note that Java standard library classes typically do not have a location associated with them.

  17. def clone(): AnyRef

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  18. def copy(sources: Traversable[(File, File)], overwrite: Boolean = false, preserveLastModified: Boolean = false): Set[File]

    Permalink

    For each pair in sources, copies the contents of the first File (the source) to the location of the second File (the target).

    For each pair in sources, copies the contents of the first File (the source) to the location of the second File (the target).

    A source file is always copied if overwrite is true. If overwrite is false, the source is only copied if the target is missing or is older than the source file according to last modified times. If the source is a directory, the corresponding directory is created.

    If preserveLastModified is true, the last modified times are transferred as well. Any parent directories that do not exist are created. The set of all target files is returned, whether or not they were updated by this method.

  19. def copyDirectory(source: File, target: File, overwrite: Boolean = false, preserveLastModified: Boolean = false): Unit

    Permalink

    Copies the contents of each file in the source directory to the corresponding file in the target directory.

    Copies the contents of each file in the source directory to the corresponding file in the target directory. A source file is always copied if overwrite is true. If overwrite is false, the source is only copied if the target is missing or is older than the source file according to last modified times. Files in target without a corresponding file in source are left unmodified in any case. If preserveLastModified is true, the last modified times are transferred as well. Any parent directories that do not exist are created.

  20. def copyFile(sourceFile: File, targetFile: File, preserveLastModified: Boolean = false): Unit

    Permalink

    Copies the contents of sourceFile to the location of targetFile, overwriting any existing content.

    Copies the contents of sourceFile to the location of targetFile, overwriting any existing content. If preserveLastModified is true, the last modified time is transferred as well.

  21. def copyLastModified(sourceFile: File, targetFile: File): Boolean

    Permalink

    Transfers the last modified time of sourceFile to targetFile.

  22. def createDirectories(dirs: Traversable[File]): Unit

    Permalink

    Creates directories dirs and all parent directories.

    Creates directories dirs and all parent directories. It tries to work around a race condition in File.mkdirs() by retrying up to a limit.

  23. def createDirectory(dir: File): Unit

    Permalink

    Creates directory dir and all parent directories.

    Creates directory dir and all parent directories. It tries to work around a race condition in File.mkdirs() by retrying up to a limit.

  24. def createTemporaryDirectory: File

    Permalink

    Creates a directory in the default temporary directory with a name generated from a random integer.

  25. def createUniqueDirectory(baseDirectory: File): File

    Permalink

    Creates a directory in baseDirectory with a name generated from a random integer

  26. def defaultCharset: Charset

    Permalink

    The default Charset used when not specified: UTF-8.

  27. def delete(file: File): Unit

    Permalink

    Deletes file, recursively if it is a directory.

  28. def delete(files: Iterable[File]): Unit

    Permalink

    Deletes each file or directory (recursively) in files.

  29. def deleteFilesEmptyDirs(files: Iterable[File]): Unit

    Permalink

    Deletes each file or directory in files recursively.

    Deletes each file or directory in files recursively. Any empty parent directories are deleted, recursively.

  30. def deleteIfEmpty(dirs: Set[File]): Unit

    Permalink

    Deletes all empty directories in the set.

    Deletes all empty directories in the set. Any non-empty directories are ignored.

  31. def directoryURI(uri: URI): URI

    Permalink

    Converts an absolute File to a URI.

    Converts an absolute File to a URI. The File is converted to a URI (toURI), normalized (normalize), encoded (toASCIIString), and a forward slash ('/') is appended to the path component if it does not already end with a slash.

  32. def directoryURI(dir: File): URI

    Permalink

    Converts an absolute File to a URI.

    Converts an absolute File to a URI. The File is converted to a URI (toURI), normalized (normalize), encoded (toASCIIString), and a forward slash ('/') is appended to the path component if it does not already end with a slash.

  33. final def eq(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  34. def equals(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  35. def finalize(): Unit

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  36. def foldLines[T](in: BufferedReader, init: T)(f: (T, String) ⇒ T): T

    Permalink

    Applies f to each line read from in and the accumulated value of type T, with initial value init.

    Applies f to each line read from in and the accumulated value of type T, with initial value init. This method does not close in.

  37. def foreachLine(in: BufferedReader)(f: (String) ⇒ Unit): Unit

    Permalink

    Applies f to each line read from in.

    Applies f to each line read from in. This method does not close in.

  38. final def getClass(): Class[_]

    Permalink
    Definition Classes
    AnyRef → Any
  39. def gunzip(input: InputStream, output: OutputStream): Unit

    Permalink

    Gunzips the InputStream 'input' and writes it to 'output'.

    Gunzips the InputStream 'input' and writes it to 'output'. Neither stream is closed.

  40. def gunzip(in: File, out: File): Unit

    Permalink

    Gunzips the file 'in' and writes it to 'out'.

    Gunzips the file 'in' and writes it to 'out'. 'in' cannot be the same file as 'out'.

  41. def gzip(input: InputStream, output: OutputStream): Unit

    Permalink

    Gzips the InputStream 'in' and writes it to 'output'.

    Gzips the InputStream 'in' and writes it to 'output'. Neither stream is closed.

  42. def gzip(in: File, out: File): Unit

    Permalink

    Gzips the file 'in' and writes it to 'out'.

    Gzips the file 'in' and writes it to 'out'. 'in' cannot be the same file as 'out'.

  43. def gzipFileIn[T](file: File)(f: (InputStream) ⇒ T): T

    Permalink

    Applies f to a buffered gzip InputStream for file.

    Applies f to a buffered gzip InputStream for file. The streams involved are opened before calling f and closed after it returns. The result is the result of f.

  44. def gzipFileOut[T](file: File)(f: (OutputStream) ⇒ T): T

    Permalink

    Applies f to a buffered gzip OutputStream for file.

    Applies f to a buffered gzip OutputStream for file. The streams involved are opened before calling f and closed after it returns. The result is the result of f.

  45. def hashCode(): Int

    Permalink
    Definition Classes
    AnyRef → Any
  46. final def isInstanceOf[T0]: Boolean

    Permalink
    Definition Classes
    Any
  47. def jar(sources: Traversable[(File, String)], outputJar: File, manifest: Manifest): Unit

    Permalink

    Creates a jar file.

    Creates a jar file.

    sources

    The files to include in the jar file paired with the entry name in the jar. Only the pairs explicitly listed are included.

    outputJar

    The file to write the jar to.

    manifest

    The manifest for the jar.

  48. def listFiles(dir: File): Array[File]

    Permalink

    Returns the children of directory dir in a non-null array.

  49. def listFiles(dir: File, filter: java.io.FileFilter): Array[File]

    Permalink

    Returns the children of directory dir that match filter in a non-null array.

  50. def listFiles(filter: java.io.FileFilter)(dir: File): Array[File]

    Permalink

    Returns the children of directory dir that match filter in a non-null array.

  51. def load(properties: Properties, from: File): Unit

    Permalink

    Reads the properties in from into properties.

    Reads the properties in from into properties. If from does not exist, properties is left unchanged.

  52. def move(a: File, b: File): Unit

    Permalink

    Moves the contents of a to the location specified by b.

    Moves the contents of a to the location specified by b. This method deletes any content already at b and creates any parent directories of b if they do not exist. It will first try File.renameTo and if that fails, resort to copying and then deleting the original file. In either case, the original File will not exist on successful completion of this method.

  53. def move(files: Traversable[(File, File)]): Unit

    Permalink

    For each pair in files, moves the contents of the first File to the location of the second.

    For each pair in files, moves the contents of the first File to the location of the second. See move(File,File) for the behavior of the individual move operations.

  54. final def ne(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  55. final def notify(): Unit

    Permalink
    Definition Classes
    AnyRef
  56. final def notifyAll(): Unit

    Permalink
    Definition Classes
    AnyRef
  57. def objectInputStream(wrapped: InputStream, loader: ClassLoader): ObjectInputStream

    Permalink

    Constructs an ObjectInputStream on wrapped that uses loader to load classes.

    Constructs an ObjectInputStream on wrapped that uses loader to load classes. See also issue 136.

  58. def parseClasspath(s: String): Seq[File]

    Permalink

    Parses a classpath String into File entries according to the current platform's path separator.

  59. def pathSplit(s: String): Array[String]

    Permalink

    Splits a String around the platform's path separator characters.

  60. def read(file: File, charset: Charset = defaultCharset): String

    Permalink

    Reads the full contents of file into a String using charset or UTF-8 if charset is not explicitly specified.

  61. def readBytes(in: InputStream): Array[Byte]

    Permalink

    Reads the full contents of in into a byte array.

    Reads the full contents of in into a byte array. This method does not close in.

  62. def readBytes(file: File): Array[Byte]

    Permalink

    Reads the full contents of in into a byte array.

  63. def readLines(in: BufferedReader): List[String]

    Permalink

    Reads all of the lines from in.

    Reads all of the lines from in. This method does not close in.

  64. def readLines(file: File, charset: Charset = defaultCharset): List[String]

    Permalink

    Reads all of the lines in file using the provided charset or UTF-8 if charset is not explicitly specified.

  65. def readLinesURL(url: URL, charset: Charset = defaultCharset): List[String]

    Permalink

    Reads all of the lines from url using the provided charset or UTF-8 if charset is not explicitly specified.

  66. def readStream(in: InputStream, charset: Charset = defaultCharset): String

    Permalink

    Reads the full contents of in into a byte array.

    Reads the full contents of in into a byte array. This method does not close in.

  67. def reader[T](file: File, charset: Charset = defaultCharset)(f: (BufferedReader) ⇒ T): T

    Permalink
  68. def relativize(base: File, file: File): Option[String]

    Permalink

    Returns the path for file relative to directory base or None if base is not a parent of file.

    Returns the path for file relative to directory base or None if base is not a parent of file. If file or base are not absolute, they are first resolved against the current working directory.

  69. def relativizeFile(base: File, file: File): Option[File]

    Permalink

    Returns the relative file for file relative to directory base or None if base is not a parent of file.

    Returns the relative file for file relative to directory base or None if base is not a parent of file. If file or base are not absolute, they are first resolved against the current working directory.

  70. def resolve(base: File, f: File): File

    Permalink

    Resolves f against base, which must be an absolute directory.

    Resolves f against base, which must be an absolute directory. The result is guaranteed to be absolute. If f is absolute, it is returned without changes.

  71. def split(name: String): (String, String)

    Permalink

    Splits the given string into base and extension strings.

    Splits the given string into base and extension strings. If name contains no period, the base string is the input string and the extension is the empty string. Otherwise, the base is the substring up until the last period (exclusive) and the extension is the substring after the last period.

    For example, split("Build.scala") == ("Build", "scala")

  72. def stash[T](files: Set[File])(f: ⇒ T): T

    Permalink

    Move the provided files to a temporary location.

    Move the provided files to a temporary location. If 'f' returns normally, delete the files. If 'f' throws an Exception, return the files to their original location.

  73. final def synchronized[T0](arg0: ⇒ T0): T0

    Permalink
    Definition Classes
    AnyRef
  74. val temporaryDirectory: File

    Permalink
  75. def toFile(url: URL): File

    Permalink

    Constructs a File corresponding to url, which must have a scheme of file.

    Constructs a File corresponding to url, which must have a scheme of file. This method properly works around an issue with a simple conversion to URI and then to a File.

  76. def toString(): String

    Permalink
    Definition Classes
    AnyRef → Any
  77. def toURI(f: File): URI

    Permalink

    Converts the given File to a URI.

    Converts the given File to a URI. If the File is relative, the URI is relative, unlike File.toURI

  78. def touch(file: File, setModified: Boolean = true): Unit

    Permalink

    Creates a file at the given location if it doesn't exist.

    Creates a file at the given location if it doesn't exist. If the file already exists and setModified is true, this method sets the last modified time to the current time.

  79. def touch(files: Traversable[File]): Unit

    Permalink

    Each input file in files is created if it doesn't exist.

    Each input file in files is created if it doesn't exist. If a file already exists, the last modified time is set to the current time. It is not guaranteed that all files will have the same last modified time after this call.

  80. def transfer(in: InputStream, out: OutputStream): Unit

    Permalink

    Copies all bytes from the given input stream to the given output stream.

    Copies all bytes from the given input stream to the given output stream. Neither stream is closed.

  81. def transfer(in: InputStream, to: File): Unit

    Permalink

    Copies all bytes from the given input stream to the given File.

    Copies all bytes from the given input stream to the given File. The input stream is not closed by this method.

  82. def transfer(in: File, out: OutputStream): Unit

    Permalink

    Copies the contents of the input file in to the out stream.

    Copies the contents of the input file in to the out stream. The output stream is not closed by this method.

  83. def transfer(in: File, out: File): Unit

    Permalink

    Copies the contents of in to out.

  84. def transferAndClose(in: InputStream, out: OutputStream): Unit

    Permalink

    Copies all bytes from the given input stream to the given output stream.

    Copies all bytes from the given input stream to the given output stream. The input stream is closed after the method completes.

  85. def unzip(from: File, toDirectory: File, filter: NameFilter = AllPassFilter, preserveLastModified: Boolean = true): Set[File]

    Permalink
  86. def unzipStream(from: InputStream, toDirectory: File, filter: NameFilter = AllPassFilter, preserveLastModified: Boolean = true): Set[File]

    Permalink
  87. def unzipURL(from: URL, toDirectory: File, filter: NameFilter = AllPassFilter, preserveLastModified: Boolean = true): Set[File]

    Permalink
  88. def urlAsFile(url: URL): Option[File]

    Permalink
  89. val utf8: Charset

    Permalink
  90. final def wait(): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  91. final def wait(arg0: Long, arg1: Int): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  92. final def wait(arg0: Long): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  93. def withTemporaryDirectory[T](action: (File) ⇒ T): T

    Permalink

    Creates a temporary directory and provides its location to the given function.

    Creates a temporary directory and provides its location to the given function. The directory is deleted after the function returns.

  94. def withTemporaryFile[T](prefix: String, postfix: String)(action: (File) ⇒ T): T

    Permalink

    Creates a file in the default temporary directory, calls action with the file, deletes the file, and returns the result of calling action.

    Creates a file in the default temporary directory, calls action with the file, deletes the file, and returns the result of calling action. The name of the file will begin with prefix, which must be at least three characters long, and end with postfix, which has no minimum length.

  95. def write(properties: Properties, label: String, to: File): Unit

    Permalink

    Writes properties to the File to, using label as the comment on the first line.

    Writes properties to the File to, using label as the comment on the first line. If any parent directories of to do not exist, they are first created.

  96. def write(file: File, bytes: Array[Byte]): Unit

    Permalink

    Writes bytes to file, overwriting any existing content.

    Writes bytes to file, overwriting any existing content. If any parent directories do not exist, they are first created.

  97. def write(file: File, content: String, charset: Charset = defaultCharset, append: Boolean = false): Unit

    Permalink

    Writes content to file using charset or UTF-8 if charset is not explicitly specified.

    Writes content to file using charset or UTF-8 if charset is not explicitly specified. If append is false, the existing contents of file are overwritten. If append is true, the new content is appended to the existing contents. If file or any parent directories do not exist, they are created.

  98. def writeLines(writer: PrintWriter, lines: Seq[String]): Unit

    Permalink

    Writes lines to writer using writer's println method.

  99. def writeLines(file: File, lines: Seq[String], charset: Charset = defaultCharset, append: Boolean = false): Unit

    Permalink

    Writes lines to file using the given charset or UTF-8 if charset is not explicitly specified.

    Writes lines to file using the given charset or UTF-8 if charset is not explicitly specified. If append is false, the contents of the file are overwritten. If append is true, the lines are appended to the file. A newline is written after each line and NOT before the first line. If any parent directories of file do not exist, they are first created.

  100. def writer[T](file: File, content: String, charset: Charset, append: Boolean = false)(f: (BufferedWriter) ⇒ T): T

    Permalink
  101. def zip(sources: Traversable[(File, String)], outputZip: File): Unit

    Permalink

    Creates a zip file.

    Creates a zip file.

    sources

    The files to include in the zip file paired with the entry name in the zip. Only the pairs explicitly listed are included.

    outputZip

    The file to write the zip to.

Inherited from AnyRef

Inherited from Any

Ungrouped