Skip to contents

Changelog

Source: NEWS.md

attachment 1.0.1

Bug fixes

  • att_from_examples() (and therefore att_amend_desc()) no longer chokes on inline R inside roxygen2 markdown tags such as @param x \r helper(“x”)`whenhelper()is a package-local function. Previously,att_from_examples()delegated toroxygen2::parse_file(), which evaluated inline R againstbaseenv()(roxygen2's fallback when no package env is registered) — base R is reachable, but package-local helpers are not, so each affected tag emittedcould not find function “helper”`. Example detection now uses a focused regex over the source instead of the full roxygen2 tokenizer (#135).

attachment 1.0.0

CRAN release: 2026-04-25

Detection — new foundation

  • att_from_rscript() now walks the R syntax tree instead of matching the source text with regexes. Dependency detection no longer produces false positives on :: inside string literals or comments (e.g. xpath following-sibling::td, CSS label::after, sprintf('%s::plot()', ...)) (#120, #132).
  • The AST walker safely handles “empty” call arguments (x[, 1], x[1, ], empty switch alternatives, missing else branches). Earlier development drafts of the walker crashed with argument "el" is missing, with no default on any script containing these patterns, which would have silently degraded every real-world script to the legacy regex fallback.

Detection — new patterns recognised

Detection — robustness

  • att_from_rscript() gains an encoding argument (default getOption("encoding")) so scripts saved in Latin-1 / Windows-1252 are read with the system locale instead of being forced to UTF-8.
  • att_from_rscript() now warns when a file fails to parse as valid R code and the legacy regex-based detector is used as a fallback, so broken scripts are no longer silently degraded.
  • The legacy regex-based fallback detector now accepts underscores in package names (e.g. my_pkg::fn). Previously an underscore truncated the detected name to the portion after the underscore, so a single syntax error upstream could corrupt detection across the whole file.

Vignettes & Rmd / Quarto

  • att_from_rmds() infers the vignette engine from the files actually present: quarto is added when .qmd files are found, rmarkdown when .Rmd files are found, both when the directory mixes the two. Previously rmarkdown was forced in for .qmd-only projects (#131).
  • att_from_rmd() / att_from_rmds(): inside_rmd now defaults to NULL and is auto-detected via knitr::opts_knit$get("out.format"), so users no longer have to think about it (#106).

Maintenance

  • Dropped the fusen development workflow; R/amend_with_config.R, R/create_dependencies_file.R, R/dependencies_file_text.R and their tests are now hand-maintained.
  • Fixed create_renv_for_dev() by removing 'renv' from folder_to_include.
  • Added a manual detection edge-case harness at dev/manual_detection_edge_cases.R covering ~170 scripted cases (true positives, false positives, known limitations) to make future regressions of the detector obvious.

attachment 0.4.5

CRAN release: 2025-03-14

Bug fixes

attachment 0.4.4

CRAN release: 2025-02-08

Patch

attachment 0.4.3

CRAN release: 2025-01-31

New features

  • Add att_from_examples() to get all packages called in examples from R files
  • Add att_from_data() to look for functions called in data loading code
  • att_amend_desc amend package DESCRIPTION file (Suggests) with the list of dependencies extracted from examples in R files.
  • set_remotes_to_desc() takes into account the branch

Patch

  • Adding an example using suggest packages to the dummypackage
  • att_from_rmds() and att_from_rscript doesn’t search in ‘renv’ folder anymore

attachment 0.4.2

CRAN release: 2024-07-01

New features

  • create_renv_for_dev can work even outside of an R packages

attachment 0.4.1

CRAN release: 2024-01-22

Bug fixes

  • Modification of unit tests following {roxygen2} changes. att_amend_desc and att_from_namespace return messages instead of warnings. (@MurielleDelmotte)

attachment 0.4.0

CRAN release: 2023-05-31

Breaking changes

  • When using att_amend_desc() without the default parameters, like pkg_ignore = "x" will now require att_amend_desc(pkg_ignore = "x", update.config = TRUE), otherwise, it will fail. This allows for the use of parameters stored in the config file when running att_amend_desc() directly in the console. Recommendation: Run att_amend_desc(pkg_ignore = "x", update.config = TRUE) if you have to update your config, run att_amend_desc() daily as you’ll want to use what is stored in the config file.

  • create_dependencies_file() gets parameter install_only_if_missing = FALSE by default to complete the installation instructions packages only if missing. (@MurielleDelmotte)

New features

  • att_amend_desc() can run with the last set of parameters stored in a configuration file, without having to call them all each time. See vignettes and documentation of parameters update.config = FALSE, use.config = FALSE and path.c = "dev/config_attachment.yaml". (@dagousket)
  • create_dependencies_file() now takes other sources into account (git, gitlab, github, bioc, local). (@MurielleDelmotte)
  • Use create_dependencies_file(to = NULL) to only get the output as character and do not create a file

Bug fixes

attachment 0.3.1

CRAN release: 2023-01-27

New features

  • find_remotes() now informs when using “r-universe” repositories.

Minor changes

  • a new parameters check_if_suggests_is_installed in att_amend_desc() allow not to check if suggested package is installed. (thanks to @yogat3ch)
  • create_renv_for_prod() don’t look anymore for suggested packages
  • Clean a maximum of temp directories after examples and unit tests

attachment 0.3.0

CRAN release: 2022-09-19

New features

Minor changes

  • Documentation for bookdown and quarto dependencies extraction updated

Bug fixes

  • Allow to use dependencies after att_amend_desc() #52
  • Fix HTML5 issues with update to {roxygen2}

attachment 0.2.5

CRAN release: 2022-05-15

Major changes

Minor changes

  • att_amend_desc() now saves file before processing
  • Newline escape code \n will not interfere with package discovery

attachment 0.2.4

CRAN release: 2021-11-16

Breaking changes

  • (broken in 0.2.3) - att_to_desc_from_is() can now run with must.exist = FALSE to be used to fill DESCRIPTION file during bookdown CI process. CI YAML files must be updated with this parameter.

Major changes

  • Split vignette in two: package development and other dependencies management

Minor changes

  • Allow to clean remotes list before updating with set_remotes_to_desc(clean = TRUE)

attachment 0.2.3

CRAN release: 2021-11-10

Major changes

Minor changes

  • Check for packages names misspelled before filling DESCRIPTION.
  • Allow vector of R files in att_from_rscripts()
  • Move default git branch from master to main

Bug fixes

  • Add NAMESPACE if missing with att_amend_desc(document = TRUE)
  • Add DESCRIPTION with empty skeleton if missing with att_amend_desc()
  • Default to remove NAMESPACE before updating to get rid of corrupted ones in att_from_namespace()
  • Fix detection of multiple render outputs in Rmd YAML with att_from_rmd()

attachment 0.2.1

CRAN release: 2021-01-21

  • Check for older pandoc version in tests

attachment 0.2.0

CRAN release: 2021-01-19

Breaking changes * att_to_description() deprecated in favor of att_amend_desc() to be first in autocompletion list, as this is the most used function of this package. * att_from_rmd() gets parameter inline = TRUE by default to explore calls for packages in inline R code. * att_from_rmd() and att_from_rmds() are not anymore executed in separate R session by default. You must set inside_rmd = TRUE to do so.

Minor * Add find_remotes() to help fill Remotes field in DESCRIPTION * att_to_desc_from_is() add parameter normalize to avoid problem with {desc}. (See https://github.com/r-lib/desc/issues/80)

attachment 0.1.0

CRAN release: 2020-03-15

attachment 0.0.9

CRAN release: 2019-05-05

  • att_from_rmd adds a temporary encoding parameter as knitr::purl will only deal with UTF-8 in the future. Parameter not added in att_from_rmds.
  • att_to_description if {covr} is needed, should be added in parameter extra.suggests
  • att_to_description has a parameter ‘dir.t’ to extract suggests dependencies from test directory Available by default

attachment 0.0.8

  • att_to_description allows for ‘LinkingTo’ field in DESCRIPTION with a message
  • att_from_rmd now reads yaml header
  • att_from_rmd use purl to extract R code in an other R session using system("Rscript -e ''")
  • att_from_rmd: add warn option to allow hide messages from purl()

attachment 0.0.7

  • att_to_description accept parameter path for package not being the current project
  • att_to_description no error if NAMESPACE is empty
  • create_dependencies_file filters base packages that cannot be installed

attachment 0.0.6

  • Prepare examples for CRAN

attachment 0.0.5

  • att_to_description deals with Remote dependencies
  • att_to_description deals with Depends dependencies
  • att_to_description keeps versions of packages previously added
  • att_to_description removes option for automatic pkg version
  • create_dependencies_file deals with github Remotes
  • att_from_rmds now accept a vector of Rmd filenames

attachment 0.0.4

  • Add examples in functions

attachment 0.0.3

  • att_to_description(add_version = TRUE) adds version of package in DESCRIPTION
  • att_to_description(pkg_ignore) adds possibility to ignore some packages

attachment 0.0.3

  • Get ready for CRAN
  • Add tests.

attachment 0.0.2

  • New function install_from_description to install all missing packages listed in the description file
  • Add an hex by @statnmap !
  • Allow for absence of vignette folder in att_to_description
  • Add create_dependencies_file to create a file listing all packages dependencies to dinstall before your package
  • Allow for pkg::fun calls in R scripts with att_from_functions
  • Add option to run devtools::document() before att_from_description

attachment 0.0.0.9000

  • Added a NEWS.md file to track changes to the package.