fs 1.3.1 Unreleased

  • Fix missed test with UTF-8 characters, which now passes on a strict Latin-1 locale.

  • Fix undefined behavior when casting -1 to size_t.

fs 1.3.0 2019-05-02

Breaking changes

  • dir_ls(), dir_map(), dir_walk(), dir_info() and dir_tree() gain a recurse argument, which can be either a TRUE or FALSE (as was supported previously) or a number of levels to recurse. The previous argument recursive has been deprecated.

New features

Minor improvements and fixes

  • dir_create() now throws a more accurate error message when you try to create a directory in a non-writeable location (#196).

  • fs_path objects now always show 10 characters by default when printed in tibbles (#191).

  • path_file(), path_dir() and path_ext() now return normal character vectors rather than tidy paths (#194).

  • path_package() now works with paths in development packages automatically (#175).

  • tests now pass successfully when run in strict Latin-1 locale

fs 1.2.7 2019-03-19

New features

  • file_size() function added as a helper for file_info("file")$size (#171)

  • is_file_empty() function added to test for empty files` (#171)

  • dir_tree() function added to print a command line representation of a directory tree, analogous to the unix tree program (#82).

  • Add a comparison vignette to quickly compare base R, fs and shell alternatives (@xvrdm, #168).

Minor improvements and fixes

fs 1.2.6 2018-08-23

fs 1.2.5 2018-07-30

  • Patch release to fix tests which left files in the R session directory

fs 1.2.4 2018-07-26

New Features

Minor improvements and fixes

  • path_tidy() now always includes a trailing slash for the windows root directory, e.g. C:/ (#124).

  • path_ext(), path_ext_set() and path_ext_remove() now handle paths with non-ASCII characters (#120).

  • fs_path objects now print (without colors) even if the user does not have permission to stat them (#121).

  • compatibility with upcoming gcc 8 based Windows toolchain (#119)

fs 1.2.3 2018-06-08



fs 1.2.2 2018-03-21


  • fs no longer needs a C++11 compiler, it now works with compilers which support only C++03 (#90).


  • fs_path fs_bytes and fs_perm objects now use methods::setOldClass() so that S4 dispatch to their base classes works as intended (#91).

  • Fix allocation bug in path_exists() using delete [] when we should have used free().

fs 1.2.1 2018-03-20


  • path_abs() gains a start argument, to specify where the absolute path should be calculated from (#87).


  • path_ext() now returns character() if given 0 length inputs (#89)

  • Fix for a memory issue reported by ASAN and valgrind.

fs 1.2.0 2018-03-13

Breaking changes

  • path_expand() and path_home() now use USERPROFILE or HOMEDRIVE/HOMEPATH as the user home directory on Windows. This differs from the definition used in path.expand() but is consistent with definitions from other programming environments such as python and rust. This is also more compatible with external tools such as git and ssh, both of which put user-level files in USERPROFILE by default. To mimic R’s (and previous) behavior there are functions path_expand_r() and path_home_r().

  • Handling missing values are more consistent. In general is_* functions always return FALSE for missing values, path_* functions always propagate NA values (NA inputs become NA outputs) and dir_* file_* and link_* functions error with NA inputs.

  • fs functions now preserve tildes in their outputs. Previously paths were always returned with tildes expanded. Users can use path_expand() to expand tildes if desired.


  • Fix crash when a files user or group id did not exist in the respective database (#84, #58)
  • Fix home expansion on systems without readline (#60).
  • Fix propagation of NA values in path_norm() (#63).


fs 1.1.0 2018-01-26

Breaking changes

  • Tidy paths no longer expand ~.

  • Filesystem modification functions now error for NA inputs. (#48)

  • path() now returns 0 length output if given any 0 length inputs (#54).

New features

  • Removed the autotool system dependency on non-windows systems.


  • dir_delete() now correctly expands paths (#47).

  • dir_delete() now correctly deletes hidden files and directories (#46).

  • link_path() now checks for an error before trying to make a string, avoiding a crash (#43).

  • libuv return paths now marked as UTF-8 strings in C code, fixing encoding issues on windows. (#42)

  • dir_copy() now copies the directory inside the target if the target is a directory (#51).

  • dir_copy() now works correctly with absolute paths and no longer removes files when overwrite = TRUE.

fs 1.0.0 2018-01-19

  • Removed the libbsd system dependency on linux
  • Initial release
  • Added a NEWS.md file to track changes to the package.