awsjavasdk: Boilerplate R access to the AWS Java SDK via package:rJava
In awsjavasdk: Boilerplate R Access to the Amazon Web Services ('AWS') Java SDK

# Include badges only when making the github markdown
library(knitr)
if ("github_markdown" %in% knitr::opts_knit$get("rmarkdown.pandoc.to")) {
  cat("
[![License](http://img.shields.io/badge/license-GPL%20%28%3E=%202%29-brightgreen.svg?style=flat)](http://www.gnu.org/licenses/gpl-2.0.html)
[![Travis-CI Build Status](https://travis-ci.org/zapier/awsjavasdk.svg?branch=master)](https://travis-ci.org/zapier/awsjavasdk)
[![CRAN_Status_Badge](http://www.r-pkg.org/badges/version/awsjavasdk)](https://cran.r-project.org/package=awsjavasdk)
[![codecov.io](https://codecov.io/github/zapier/awsjavasdk/coverage.svg?branch=master)](https://codecov.io/github/zapier/awsjavasdk?branch=master)
")
}

knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "README-"
)

Why should I use it?

If you are like most useRs you shouldn't. package:awsjavasdk provides boilerplate access to all of the classes included in the AWS Java SDK (inclusive of 3rd party classes). For most useRs this isn't user friendly enough.

If you are looking for easy access to AWS resoures, this package isn't for you. Right now the best supported option for easy access is, in the author's opinion, provided by cloudyr's aws series of packages (some of which are already on CRAN).

However, if you are feeling limited by the web api exposed by cloudyr, like building things from scratch, or like the 'safety' of directly using an approved AWS SDK, then this package may be for you - but only if you don't mind a shotgun approach. The current version of the package loads all .jars provided by the SDK.

How do I use it?

Before you can load anything, you'll need to install the Java SDK. package:awsjavasdk handles the installation location for you. You just need to manually trigger the installation itself so that this package can be CRAN compliant.

library(awsjavasdk)

# Install the sdk if it hasn't been installed yet
if (!awsjavasdk::aws_sdk_present()) {
  awsjavasdk::install_aws_sdk()
}

Then, you can load all java classes included in the SDK...

awsjavasdk::load_sdk()

From there, you're on your own. :)

E.g.

v <- rJava::J("com.amazonaws.util.VersionInfoUtils")
print(v$getVersion())

How do I get it?

The current version is not on CRAN, but you can fetch an early release of the upcoming build directly from github:

library(devtools)
install_github("zapier/awsjavasdk")
library(awsjavasdk)

Author's Note

This code was inspired by and borrowed in parts from multiple web sources including published code and a blog post by JD Long.

Roadmap

Add support for displaying SDK install location
Add support for installing a new SDK version if available; always load the latest SDK
Add support for listing available SDK versions
Add support for loading a specific SDK version
Add support for listing jars
Add support for loading specific jars