Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

box without modules #279

Open
ggrothendieck opened this issue May 29, 2022 · 1 comment
Open

box without modules #279

ggrothendieck opened this issue May 29, 2022 · 1 comment

Comments

@ggrothendieck
Copy link

ggrothendieck commented May 29, 2022

Please describe your feature request

Although the purpose of box is to define modules as an alternative to packages two other usages are possible:

  1. add a help system to a script file without using modules. Many times I deal with R users who do not want to learn additional infrastructure whether it be packages, modules or whatever. They want to continue to either paste scripts into R or use source(...). All they really need is to be given a script with roxygen2 markup and a help command that will get them formatted help on that script. What would also be useful would be something analogous to help("function") and help(package = "myPackage") but for a single script. Ideally there would only be one help command to learn and no other commands would be needed since the whole purpose is to avoid learning and to avoid infrastructure when dealing with occasional type of R users.

  2. as a stepping stone to developing a package. Again this does not require modules but just requires some support for roxygen2 markup to get help as in (1). Also, what would be useful for this one would be a command that converts the script to a package.

This could either be part of box or made into a separate package.

@DanChaltiel
Copy link

For your 2nd point, you might be interested in using https://thinkr-open.github.io/fusen/

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants