Mejor explicación de cuándo usar Importaciones / Depende

El manual " Escritura de extensiones R " proporciona la siguiente guía sobre cuándo usar Importaciones o Depende:

Las reglas generales son

• Los paquetes cuyo espacio de nombres solo es necesario para cargar el paquete usando la biblioteca (pkgname) deben aparecer en el campo 'Importaciones' y no en el campo 'Depende'.
• Los paquetes que deben adjuntarse para cargar con éxito el paquete usando la biblioteca (pkgname) solo deben aparecer en el campo 'Depende'.

¿Alguien puede proporcionar un poco más de claridad sobre esto? ¿Cómo sé cuándo mi paquete solo necesita espacios de nombres cargados y cuándo necesito adjuntar un paquete? ¿Cuáles son ejemplos de ambos? Creo que el paquete típico es solo una colección de funciones que a veces llaman funciones en otros paquetes (donde ya se ha codificado un poco de trabajo). ¿Es este escenario 1 o 2 arriba?

Editar

Escribí una publicación de blog con una sección sobre este tema específico (busque 'Importaciones v Depende'). Las imágenes hacen que sea mucho más fácil de entender.

"Imports"es más seguro que "Depends"(y también hace que un paquete lo use como un "mejor ciudadano" con respecto a otros paquetes que sí lo usan "Depends").

Una "Depends"directiva intenta asegurar que una función de otro paquete esté disponible adjuntando el otro paquete a la ruta de búsqueda principal (es decir, la lista de entornos devueltos por search()). Sin embargo, esta estrategia se puede frustrar si otro paquete, cargado más tarde, coloca una función con un nombre idéntico anteriormente en la ruta de búsqueda. Chambers ( en SoDA ) utiliza el ejemplo de la función "gam", que se encuentra en los paquetes gamy mgcv. Si se cargaron otros dos paquetes, uno de los cuales depende gamy el otro depende de mgcv, la función encontrada por las llamadas a gam()dependería del orden en que se adjuntaron esos dos paquetes. No está bien.

Se "Imports"debe usar una directiva para cualquier paquete de soporte cuyas funciones se deben colocar <imports:packageName>(buscar inmediatamente después <namespace:packageName>), en lugar de en la ruta de búsqueda normal. Si cualquiera de los paquetes en el ejemplo anterior usara el "Imports"mecanismo (que también requiere importo importFromdirectivas en el NAMESPACEarchivo), las cosas mejorarían de dos maneras. (1) El paquete en sí mismo obtendría el control sobre qué mgcvfunción se utiliza. (2) Al mantener la ruta de búsqueda principal libre de los objetos importados, ni siquiera rompería la dependencia del otro paquete de la otra mgcvfunción.

Esta es la razón por la cual el uso de espacios de nombres es una buena práctica, por qué ahora CRAN lo aplica y (en particular) por qué usar "Imports"es más seguro que usarlo "Depends".

Editado para agregar una advertencia importante:

Desafortunadamente, hay una excepción común a los consejos anteriores: si su paquete se basa en un paquete Aque se encuentra "Depends"en otro paquete B, es probable que deba adjuntarlo Acon una "Dependsdirectiva.

Esto se debe a que las funciones del paquete Ase escribieron con la expectativa de que el paquete By sus funciones se adjuntarían a la search()ruta .

Una "Depends"directiva cargará y adjuntará el paquete A, en cuyo punto Ala propia "Depends"directiva del paquete , en una reacción en cadena, hará que el paquete también Bse cargue y se adjunte. Las funciones en el paquete Apodrán encontrar las funciones en el paquete Ben las que se basan.

Una "Imports"directiva cargará pero no adjuntará el paquete Ay no cargará ni adjuntará el paquete B. ( "Imports"Después de todo, espera que los escritores de paquetes están utilizando el mecanismo de espacio de nombres, y que el paquete Ava a utilizar "Imports"hasta el punto de que cualquiera de las funciones en Bque necesitan tener acceso a.) Llama por sus funciones a cualquier función en el paquete Aque se basan en funciones en el paquete Bvoluntad en consecuencia fracasan.

Las dos únicas soluciones son:

1. Haga que su paquete adjunte el paquete Ausando una "Depends"directiva.
2. Mejor a largo plazo, comuníquese con el responsable del paquete Ay pídales que hagan un trabajo más cuidadoso al construir su espacio de nombres (en palabras de Martin Morgan en esta respuesta relacionada ).

Hadley Wickham da una explicación fácil ( http://r-pkgs.had.co.nz/namespace.html ):

Enumerar un paquete en Dependso Importsasegura que se instala cuando sea necesario. La principal diferencia es que donde Importssolo carga el paquete, lo Dependsadjunta. No hay otras diferencias. [...]

A menos que haya una buena razón de lo contrario, siempre debe enumerar los paquetes en Importsnot Depends. Esto se debe a que un buen paquete es autónomo y minimiza los cambios en el entorno global (incluida la ruta de búsqueda). La única excepción es si su paquete está diseñado para usarse junto con otro paquete. Por ejemplo, el paquete analógico se basa en vegano. No es útil sin vegan, por lo que tiene vegan en Dependslugar de Imports. Del mismo modo, ggplot2 realmente debería depender de escalas, en lugar de importarlo.

Chambers en SfDA dice que use 'Importaciones' cuando este paquete usa un mecanismo de 'espacio de nombres' y dado que ahora se requiere que todos los paquetes los tengan, entonces la respuesta podría ser siempre usar 'Importaciones'. En el pasado, los paquetes podrían haberse cargado sin tener espacios de nombres y, en ese caso, debería haber utilizado Depends.

Aquí hay una pregunta simple para ayudarlo a decidir cuál usar:

¿Su paquete requiere que el usuario final tenga acceso directo a las funciones de otro paquete?

• NO -> Importaciones (respuesta más común)
• SÍ -> Depende

El único momento en que debe usar 'Depends' es cuando su paquete es un complemento o compañero de otro paquete, donde su usuario final utilizará funciones de su paquete y del paquete 'Depends' en su código. Si su usuario final solo interactuará con sus funciones, y el otro paquete solo estará trabajando detrás de escena, entonces use 'Importaciones' en su lugar.

La advertencia a esto es que si agrega un paquete a 'Importaciones', como debería hacerlo normalmente, su código deberá referirse a las funciones de ese paquete, utilizando la sintaxis completa del espacio de nombres, por ejemplo dplyr::mutate(), en lugar de solo mutate(). Hace que el código sea un poco más complicado de leer, pero es un pequeño precio a pagar por una mejor higiene del paquete.