rfoaas (version 1.1.1)

rfoaas-package: R Interface to FOAAS

Description

The FOAAS service is provided as a modern, RESTful, scalable solution. This package provides an R interface.

Usage

off(name, from, filter, language)
  you(name, from, filter, language)
  this(from, filter, language)
  that(from, filter, language)
  everything(from, filter, language)
  everyone(from, filter, language)
  donut(name, from, filter, language)
  shakespeare(name, from, filter, language)
  linus(name, from, filter, language)
  king(name, from, filter, language)
  pink(name, filter, language)
  life(name, filter, language)
  chainsaw(name, from, filter, language)
  outside(name, from, filter, language)
  thanks(from, filter, language)
  fascinating(from, filter, language)
  madison(name, from, filter, language)
  cool(from, filter, language)
  field(name, from, reference, filter, language)
  nugget(name, from, filter, language)
  yoda(name, from, filter, language)
  ballmer(name, company, from, filter, language)
  what(from, filter, language)
  because(from, filter, language)
  caniuse(tool, from, filter, language)
  bye(from, filter, language)
  diabetes(from, filter, language)
  bus(from, filter, language)
  xmas(name, from, filter, language)
  awesome(from, filter, language)
  tucker(from, filter, language)
  bucket(from, filter, language)
  bday(name, from, filter, language)
  family_(from, filter, language)
  shutup(name, from, filter, language)
  zayn(from, filter, language)
  keepcalm(reaction, from, filter, language)
  dalton(name, from, filter, language)
  dosomething(do, something, from, filter, language)

  retard(from, filter, language)
  thumbs(name, from, filter, language)
  back(name, from, filter, language)
  bm(name, from, filter, language)
  gfy(name, from, filter, language)
  greed(something, from, filter, language)
  me(from, filter, language)
  mornin(from, filter, language)
  think(name, from, filter, language)
  keep(name, from, filter, language)
  single_(from, filter, language)
  look(name, from, filter, language)
  looking(from, filter, language)
  no(from, filter, language)
  give(from, filter, language)
  zero(from, filter, language)
  pulp(name, from, filter, language)
  sake(from, filter, language)
  anyway(name, from, filter, language)
  maybe(from, filter, language)
  blackadder(name, from, filter, language)
  horse(from, filter, language)
  deraadt(name, from, filter, language)
  problem(name, from, filter, language)
  cocksplat(name, from, filter, language)
  too(from, filter, language)
  thing(name, from, filter, language)
  asshole(from, filter, language)
  cup(from, filter, language)
  fyyff(from, filter, language)
  immensity(from, filter, language)
  programmer(from, filter, language)
  rtfm(from, filter, language)
  thinking(name, from, filter, language)
  getRandomFO(name, from, filter, language)

version() operations()

# S3 method for rfoaas print(x, width = NULL, ...)

Arguments

name

The name to whom the message is directed.

from

The name of the message requester. If omitted, the value of the (optional) global variable ‘rfoaasFrom’ is used, and if that variable is missing or unset, a default is filled-in based on the user name obtained via Sys.info.

filter

An optional filter. If unset, the (optional) global variable ‘rfoaasFilter’ can provide a default, and a fallback value of ‘none’. Currently the only other permitted value is ‘shoutcloud’ to enable filtering via the magnificient http://shoutcloud.io service.

language

An optional filter argument. If set, the message is internationalized to the given (optional) language stated as the the usual two-character code such as ‘fr’, ‘de’, ‘es’.

reference

An additional referenced in the message.

company

A company referenced in the message.

tool

A company referenced in the message.

do

A activity referenced in the message.

something

An object referenced in the message.

reaction

An activity referenced in the message.

x

Default object for print method

width

Optional column width parameter

...

Other optional arguments

Value

For all (but one) queries, a text string with the request FOAAS message is returned.

The exception is the very last query listed: operations() returns a JSON object describing all queries currently supported by the API, along with their (descriptive) name, the URL and the supported fields. As the return object is in JSON, one the available JSON parsers implementing a fromJSON() method is recommended to convert it into a native R object.

Return values are set to the UTF-8 encoding as the FOAAS service defaults using UTF-8 strings. Anectodatally, this seems to help only on the Windows operating system as the other already handled UTF-8 correctly.

Details

The operations() query returns a JSON object describing the current API. The version() function returns the current API version (as text). All other methods return the requested FOAAS message using the given arguments.

See http://foaas.com for complete service details at the current API level.

At present, only plain text requests are made and returned (with one exception being operations(), see above).

The from argument uses an internal helper function to supply a default value: either an R options() variable accessible via the key rfoaasFrom, or the value of Sys.info()["user"] as fallback.

The filter argument uses an internal helper function to supply a default value: either an R options() variable accessible via the key rfoaasFilter, or a default of ‘none’. Currently, the only other permissible value is ‘shoutcloud’ to enable filtering via the magnificient http://shoutcloud.io service.

Examples

Run this code
# NOT RUN {
                   # as we need a needwork connection

    ## returns current API version
    version()

    ## example 'madison' accessor in API
    madison("Billy", "Eric")

    ## operations() returns JSON object listing the accessible functionality
    if (require(jsonlite)) print(fromJSON(operations()))

    
# }

Run the code above in your browser using DataCamp Workspace