| NEWS | R Documentation |
Added set.this.path(), an alias for
inside.source().
Added Sys.putenv(), an alternate method for setting
environment variables.
system.file(package = "this.path", "extdata", "main.R")
is the script used to determine the translations of
"Untitled" and "R Editor" between different
languages and different C runtimes (for use in ‘Rgui’
for Windows). This script no longer relies on ‘Python’
nor external R packages, so anyone can run it.
shFILE() now parses the command line arguments in the exact same
manner as R itself, more accurately selecting argument FILE.
A relative path returned by as.rel.path() / /
relpath() will always begin with "./" or
"../".
C code no longer uses lang1() through lang6() with
multiple unprotected arguments, uses allocList() and
SETCAR() instead.
C code no longer uses sprintf(), uses snprintf() instead.
this.path does a much better job of determining if the R session is from ‘VSCode’.
this.path does a much better job of determining the path of the executing script from ‘Rgui’.
this.path() now works inside knitr::knit(), fixing
issue #4 at BugReports URL.
By extension, withArgs(knitr::knit()) now also works.
this.path() now accepts arguments original and
for.msg that return the original argument from source / /
knit / / Rscript or return a character string that can be
used in diagnostic messages / / warnings / / errors. It should be noted
that this.path(for.msg = TRUE) should not be used for
constructing file paths.
shFILE() also accepts argument original that returns the
original FILE argument from Rscript.
Added splitext(), removeext(), ext(), and
ext<-() for manipulating paths with extensions.
Added progArgs(), similar to fileArgs() but better, might
remove fileArgs() later.
Added is.main() for determining if an expression is run in a
top-level code environment.
Added wrap.source() and inside.source() for implementing
this.path() with any source-like function.
Added LINENO() for determining the line number of the executing
expression in the executing script.
Added relpath(), a version of as.rel.path() with
different default argument values.
Added OS.type, a list of TRUE/FALSE values giving
more details about the operating system.
normalized.shFILE(), this.path2(), this.dir2(),
and this.dir3() are defunct and should be replaced with
shFILE(), this.path(default = NULL),
this.dir(default = NULL), and
this.dir(default = getwd()), respectively.
check.path() and check.dir() now use path.join()
instead of file.path().
fileArgs(), progArgs(), from.shell(), and
is.main() no longer force the normalization of the source
/ / knit / / Rscript path, but instead save it as a
promise to be evaluated later if / / when desired.
See issue #3 at BugReports URL.
Fixed this.path() when called in a script from a shell on ubuntu
installed on an android (where .Platform$GUI == "unknown",
normally "unix").
Fixed path.join(), basename2(), and dirname2() not
having a trailing nul-character.
Added path.join(), basename2(), and dirname2() for
constructing and manipulating paths to files. These are based on
file.path(), basename(), and dirname(), but behave
differently with network shares and a few important edge cases.
this.dir(), here(), and this.proj() all use
path.join() and dirname2() instead of file.path()
and dirname(), this may change behaviour for some users and
cases, but should be an improvement overall.
Added tryCatch2(), introducing argument else. similar to
try except in ‘Python’.
Added else. argument to this.path(), this.dir(),
shFILE(), and normalized.shFILE(), a function to act on
the return value.
Added asArgs(), fileArgs(), and withArgs() to more
easily provide arguments to a script.
Added from.shell() to determine if a script was run from a shell.
Added this.proj(...), similar to here::here(...), except
that this.proj() supports multiple projects in one R session
and is independent of working directory.
this.path::here() no longer uses dirname() on a UNC path.
this.path() and others now work in VSCode.
when source-ing a file URL,
source("file:///path/to/file"), this.path() no longer
attempts to re-open a connection.
All previously defunct functions were removed entirely.
this.path(), this.dir(), shFILE(), and
normalized.shFILE() were given a new argument default
that will be evaluated and returned if there is no executing script or
command line argument FILE was not found.
this.path2(), this.dir2(), and this.dir3() are
deprecated and should be replaced with
this.path(default = NULL), this.dir(default = NULL), and
this.dir(default = getwd()), respectively.
normalized.shFILE() no longer sets attribute
"this.path.from.shell", that is now handled by
this.path().