How to read a directory?

//> using toolkit latest

//> using dep com.lihaoyi::os-lib:0.9.1

lazy val example = project.in(file("."))
  .settings(
    scalaVersion := "3.3.4",
    libraryDependencies += "org.scala-lang" %% "toolkit" % "0.1.7"
  )

libraryDependencies += "com.lihaoyi" %% "os-lib" % "0.9.1"

object example extends ScalaModule {
  def scalaVersion = "3.3.4"
  def ivyDeps =
    Agg(
      ivy"org.scala-lang::toolkit:0.1.7"
    )
}

ivy"com.lihaoyi::os-lib:0.9.1"

Paths

A fundamental data type in OS-Lib is os.Path, representing a path on the filesystem. An os.Path is always an absolute path.

OS-Lib also provides os.RelPath (relative paths) and os.SubPath (a relative path which cannot ascend to parent directories).

Typical starting points for making paths are os.pwd (the current working directory), os.home (the current user’s home directory), os.root (the root of the filesystem), or os.temp.dir() (a new temporary directory).

Paths have a / method for adding path segments. For example:

val etc: os.Path = os.root / "etc"

Reading a directory

os.list returns the contents of a directory:

val entries: Seq[os.Path] = os.list(os.root / "etc")

Or if we only want subdirectories:

val dirs: Seq[os.Path] = os.list(os.root / "etc").filter(os.isDir)

To recursively descend an entire subtree, change os.list to os.walk. To process results on the fly rather than reading them all into memory first, substitute os.walk.stream.