记录闪亮的应用程序

ags*_*udy 10 r roxygen2 shiny

有没有办法为R闪亮的应用程序生成文档?

没有文档就很难维护一个闪亮的应用程序.

似乎所有的测试/文档生态系统都是为R包结构创建的.也许我们可以为闪亮的应用程序模拟/扩展此行为?

一个例子 :

反应式表达式通常是R闪亮元素,可以包含复杂的数据结构.

   filtered_dat <- reactive({ 
      dx[ NAME == input$crr & TOU == input$tou & 
            PlotYear == input$year. & PlotMonth == input$season]
    })
Run Code Online (Sandbox Code Playgroud)

为了给出更多上下文,我在这里使用R shiny构建一个完整的Web应用程序.所有业务逻辑都包含在一个独立的包中.

为了测试Ui,我认为它很复杂(例如可以使用Rselenium),但是从roxygen2注释生成doc 只是解析.拥有这样的工具应该很容易.

ags*_*udy 1

更新

添加闪亮应用程序的示例


没有理想的解决方案,但这基本上是我处理闪亮应用程序的方法,以创建一个强大且“记录良好”的闪亮应用程序:

  • 创建一个包,将所有逻辑放入其中。不用担心从包中调用输入/输出结构作为参数。还可以尝试在包中创建一些控件。例如,您可以拥有一些基本闪亮控件的内联版本。

典型的包将具有以下结构:

 R
     ui-view1.R
     ui-view2.R
     server-server1.R
     server-server2.R
     controls.R
Run Code Online (Sandbox Code Playgroud)
  • 创建一个闪亮的应用程序,其结构可以反映不同的应用程序元素。基本上为每个应用程序页面创建一个视图/服务器文件。您当然可以将闪亮的应用程序放在 inst/ui 下或将其放在单独的项目中。

这里有一个例子:

 app 
     ui.R
     server.R
     global.R
     views
        view1.R
        view2.R
     servers
        server1.R
        server2.R
     init 
        global1.R
        gloabl2.R
Run Code Online (Sandbox Code Playgroud)