@spec from_io(device :: IO.device()) :: t()

Create a file from an IO.device()

Example

iex> path = "README.md"
...> {:ok, device} = File.open(path)
...> Ash.Type.File.from_io(device)
%Ash.Type.File{source: device, implementation: Ash.Type.File.IO}

@spec from_path(path :: Path.t()) :: t()

Create a file from a path.

Example

iex> path = "README.md"
...> Ash.Type.File.from_path(path)
%Ash.Type.File{source: "README.md", implementation: Ash.Type.File.Path}

@spec open(file :: t(), [{:modes, [File.mode()]}]) ::
  {:ok, IO.device()} | {:error, Ash.Type.File.Implementation.error()}

Open the file with the given modes.

This function will delegate to the open/2 function on the implementation.

For details on the modes argument, see the File.open/2 documentation.

Example

iex> path = "README.md"
...> file = Ash.Type.File.from_path(path)
...> Ash.Type.File.open(file, [:read])
...> # => {:ok, #PID<0.109.0>}

@spec path(file :: t()) ::
  {:ok, Path.t()}
  | {:error, :not_supported | Ash.Type.File.Implementation.error()}

Returns the path to the file.

Not every implementation will support this operation. If the implementation does not support this operation, then {:error, :not_supported} will be returned. In this case, use the open/2 function to access the file.

Example

iex> path = "README.md"
...> file = Ash.Type.File.from_path(path)
...> Ash.Type.File.path(file)
{:ok, "README.md"}