zio/zio-aws
47.9
Weak · 7 November 2026
7.6k
lines of production code
Scala
primary language
4
measurements over time
What this system is
Features
Add Akka HTTP client implementation for ZIO AWS
Users can now use Akka HTTP as the underlying transport for ZIO AWS by importing the new \zio.aws.akkahttp.AkkaHttpClient\ module. This change introduces the \AkkaHttpClient\ object, which provides a \ZLayer\ to construct an \HttpClient\ backed by Akka's \ActorSystem\ and configurable connection pool settings, enabling integration with AWS SDK services via the Akka HTTP SPI.
zio-aws-akka-http · high confidence
Add DynamoDB example with logging and circuit breaking
The examples/example2 module now includes a Scala application that demonstrates how to use ZIO AWS to perform a full table scan on DynamoDB. The example configures the AWS client with Netty and default credentials, and applies ZIO aspects to the DynamoDB layer to enable call logging and circuit-breaking resilience using the rezilience library.
examples/example2 · high confidence
Add Kinesis stream interaction example
The \examples/example3\ module now includes a Scala application demonstrating how to interact with Amazon Kinesis using the ZIO AWS library. The example configures AWS credentials and region, lists existing streams and shards, registers a stream consumer, puts a record into a stream, and subscribes to the shard to consume events.
examples/example3 · high confidence
Add http4s-based async HTTP client implementation for AWS SDK
This change introduces a new http4s-based asynchronous HTTP client implementation for the AWS SDK, allowing users to leverage the http4s Blaze client for AWS requests. The module provides configuration support for the Blaze client, including timeouts, connection limits, user-agent headers, and parser modes, exposed via the ZIO Config system. It registers the \Http4sAsyncHttpService\ as the default async HTTP service provider through the Java SPI mechanism.
zio-aws-http4s · high confidence
Added example demonstrating AWS EC2 and Elastic Beanstalk integration
A new example application (Main.scala) has been added to the examples/example1 directory. It demonstrates how to use the ZIO AWS SDK to interact with AWS Elastic Beanstalk and EC2 services. The example retrieves application descriptions, lists environments, fetches environment resources, and details EC2 instance information (ID, type, launch time) using the Netty HTTP client and ZIO's effect system.
examples/example1 · high confidence
Adds AWS CRT HTTP client implementation
Introduces a new HTTP client implementation based on the AWS Common Runtime (CRT) for use with ZIO AWS. This change adds the \AwsCrtHttpClient\ component, which provides both default and customized client layers, and includes configuration models for proxy settings, connection health, TCP keep-alive, and post-quantum TLS support, along with the corresponding ZIO Config descriptors to allow users to configure these options.
zio-aws-crt-http · high confidence
Core AWS service request handling and streaming infrastructure
The \zio-aws-core\ module now provides the foundational implementation for executing AWS API calls and handling streaming data. \AwsServiceBase\ introduces protected methods to manage synchronous and asynchronous request-response patterns, including robust support for paginated requests (both simple and advanced) that automatically handle token iteration via ZIO streams. It also adds support for streaming request bodies and response outputs through \ZStreamAsyncRequestBody\ and \ZStreamAsyncResponseTransformer\, which bridge ZIO streams with the AWS SDK's reactive streams interfaces. Additionally, \ZEventStreamResponseHandler\ enables handling of AWS event streams, while \BuilderHelper\ and internal utilities simplify the construction of AWS SDK builders using ZIO Prelude's \Optional\ type.
zio-aws-core/src/main/scala/zio/aws/core · high confidence
Introduction of ZIO-based AWS SDK core and HTTP client implementations
This release introduces the foundational core library for the ZIO AWS SDK, including error handling via \AwsError\, streaming output support through \StreamingOutputResult\, and a new aspect system for logging and metrics in \zio.aws.core.aspects\. It also provides concrete HTTP client implementations for both http4s (\Http4sClient\) and Netty (\NettyChannelOptions\, \HttpOrHttps\), enabling users to make AWS service calls using ZIO effects instead of the previous Scala \Option\-based or blocking patterns.
repository · high confidence
New Netty HTTP client with configurable connection, proxy, and HTTP/2 settings
The zio-aws-netty module now provides a new Netty-based HTTP client implementation. Users can configure connection pooling (max concurrency, pending acquires, timeouts, idle time), SSL providers (JDK, OpenSSL), proxy settings (host, port, scheme, non-proxy hosts), and HTTP/2 parameters (max streams, initial window size, health check ping period) via the new NettyClientConfig and Http2Config case classes. The client supports HTTP/1.1, HTTP/2, and Dual protocol modes, and allows customization of Netty channel options.
zio-aws-netty · high confidence
Project setup and documentation overhaul
The repository now includes a .jvmopts file to configure JVM memory and module access for local development, a .env.template and clone\_aws\_repo.sh script to streamline cloning the AWS SDK v2 repository, and updated .gitignore rules. The README has been completely rewritten to provide a comprehensive introduction, installation instructions, and a detailed usage example for the ZIO AWS library.
(repo-wide) · high confidence
Removals
Removal of legacy codegen model loader
The \zio-aws-codegen/loader\ package, which previously handled the discovery and loading of AWS service models (including service definitions, waiters, paginators, and customization configs) via the \Loader\ service interface, has been removed. This eliminates the legacy mechanism for resolving and parsing \service-2.json\ and related configuration files from classpath resources during code generation.
zio-aws-codegen/src/main/scala/io/github/vigoo/zioaws/codegen/loader · high confidence
Behavioural changes
Code generation entry point moved from CLI to SBT plugin
The standalone CLI entry point (Main.scala) and its associated argument parsing logic have been removed from the code generator. This change reflects the migration of the code generation step into an SBT plugin, meaning users will now trigger generation through the build tool rather than a direct command-line interface.
zio-aws-codegen/src/main/scala/io/github/vigoo/zioaws/codegen/generator · high confidence
Code generator refactored to ZIO 2 and AWS SDK v2
The code generator in zio-aws-codegen has been rewritten to target ZIO 2 and the AWS SDK for Java v2. This change introduces a new generator architecture (AwsGeneratorImpl) that uses ZIO effects for generation, replaces the previous Option-based pagination handling with a dedicated PaginationDefinition system, and adds support for streaming and event-stream operations. It also introduces blacklisting for specific Java wrapper types (like Boolean, Integer, Double) to prevent unnecessary newtype generation and updates the package structure to zio.aws.
zio-aws-codegen/src/main/scala/zio/aws/codegen/generator · high confidence
Migrate code generation and CI configuration to ZIO 2 and zio-sbt
The code generator and its build infrastructure have been upgraded to support ZIO 2. This includes migrating the SBT plugin to use ZIO 2's runtime and effect system, updating the CI configuration to use the \zio-sbt-ci\ library for GitHub Actions, and adjusting the code generation parameters to reflect the new ZIO-based architecture. Users will benefit from improved stability and alignment with the ZIO 2 ecosystem, though this represents a significant underlying shift in how the code generation tasks are executed.
zio-aws-codegen/src/main/scala/zio/aws/codegen · high confidence
New AWS client configuration system with common and custom settings
The core configuration module has been replaced with a new system that manages AWS client setup via ZIO layers. Users can now configure clients using a \CommonAwsConfig\ (handling endpoints, regions, credentials, and timeouts) or apply custom \ClientCustomization\ logic. The new \AwsConfig\ trait provides specific methods to apply these settings to AWS SDK builders, separating general client configuration from HTTP client selection.
zio-aws-core/src/main/scala/zio/aws/core/config · high confidence
New AWS schema loader supporting classpath and Git sources
The codegen loader has been replaced with a new implementation that can load AWS service models from two sources: bundled resources on the classpath (FromClasspath) or by cloning and checking out the official AWS Java SDK v2 Git repository (FromGit). This change allows the code generator to fetch the latest service definitions dynamically from Git rather than relying solely on static, bundled JSON files, and introduces a caching layer to optimize repeated model loading.
zio-aws-codegen/src/main/scala/zio/aws/codegen/loader · high confidence
New HTTP client abstraction and socket configuration descriptors
The core HTTP client module now introduces a new \HttpClient\ trait and companion object that abstracts the creation of AWS SDK async HTTP clients. This implementation supports protocol selection (HTTP/1.1, HTTP/2, or Dual) and automatically selects the appropriate client based on service capabilities, failing if an HTTP/2-only client is forced on an HTTP/1.1-only service. Additionally, a new \descriptors\ package provides configuration helpers for standard Java socket options (such as keep-alive, buffer sizes, and TCP nodelay), enabling users to configure low-level network behavior through the ZIO Config system.
zio-aws-core/src/main/scala/zio/aws/core/httpclient · high confidence
Removal of core error and service abstractions
The \AwsError\ trait and the \AwsServiceBase\ trait have been removed from the core module. This eliminates the previous mechanism for wrapping AWS responses into a generic \AwsError\ type and the base service interface that handled asynchronous request-response conversions using \CompletableFuture\. Users relying on these specific core abstractions for error handling or service composition will need to adopt the updated error and service models provided by the library.
zio-aws-core/src/main/scala/io/github/vigoo/zioaws/core · high confidence
Removal of legacy ZIO 1 AWS configuration layer
The \AwsConfig\ type and its associated \ZLayer\ implementation in \zio-aws-core\ have been removed. This eliminates the legacy ZIO 1-style configuration service (\Has\[AwsConfig.Service\]\) that previously provided default, no-op hooks for configuring AWS clients and HTTP clients, reflecting the library's migration to ZIO 2.
zio-aws-core/src/main/scala/io/github/vigoo/zioaws/core/config · high confidence
Validation of endpoint URI scheme and new instance-profile credentials provider
The configuration system now validates that the \endpointOverride\ URI includes an \http\ or \https\ scheme, preventing runtime errors when invalid URIs are provided. Additionally, users can now configure the \instance-profile\ credentials provider type via configuration, alongside the existing \default\, \anonymous\, and \static\ options.
zio-aws-core/src/main/scala/zio/aws/core/config/descriptors · high confidence
Test coverage
Added comprehensive test suite for AwsServiceBase; Added integration tests for DynamoDB AttributeValue type-checking methods and multi-client AWS service operations; Added simulation utilities for AWS SDK async streams and pagination; Added tests for AWS config validation and parsing.
Dependencies
Added scalafmt configuration for code formatting
A new .scalafmt.conf file has been added to the zio-aws-codegen module to standardize code formatting. The configuration sets the scalafmt version to 3.0.7, specifies the Scala 2.12 dialect, and preserves existing line endings.
zio-aws-codegen · high confidence
Build infrastructure upgraded to SBT 1.13.0 with ZIO 2 and AWS SDK 2.55.11
The project's build system has been significantly modernized, upgrading the SBT version from 1.3.13 to 1.13.0 and introducing a new \project/Common.scala\ file to centralize dependency management. This change establishes ZIO 2.1.26 as the core runtime, updates the AWS SDK to version 2.55.11, and configures support for Scala 2.13.18 and Scala 3.9.0. Additionally, the release process has been migrated to use \sbt-ci-release-early\ 2.1.15, and publishing targets have been updated to the new Maven Central Portal (central.sonatype.com).
project · high confidence
Upgrade to ZIO 2.1 and AWS SDK 2.55
The project dependencies have been updated to ZIO 2.1.26 and the AWS SDK for Java 2.55.11. This upgrade also includes updates to supporting libraries such as Scala Meta 4.4.31, JGit 6.0.0, and Akka HTTP 10.2.10, ensuring compatibility with the latest ZIO 2.x ecosystem and current AWS service APIs.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 52 → 48 (-4.6)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 56 → 56 (+0.0)
- Architecture 96 → 96 (+0.0)
- Maturity 54 → 54 (+0.0)
- Readiness 41 → 36 (-5.5)
- Security 68 → 51 (-17.2)
- Performance 100 → 100 (+0.0)
Resolved (22)
- Configuration vs Execution Parameter Mismatch: The Parameters case class defines targetRoot as a Path, but the CI job generation methods in ZioAwsCi do not accept or use a target root parameter. This suggests a disconnect between the configuration model and the actual execution interface for CI jobs.
- Documentation: no installation or build instructions (website/docs/wrappers.md)
- Documentation: no project overview (website/docs/wrappers.md)
- Duplicate Method Signature with Different Effect Context: AwsGenerator exposes two methods with identical names and parameter lists (generateServiceCode), but they differ in their ZIO environment context (ZIO[Any, ...] vs ZIO[AwsGenerator, ...]). This is likely an accidental duplication or a copy-paste error in the API surface, causing ambiguity for callers.
- Duplicate Properties: AwsGeneratorImpl exposes both cfg and config as properties of type Parameters. These appear to be duplicate fields holding the same configuration data, which is confusing and redundant.
- Medium CVE: [GHSA redacted] (build.sbt)
- Outdated: com.typesafe.akka:akka-http_2.12
- Outdated: com.typesafe.akka:akka-stream_2.12
- Outdated: dev.zio:zio-nio_2.12
- Outdated: dev.zio:zio-streams_2.12
- Outdated: dev.zio:zio-test-sbt_2.12
- Outdated: dev.zio:zio-test_2.12
- Outdated: dev.zio:zio_2.12
- Outdated: io.github.vigoo:metagen-core_2.12
- Outdated: org.apache.logging.log4j:log4j-1.2-api
- Outdated: org.apache.logging.log4j:log4j-api
- Outdated: org.apache.logging.log4j:log4j-core
- Outdated: org.apache.logging.log4j:log4j-slf4j-impl
- Outdated: org.eclipse.jgit:org.eclipse.jgit
- Outdated: org.http4s:http4s-blaze-client_2.12
- …and 2 more
New (1)
- Dependency hygiene PARTLY measured — sbt declarations read, dependency currency not (Maven Central unreachable)
Changes since last survey
- 10 commits — 10 feature/other, 0 fixes
By area
- project/Common.scala — 6 commits
- .github/workflows — 2 commits
- project/build.properties — 1 commit
- project/plugins.sbt — 1 commit
Notable commits
- change: Update aws-core, http-client-spi, ... to 2.57.11 (#2010)
- change: Update aws-core, http-client-spi, ... to 2.57.2 (#1998)
- change: Update aws-core, http-client-spi, ... to 2.57.6 (#2003)
- change: Update aws-core, http-client-spi, ... to 2.57.7 (#2006)
- change: Update aws-core, http-client-spi, ... to 2.57.8 (#2007)
- change: Update aws-core, http-client-spi, ... to 2.57.9 (#2008)
- change: Update sbt, scripted-plugin to 1.13.1 (#2002)
- change: Update sbt-dotenv to 3.4.0 (#1991)
- change: Update zio, zio-streams, zio-test, ... to 2.1.27 (#1990)
- change: Update zio-sbt-ci, zio-sbt-website to 0.8.7 (#2004)
Architecture
- Containers 0 added · 0 removed · contexts 0 added · 0 removed · edges 0 added · 1 removed
Removed dependency edges (was a dependency, now gone) (1)
- repository → zio-aws-codegen
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
zio/zio-aws was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 7 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit e48d3de7d4d6c68ba8df3fa4da155f7a6323d7ac — the exact code this score is about.
- Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.3+preprod-5f8314471808.