|
1 | 1 | #' Mock functions in a package. |
2 | 2 | #' |
3 | 3 | #' @description |
4 | | -#' `r lifecycle::badge("deprecated")` |
5 | | -#' |
6 | 4 | #' `with_mock()` and `local_mock()` are deprecated in favour of |
7 | 5 | #' [with_mocked_bindings()] and [local_mocked_bindings()]. |
8 | 6 | #' |
9 | 7 | #' These functions worked by using some C code to temporarily modify the mocked |
10 | | -#' function _in place_. This was an abuse of R's internals and it is no longer |
| 8 | +#' function _in place_. This was an abuse of R's internals and it is no longer |
11 | 9 | #' permitted. |
12 | 10 | #' |
| 11 | +#' @section 3rd edition: |
| 12 | +#' `r lifecycle::badge("deprecated")` |
| 13 | +#' |
| 14 | +#' `with_mock()` and `local_mock()` are deprecated in the third edition. |
| 15 | +#' |
13 | 16 | #' @param ... named parameters redefine mocked functions, unnamed parameters |
14 | 17 | #' will be evaluated after mocking the functions |
15 | 18 | #' @param .env the environment in which to patch the functions, |
|
21 | 24 | #' @return The result of the last unnamed parameter |
22 | 25 | #' @export |
23 | 26 | with_mock <- function(..., .env = topenv()) { |
24 | | - lifecycle::deprecate_warn("3.3.0", "with_mock()", "with_mocked_bindings()") |
25 | | - |
26 | | - dots <- eval(substitute(alist(...))) |
27 | | - mock_qual_names <- names(dots) |
28 | | - |
29 | | - if (all(mock_qual_names == "")) { |
30 | | - warning( |
31 | | - "Not mocking anything. Please use named parameters to specify the functions you want to mock.", |
32 | | - call. = FALSE |
33 | | - ) |
34 | | - code_pos <- rep(TRUE, length(dots)) |
35 | | - } else { |
36 | | - code_pos <- (mock_qual_names == "") |
37 | | - } |
38 | | - code <- dots[code_pos] |
39 | | - |
40 | | - mock_funs <- lapply(dots[!code_pos], eval, parent.frame()) |
41 | | - mocks <- extract_mocks(mock_funs, .env = .env) |
42 | | - |
43 | | - on.exit(lapply(mocks, reset_mock), add = TRUE) |
44 | | - lapply(mocks, set_mock) |
45 | | - |
46 | | - # Evaluate the code |
47 | | - if (length(code) > 0) { |
48 | | - for (expression in code[-length(code)]) { |
49 | | - eval(expression, parent.frame()) |
50 | | - } |
51 | | - # Isolate last item for visibility |
52 | | - eval(code[[length(code)]], parent.frame()) |
53 | | - } |
| 27 | + lifecycle::deprecate_stop("3.3.0", "with_mock()", "with_mocked_bindings()") |
54 | 28 | } |
55 | 29 |
|
56 | 30 | #' @export |
57 | 31 | #' @rdname with_mock |
58 | 32 | local_mock <- function(..., .env = topenv(), .local_envir = parent.frame()) { |
59 | | - lifecycle::deprecate_warn("3.3.0", "local_mock()", "local_mocked_bindings()") |
60 | | - |
61 | | - mocks <- extract_mocks(list(...), .env = .env) |
62 | | - on_exit <- bquote( |
63 | | - on.exit(lapply(.(mocks), .(reset_mock)), add = TRUE), |
64 | | - ) |
65 | | - |
66 | | - lapply(mocks, set_mock) |
67 | | - eval_bare(on_exit, .local_envir) |
68 | | - invisible() |
69 | | -} |
70 | | - |
71 | | -pkg_rx <- ".*[^:]" |
72 | | -colons_rx <- "::(?:[:]?)" |
73 | | -name_rx <- ".*" |
74 | | -pkg_and_name_rx <- sprintf("^(?:(%s)%s)?(%s)$", pkg_rx, colons_rx, name_rx) |
75 | | - |
76 | | -extract_mocks <- function(funs, .env) { |
77 | | - if (is.environment(.env)) { |
78 | | - .env <- environmentName(.env) |
79 | | - } |
80 | | - mock_qual_names <- names(funs) |
81 | | - |
82 | | - lapply( |
83 | | - stats::setNames(nm = mock_qual_names), |
84 | | - function(qual_name) { |
85 | | - pkg_name <- gsub(pkg_and_name_rx, "\\1", qual_name) |
86 | | - |
87 | | - if (is_base_pkg(pkg_name)) { |
88 | | - stop( |
89 | | - "Can't mock functions in base packages (", pkg_name, ")", |
90 | | - call. = FALSE |
91 | | - ) |
92 | | - } |
93 | | - |
94 | | - name <- gsub(pkg_and_name_rx, "\\2", qual_name) |
95 | | - |
96 | | - if (pkg_name == "") { |
97 | | - pkg_name <- .env |
98 | | - } |
99 | | - |
100 | | - env <- asNamespace(pkg_name) |
101 | | - |
102 | | - if (!exists(name, envir = env, mode = "function")) { |
103 | | - stop("Function ", name, " not found in environment ", |
104 | | - environmentName(env), ".", |
105 | | - call. = FALSE |
106 | | - ) |
107 | | - } |
108 | | - mock(name = name, env = env, new = funs[[qual_name]]) |
109 | | - } |
110 | | - ) |
111 | | -} |
112 | | - |
113 | | -mock <- function(name, env, new) { |
114 | | - target_value <- get(name, envir = env, mode = "function") |
115 | | - structure( |
116 | | - list( |
117 | | - env = env, |
118 | | - name = as.name(name), |
119 | | - orig_value = .Call(duplicate_, target_value), target_value = target_value, |
120 | | - new_value = new |
121 | | - ), |
122 | | - class = "mock" |
123 | | - ) |
124 | | -} |
125 | | - |
126 | | -set_mock <- function(mock) { |
127 | | - .Call(reassign_function, mock$name, mock$env, mock$target_value, mock$new_value) |
128 | | -} |
129 | | - |
130 | | -reset_mock <- function(mock) { |
131 | | - .Call(reassign_function, mock$name, mock$env, mock$target_value, mock$orig_value) |
132 | | -} |
133 | | - |
134 | | -is_base_pkg <- function(x) { |
135 | | - x %in% rownames(utils::installed.packages(priority = "base")) |
| 33 | + lifecycle::deprecate_stop("3.3.0", "local_mock()", "local_mocked_bindings()") |
136 | 34 | } |
0 commit comments