Document imports in a single file

[IndrajeetPatil]

Note that the NAMESPACE file remains unchanged.

This is similar to the idiom utilized by {usethis} package.

[github-actions]

This is how benchmark results would change (along with a 95% confidence interval in relative change) if 765e837 is merged into main:

•   :ballot_box_with_check:cache_applying: 23.6ms -> 23.7ms [-0.14%, +0.68%]
•   :ballot_box_with_check:cache_recording: 742ms -> 741ms [-0.55%, +0.35%]
•   :ballot_box_with_check:without_cache: 1.87s -> 1.87s [-0.5%, +0.14%]

Further explanation regarding interpretation and methodology can be found in the documentation.

[lorenzwalthert]

Ok. I am not sure that’s the best way though. Just as context: at the very beginning, we imported all objects on a function basis. That’s why there are many duplicated statements. It reminds me now of the Python import style. The good thing about the duplication is that if a function call looks unknown, you can see quickly check the roxygen comments to know where it comes from. But since we anyways mostly imported functions that developers know, and prefixed the more exotic lines with ::, I guess this argument is less strong.

[lorenzwalthert]

I guess the PR makes sense mostly though. Maybe some of the functions that are just used once and that are more exotic like as_mapper() could also be prefixed with ::, although this might have minor Speedo implications.

[lorenzwalthert]

write.table and capture.output could be prefixed, these are not used at runtime anyways, only for testing.

[IndrajeetPatil]

This conditional is unnecessary since it will always be true.

[IndrajeetPatil]

Maybe some of the functions that are just used once and that are more exotic like as_mapper() could also be prefixed with ::

I have done so now.

although this might have minor Speedo implications

Each :: call costs roughly 120 nanoseconds, so I don't think the performance should degrade in any significant way.

[github-actions]

This is how benchmark results would change (along with a 95% confidence interval in relative change) if 1f8474b is merged into main:

•   :ballot_box_with_check:cache_applying: 23.3ms -> 23.4ms [-0.1%, +0.65%]
•   :ballot_box_with_check:cache_recording: 723ms -> 722ms [-0.58%, +0.08%]
•   :ballot_box_with_check:without_cache: 1.83s -> 1.83s [-0.81%, +0.58%]

Further explanation regarding interpretation and methodology can be found in the documentation.