NEWS
templateflow 0.1.0
Breaking changes
- Cache directory now uses platform-appropriate location via
rappdirs:
macOS ~/Library/Caches/templateflow, Windows AppData/Local.
Set TEMPLATEFLOW_HOME to override.
New features
- Custom error conditions (
templateflow_error, templateflow_network_error,
templateflow_not_found, templateflow_invalid_filter, templateflow_cache_error)
for structured error handling with tryCatch().
- Migrated HTTP backend from
httr to httr2 with automatic retry and
exponential backoff on transient failures.
- Atomic file writes prevent partial/corrupt downloads.
- Config-driven layout parsing from
config.json instead of hardcoded entities.
tf_ls() gains as_df parameter to return results as a data frame.
tf_get() gains read parameter to return neuroimaging objects directly
using RNifti, oro.nifti, or gifti when available.
tf_prefetch() batch-downloads all zero-byte skeleton stubs.
tf_cache_stats(), tf_cache_scan(), tf_cache_refresh() cache utilities.
- Fuzzy entity name matching with suggestions on typos.
- Full CLI rewrite with 9 subcommands:
config, ls, get, wipe, update,
meta, cite, refresh, doctor.
- DataLad backend support via
TEMPLATEFLOW_USE_DATALAD environment variable.
- Neuroimaging file reader dispatch (
tf_read_file()) for NIfTI, GIFTI, JSON, TSV.
Bug fixes
print.TemplateFlowClient now correctly returns invisible(x).
- Roxygen annotation for
print.TemplateFlowClient moved to proper location.
templateflow 0.0.1
- Initial release with S3-backed template querying and caching.