Espaces de noms dans les paquets R

Question

Comment apprendre à donner un espace de noms à un paquetage R ? Je trouve la documentation dans "R Extensions" très bien, mais je ne comprends pas vraiment ce qui se passe quand une variable est importée ou exportée - j'ai besoin d'un guide pour les nuls sur ces directives.

Comment décidez-vous de ce qui est exporté ? Est-ce que c'est juste tout ce qui ne devrait pas nécessiter la syntaxe pkg:::var ? Qu'en est-il des importations ?

Les importations permettent-elles de s'assurer plus facilement que l'utilisation des fonctions d'autres paquets n'est pas confuse lorsque les noms de fonctions se chevauchent ?

Y a-t-il des considérations particulières pour les classes S4 ?

Les paquets que je connais et qui utilisent des espaces de noms tels que sp et rgdal sont assez compliqués - existe-t-il des exemples simples qui pourraient rendre les choses plus claires ?

Answer 1

J'ai un début de réponse sur le wiki de devtools : https://r-pkgs.org/Metadata.html

Answer 2

Quelques années plus tard, voici....

J'ai consolidé les résultats obtenus par Chambers, d'autres messages StackOverflow et beaucoup de bricolage dans R : https://blog.thatbuthow.com/how-r-searches-and-finds-stuff/

Il s'agit moins de la mise en œuvre de NAMESPACE/IMPORTS/DEPENDS que de l'objectif de ces structures. Il répond à certaines de vos questions.

Answer 3

L'explication la plus claire que j'ai lue se trouve dans l'ouvrage de John Chambers intitulé Logiciel d'analyse des données : Programmation avec R page 103. Je ne connais pas d'explications gratuites en ligne qui soient meilleures que celles que vous avez déjà trouvées dans le manuel R Extensions.

Answer 4

Vous pouvez également choisir un petit paquet facile et le suivre.

J'ai regardé de manière semi-aléatoire résumé qui est l'un de mes plus petits paquets. Je charge une (petite) bibliothèque dynamique et j'exporte un symbole, le symbole digest() fonction. Voici le contenu du fichier NAMESPACE :

## package has dynamic library
useDynLib(digest)

## and one and only one core function
export(digest)

Jetez un coup d'œil au reste des fichiers sources et essayez peut-être de lire Écrire des extensions R à côté de l'examen de l'exemple, et faites quelques expériences.

Answer 5

http://www.stat.uiowa.edu/~luke/R/namespaces/morenames.pdf