Added a function shrink_images() to shrink images to
a maximum width using the magick package (thanks, @apreshill,
rstudio/blogdown#614).
Added a function tinify_dir() as a wrapper of
tinify() to compress images under a directory.
file_ext() supports more file extensions now, such
as .c++, .FB2K-COMPONENT, and so on (thanks,
@tentacles-from-outer-space,
#68).
Fixed the issue that xfun::base_pkgs() could hang R
(thanks, @mmaechler, #66).
The ... argument in dir_create() was
not passed to dir.create().
github_releases(use_jsonlite = FALSE) supports R
versions below 4.1.0 now.
session_info() silently drops empty package names
now (thanks, @phargarten2, #65).
Added a new function is_blank() (previously existed
in knitr) to test if all elements of a character vector
are blank (white spaces or empty strings).
Added a new argument error = TRUE to
existing_files().
github_releases() can fetch all releases (tags) of a
Github repo now.
Added an argument .error to
download_file() so that users can customize the error
message when the download fails.
Added functions rest_api_raw() and
rest_api() to get data from a REST API; also added the
function github_api() to get data from the Github API based
on rest_api_raw().
Added a wrapper function system3() based on
system2() to mark the character output of
system2() as UTF-8 if appropriate.
Added a function existing_files() to return file
paths that exist (a shorthand of
x[file.exists(x)]).
Added a function read_all() to read multiple files
and concatenate the content into a character vector.
url_accessible() uses curlGetHeaders()
by default (instead of download_file()) to test if a URL is
accessible when the curl package is not
available.
When options(xfun.rev_check.compare = FALSE),
rev_check() will run R CMD check on reverse
dependencies against a source package but not the CRAN version of this
package. By default, this option is TRUE, meaning that
R CMD check will run against both versions of the
package.
Added a new function url_accessible() to test if a
URL can be downloaded.
Added a new function try_error() to try an
expression and see if it throws an error.
Exported and documented the function
xfun::base_pkgs() (to return base R package
names).
Changed the default value of the status_only
argument of compare_Rcheck() from FALSE to
TRUE.
Added new functions crandalf_check() and
crandalf_results() for checking (especially large numbers
of) reverse dependencies of packages via crandalf.
Added new functions append_utf8() and
append_unique() based on read_utf8() and
write_utf8() to append content to files or
connections.
The windows_only argument of
native_encode() has been removed. Now
native_encode() only tries the conversion to native
encoding on platforms where l10n_info()[['UTF-8']] does not
return TRUE.
Added a solaris argument to
upload_win_builder().
Fixed a bug in broken_packages() (thanks, @PythonCoderUnicorn,
rstudio/rmarkdown#1990).
Added a files argument to optipng() so
that users can specify the list of PNG files instead of running
optipng on a whole directory.
Exported the internal function broken_packages() to
reinstall broken R packages.
Fixed the bug in proj_root() #54 (thanks, @clarkliming).
Added a tinify() function to compress PNG/JPEG
images via the Tinify
API.
Added a news2md() function to convert package news
to the Markdown format. This is mainly for converting the plain-text
NEWS file and the NEWS.Rd file to
NEWS.md.
Added a format_bytes() function to format numbers of
bytes using a specified unit, e.g., 1024 can be formatted
as 1 Kb.
When using pkg_load2() in an renv
project, it will use renv::install() to install missing
packages by default to take advantage of renv’s caching
feature (thanks, @chunyunma @cderv, #52).
upload_win_builder() no longer requires the system
command curl to be available; if curl is not
available, the R package curl will be used instead,
which means this R package must be installed. In addition to uploading
to the ftp server of win-builder, it’s also possible to
upload to https://win-builder.r-project.org/upload.aspx: call
upload_win_builder(..., server = 'https'). This change was
made so that it would be possible to continue to upload to win-builder
in case it should stop supporting ftp (CRAN has discouraged
package authors from using ftp://).
\begin{} and \end{} do not match (thanks,
@oliviergimenez, #51).The argument src was renamed to pkg in
install_dir().
The argument file of
upload_win_builder() defaults to pkg_build()
now, i.e., by default, it will build a source package and upload it, so
you do not need to build the package separately.
relative_path() is vectorized now.
Added a new function retry() to retry calling a
function for a number of times in case of errors.
Added a new function sort_file(), which is a
shorthand for process_file(fun = sort) to sort the lines in
a text file.
FUN was renamed to fun in
process_file().download_file(), the timeout option
in options() is set to 3600 seconds when it takes the
default value of 60 seconds, which may not be enough for downloading
large files (thanks, @matthewgson, yihui/tinytex#286).Added a new function pkg_available() to test if a
package with a minimal version is available (thanks, @cderv, #45).
Added a new function set_envvar() to set environment
variables and return their old values, so they could be restored
later.
Added a new function exit_call() to call a function
when a parent function exits.
Exported the internal function read_bin().
Added an argument verbose to
bg_process().
Rscript_call() gains an options
argument to pass command-line options to Rscript (thanks,
@cderv, #48).
Added a function msg_cat() to generate a message
with cat(). See the help page ?xfun::msg_cat
for more information.
Added a function mark_dirs() to mark directories
with a trailing slash in a vector of paths to differentiate them from
normal filenames (#44).
xfun::proc_kill() failed to work on *nix.
xfun::del_empty_dir() failed to delete empty
dirs.
xfun::file_string() preserves emptiness (thanks,
@MichaelChirico, #38).
xfun::raw_string() preserves the class(es) of the
input now (thanks, @MichaelChirico, #40).
dir_create().Added functions bg_process() to run a command in a
background process, and proc_kill() to kill a
process.
Added a function del_empty_dir() to delete a
directory if it is empty.
Added functions is_abs_path() and
is_rel_path() to check if paths are absolute or
relative.
Added a function is_sub_path() to test if a path is
under a directory.
Added a function is_web_path() to test if a path is
a web path that starts with http:// or
https:// or ftp:// or
ftps://.
Documented and exported the previously internal functions
dir_exists() and file_exists() (thanks, @cderv, #36).
Added a function dir_create() to create a directory
recursively by default when it does not exist.
Added an argument fail to
Rscript_call() to allow users to customize the error
message when an error occurred in calling the function in a new R
session.
file_ext(), sans_ext(), and
with_ext() no longer use tools::file_ext() or
tools::file_path_sans_ext(), but provide a slightly
different implementation. They treat tar.(gz|bz2|xz) and
nb.html as file extensions, and also allow extensions to
contain a trailing ~ or #.Added a function grep_sub() to perform replacement
with gsub() on elements matched from
grep().
Added a function github_releases() to obtain the
tags from the Github releases of a repo.
Added a function bump_version() to increase the last
digit of version numbers by one.
Moved a function process_file() from the
blogdown package to this package, and documented
it.
Added a function valid_syntax() to check if an R
code fragment is syntactically valid. This function was moved from the
highr package.
Added a function url_filename() to extract filenames
from URLs. This function is used by download_file() to
determine the default output filename.
Added a function do_once() to perform a task once in
an R session.
Added a function proj_root() to find the root
directory of a project. Currently it only supports R package projects
and RStudio projects by default.
Added a function relative_path() to calculate the
relative path of a path relative to a directory.
Added a function from_root(), which is similar to
here::here() but returns a relative path instead of an
absolute path.
Added a function magic_path() that, given an
incomplete input path, tries to find the actual path recursively under
subdirectories of a root directory. For example, users may only provide
a base filename, and magic_path() will look for this file
under subdirectories and return the actual path if it is found.
download_file() tries the download method
winnet first (previously it was libcurl) on
Windows (thanks, @cderv, #33).Supports
xfun::pkg_attach(packages, install = "pak"), i.e., use
pak::pkg_install() to install a package when it is not
installed (thanks, @GitHunter0, #32).
Added a new function xfun::split_source() to split
lines of R source code into minimal complete expressions. This function
was moved from the highr package.
base64_decode() to decode data
from the base64 encoding (thanks, @wush978, #31).Added a new function tree(), which is based on
str() in base R, but changes the output of
str() into a tree diagram to make it easier to understand
nested data structures.
Added a new function base64_encode() to encode data
into the base64 encoding (thanks, @wush978, #27).
Added a new function base64_uri() to generate the
Data URI (or Data URL) for a file.
<!-- --> are
not longer recognized as code blocks but prose (thanks, @jarauh, #25).cache_rds() function can invalidate the cache
automatically when the code passed to its expr argument has
changed. Two new arguments, hash and clean
were added to this function to make it more useful and powerful. See the
help page ?xfun::cache_rds() for more information.Added a new function cache_rds() to cache an R
expression to a *.rds file.
Added a new function Rscript_call() to call a
function (with arguments) in a new R session via the command
Rscript.
The recheck argument of rev_check() can
take a vector of package names, and only these packages will be checked.
See ?xfun::rev_check for more details.
split_lines().read_utf8() will read the file with
options(encoding = 'native.enc') and ignore user’s setting
such as options(encoding = 'UTF-8') (#21).as_strict_list() to convert an
existing object to a strict list without wrapping it in another list if
the object already is of type list (in contrast to how
strict_list() behaves) (thanks, @salim-b, #20).rename_seq() to rename files to add an
incremental numeric prefix to the filenames, e.g., rename
a.txt, b.txt, c.txt to
1-a.txt, 2-b.txt, 3-c.txt.xfun::write_utf8(NULL) is equivalent to
xfun::write_utf8(character(0)) now (thanks, @schloerke,
yihui/knitr#1714).loadable() is quiet with R 3.6.0
(https://stat.ethz.ch/pipermail/r-devel/2019-May/077774.html).... argument to same_path() to
pass additional arguments to normalize_path().warn argument in prose_index() failed
to suppress warnings.Added functions upload_ftp() and
upload_win_builder() to upload files to FTP
servers.
Added a function stringsAsStrings() (see its help
page for details).
Added an argument warn to prose_index()
to suppress the warning when code fences are not balanced.
prose_index() recognizes double
backticks as code fences (thanks, @shrektan, #14 #15).Added functions embed_file(),
embed_dir(), and embed_files() to embed files
in an HTML output file (e.g., from R Markdown), so that the files can be
directly downloaded from the web browser. One use case is to call one of
these functions in an R code chunk of an Rmd document to embed the Rmd
source document or data files in the HTML output, so readers can
download them.
Added a new argument message to
pkg_attach(), so you can suppress package startup messages
via xfun::pkg_attach(..., message = FALSE) or set the
global option options(xfun.pkg_attach.message = FALSE)
(thanks, @wch,
yihui/knitr#1583).
The argument rw_error was moved from
gsub_dir() to gsub_file()
(gsub_dir(rw_error = ...) will still work).
is_ascii() now returns NA for
NA_character_ (thanks, @shrektan, #8 #9).
Added a new functions download_file() to try various
methods to download a file.
Added a new function is_ascii() to test if a
character vector only consists of ASCII characters.
Added a new function numbers_to_words() to convert
numbers to English words (thanks, @daijiang, #3).
Added a new_session argument to
loadable().
Added new functions gsub_file(),
gsub_files(), gsub_dir(), and
gsub_ext() to replace strings in files.
Added new functions Rscript and Rcmd as
wrappers of system2('Rscript') and
system2('R', 'CMD'), respectively.
Added a new function install_dir() to install a
source package from a directory.
Added a new function file_string() to read a text
file (encoded in UTF-8) and return its content a single character string
(lines concatenated by \n).
Added a new function raw_string() to print a
character vector in its “raw” form using
cat(..., sep = '\n') instead of print(),
because the latter may introduce [1], “extra” double
quotes, and escape sequences, which are not very
human-readable.
Added a new function session_info() as an
alternative to sessionInfo().
Added a new function rev_check() to run
R CMD check on the reverse dependencies of a package, and a
corresponding helper function compare_Rcheck() for showing
the differences in logs with the CRAN version and the current version of
the package, respectively.
Added new functions for dealing with Markdown text:
prose_index() returns the line indices of text that is
prose (not code blocks), and protect_math() protects math
expressions in Markdown in backticks.
Added an error argument to read_utf8()
to signal an error if the file is not encoded in UTF-8.
attr() as an abbreviation of
base::attr(exact = TRUE).
file_ext(), sans_ext(), and
with_ext() to manipulate extensions in filenames.
in_dir() to evaluate an R expression in a
directory.
isFALSE() as an abbreviation of
identical(x, FALSE).
is_windows(), is_macos(),
is_linux(), and is_unix() to test operating
systems.
native_encode() to try to encode a character vector
in the native encoding.
normalize_path() as an abbreviation of
normalizePath(winslash = '/', mustWork = FALSE).
optipng() to run the command optipng to
optimize all PNG files under a directory.
parse_only() parses R code without keeping the
source references.
pkg_attach() and pkg_load() to attach
and load a vector of packages, respectively (and optionally, install the
missing packages).
read_utf8() and write_utf8() to read
and write UTF-8 files, respectively.
same_path() to test if two paths are the
same.
strict_list() is a version of list()
that disables partial matching of the $ operator.
tojson() is a simple JSON serializer.
try_silent() is an abbreviation of
try(silent = TRUE).