[Rd] Questions about imports to a namespace
murdoch.duncan at gmail.com
Tue Jul 3 12:41:45 CEST 2012
On 12-07-02 10:53 PM, Simon Knapp wrote:
> I am a bit unsure about using imports in packages and have a few
> questions. I'm sure the answer to some of these is 'it depends', but
> I'm interested in what others think and 'best practices' when this is
> the case.
> 1) If I use an import or importFrom declaration in a NAMESPACE, should
> I also qualify the package in calls to the imported function (e.g.
No, you won't need that. I would expect it to slow things down a bit,
since it needs two searches instead of one: look up "maptools", look up
> 2) If the 'best practice' is to qualify the calls, when does one stop;
> e.g. is it good/bad to say base::sapply?
> 3) If one is calling a (S3) generic, should one qualify the namespace?
> Can this cause problems?
I think it wouldn't hurt other than the slight speed hit.
> 4) Is it better to check for arguments that are missing, or use a
> default value of, say, NA; i.e. is missing(arg) preferable to
That depends. It's easier to set an argument to a special value in a
call from another function than it is to conditionally set it to be
missing, but there are only a couple of general purpose choices for
"missing" values: NA and NULL, and you might want a user to be able to
specify those. (You can also use negative values for counts, etc., in
> 5) I would like to declare a (S3) generic 'cleanup(x)' but
> 'cleanup(...)' already exists in R.utils, which my package depends on.
> Should I do it?
No. Use a different name. If you are using R.utils, your users are
also using it, and their code may want to call R.utils::cleanup without
the R.utils:: prefix.
> 6) I am used to writing 'requires(package)' for each package I use
> within a function. If I have used import or importFrom in my
> NAMESPACE, should I still do this?
No, it just slows things down, and can cause other problems for users
because it changes the search list.
More information about the R-devel