diff --git a/NAMESPACE b/NAMESPACE index b2e3c0f..dbd2589 100644 --- a/NAMESPACE +++ b/NAMESPACE @@ -26,10 +26,10 @@ export(search_google) export(search_grep) export(search_ixquick) export(search_kagi) +export(search_posit) +export(search_posit_community) export(search_qwant) -export(search_rscom) export(search_rseek) -export(search_rstudio_community) export(search_site) export(search_so) export(search_sp) diff --git a/NEWS.md b/NEWS.md index 33d3dcc..b48f175 100644 --- a/NEWS.md +++ b/NEWS.md @@ -9,7 +9,7 @@ - `ask_mistral()`: Searches with Mistral AI - `ask_copilot()`: Searches with Microsoft Bing's Copilot - `ask_meta_ai()`: Searches with Meta AI -- Added an AI Prompt Management System with Persona Prompts +- Added an AI Prompt Management System with Persona Prompts: - `ai_prompt()`: Set a prompt for the AI - `ai_prompt_active()`: View the active prompt - `ai_prompt_clear()`: Clear the active prompt @@ -26,6 +26,11 @@ ([#42](https://github.com/coatless-rpkg/searcher/pull/42)) - Added searcher logo ([#40](https://github.com/coatless-rpkg/searcher/pull/40)) +## Deprecations + +- Deprecated `search_rstudio_community()` and `search_rscom()` functions. ([#43](https://github.com/coatless-rpkg/searcher/pull/43)) + - These functions are now replaced by `search_posit_community()`/`search_posit()` + which searches [Posit Community](https://community.posit.co/search). # searcher 0.0.7 @@ -107,7 +112,7 @@ ## Features - Added search portal: - - `search_rstudio_community()` or `search_rscom()`: Searches on [RStudio Community](https://community.rstudio.com/search). + - `search_rstudio_community()` or `search_rscom()`: Searches on RStudio Community. (#13, #17) - Added vignette on search patterns (#18). diff --git a/R/index-sites.R b/R/index-sites.R index 98c4ba9..a167c2e 100644 --- a/R/index-sites.R +++ b/R/index-sites.R @@ -60,9 +60,9 @@ site_index = keyword_entry("[r]", "[tidyverse]") ), site_entry( - "rstudio community", - "https://community.rstudio.com/search?q=", - "rscom", + "posit community", + "https://community.posit.co/search?q=", + "posit", NULL ), site_entry( diff --git a/R/search-functions.R b/R/search-functions.R index c351a05..d069e34 100644 --- a/R/search-functions.R +++ b/R/search-functions.R @@ -5,7 +5,8 @@ #' #' @param site Name of site to search on. Supported options: #' `"google"` (default), `"bing"`, `"duckduckgo"`, `"startpage"`, -#' `"qwant"`,`"rstudio community"`, `"twitter"`,`"stackoverflow"`, +#' `"qwant"`,`"posit community"`, `"brave"`, `"kagi"`, +#' `"twitter"`, `"stackoverflow"`, #' `"github"`, `"grep"`, and `"bitbucket"`. #' @param query Contents of string to search. Default is the error message. #' @param rlang Search for results written in R. Default is `TRUE` @@ -20,7 +21,7 @@ #' @seealso [search_google()], [search_bing()], [search_duckduckgo()], #' [search_startpage()], [search_rseek()], [search_qwant()], #' [search_brave()], [search_kagi()], [search_twitter()], -#' [search_rstudio_community()], [search_stackoverflow()], +#' [search_posit_community()], [search_stackoverflow()], #' [search_github()], [search_grep()], [search_bitbucket()], and [searcher()] #' @examples #' # Search in a generic way @@ -47,8 +48,8 @@ #' # Search Brave #' search_brave("webR") #' -#' # Search RStudio Community -#' search_rstudio_community("RStudio IDE") +#' # Search Posit Community +#' search_posit_community("RStudio IDE") #' #' # Search Twitter #' search_twitter("searcher") @@ -91,8 +92,8 @@ search_site = function(query, "rseek", "brave", "kagi", - "rstudio community", - "rscom", + "posit community", + "posit", "twitter", "stackoverflow", "so", @@ -127,8 +128,8 @@ search_site = function(query, rseek = search_rseek(query, rlang), brave = search_brave(query, rlang), kagi = search_kagi(query, rlang), - `rstudio community` = , # empty case carried below - rscom = search_rstudio_community(query, rlang), + `posit community` = , # empty case carried below + posit = search_posit_community(query, rlang), twitter = search_twitter(query, rlang), stackoverflow = , # empty case carried below so = search_stackoverflow(query, rlang), @@ -252,7 +253,7 @@ search_sp = search_startpage #' #' For additional details regarding Ecosia's #' search interface please see: -#' \url{https://ecosia.helpscoutdocs.com/article/502-ecosia-on-desktop} +#' \url{https://support.ecosia.org/article/657-installing-ecosia-on-your-desktop-device} search_ecosia = searcher("ecosia") #' @rdname search_site @@ -294,19 +295,19 @@ search_kagi = searcher("kagi") #' @rdname search_site #' @export -#' @section RStudio Community Search: -#' The `search_rstudio_community()` and `search_rscom()` functions both search -#' [RStudio Community](https://community.rstudio.com/) using: -#' \code{https://community.rstudio.com/search?q=} +#' @section Posit Community Search: +#' The `search_posit_community()` and `search_posit()` functions both search +#' [Posit Community](https://forum.posit.co/) using: +#' \code{https://forum.posit.co/search?q=} #' -#' For additional details regarding [RStudio Community](https://community.rstudio.com/)'s +#' For additional details regarding [Posit Community](https://forum.posit.co/)'s #' search interface please see the [Discourse](https://discourse.org) API documentation: #' \url{https://docs.discourse.org/#tag/Search} -search_rstudio_community = searcher("rscom") +search_posit_community = searcher("posit") #' @rdname search_site #' @export -search_rscom = search_rstudio_community +search_posit = search_posit_community #' @rdname search_site #' @export diff --git a/README.Rmd b/README.Rmd index fb48a43..14b22e0 100644 --- a/README.Rmd +++ b/README.Rmd @@ -65,7 +65,7 @@ platforms are supported: [Google](https://www.google.com), [Bing](https://www.bi [DuckDuckGo](https://duckduckgo.com/), [Startpage](https://www.startpage.com/en/), Ecosia, [rseek](https://rseek.org/), Qwant, [Brave](https://search.brave.com/), Kagi, X (formerly Twitter), [StackOverflow](https://stackoverflow.com/), -[RStudio Community](https://community.rstudio.com/search), +[Posit Community](https://community.posit.co/search), [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 @@ -92,9 +92,9 @@ search_twitter("machine learning", rlang = FALSE) search_stackoverflow("linear regression") search_stackoverflow("linear regression", rlang = FALSE) # or search_so(...) -# Searching RStudio Community for tips -search_rstudio_community("tips") -search_rstudio_community("tips", rlang = FALSE) # or search_rscom(...) +# Searching Posit Community for tips +search_posit_community("tips") +search_posit_community("tips", rlang = FALSE) # or search_posit(...) # Searching GitHub code for graphs in R and other languages search_grep("graph") @@ -188,7 +188,7 @@ search_grep() search_duckduckgo() # or search_ddg() search_startpage() # or search_sp() search_stackoverflow() # or search_so() -search_rstudio_community() # or search_rscom() +search_posit_community() # or search_posit() search_github() # or search_gh() search_bitbucket() # or search_bb() ``` diff --git a/README.md b/README.md index b6eca28..fd3e96c 100644 --- a/README.md +++ b/README.md @@ -60,7 +60,7 @@ repositories. The following search platforms are supported: [Startpage](https://www.startpage.com/en/), Ecosia, [rseek](https://rseek.org/), Qwant, [Brave](https://search.brave.com/), Kagi, X (formerly Twitter), [StackOverflow](https://stackoverflow.com/), -[RStudio Community](https://community.rstudio.com/search), +[Posit Community](https://community.posit.co/search), [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 @@ -87,9 +87,9 @@ search_twitter("machine learning", rlang = FALSE) search_stackoverflow("linear regression") search_stackoverflow("linear regression", rlang = FALSE) # or search_so(...) -# Searching RStudio Community for tips -search_rstudio_community("tips") -search_rstudio_community("tips", rlang = FALSE) # or search_rscom(...) +# Searching Posit Community for tips +search_posit_community("tips") +search_posit_community("tips", rlang = FALSE) # or search_posit(...) # Searching GitHub code for graphs in R and other languages search_grep("graph") @@ -186,7 +186,7 @@ search_grep() search_duckduckgo() # or search_ddg() search_startpage() # or search_sp() search_stackoverflow() # or search_so() -search_rstudio_community() # or search_rscom() +search_posit_community() # or search_posit() search_github() # or search_gh() search_bitbucket() # or search_bb() ``` diff --git a/man/search_site.Rd b/man/search_site.Rd index dec481e..5496ee2 100644 --- a/man/search_site.Rd +++ b/man/search_site.Rd @@ -14,8 +14,8 @@ \alias{search_qwant} \alias{search_brave} \alias{search_kagi} -\alias{search_rstudio_community} -\alias{search_rscom} +\alias{search_posit_community} +\alias{search_posit} \alias{search_twitter} \alias{search_stackoverflow} \alias{search_so} @@ -29,7 +29,7 @@ search_site( query, site = c("google", "bing", "duckduckgo", "ddg", "startpage", "sp", "qwant", "rseek", - "brave", "kagi", "rstudio community", "rscom", "twitter", "stackoverflow", "so", + "brave", "kagi", "posit community", "posit", "twitter", "stackoverflow", "so", "github", "gh", "grep", "bitbucket", "bb", "chatgpt", "claude", "perplexity", "mistral", "bing copilot", "copilot", "meta ai", "meta"), rlang = TRUE, @@ -60,9 +60,9 @@ search_brave(query = geterrmessage(), rlang = TRUE) search_kagi(query = geterrmessage(), rlang = TRUE) -search_rstudio_community(query = geterrmessage(), rlang = TRUE) +search_posit_community(query = geterrmessage(), rlang = TRUE) -search_rscom(query = geterrmessage(), rlang = TRUE) +search_posit(query = geterrmessage(), rlang = TRUE) search_twitter(query = geterrmessage(), rlang = TRUE) @@ -85,7 +85,8 @@ search_bb(query = geterrmessage(), rlang = TRUE) \item{site}{Name of site to search on. Supported options: \code{"google"} (default), \code{"bing"}, \code{"duckduckgo"}, \code{"startpage"}, -\code{"qwant"},\code{"rstudio community"}, \code{"twitter"},\code{"stackoverflow"}, +\code{"qwant"},\code{"posit community"}, \code{"brave"}, \code{"kagi"}, +\code{"twitter"}, \code{"stackoverflow"}, \code{"github"}, \code{"grep"}, and \code{"bitbucket"}.} \item{rlang}{Search for results written in R. Default is \code{TRUE}} @@ -136,7 +137,7 @@ Ecosia using: For additional details regarding Ecosia's search interface please see: -\url{https://ecosia.helpscoutdocs.com/article/502-ecosia-on-desktop} +\url{https://support.ecosia.org/article/657-installing-ecosia-on-your-desktop-device} } \section{Rseek Search}{ @@ -166,13 +167,13 @@ This is a paid search engine, and you will need to sign up for an account to use it. } -\section{RStudio Community Search}{ +\section{Posit Community Search}{ -The \code{search_rstudio_community()} and \code{search_rscom()} functions both search -\href{https://community.rstudio.com/}{RStudio Community} using: -\code{https://community.rstudio.com/search?q=} +The \code{search_posit_community()} and \code{search_posit()} functions both search +\href{https://forum.posit.co/}{Posit Community} using: +\code{https://forum.posit.co/search?q=} -For additional details regarding \href{https://community.rstudio.com/}{RStudio Community}'s +For additional details regarding \href{https://forum.posit.co/}{Posit Community}'s search interface please see the \href{https://discourse.org}{Discourse} API documentation: \url{https://docs.discourse.org/#tag/Search} } @@ -254,8 +255,8 @@ search_qwant("Quarto") # Search Brave search_brave("webR") -# Search RStudio Community -search_rstudio_community("RStudio IDE") +# Search Posit Community +search_posit_community("RStudio IDE") # Search Twitter search_twitter("searcher") @@ -291,6 +292,6 @@ options(error = search_google) \code{\link[=search_google]{search_google()}}, \code{\link[=search_bing]{search_bing()}}, \code{\link[=search_duckduckgo]{search_duckduckgo()}}, \code{\link[=search_startpage]{search_startpage()}}, \code{\link[=search_rseek]{search_rseek()}}, \code{\link[=search_qwant]{search_qwant()}}, \code{\link[=search_brave]{search_brave()}}, \code{\link[=search_kagi]{search_kagi()}}, \code{\link[=search_twitter]{search_twitter()}}, -\code{\link[=search_rstudio_community]{search_rstudio_community()}}, \code{\link[=search_stackoverflow]{search_stackoverflow()}}, +\code{\link[=search_posit_community]{search_posit_community()}}, \code{\link[=search_stackoverflow]{search_stackoverflow()}}, \code{\link[=search_github]{search_github()}}, \code{\link[=search_grep]{search_grep()}}, \code{\link[=search_bitbucket]{search_bitbucket()}}, and \code{\link[=searcher]{searcher()}} } diff --git a/man/searcher.Rd b/man/searcher.Rd index 827d2f4..6971d1c 100644 --- a/man/searcher.Rd +++ b/man/searcher.Rd @@ -9,7 +9,8 @@ searcher(site, keyword = getOption("searcher.default_keyword")) \arguments{ \item{site}{Name of site to search on. Supported options: \code{"google"} (default), \code{"bing"}, \code{"duckduckgo"}, \code{"startpage"}, -\code{"qwant"},\code{"rstudio community"}, \code{"twitter"},\code{"stackoverflow"}, +\code{"qwant"},\code{"posit community"}, \code{"brave"}, \code{"kagi"}, +\code{"twitter"}, \code{"stackoverflow"}, \code{"github"}, \code{"grep"}, and \code{"bitbucket"}.} \item{keyword}{Opt to search under different default terms.} diff --git a/tests/testthat/test-search-functions.R b/tests/testthat/test-search-functions.R index 54357fb..1bfc4ed 100644 --- a/tests/testthat/test-search-functions.R +++ b/tests/testthat/test-search-functions.R @@ -111,16 +111,16 @@ test_that("Check link generation - kagi", { }) -test_that("Check link generation - RStudio Community", { +test_that("Check link generation - Posit Community", { expect_identical( - search_rscom("toad"), - "https://community.rstudio.com/search?q=toad" + search_posit("toad"), + "https://community.posit.co/search?q=toad" ) expect_identical( - search_rscom("toad", rlang = FALSE), - "https://community.rstudio.com/search?q=toad" + search_posit("toad", rlang = FALSE), + "https://community.posit.co/search?q=toad" ) }) @@ -219,8 +219,8 @@ test_that("Validate selection short name - search_site", { ) expect_identical( - search_site("toad", "rscom", rlang = FALSE), - "https://community.rstudio.com/search?q=toad" + search_site("toad", "posit", rlang = FALSE), + "https://community.posit.co/search?q=toad" ) expect_identical( @@ -288,7 +288,7 @@ test_that("Malformed search query validation", { expect_identical( - search_rscom(""), + search_posit(""), "", "Empty string check if no error messages" ) diff --git a/vignettes/search-patterns.Rmd b/vignettes/search-patterns.Rmd index 4e29b73..c8e2ffe 100644 --- a/vignettes/search-patterns.Rmd +++ b/vignettes/search-patterns.Rmd @@ -65,7 +65,7 @@ _R_-specific results. If `rlang = FALSE`, then the results are generalized. - Community Sites - [StackOverflow](https://stackoverflow.com/): ` + [r]` - Twitter: ` + #rstats` - - [RStudio Community](https://community.rstudio.com/search): `` + - [Posit Community](https://forum.posit.co/search) (formerly RStudio Community): `` - [Rseek](https://rseek.org/): `` - Code Repositories - [GitHub Search](https://github.com/search): ` language:r type:issue`