Add function signatures to box-attached package functions

.github/workflows/test-and-lint.yaml

@@ -45,6 +45,13 @@ jobs:
           extra-packages: any::rcmdcheck
           needs: check
 
+      - name: R CMD CHECK
+        if: always()
+        uses: r-lib/actions/check-r-package@v2
+        with:
+          error-on: '"note"'
+          args: 'c("--no-tests", "--no-manual", "--as-cran")'
+
       - name: Lint
         if: always()
         shell: Rscript {0}

DESCRIPTION

@@ -1,6 +1,6 @@
 Package: box.lsp
 Title: What the Package Does (One Line, Title Case)
-Version: 0.0.0.9002
+Version: 0.0.0.9004
 Authors@R: 
   c(
     person("Ricardo Rodrigo", "Basa", role = c("aut", "cre"), email = "[email protected]"),
@@ -12,16 +12,18 @@ Description: What the package does (one paragraph).
 License: LGPL (>= 3)
 Encoding: UTF-8
 Roxygen: list(markdown = TRUE)
-RoxygenNote: 7.3.1
+RoxygenNote: 7.3.2
 Imports: 
   box,
-  purrr
+  cli,
+  fs
 Suggests:
-  fs,
   languageserver,
   lintr,
   magrittr,
   mockery,
+  purrr,
+  rprojroot,
   stringi,
   stringr,
   testthat (>= 3.0.0),

NAMESPACE

@@ -1,4 +1,5 @@
 # Generated by roxygen2: do not edit by hand
 
+export(box_use_parser)
+export(use_box_lsp)
 import(box)
-import(purrr)

NEWS.md

@@ -1,4 +1,12 @@
-* box.lsp 0.0.0.9002
+# box.lsp 0.0.0.9004
+
+* add function signatures
+
+# box.lsp 0.0.0.9003
+
+* steps towards package
+
+# box.lsp 0.0.0.9002
 
 * support for pkg[attach_list]
 * support for pkg[alias = attached_function]

R/box_lsp.R

@@ -1,38 +1,85 @@
 #' @import box
 NULL
 
-#' @import purrr
-NULL
+#' Box::use Document Parser
+#'
+#' Custom \{languageserver\} parser hook for \{box\} modules.
+#'
+#' @param expr An R expression to evaluate
+#' @param action A list of action functions from `languageserver:::parse_expr()`.
+#' @returns Used for side-effects provided by the `action` list of functions.
+#'
+#' @export
+box_use_parser <- function(expr, action) {
+  call <- match.call(box::use, expr)
+  packages <- unlist(lapply(call[-1], function(x) {
+    # this is for the last blank in box::use(something, )
+    if (x == "") {
+      return()
+    }
+
+    # this is for a whole package attached box::use(dplyr)
+    if (typeof(x) == "symbol") {
+      # attempts to get package$func to work
+      # nolint start
+      # action$assign(symbol = paste0(as.character(x), "$", getNamespaceExports(as.character(x))), value = NULL)
+      # action$assign(symbol = getNamespaceExports(as.character(x)), value = NULL)
+      # return()
+      # nolint end
+      return(as.character(x))
+    }
+
+    # this is for a whole module attached box::use(app/logic/utils)
+    if (as.character(x[[1]]) == "/") {
+      y <- x[[length(x)]]
+
+      # this case is for app/logic/module_one
+      if (length(y) == 1) {
+        action$assign(symbol = as.character(y), value = NULL)
+      }
+
+      # this case is for app/logic/module_two[...]
+      if (length(y) == 3 && y[[3]] == "...") {
+        # import box module, iterate over its namespace and assign
+      }
+
+      # this case is for app/logic/module_three[a, b, c]
+      lapply(y[-c(1, 2)], function(z) {
+        action$assign(symbol = as.character(z), value = NULL)
+      })
+
+      return()
+    }
+
+    # for box::use(dplyr[<assign list>])
+    if (x[[1]] == "[") {
+      # for box::use(dplyr[alias = a])
+      # Does not seem to be needed
+      # nolint start
+      # action$assign(symbol = names(x) %>% purrr::keep(~. != ""), value = NULL)
+      # nolint end
+      # for box::use(dplyr[a, b, c])
+      lapply(as.character(x)[-c(1, 2)], function(y) {
+        if (y != "...") {
+          namespaced_function <- paste0(as.character(x[[2]]), "::", as.character(y))
+
+          tmp_name <- "temp_func"
+          signature <- deparse(eval(parse(text = namespaced_function, keep.source = TRUE)))[[1]]
+          empty <- "{ }"
+          tmp_sig <- paste(tmp_name, "<-", signature, empty)
+          func_sig <- parse(text = tmp_sig, keep.source = TRUE)[[1]]
+
+
+          action$assign(symbol = as.character(y), value = func_sig[[3L]])
+          action$parse(func_sig[[3L]])
+        }
+      })
 
-# stash
-# nolint start
-# box_use_parser <- function(expr, action) {
-#   fun <- if (requireNamespace("box", quietly = TRUE)) box::use else
-#     function(...) NULL
-#   call <- match.call(fun, expr, expand.dots = FALSE)
-#
-#   if(!isTRUE(call$character.only)) {
-#     packages <- vapply(
-#       call[["..."]],
-#       function(item) {
-#         item <- as.character(item)
-#         if (item[1] == "[" && grepl("\\.\\.\\.", item[3])) {
-#           return(item[2])
-#         } else {
-#           return("")
-#         }
-#       },
-#       character(1L)
-#     )
-#     packages <- purrr::keep(packages, ~. != "")
-#     action$update(packages = packages)
-#
-#     test_value <- "function(x, y) { \"A \" }"
-#     action$assign(symbol = "module$fun", value = "function(x, y) { \"A \" }")
-#     action$parse(test_value)
-#   }
-# }
-# nolint end
-
-options(languageserver.trace = TRUE)
-options(languageserver.debug = TRUE)
+      # for box::use(dplyr[a, b, ...])
+      if (x[[length(x)]] == "...") {
+        as.character(x[[2]])
+      }
+    }
+  }))
+  action$update(packages = packages)
+}