Want to share your content on R-bloggers? click here if you have a blog, or here if you don't.
We have just released version 3.0.1 of the pkgsearch package on CRAN! ???? pkgsearch munges CRAN metadata and lets you
access it through several lenses: search packages by keyword, popularity, recent activity, package name and more.
Get pkgsearch’s latest version from
a safe CRAN mirror near
you:
install.packages("pkgsearch")
This release, compared to pkgsearch 2.0.0, brings
???? Better package search functionality
New RStudio addin to search for packages in a GUI:
pkg_search_addin().New function
advanced_search()for more search flexibility.
???? New functionality
cran_package(),cran_packages()andcran_package_history()functions to query metadata about certain packages.cran_events()function to list recent CRAN events, new, updated or archived packages.cran_top_downloaded()function to query packages with the most downloads.cran_trending()function to return the trending CRAN packages.
That’s… a lot! Let’s have some fun with the package.
Explore packages in a GUI
You can use pkgsearch with an interface. See more in the video below. You can also launch the interface in a browser without RStudio, refer to the addin docs.
< !--html_preserve-->
Other use cases
The pkgsearch package is the answer to many questions you might have about CRAN packages, thanks to its exposing it through different lenses.
library("pkgsearch")
Packages to do mocking
Remember our blog post about mocking when unit testing? How could we search CRAN packages related to mocking?
pkg_search("mocking")
## - "mocking" ------------------------------------- 8 packages in 0.009 seconds -
## # package version by @ title
## 1 100 mockery 0.4.2 Jim Hester 3M Mocking Library for R
## 2 43 mockr 0.1 Kirill Müller 3y Mocking in R
## 3 19 crul 0.9.0 Scott Chamberlain 20d HTTP Client
## 4 14 fakemake 1.5.0 Andreas Dominik Cullmann 22d Mock the Unix Make Ut...
## 5 9 httptest 3.2.2 Neal Richardson 1y A Test Environment fo...
## 6 4 spongebob 0.4.0 Jay Qi 9M SpongeBob-Case Conver...
## 7 0 vcr 0.3.0 Scott Chamberlain 3M Record 'HTTP' Calls t...
## 8 0 webmockr 0.4.0 Scott Chamberlain 4M Stubbing and Setting ...
Dependencies of a package over time?
< !--html_preserve-->
< !--/html_preserve-->Does anyone in #rstats world know how to get the dependencies of a specific package version? What ive seen is deps for whatever *current* repo/CRAN version, but I need to go back to past dependencies. @jimhester_ ?
— Stu Field (@stufield3) October 22, 2019
YES, we know! ???? ✋ So say we want to query the dependencies of tsibble, we can use cran_package_history() for that.
library("magrittr")
cran_package_history("tsibble")[, c("Package", "Version", "dependencies")] %>%
tidyr::unnest(dependencies)
## # A tibble: 447 x 5
## Package Version type package version
## <chr> <chr> <chr> <chr> <chr>
## 1 tsibble 0.1.0 Depends R >= 3.1.3
## 2 tsibble 0.1.0 Imports rlang *
## 3 tsibble 0.1.0 Imports tidyr *
## 4 tsibble 0.1.0 Imports purrr *
## 5 tsibble 0.1.0 Imports tibble >= 1.4.1
## 6 tsibble 0.1.0 Imports pillar >= 1.0.1
## 7 tsibble 0.1.0 Imports lubridate *
## 8 tsibble 0.1.0 Imports dplyr >= 0.7.3
## 9 tsibble 0.1.0 Imports Rcpp >= 0.12.3
## 10 tsibble 0.1.0 Imports tidyselect *
## # … with 437 more rows
Or of one particular version of tsibble, then we can run cran_packages() (or cran_package() with its version argument, that returns a list).
cran_packages("tsibble@0.2.0")
## # A tibble: 1 x 25
## Package Type Title Version Date `Authors@R` Description ByteCompile
## <chr> <chr> <chr> <chr> <chr> <chr> <chr> <chr>
## 1 tsibble Pack… Tidy… 0.2.0 2018… "c(\nperso… "Provides … true
## # … with 17 more variables: VignetteBuilder <chr>, License <chr>, URL <chr>,
## # BugReports <chr>, Encoding <chr>, LazyData <chr>, RoxygenNote <chr>,
## # NeedsCompilation <chr>, Packaged <chr>, Author <chr>, Maintainer <chr>,
## # Repository <chr>, `Date/Publication` <chr>, crandb_file_date <chr>,
## # MD5sum <chr>, date <chr>, dependencies <list>
info <- cran_package("tsibble", version = "0.2.0")
info[c("Imports", "Suggests", "Depends")]
## $Imports
## $Imports$rlang
## [1] ">= 0.2.0"
##
## $Imports$tidyr
## [1] "*"
##
## $Imports$purrr
## [1] ">= 0.2.3"
##
## $Imports$tibble
## [1] ">= 1.4.1"
##
## $Imports$pillar
## [1] ">= 1.0.1"
##
## $Imports$lubridate
## [1] "*"
##
## $Imports$dplyr
## [1] ">= 0.7.3"
##
## $Imports$Rcpp
## [1] ">=\n0.12.3"
##
## $Imports$tidyselect
## [1] "*"
##
##
## $Suggests
## $Suggests$knitr
## [1] "*"
##
## $Suggests$rmarkdown
## [1] "*"
##
## $Suggests$testthat
## [1] "*"
##
## $Suggests$covr
## [1] "*"
##
## $Suggests$hts
## [1] "*"
##
## $Suggests$hms
## [1] "*"
##
## $Suggests$nycflights13
## [1] "*"
##
## $Suggests$ggplot2
## [1] ">= 2.2.0"
##
##
## $Depends
## $Depends$R
## [1] ">= 3.1.3"
When was the CRAN incoming queue closed?
From time to time CRAN incoming queue is closed, for instance earlier this year from August 9 to August 18. Can we see that in the data?
library("ggplot2")
cran_events <- cran_events(limit = 5000)
events_df <- tibble::tibble(
date = anytime::anytime(purrr::map_chr(cran_events, "date")),
type = purrr::map_chr(cran_events, "event")
)
ggplot(events_df) +
geom_segment(aes(x = date, xend = date,
col = type),
y = 0, yend = 1) +
viridis::scale_colour_viridis(discrete = TRUE) +
theme_minimal() +
hrbrthemes::theme_ipsum(base_size = 16,
axis_title_size = 16) +
xlab("Time") +
theme(
axis.text.y = element_blank(),
axis.ticks.y = element_blank(),
axis.title.y = element_blank(),
legend.position = "bottom") +
ggtitle("Latest 5,000 CRAN events",
subtitle = "Data obtained via the R-hub pkgsearch R package")
So yes, we do see the CRAN (well-deserved!) break in the data!
Related work
Without surprise pkgsearch is our favorite CRAN metadata munger since it is ours, but we know of other great tools!
The
packagefinderpackage by Joachim Zuckarelli aims at providing a Comfortable Search for R Packages on CRAN Directly from the R Console.CRANberriesby Dirk Eddelbuettel “aggregates information about new, updated and removed packages from the CRAN network for R available as this html version and a corresponding RSS feed.” and a Twitter feed. Handy!
Conclusion
In this post we gave an overview of pkgsearch functionalities. It could become your go-to package for searching and exploring CRAN packages thanks to its exposing CRAN metadata in different ways: packages related to a keyword, trending packages, information about a package, etc. And you can use it either from the R console or a GUI!
The best place to get to know pkgsearch is its brand-new documentation website built with pkgdown, and the best place to provide feedback or contribute is its GitHub repo. We look forward to hearing from your use cases, and hope your enthusiasm for the package can push it to the cran_trending() VIP list! ????
pkg_search("search CRAN")
## - "search CRAN" ----------------------------- 15699 packages in 0.015 seconds -
## # package version by @ title
## 1 100 pkgsearch 3.0.1 Gábor Csárdi 17h Search and Query CRAN...
## 2 63 packagefinder 0.1.5 Joachim Zuckarelli 25d Comfortable Search fo...
## 3 62 CRANsearcher 1.0.0 Agustin Calatroni 2y RStudio Addin for Sea...
## 4 55 RWsearch 4.6.2 Patrice Kiener 3M Lazy Search in R Pack...
## 5 20 XML 3.98.1.20 ORPHANED 6M Tools for Parsing and...
## 6 17 RCurl 1.95.4.12 Duncan Temple Lang 9M General Network (HTTP...
## 7 12 NCmisc 1.1.6 Nicholas Cooper 1y Miscellaneous Functio...
## 8 11 badgecreatr 0.2.0 Roel M. Hogervorst 11M Create Badges for 'Tr...
## 9 11 pROC 1.15.3 Xavier Robin 4M Display and Analyze R...
## 10 10 FNN 1.1.3 Shengqiao Li 9M Fast Nearest Neighbor...
R-bloggers.com offers daily e-mail updates about R news and tutorials about learning R and many other topics. Click here if you're looking to post or find an R/data-science job.
Want to share your content on R-bloggers? click here if you have a blog, or here if you don't.