Simplifile provides synchronous operations for working with files and directories that work for all non-browser targets (Erlang, Node, Deno, and Bun).
simplifile
?Simplifile makes a simple tradeoff: it confines itself to a subset of purely synchronous file/directory utilities so that it can have one API for all targets. Erlang and JavaScript have fundamentally different concurrency models, so bindings to async code will simply be different for different targets.
You should use simplifile if
If you think you need a different solutions, these projects may be helpful: File streams (erlang target)
Please consult the changelog, but basically:
The deprecated is_file
, is_directory
functions have been removed.
The verify_is_file
, verify_is_directory
, and verify_is_symlink
have had their verify_ prefixes removed (now is_file
, is_directory
, is_symlink
respectively).
The Unknown
variant of FileError
now has an inner String
.
let filepath = "./test/hello.txt"
let assert Ok(_) = "Hello, World" |> write(to: filepath)
let assert Ok(_) = "Goodbye, Mars" |> append(to: filepath)
let assert Ok("Hello, WorldGoodbye, Mars") = read(from: filepath)
let assert Ok(_) = delete(filepath)
let assert Error(_) = read(from: filepath)
If available on Hex this package can be added to your Gleam project:
gleam add simplifile
and its documentation can be found at https://hexdocs.pm/simplifile.
Contributions are welcome! The best way to start for medium to large features is by opening an issue with the feature suggestion, otherwise feel free to just make a PR! Code contributions should include tests. Please make sure tests pass on all supported targets (you can run the test.sh file in the top level of the project to run tests for each target). Please also include an entry in the Unreleased section of the changelog.