{"Package":"mockr","Title":"Mocking in R","Version":"0.1","Authors@R":"person(\"Kirill\", \"Mller\", role = c(\"aut\", \"cre\"), email = \"krlmlr+r@mailbox.org\")","Description":"Provides a means to mock a package function, i.e., temporarily substitute it for testing. Designed as a drop-in replacement for 'testthat::with_mock()', which may break in R 3.4.0 and later.","Imports":"lazyeval","Suggests":"testthat, covr","License":"GPL-3","Encoding":"UTF-8","LazyData":"true","Date":"2017-04-28","BugReports":"https://github.com/krlmlr/mockr/issues","URL":"https://github.com/krlmlr/mockr, http://krlmlr.github.io/mockr","RoxygenNote":"6.0.1","NeedsCompilation":"no","Packaged":"2017-04-29 08:10:46 UTC; muelleki","Author":"Kirill Mller [aut, cre]","Maintainer":"Kirill Mller ","Repository":"CRAN","Date/Publication":"2017-04-29 13:18:38 UTC","repoType":"cran","tarballUrl":"ftp://cran.r-project.org/pub/R/src/contrib/mockr_0.1.tar.gz","jsonAuthors":[{"name":"Kirill Mller","email":"krlmlr+r@mailbox.org","maintainer":true}],"readme":"\nmockr [![Travis-CI Build Status](https://travis-ci.org/krlmlr/mockr.svg?branch=master)](https://travis-ci.org/krlmlr/mockr) [![Coverage Status](https://img.shields.io/codecov/c/github/krlmlr/mockr/master.svg)](https://codecov.io/github/krlmlr/mockr?branch=master) [![CRAN\\_Status\\_Badge](http://www.r-pkg.org/badges/version/mockr)](https://cran.r-project.org/package=mockr)\n=====================================================================================================================================================================================================================================================================================================================================================================================\n\nThe goal of mockr is to provide a drop-in replacement for `testthat::with_mock()` which will be deprecated in the next version of `testthat`. The only exported function, `with_mock()`, is modeled closely after the original implementation, but now only allows mocking functions in the package under test. In contrast to the original implementation, no fiddling with R's internals is needed, and the implementation plays well with byte-compiled code. There are some caveats, though:\n\n1. Mocking external functions (in other packages) doesn't work anymore. This is by design.\n - If you need to mock an external function, write a wrapper.\n - If that external function is called by a third-party function, you'll need to perhaps mock that third-party function, or look for a different way of implementing this test or organizing your code.\n\n2. You cannot refer to functions in your package via `your.package::` or `your.package:::` anymore, this is a limitation of the implementation.\n - Simply remove the `your.package:::`, your code and tests should run just fine without that.\n\nIf you encounter other problems, please [file an issue](https://github.com/krlmlr/mockr/issues).\n\nExample\n-------\n\n``` r\nsome_func <- function() stop(\"oops\")\nsome_other_func <- function() some_func()\n\n# Calling this function gives an error\nsome_other_func()\n#> Error in some_func(): oops\n\ntester_func <- function() {\n # Here, we override the function that raises the error\n with_mock(\n some_func = function() 42,\n some_other_func()\n )\n}\n\n# No error raised\ntester_func()\n#> [1] 42\n\n# Mocking doesn't override functions in the same environment by design\nwith_mock(some_func = function() 6 * 7, some_other_func())\n#> Error in some_func(): oops\n```\n\nInstallation\n------------\n\nInstall from GitHub via\n\n``` r\ndevtools::install_github(\"krlmlr/mockr\")\n```","jobInfo":{"package":"mockr","version":"0.1","parsingStatus":"success","parserVersion":1,"parsedAt":"2022-04-02T20:29:48+0000"}}

Description

Arguments

See Also