Boilerplate R Access to the Amazon Web Services ('AWS') Java SDK

Provides boilerplate access to all of the classes included in the Amazon Web Services ('AWS') Java Software Development Kit (SDK) via package:'rJava'. According to Amazon, the 'SDK helps take the complexity out of coding by providing Java APIs for many AWS services including Amazon S3, Amazon EC2, DynamoDB, and more'. You can read more about the included Java code on Amazon's website: < https://aws.amazon.com/sdk-for-java/>.


License Travis-CI Build Status CRAN_Status_Badge codecov.io

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)
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

News

aws_java_sdk 0.2.0

  • Added ability to install in alternate location to meet CRAN requirements.

aws_java_sdk 0.1.0

  • Initial Github Commit

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.

install.packages("awsjavasdk")

0.2.0 by Russell Pierce, a year ago


https://github.com/zapier/awsjavasdk


Report a bug at https://github.com/zapier/awsjavasdk/issues


Browse source code at https://github.com/cran/awsjavasdk


Authors: Russell Pierce [aut, cre]


Documentation:   PDF Manual  


GPL-2 license


Imports utils, rJava, R.utils, assertthat, rappdirs

Suggests testthat, covr, knitr, rmarkdown


See at CRAN