4 curated breaking changes across major versions of fs. Use this as a migration checklist before bumping dependencies.
`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.
`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.
Get this data programmatically \u2014 free, no authentication.
curl https://depscope.dev/api/breaking/cran/fsfs 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.