{attachment} v0.2.0 : trouver les dépendances dans vos scripts et remplir la DESCRIPTION de vos packages

Author : Sébastien Rochette
Categories : développement, package, thinkrverse
Tags : attachment, documentation, rmd-first, thinkr-package
Date :

Une nouvelle version de {attachment} a été publiée sur le CRAN ! Nous continuons d’améliorer ses fonctionnalités pour vous aider à gérer les dépendances dans R, en particulier lors du développement des packages.

Depuis notre dernier billet de blog présentant l’objectif de {attachment}, deux versions sont arrivées sur le CRAN. La documentation complète est disponible sur le site web {pkgdown} : https://thinkr-open.github.io/attachment.
Néanmoins, pour les développeurs de packages, att_amend_desc() reste votre meilleur ami après chaque modification de votre package. Juste avant les devtools::check() comme nous l’expliquons dans notre guide pour le développement de packages avec la documentation.

Installer {attachment} depuis CRAN ou GitHub

CRAN version

install.packages("attachment")

Development version

# install.packages("devtools")
devtools::install_github("ThinkR-open/attachment")

{attachment} 0.2.0: Trouver les dépendances dans le code en ligne des Rmarkdown (inline code)

Breaking changes

  • att_to_description() déprécié pour att_amend_desc() afin d’être le premier dans la liste avec l’auto-completion. C’est la fonction la plus utilisée.
  • att_from_rmd() hérite du paramètre inline = TRUE par défault pour explorer les appels de packages dans le code inline des Rmd.
  • att_from_rmd() et att_from_rmds() ne sont plus exécuté dans une session R séparée par défaut. Vous devrez définir inside_rmd = TRUE si vous l’utilisez à l’intérieur d’un Rmd.

Minor

  • Ajout de find_remotes() pour vous aider à remplir le champ Remotes dans le fichier DESCRIPTION
  • att_to_desc_from_is() reçoit le paramètre normalize pour éviter les problèmes avec {desc}. (Voir https://github.com/r-lib/desc/issues/80)

{attachment} 0.1.0: Gérer le fichier DESCRIPTION d’un gitbook {bookdown}

Regarder comment remplir la DESCRIPTION pour vos {bookdown} dans la documentation: https://thinkr-open.github.io/attachment/articles/b-bookdown-and-scripts.html

  • att_amend_desc() prend la place de att_to_description()
  • att_desc_from_is() met à jour DESCRIPTION à partir d’un vecteur de packages pour imports/suggests directement
  • att_to_desc_from_pkg() est un alias pour att_amend_desc()
  • La dépendance à {devtools} est retirée et remplacée par {roxygen}
  • att_to_description() affiche un message pour les packages ajoutés ou retirés de DESCRIPTION
  • att_to_description() gère les dépendances de le dossier de tests/
  • att_from_rmds() permet d’utiliser une regex afin de définir les fichiers Rmd à trouver

Comments


Also read