diff --git a/DESCRIPTION b/DESCRIPTION index 5117179..b13adce 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -1,6 +1,6 @@ Package: searcher Title: Query Search Interfaces -Version: 0.0.6 +Version: 0.0.7 Authors@R: c( person("James", "Balamuta", email = "balamut2@illinois.edu", diff --git a/NEWS.md b/NEWS.md index 9a3dab9..aeae878 100644 --- a/NEWS.md +++ b/NEWS.md @@ -4,11 +4,10 @@ - Added search portals: - `search_grep()`: Searches on grep.app. - ([#35](https://github.com/r-assist/searcher/issues/35), - [#37](https://github.com/r-assist/searcher/pull/37)) + ([#35](https://github.com/coatless-rpkg/searcher/issues/35), + [#37](https://github.com/coatless-rpkg/searcher/pull/37)) - `search_qwant()`: Searches on Qwant. - ([#36](https://github.com/r-assist/searcher/issues/36), - [#38](https://github.com/r-assist/searcher/pull/38)) + ([#36](https://github.com/coatless-rpkg/searcher/issues/36)) # searcher 0.0.6 @@ -16,10 +15,10 @@ - Added search portals: - `search_ecosia()`: Searches on Ecosia. - ([#31](https://github.com/r-assist/searcher/issues/31), - [#32](https://github.com/r-assist/searcher/pull/32)) + ([#31](https://github.com/coatless-rpkg/searcher/issues/31), + [#32](https://github.com/coatless-rpkg/searcher/pull/32)) - `search_rseek()`: Searches on [rseek](https://rseek.org/). - ([#32](https://github.com/r-assist/searcher/pull/33), thanks [@rossellhayes](https://github.com/rossellhayes)!) + ([#32](https://github.com/coatless-rpkg/searcher/pull/33), thanks [@rossellhayes](https://github.com/rossellhayes)!) ## Bug Fixes @@ -29,20 +28,20 @@ ## Deployment - Updated [GitHub Actions for R](https://github.com/r-lib/actions) workflows - ([#34](https://github.com/r-assist/searcher/pull/34)). -- Added pkgdown website ([#34](https://github.com/r-assist/searcher/pull/34)). + ([#34](https://github.com/coatless-rpkg/searcher/pull/34)). +- Added pkgdown website ([#34](https://github.com/coatless-rpkg/searcher/pull/34)). # searcher 0.0.5 ## Features - Added search portal: - - `search_twitter()`: Searches on [Twitter](https://twitter.com/search). - ([#19](https://github.com/r-assist/searcher/issues/19), - [#30](https://github.com/r-assist/searcher/pull/30)) + - `search_twitter()`: Searches on Twitter. + ([#19](https://github.com/coatless-rpkg/searcher/issues/19), + [#30](https://github.com/coatless-rpkg/searcher/pull/30)) - Added ability to set default package actions. - ([#7](https://github.com/r-assist/searcher/issues/7), - [#20](https://github.com/r-assist/searcher/pull/20)) + ([#7](https://github.com/coatless-rpkg/searcher/issues/7), + [#20](https://github.com/coatless-rpkg/searcher/pull/20)) - `searcher.launch_delay` controls how long the user remains in _R_ prior to the browser opening. Default is `0.5` seconds. - `searcher.use_rstudio_viewer` specifies whether RStudio's viewer pane should @@ -52,8 +51,8 @@ between either `"base"` or `"tidyverse"`. Default is `"base"`. - Added option to launch RStudio's Viewer pane to display search results. - Note: This feature requires a patch per [rstudio/rstudio#2252](https://github.com/rstudio/rstudio/issues/2252). - ([#21](https://github.com/r-assist/searcher/issues/21), - [#22](https://github.com/r-assist/searcher/pull/22)) + ([#21](https://github.com/coatless-rpkg/searcher/issues/21), + [#22](https://github.com/coatless-rpkg/searcher/pull/22)) ## Breaking Changes @@ -68,11 +67,11 @@ ## Deployment -- Switched from using [TravisCI](http://travis-ci.com/) to using +- Switched from using [TravisCI](https://www.travis-ci.com/) to using [GitHub Actions for R](https://github.com/r-lib/actions). - ([#25](https://github.com/r-assist/searcher/issues/25), - [#27](https://github.com/r-assist/searcher/pull/27)) -- Improved code coverage of unit tests ([#29](https://github.com/r-assist/searcher/pull/29)) + ([#25](https://github.com/coatless-rpkg/searcher/issues/25), + [#27](https://github.com/coatless-rpkg/searcher/pull/27)) +- Improved code coverage of unit tests ([#29](https://github.com/coatless-rpkg/searcher/pull/29)) # searcher 0.0.4 diff --git a/R/search-functions.R b/R/search-functions.R index d6c0146..f275cf1 100644 --- a/R/search-functions.R +++ b/R/search-functions.R @@ -173,7 +173,7 @@ searcher = function(site, keyword = getOption("searcher.default_keyword")) { #' The `search_google` function searches [Google](https://www.google.com/) using: #' `https://www.google.com/search?q=` #' -#' See \url{https://moz.com/blog/the-ultimate-guide-to-the-google-search-parameters} +#' See \url{https://moz.com/learn/seo/search-operators} #' for details. search_google = searcher("google") @@ -208,10 +208,6 @@ search_ixquick = function(query = geterrmessage(), rlang = TRUE) { #' The `search_startpage()` function searches #' [startpage](https://startpage.com) using: #' \code{https://startpage.com/do/dsearch?query=} -#' -#' For additional details regarding [startpage](https://startpage.com)'s -#' search interface please see: -#' \url{https://support.startpage.com/index.php?/Knowledgebase/Article/View/1261/0/add-familystartpagecom-as-the-default-search-engine-in-chrome} search_startpage = searcher("sp") #' @rdname search_site @@ -227,7 +223,7 @@ search_sp = search_startpage #' #' For additional details regarding Ecosia's #' search interface please see: -#' \url{https://ecosia.zendesk.com/hc/en-us} +#' \url{https://ecosia.helpscoutdocs.com/article/502-ecosia-on-desktop} search_ecosia = searcher("ecosia") #' @rdname search_site @@ -241,7 +237,7 @@ search_rseek = searcher("rseek") #' @export #' @section Qwant Search: #' The `search_qwant()` function searches -#' [Qwant](https://qwant.com) using: `https://www.qwant.com/?q=` +#' Qwant using: `https://www.qwant.com/?q=` search_qwant = searcher("qwant") ########################### End Search Engines @@ -270,12 +266,12 @@ search_rscom = search_rstudio_community #' @export #' @section Twitter Search: #' The `search_twitter()` functions search -#' [Twitter](https://twitter.com/) using: +#' Twitter using: #' \code{https://twitter.com/search?q=} #' -#' For additional details regarding [Twitter](https://twitter.com/)'s +#' For additional details regarding Twitter's #' search interface please see: -#' \url{https://help.twitter.com/en/using-twitter/twitter-advanced-search} +#' `https://help.twitter.com/en/using-x/x-advanced-search` search_twitter = searcher("twitter") #' @rdname search_site @@ -287,7 +283,7 @@ search_twitter = searcher("twitter") #' #' For additional details regarding [StackOverflow](https://stackoverflow.com)'s #' search interface please see: -#' \url{https://stackoverflow.com/help/advanced-search-parameters-jobs} +#' `https://stackoverflow.com/help/searching` search_stackoverflow = searcher("so") #' @rdname search_site @@ -307,8 +303,8 @@ search_so = search_stackoverflow #' #' For additional details regarding [GitHub](https://github.com)'s #' search interface please see: -#' \url{https://help.github.com/categories/searching-for-information-on-github/} -#' and \url{https://help.github.com/articles/searching-code/} +#' +#' and search_github = searcher("gh") #' @rdname search_site diff --git a/README.Rmd b/README.Rmd index f7532f8..50616bd 100644 --- a/README.Rmd +++ b/README.Rmd @@ -18,7 +18,6 @@ knitr::opts_chunk$set( [![R-CMD-check](https://github.com/coatless-rpkg/searcher/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/coatless-rpkg/searcher/actions/workflows/R-CMD-check.yaml) [![CRAN RStudio mirror downloads](https://cranlogs.r-pkg.org/badges/searcher)](https://www.r-pkg.org/pkg/searcher) [![CRAN\_Status\_Badge](https://www.r-pkg.org/badges/version/searcher)](https://cran.r-project.org/package=searcher) -[![Codecov test coverage](https://codecov.io/gh/coatless-rpkg/searcher/branch/master/graph/badge.svg)](https://codecov.io/gh/coatless-rpkg/searcher?branch=master) The goal of `searcher` is to provide a search interface directly inside of _R_. @@ -64,7 +63,7 @@ The `search_*()` functions can be used to search a query directly from _R_ on major search engines, programming help websites, and code repositories. The following search platforms are supported: [Google](https://www.google.com), [Bing](https://www.bing.com/), [DuckDuckGo](https://duckduckgo.com/), [Startpage](https://www.startpage.com/en/), -Ecosia, [rseek](https://rseek.org/), [Qwant](https://qwant.com/), [Twitter](https://twitter.com/search), [StackOverflow](https://stackoverflow.com/search), +Ecosia, [rseek](https://rseek.org/), Qwant, X (formerly Twitter), [StackOverflow](https://stackoverflow.com/), [RStudio Community](https://community.rstudio.com/search), [GitHub](https://github.com/search), [grep.app](https://grep.app/), and [BitBucket](https://bitbucket.org/product/). @@ -210,21 +209,21 @@ contains a robust way to automatically searching errors and warnings. ### Publicity -On the [`#rstats`-twitter verse](https://twitter.com/search?q=%23rstats), `searcher` has been positively received by +On the `#rstats`-twitter verse (c.f. `https://twitter.com/search?q=%23rstats`), `searcher` has been positively received by community members. > R package "searcher" that automatically searches Stackoverflow for error that > you just saw in the console. Cool package, especially for those who learn R :) > https://github.com/coatless-rpkg/searcher ... #r #rlang #rstats #rstudio > -> --- [Paweł Przytuła](https://twitter.com/pawel_appsilon/status/1109545516264841216) +> --- Paweł Przytuła > March 23th, 2019. ~292 Retweets and 876 likes (Note, URL updated to new repository location.) > Did you know, using "searcher" package, you could automatically to > search stackoverflow, google, GitHub and many more sites for errors, > packages or topics. #rstats > -> --- [Shakirah Nakalungi](https://twitter.com/cynthia_kyra) June 29th, 2019, when she was [Rotating Curator for the "We are R-Ladies" twitter account](https://twitter.com/WeAreRLadies/status/1144921174251581440). +> --- Shakirah Nakalungi (c.f. `https://twitter.com/cynthia_kyra`) June 29th, 2019, when she was Rotating Curator for the "We are R-Ladies" twitter account (c.f. `https://twitter.com/WeAreRLadies/status/1144921174251581440`) > ~144 Retweets and 544 likes Please let us know via an [issue ticket](https://github.com/coatless-rpkg/searcher/issues/new) diff --git a/README.md b/README.md index ac5d777..9b7d0e0 100644 --- a/README.md +++ b/README.md @@ -9,8 +9,6 @@ [![CRAN RStudio mirror downloads](https://cranlogs.r-pkg.org/badges/searcher)](https://www.r-pkg.org/pkg/searcher) [![CRAN_Status_Badge](https://www.r-pkg.org/badges/version/searcher)](https://cran.r-project.org/package=searcher) -[![Codecov test -coverage](https://codecov.io/gh/coatless-rpkg/searcher/branch/master/graph/badge.svg)](https://codecov.io/gh/coatless-rpkg/searcher?branch=master) The goal of `searcher` is to provide a search interface directly inside @@ -59,10 +57,10 @@ repositories. The following search platforms are supported: [Google](https://www.google.com), [Bing](https://www.bing.com/), [DuckDuckGo](https://duckduckgo.com/), [Startpage](https://www.startpage.com/en/), Ecosia, -[rseek](https://rseek.org/), [Twitter](https://twitter.com/search), -[StackOverflow](https://stackoverflow.com/search), [RStudio +[rseek](https://rseek.org/), Qwant, X (formerly Twitter), +[StackOverflow](https://stackoverflow.com/), [RStudio Community](https://community.rstudio.com/search), -[GitHub](https://github.com/search), and +[GitHub](https://github.com/search), [grep.app](https://grep.app/), and [BitBucket](https://bitbucket.org/product/). By default, an appropriate suffix for each platform that ensures relevant results to *R* is appended to all queries. This behavior can be disabled by using @@ -74,6 +72,7 @@ search_google("R project") search_bing("R project") search_ecosia("R project") search_rseek("R project") +search_qwant("R project") search_duckduckgo("R project") # or search_ddg(...) search_startpage("R project") # or search_sp(...) @@ -89,6 +88,10 @@ search_stackoverflow("linear regression", rlang = FALSE) # or search_so(...) search_rstudio_community("tips") search_rstudio_community("tips", rlang = FALSE) # or search_rscom(...) +# Searching GitHub code for graphs in R and other languages +search_grep("graph") +search_grep("graph", rlang = FALSE) + # Searching GitHub Issues for maps in R and other languages search_github("maps") search_github("maps", rlang = FALSE) # or search_gh(...) @@ -135,7 +138,9 @@ search_google() search_bing() search_ecosia() search_rseek() +search_qwant() search_twitter() +search_grep() search_duckduckgo() # or search_ddg() search_startpage() # or search_sp() search_stackoverflow() # or search_so() @@ -209,8 +214,8 @@ a robust way to automatically searching errors and warnings. ### Publicity -On the [`#rstats`-twitter -verse](https://twitter.com/search?q=%23rstats), `searcher` has been +On the `#rstats`-twitter verse (c.f. +`https://twitter.com/search?q=%23rstats`), `searcher` has been positively received by community members. > R package “searcher” that automatically searches Stackoverflow for @@ -218,19 +223,18 @@ positively received by community members. > those who learn R :) … \#r > \#rlang \#rstats \#rstudio > -> — [Paweł -> Przytuła](https://twitter.com/pawel_appsilon/status/1109545516264841216) -> March 23th, 2019. ~292 Retweets and 876 likes (Note, URL updated to -> new repository location.) +> — Paweł Przytuła March 23th, 2019. ~292 Retweets and 876 likes (Note, +> URL updated to new repository location.) > Did you know, using “searcher” package, you could automatically to > search stackoverflow, google, GitHub and many more sites for errors, > packages or topics. \#rstats > -> — [Shakirah Nakalungi](https://twitter.com/cynthia_kyra) June 29th, -> 2019, when she was [Rotating Curator for the “We are R-Ladies” twitter -> account](https://twitter.com/WeAreRLadies/status/1144921174251581440). -> ~144 Retweets and 544 likes +> — Shakirah Nakalungi (c.f. `https://twitter.com/cynthia_kyra`) June +> 29th, 2019, when she was Rotating Curator for the “We are R-Ladies” +> twitter account (c.f. +> `https://twitter.com/WeAreRLadies/status/1144921174251581440`) ~144 +> Retweets and 544 likes Please let us know via an [issue ticket](https://github.com/coatless-rpkg/searcher/issues/new) about how diff --git a/man/search_site.Rd b/man/search_site.Rd index ef40802..3daf552 100644 --- a/man/search_site.Rd +++ b/man/search_site.Rd @@ -94,7 +94,7 @@ up the resulting page in a web browser. The \code{search_google} function searches \href{https://www.google.com/}{Google} using: \verb{https://www.google.com/search?q=} -See \url{https://moz.com/blog/the-ultimate-guide-to-the-google-search-parameters} +See \url{https://moz.com/learn/seo/search-operators} for details. } @@ -115,10 +115,6 @@ The \code{search_duckduckgo()} and \code{search_ddg()} functions both search The \code{search_startpage()} function searches \href{https://startpage.com}{startpage} using: \code{https://startpage.com/do/dsearch?query=} - -For additional details regarding \href{https://startpage.com}{startpage}'s -search interface please see: -\url{https://support.startpage.com/index.php?/Knowledgebase/Article/View/1261/0/add-familystartpagecom-as-the-default-search-engine-in-chrome} } \section{Ecosia Search}{ @@ -129,7 +125,7 @@ Ecosia using: For additional details regarding Ecosia's search interface please see: -\url{https://ecosia.zendesk.com/hc/en-us} +\url{https://ecosia.helpscoutdocs.com/article/502-ecosia-on-desktop} } \section{Rseek Search}{ @@ -141,7 +137,7 @@ The \code{search_rseek()} function searches \href{https://rseek.org}{Rseek} usin \section{Qwant Search}{ The \code{search_qwant()} function searches -\href{https://qwant.com}{Qwant} using: \verb{https://www.qwant.com/?q=} +Qwant using: \verb{https://www.qwant.com/?q=} } \section{RStudio Community Search}{ @@ -158,12 +154,12 @@ search interface please see the \href{https://discourse.org}{Discourse} API docu \section{Twitter Search}{ The \code{search_twitter()} functions search -\href{https://twitter.com/}{Twitter} using: +Twitter using: \code{https://twitter.com/search?q=} -For additional details regarding \href{https://twitter.com/}{Twitter}'s +For additional details regarding Twitter's search interface please see: -\url{https://help.twitter.com/en/using-twitter/twitter-advanced-search} +\verb{https://help.twitter.com/en/using-x/x-advanced-search} } \section{StackOverflow Search}{ @@ -174,7 +170,7 @@ The \code{search_stackoverflow()} and \code{search_so()} functions both search For additional details regarding \href{https://stackoverflow.com}{StackOverflow}'s search interface please see: -\url{https://stackoverflow.com/help/advanced-search-parameters-jobs} +\verb{https://stackoverflow.com/help/searching} } \section{GitHub Search}{ @@ -185,8 +181,8 @@ The \code{search_github()} and \code{search_gh()} functions both search For additional details regarding \href{https://github.com}{GitHub}'s search interface please see: -\url{https://help.github.com/categories/searching-for-information-on-github/} -and \url{https://help.github.com/articles/searching-code/} +\url{https://docs.github.com/en/enterprise-cloud@latest/search-github/getting-started-with-searching-on-github/about-searching-on-github} +and \url{https://docs.github.com/en/search-github/searching-on-github/searching-code/} } \section{grep.app Search}{ diff --git a/vignettes/search-patterns.Rmd b/vignettes/search-patterns.Rmd index 919da29..4e29b73 100644 --- a/vignettes/search-patterns.Rmd +++ b/vignettes/search-patterns.Rmd @@ -63,8 +63,8 @@ _R_-specific results. If `rlang = FALSE`, then the results are generalized. - `"r programming"` was selected because it performed best when compared to `"rlang"`, `"rstats"`, and `"r language"` on [Google Trends](https://trends.google.com/trends/). - Community Sites - - [StackOverflow Search](https://stackoverflow.com/search): ` + [r]` - - [Twitter](https://twitter.com/search): ` + #rstats` + - [StackOverflow](https://stackoverflow.com/): ` + [r]` + - Twitter: ` + #rstats` - [RStudio Community](https://community.rstudio.com/search): `` - [Rseek](https://rseek.org/): `` - Code Repositories @@ -89,5 +89,5 @@ To improve your _R_-related search query, it has been suggested to use: Suggestions here were pooled from discussion on rOpenSci's slack with [Steph Locke](https://itsalocke.com/blog/) and -[Robert Mitchell](http://robertmitchellv.com/). +[Robert Mitchell](https://robertmitchellv.com/).