CHANGELOG.md

Changelog

Unreleased

--

v2.7.0 - 5 August 2026

• Add exists function for checking if a file, directory, or symlink exists at all at a given path.

v2.6.0 - 18 July 2026

• Add touch function, which creates a file if it doesn't exist and updates its access and modification times to now if it does.

v2.5.0 - 27 June 2026

• Add resolve function, which resolves relative paths to absolute paths based on the current working directory.

v2.4.0 - 7 March 2026

• Use raw option for write and append operations on Erlang
• Add delete_file function for specifically deleting a file (uses raw on Erlang as well)

v2.3.2 - 26 December 2025

• Fix bug where unknown errors were not properly converted to the Unknown variant in Erlang ffi.

v2.3.1 - 6 November 2025

• Fix bug with error string typo for Enotdir on JS.

v2.3.0 - 24 June 2025

• Add create_link function for hard-linking
• Fix bug where one could silently write non-byte aligned data to file, now throws explicit error.

v2.2.1 - 25 March 2025

• Remove use of deprecated field in JavaScript ffi

v2.2.0 - 23 September 2024

• Add copy function which can copy a file or a directory.
• Deprecate rename_file and rename_directory in favor of rename which does both.
• Refactor copy_directory to make fewer file system calls.
• Add some helpful docs for creating symlinks.

v2.1.0 - 28 August 2024

• Add FileInfo and file_info_type to get the file type from a FileInfo without checking the file system again
• Add file_info_permissions and file_info_permissions_octal to get the currently set permissions of a file or directory.
• Improve performance of get_files
• Add link_info function to get FileInfo values without following symlinks

v2.0.1 - 27 June 2024

• Internal refactoring and some added tests

v2.0.0 - 1 June 2024

• verify_is_directory, verify_is_file, verify_is_symlink become is_directory, is_file, is_symlink respectively. Deprecated is_file and is_directory removed.
• Fix mapping of FileInfo attr names in JS
• Add underlying String as context to Unknown error
• improve performance of get_files

v1.7.0 - 5 April 2024

• add create_symlink function to create a symbolic link
• add verify_is_symlink function to check if a file is a symbolic link
• add describe_error function to get human-readable descriptions out of errors

v1.6.1 - 28 March 2024

• fix bug I introduced to clear_directory_all which accidentally made absolute directories relative.

v1.6.0 - 26 March 2024

• add the clear_directory function to make it easy to delete the contents of a directory while leaving the top level directory in place.
• add the filepath dependency to clean up some code.

v1.5.1 - 22 March 2024

• use unicode module to convert filenames to utf8 on erlang

v1.5.0 - 29 February 2024

• add file_info function.

v1.4.2 - 18 February 2024

• Update msg in deprecated tag for is_directory to correctly point to verify_is_directory

v1.4.1 - 1 February 2024

• Update gleam_stdlib dependency to "~> 0.34 or ~> 1.0" in preparation for 1.0.

v1.3.1 - 27 January 2024

• Update msg in deprecated tag for is_file to correctly point to verify_is_file.

v1.3.0 - 26 January 2024

• Deprecate is_file and is_directory in favor of verify_is_file and verify_is_directory, which error on lack of permissions rather than silently returning false.

v1.2.0 - 11 January 2024

• Add the current_directory function

v1.1.2 - 9 January 2024

• Update stdlib dep to 0.33

v1.1.1 - 5 January 2024

• Fix bug with double "/" from get_files

v1.1.0 - 25 December 2023

• Added set_permissions and set_permissions_octal functions for setting permissions on a file

v1.0.0 - 16 November 2023

• No changes, just going v1 so somver starts working

v0.4.0 - 15 November 2023

• Renamed list_contents to read_directory
• Added get_files

v0.3.0 - 12 November 2023

• Switched order of parameters for write, append, write_bits, and append_bits functions. They now take the filename first.

v0.2.1 - 11 November 2023

• Updated ffi js to use BitArray

v0.2.0 - 6 November 2023

• Updated for Gleam v0.32.

v0.1.14 - 18 September 2023

• added delete_all which takes a list of paths to call delete on

v0.1.13 - 17 September 2023

• copy and rename directory functions perform a create_directory_all

v0.1.12 - 17 September 2023

• Add copy_directory and rename_directory functions

v0.1.11 - 11 September 2023

• Add copy_file and rename_file functions

v0.1.10 - 9 August 2023

• Change creat_dir_all to create_directory_all

v0.1.9 - 8 August 2023

• Add functions create_dir_all, create_file, and is_file.
• Remove function delete_directory. The delete function now deletes files and recursively deletes directories.
• make_directory is now called create_directory to be consistent with create_file.

v0.1.8 - 31 July 2023

• Small refactor to remove js functions writeFile and appendFile

v0.1.7 - 31 July 2023

• Fix bug where read was incorrectly returning non utf8 content for string on javascript target. Now returns correct NonUtf8 error

v0.1.6 - 19 July 2023

• Add make_directory and delete_directory functions for working with directories.

v0.1.5 - 12 July 2023

• Update to use new ffi syntax

v0.1.4 - 21 June 2023

• Add is_directory and list_contents functions for working with directories.

v0.1.3 - 21 June 2023

• Add ffi to remove gleam_erlang dependency

v0.1.2 - 21 June 2023

• Remove unnecessary dependency on gleam_javascript. Whoops.

v0.1.1 - 31 May 2023

• Refactored to match gleam idiom of ffi "do" functions and single signature.
• Added documentation about the utf8 issue with the read function.