reactive-aws-clients

AWS Client libraries for Scala

Features

AWS SDK for Java V2 Support
Scala wrapper auto generation from Java sources of AWS
- Support all java methods via Scala wrapper(but methods which Consumer type has can't used)
Enrich Java model classes
- Support Java model classes, add methods(AsScala suffix) for Scala by enriching the Java model class
Support concurrent types
- core
  - scala.concurrent.Future
- monix
  - monix.eval.Task
  - monix.reactive.Observable
- cats-effect
  - cats.effect.IO
- akka-stream
  - akka.stream.scaladsl.Source
  - akka.stream.scaladsl.Flow

Support environments

Java SE 8
Scala
- 2.11.x
- 2.12.x
- 2.13.x

reactive-aws-clients version	scala version	aws-sdk version	akka-version	cats version	monix
1.1.x	2.11.x, 2.12.x, 2.13.x	2.10.x	2.5.x	2.0.x(since 1.15)	3.1.x(since 1.16)
1.2.x	2.11.x, 2.12.x, 2.13.x	2.11.x	2.5.x	2.0.x	3.1.x
1.2.1+	2.11.x	2.11.x	2.5.x	2.0.x	3.1.x
1.2.1+	2.12.x, 2.13.x	2.11.x	2.6.x	2.0.x	3.1.x

Installation

Add dependencies to build.sbt.

val libraryName = "dynamodb"
val version = "1.2.0"

libraryDependencies += Seq(
  "com.github.j5ik2o" %% s"reactive-aws-$libraryName-core" % version,
  "com.github.j5ik2o" %% s"reactive-aws-$libraryName-monix" % version, // optional
  "com.github.j5ik2o" %% s"reactive-aws-$libraryName-akka" % version, // optional
  "com.github.j5ik2o" %% s"reactive-aws-$libraryName-cats" % version, // optional
)

Usage

The following is an example of dynamodb. The usage is almost the same as other libraries.

import com.github.j5ik2o.reactive.aws.dynamodb._
import com.github.j5ik2o.reactive.aws.dynamodb.implicits._ // import for enrich
import software.amazon.awssdk.services.dynamodb.model._
import software.amazon.awssdk.services.dynamodb.{ DynamoDbAsyncClient => JavaDynamoDbAsyncClient }

val underlying = JavaDynamoDbAsyncClient
  .builder()
  // ...
  .build()
val client = DynamoDbAsyncClient(underlying) // Pass the Java client instance to the constructor
val putItemRequest = PutItemRequest // Java types can be used as is
  .builder()
  .tableName(tableName)
  .itemAsScala(
    Map[String, AttributeValue](
      "Id"   -> AttributeValue.builder().s("abc").build(),
      "Name" -> AttributeValue.builder().s("xyz").build()
    )
  ) // use the enriched Scala method
  .build()
val putItemResponseFuture = client.putItem(putItemRequest)

How to build

Run the following commands (Maven is required to run mvnInstall or mvnClean)

$ git submodule update --init
$ sbt mvnClean mvnInstall // first time only
$ sbt compile

How to contribute

If you need other SDK features, please create an issue or send a P-R.

j5ik2o / reactive-aws-clients 1.2.6