https://github.com/bcpeinhardt/simplifile

Simple file operations for Gleam that work on all targets (Erlang/Node/Deno)
https://github.com/bcpeinhardt/simplifile

Last synced: 7 days ago
JSON representation

Simple file operations for Gleam that work on all targets (Erlang/Node/Deno)

• Host: GitHub
• URL: https://github.com/bcpeinhardt/simplifile
• Owner: bcpeinhardt
• Created: 2023-05-31T05:59:36.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-05-14T23:48:15.000Z (6 months ago)
• Last Synced: 2024-05-15T18:36:37.276Z (6 months ago)
• Language: Gleam
• Size: 115 KB
• Stars: 51
• Watchers: 3
• Forks: 9
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md

Awesome Lists containing this project

• awesome-gleam - simplifile - [📚](https://hexdocs.pm/simplifile/) - Basic file operations that work on all targets (Packages / File System)

README

        
# simplifile

[![Package Version](https://img.shields.io/hexpm/v/simplifile)](https://hex.pm/packages/simplifile)

[![Hex Docs](https://img.shields.io/badge/hex-docs-ffaff3)](https://hexdocs.pm/simplifile/)

Simplifile provides synchronous operations for working with files and directories that work for all 

non-browser targets (Erlang, Node, Deno, and Bun). 

## When should I use `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 

1. The same code running on JS and Erlang targets is important

2. Sync file operations will not be a major performance bottleneck (dev tooling, configuration, scripting, etc.)

3. You just wanna do some basic file operations and get on with life

If you think you need a different solutions, these projects may be helpful:

[File streams (erlang target)](https://github.com/richard-viney/file_streams)

## Upgrading to 2.0

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`. 

## Example

```gleam

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)

```

## Installation

If available on Hex this package can be added to your Gleam project:

```sh

gleam add simplifile

```

and its documentation can be found at .

## Contributing

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.