The hardware and bandwidth for this mirror is donated by METANET, the Webhosting and Full Service-Cloud Provider.
If you wish to report a bug, or if you are interested in having us mirror your free-software or open-source project, please feel free to contact us at mirror[@]metanet.ch.

Receptiviti

An R package to process text with the Receptiviti API.

A Python package is also available at Receptiviti/receptiviti-python.

Installation

Download R from r-project.org, then install the package from an R console:

Release (version 0.1.8)

install.packages("receptiviti")

Development (version 0.1.9)

# install.packages("remotes")
remotes::install_github("Receptiviti/receptiviti-r")

And load the package:

library(receptiviti)

Features

• Makes requests to the Receptiviti API, working around size and rate limitations.
• Avoids sending invalid or identical texts, or repeating requests in the same session.
• Optionally builds up a local database of returned results to avoid making repeat requests in the longer-term.

Examples

# score a single text
single <- receptiviti("a text to score")

# score multiple texts, and write results to a file
multi <- receptiviti(c("first text to score", "second text"), "filename.csv")

# score texts in separate files
## defaults to look for .txt files
file_results <- receptiviti(dir = "./path/to/txt_folder")

## could be .csv
file_results <- receptiviti(
  dir = "./path/to/csv_folder",
  text_column = "text", file_type = "csv"
)

# score texts in a single file
results <- receptiviti("./path/to/file.csv", text_column = "text")

API Access

To access the API, you will need to load your key and secret, as found on your dashboard.

You can enter these as arguments in each function call, but by default they will be looked for in these environment variables:

RECEPTIVITI_KEY="32lettersandnumbers"
RECEPTIVITI_SECRET="56LettersAndNumbers"

You can store these in your R environment file permanently:

# opens ~/.Renviron; after editing, save and restart R
usethis::edit_r_environ()

Or set them temporarily:

Sys.setenv(
  RECEPTIVITI_KEY = "32lettersandnumbers",
  RECEPTIVITI_SECRET = "56LettersAndNumbers"
)

These binaries (installable software) and packages are in development.
They may not be fully stable and should be used with caution. We make no claims about them.