Identify the file path where a target will be stored.
Identify the file path where a target will be stored after the target finishes running in the pipeline.
tar_path( name = NULL, default = NA_character_, create_dir = FALSE, store = targets::tar_config_get("store") )
name |
Symbol, name of a target.
If |
default |
Character, value to return if |
create_dir |
Logical of length 1,
whether to create |
store |
Character of length 1, path to the data store if |
Character, file path of the return value of the target.
If not called from inside a running target,
tar_path(name = your_target)
just returns
_targets/objects/your_target
, the file path where your_target
will be saved unless format
is equal to "file"
or any of the
supported cloud-based storage formats.
For non-cloud storage formats, if you call tar_path()
with no arguments while target x
is running, the name
argument defaults to the name of the running target,
so tar_path()
returns _targets/objects/x
.
For cloud-backed formats, tar_path()
returns the
path to the staging file in _targets/scratch/
.
That way, even if you select a cloud format
(e.g. tar_target(..., format = "aws_parquet", storage = "none")
)
then you can still manually write to tar_path(create_dir = TRUE)
and the targets
package will automatically hash it and
upload it to the AWS S3 bucket. This does not apply to formats
"file"
or "aws_file"
, where you would never need storage = "none"
anyway.
Other utilities:
tar_active()
,
tar_call()
,
tar_cancel()
,
tar_definition()
,
tar_envir()
,
tar_group()
,
tar_name()
,
tar_seed()
,
tar_store()
tar_path() tar_path(your_target) if (identical(Sys.getenv("TAR_EXAMPLES"), "true")) { tar_dir({ # tar_dir() runs code from a temporary directory. tar_script(tar_target(returns_path, tar_path()), ask = FALSE) tar_make() tar_read(returns_path) }) }
Please choose more modern alternatives, such as Google Chrome or Mozilla Firefox.