Aller plus loin avec la structure des packages

Développer des packages R

Jasmin Ludolf

Content Developer

Avantages des packages par rapport aux scripts

  • Meilleure organisation
  • Faciliter la reproductibilité
  • Favoriser une collaboration plus simple
  • Simplifier le partage et la distribution

Collaboration

Développer des packages R

Structurer le code dans le répertoire R

Le répertoire R/ :

  • Contient tous les fichiers de scripts R du package
  • Les scripts doivent être des fichiers .R
  • Séparer les fonctions dans différents scripts R

Mise en évidence du répertoire R

Développer des packages R

Choisir un nom de package valide

  • Lettres ASCII, chiffres et points
  • Au moins deux caractères
  • Commence par une lettre
  • Ne peut pas se terminer par un point
  • _ n'est pas un caractère valide

 

CRAN : dépôt central des packages R

1 Writing R Extensions from CRAN: https://cran.r-project.org/doc/manuals/r-devel/R-exts.html#Creating-R-packages
Développer des packages R

Le package available

library(available)

available("yourPackageName")

Vérifie

  • Nom de package valide
  • Nom disponible sur CRAN
  • Sentiment positif ou négatif
Développer des packages R

Sortie de available()

available("horrendous")

sortie de vérification pour horrendous

Développer des packages R

Choisir un nom de package informatif

Exemples :

  • readr : jeu de mots avec « reader »
  • tidyr : rôle majeur pour nettoyer les données

Exemples de noms peu informatifs :

  • MASS : obscur, référence à un manuel
  • utils : générique, sans indication
Développer des packages R

Choisir une licence pour notre package

MIT

use_mit_license()

Sortie de la licence MIT

  • Nécessite l'inclusion de l'avis de droit d'auteur d'origine
  • Principalement utilisée pour les logiciels

CC0

use_cc0_license()

Sortie de la licence CC0

  • Ne requiert pas l'inclusion de l'avis de droit d'auteur d'origine
  • Utilisée pour divers contenus : logiciels, jeux de données, textes, images
Développer des packages R

Passons à la pratique !

Développer des packages R

Preparing Video For Download...