From ce7c16900fa4ae8058c572413409880718eb32f0 Mon Sep 17 00:00:00 2001 From: mriccia Date: Wed, 19 Jul 2023 10:43:54 +0000 Subject: [PATCH 1/4] chore:prep release 1.16.1 --- CHANGELOG.md | 5 +++++ examples/pom.xml | 2 +- examples/powertools-examples-cloudformation/pom.xml | 2 +- examples/powertools-examples-core/pom.xml | 2 +- examples/powertools-examples-idempotency/pom.xml | 2 +- examples/powertools-examples-parameters/pom.xml | 2 +- examples/powertools-examples-serialization/pom.xml | 2 +- examples/powertools-examples-sqs/pom.xml | 2 +- examples/powertools-examples-validation/pom.xml | 2 +- pom.xml | 2 +- powertools-cloudformation/pom.xml | 2 +- powertools-core/pom.xml | 2 +- powertools-e2e-tests/handlers/pom.xml | 2 +- powertools-e2e-tests/pom.xml | 2 +- powertools-idempotency/pom.xml | 2 +- powertools-logging/pom.xml | 2 +- powertools-metrics/pom.xml | 2 +- powertools-parameters/pom.xml | 2 +- powertools-serialization/pom.xml | 2 +- powertools-sqs/pom.xml | 2 +- powertools-test-suite/pom.xml | 2 +- powertools-tracing/pom.xml | 2 +- powertools-validation/pom.xml | 2 +- 23 files changed, 27 insertions(+), 22 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 775074e82..d4e3c9502 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,6 +8,11 @@ This project follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) fo ## [Unreleased] +## [1.16.1] - 2023-07-19 + + + + ## [1.16.0] - 2023-06-29 diff --git a/examples/pom.xml b/examples/pom.xml index c9b8ea8ae..9ea82d99a 100644 --- a/examples/pom.xml +++ b/examples/pom.xml @@ -6,7 +6,7 @@ software.amazon.lambda powertools-examples - 1.17.0-SNAPSHOT + 1.16.1 pom Powertools for AWS Lambda (Java) library Examples diff --git a/examples/powertools-examples-cloudformation/pom.xml b/examples/powertools-examples-cloudformation/pom.xml index 198a85894..3fd582e32 100644 --- a/examples/powertools-examples-cloudformation/pom.xml +++ b/examples/powertools-examples-cloudformation/pom.xml @@ -3,7 +3,7 @@ 4.0.0 software.amazon.lambda.examples - 1.17.0-SNAPSHOT + 1.16.1 powertools-examples-cloudformation jar diff --git a/examples/powertools-examples-core/pom.xml b/examples/powertools-examples-core/pom.xml index a5d854d6b..e956c74bc 100644 --- a/examples/powertools-examples-core/pom.xml +++ b/examples/powertools-examples-core/pom.xml @@ -3,7 +3,7 @@ 4.0.0 software.amazon.lambda.examples - 1.17.0-SNAPSHOT + 1.16.1 powertools-examples-core jar diff --git a/examples/powertools-examples-idempotency/pom.xml b/examples/powertools-examples-idempotency/pom.xml index 0607fdd14..a5e779c2d 100644 --- a/examples/powertools-examples-idempotency/pom.xml +++ b/examples/powertools-examples-idempotency/pom.xml @@ -3,7 +3,7 @@ 4.0.0 software.amazon.lambda.examples - 1.17.0-SNAPSHOT + 1.16.1 powertools-examples-idempotency jar Powertools for AWS Lambda (Java) library Examples - Idempotency diff --git a/examples/powertools-examples-parameters/pom.xml b/examples/powertools-examples-parameters/pom.xml index c4631fd05..2104b151f 100644 --- a/examples/powertools-examples-parameters/pom.xml +++ b/examples/powertools-examples-parameters/pom.xml @@ -2,7 +2,7 @@ xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> 4.0.0 software.amazon.lambda.examples - 1.17.0-SNAPSHOT + 1.16.1 powertools-examples-parameters jar Powertools for AWS Lambda (Java) library Examples - Parameters diff --git a/examples/powertools-examples-serialization/pom.xml b/examples/powertools-examples-serialization/pom.xml index 4974842dd..82a8af5ba 100644 --- a/examples/powertools-examples-serialization/pom.xml +++ b/examples/powertools-examples-serialization/pom.xml @@ -2,7 +2,7 @@ xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> 4.0.0 software.amazon.lambda.examples - 1.17.0-SNAPSHOT + 1.16.1 powertools-examples-serialization jar Powertools for AWS Lambda (Java) library Examples - Serialization diff --git a/examples/powertools-examples-sqs/pom.xml b/examples/powertools-examples-sqs/pom.xml index c5b811678..ea3842de0 100644 --- a/examples/powertools-examples-sqs/pom.xml +++ b/examples/powertools-examples-sqs/pom.xml @@ -2,7 +2,7 @@ xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> 4.0.0 software.amazon.lambda.examples - 1.17.0-SNAPSHOT + 1.16.1 powertools-examples-sqs jar Powertools for AWS Lambda (Java) library Examples - SQS diff --git a/examples/powertools-examples-validation/pom.xml b/examples/powertools-examples-validation/pom.xml index 455fd66b8..89f823a55 100644 --- a/examples/powertools-examples-validation/pom.xml +++ b/examples/powertools-examples-validation/pom.xml @@ -2,7 +2,7 @@ xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> 4.0.0 software.amazon.lambda.examples - 1.17.0-SNAPSHOT + 1.16.1 powertools-examples-validation jar Powertools for AWS Lambda (Java) library Examples - Validation diff --git a/pom.xml b/pom.xml index f0c671883..152035061 100644 --- a/pom.xml +++ b/pom.xml @@ -6,7 +6,7 @@ software.amazon.lambda powertools-parent - 1.17.0-SNAPSHOT + 1.16.1 pom Powertools for AWS Lambda (Java) library Parent diff --git a/powertools-cloudformation/pom.xml b/powertools-cloudformation/pom.xml index 3a846c378..0d1a3e45b 100644 --- a/powertools-cloudformation/pom.xml +++ b/powertools-cloudformation/pom.xml @@ -10,7 +10,7 @@ powertools-parent software.amazon.lambda - 1.17.0-SNAPSHOT + 1.16.1 Powertools for AWS Lambda (Java)library Cloudformation diff --git a/powertools-core/pom.xml b/powertools-core/pom.xml index cf9ad45d1..63867e8d6 100644 --- a/powertools-core/pom.xml +++ b/powertools-core/pom.xml @@ -10,7 +10,7 @@ powertools-parent software.amazon.lambda - 1.17.0-SNAPSHOT + 1.16.1 Powertools for AWS Lambda (Java) library Core diff --git a/powertools-e2e-tests/handlers/pom.xml b/powertools-e2e-tests/handlers/pom.xml index ae26364dd..d08ede7e9 100644 --- a/powertools-e2e-tests/handlers/pom.xml +++ b/powertools-e2e-tests/handlers/pom.xml @@ -10,7 +10,7 @@ Fake handlers that use Powertools for AWS Lambda (Java). - 1.17.0-SNAPSHOT + 1.16.1 UTF-8 1.8 1.8 diff --git a/powertools-e2e-tests/pom.xml b/powertools-e2e-tests/pom.xml index 8754117db..27782d4c5 100644 --- a/powertools-e2e-tests/pom.xml +++ b/powertools-e2e-tests/pom.xml @@ -6,7 +6,7 @@ powertools-parent software.amazon.lambda - 1.17.0-SNAPSHOT + 1.16.1 powertools-e2e-tests diff --git a/powertools-idempotency/pom.xml b/powertools-idempotency/pom.xml index cb4d9b802..f8856b00d 100644 --- a/powertools-idempotency/pom.xml +++ b/powertools-idempotency/pom.xml @@ -7,7 +7,7 @@ software.amazon.lambda powertools-parent - 1.17.0-SNAPSHOT + 1.16.1 powertools-idempotency diff --git a/powertools-logging/pom.xml b/powertools-logging/pom.xml index 767fbd3ee..a84de6b2f 100644 --- a/powertools-logging/pom.xml +++ b/powertools-logging/pom.xml @@ -10,7 +10,7 @@ powertools-parent software.amazon.lambda - 1.17.0-SNAPSHOT + 1.16.1 Powertools for AWS Lambda (Java) library Logging diff --git a/powertools-metrics/pom.xml b/powertools-metrics/pom.xml index ed2d2f815..413ac3ba1 100644 --- a/powertools-metrics/pom.xml +++ b/powertools-metrics/pom.xml @@ -10,7 +10,7 @@ powertools-parent software.amazon.lambda - 1.17.0-SNAPSHOT + 1.16.1 Powertools for AWS Lambda (Java) library Metrics diff --git a/powertools-parameters/pom.xml b/powertools-parameters/pom.xml index b50844d99..5013ba4c0 100644 --- a/powertools-parameters/pom.xml +++ b/powertools-parameters/pom.xml @@ -7,7 +7,7 @@ powertools-parent software.amazon.lambda - 1.17.0-SNAPSHOT + 1.16.1 powertools-parameters diff --git a/powertools-serialization/pom.xml b/powertools-serialization/pom.xml index f21ecb412..9481f38fa 100644 --- a/powertools-serialization/pom.xml +++ b/powertools-serialization/pom.xml @@ -7,7 +7,7 @@ powertools-parent software.amazon.lambda - 1.17.0-SNAPSHOT + 1.16.1 powertools-serialization diff --git a/powertools-sqs/pom.xml b/powertools-sqs/pom.xml index 618aa948c..b6ae9da90 100644 --- a/powertools-sqs/pom.xml +++ b/powertools-sqs/pom.xml @@ -10,7 +10,7 @@ powertools-parent software.amazon.lambda - 1.17.0-SNAPSHOT + 1.16.1 Powertools for AWS Lambda (Java) library SQS diff --git a/powertools-test-suite/pom.xml b/powertools-test-suite/pom.xml index 5737296da..bde7b7176 100644 --- a/powertools-test-suite/pom.xml +++ b/powertools-test-suite/pom.xml @@ -10,7 +10,7 @@ powertools-parent software.amazon.lambda - 1.17.0-SNAPSHOT + 1.16.1 Powertools for AWS Lambda (Java) library Test Suite diff --git a/powertools-tracing/pom.xml b/powertools-tracing/pom.xml index 42a229f42..51315d6a0 100644 --- a/powertools-tracing/pom.xml +++ b/powertools-tracing/pom.xml @@ -10,7 +10,7 @@ powertools-parent software.amazon.lambda - 1.17.0-SNAPSHOT + 1.16.1 Powertools for AWS Lambda (Java) library Tracing diff --git a/powertools-validation/pom.xml b/powertools-validation/pom.xml index 1469183ef..293c599f6 100644 --- a/powertools-validation/pom.xml +++ b/powertools-validation/pom.xml @@ -10,7 +10,7 @@ powertools-parent software.amazon.lambda - 1.17.0-SNAPSHOT + 1.16.1 Powertools for AWS Lambda (Java) validation library From 6774115485086344ecb13d2963971c0b58bb27f4 Mon Sep 17 00:00:00 2001 From: Jerome Van Der Linden Date: Wed, 19 Jul 2023 12:49:08 +0200 Subject: [PATCH 2/4] update doc --- README.md | 229 +++++++++++++++++++++++++++++------------------------ mkdocs.yml | 2 +- 2 files changed, 127 insertions(+), 104 deletions(-) diff --git a/README.md b/README.md index 0a7cd0112..ae3ebc3c1 100644 --- a/README.md +++ b/README.md @@ -2,128 +2,144 @@ ![aws provider](https://img.shields.io/badge/provider-AWS-orange?logo=amazon-aws&color=ff9900) ![Build status](https://github.com/aws-powertools/powertools-lambda-java/actions/workflows/build.yml/badge.svg) ![Maven Central](https://img.shields.io/maven-central/v/software.amazon.lambda/powertools-parent) [![codecov.io](https://codecov.io/github/aws-powertools/powertools-lambda-java/branch/main/graphs/badge.svg)](https://app.codecov.io/gh/aws-powertools/powertools-lambda-java) +Powertools for AWS Lambda (Java) is a developer toolkit to implement Serverless best practices and increase developer +velocity. -Powertools for AWS Lambda (Java) is a developer toolkit to implement Serverless best practices and increase developer velocity. +> Also available +> in [Python](https://github.com/aws-powertools/powertools-lambda-python), [TypeScript](https://github.com/aws-powertools/powertools-lambda-typescript), +> and [.NET](https://github.com/aws-powertools/powertools-lambda-dotnet). -> Also available in [Python](https://github.com/aws-powertools/powertools-lambda-python), [TypeScript](https://github.com/aws-powertools/powertools-lambda-typescript), and [.NET](https://github.com/aws-powertools/powertools-lambda-dotnet). - -**[📜Documentation](https://docs.powertools.aws.dev/lambda-java/)** | **[Feature request](https://github.com/aws-powertools/powertools-lambda-java/issues/new?assignees=&labels=feature-request%2C+triage&template=feature_request.md&title=)** | **[🐛Bug Report](https://github.com/aws-powertools/powertools-lambda-java/issues/new?assignees=&labels=bug%2C+triage&template=bug_report.md&title=)** | **[Detailed blog post](https://aws.amazon.com/blogs/opensource/simplifying-serverless-best-practices-with-aws-lambda-powertools-java/)** +**[📜Documentation](https://docs.powertools.aws.dev/lambda-java/)** | * +*[Feature request](https://github.com/aws-powertools/powertools-lambda-java/issues/new?assignees=&labels=feature-request%2C+triage&template=feature_request.md&title=) +** | * +*[🐛Bug Report](https://github.com/aws-powertools/powertools-lambda-java/issues/new?assignees=&labels=bug%2C+triage&template=bug_report.md&title=) +** | * +*[Detailed blog post](https://aws.amazon.com/blogs/opensource/simplifying-serverless-best-practices-with-aws-lambda-powertools-java/) +** ### Installation -Powertools for AWS Lambda (Java) is available in Maven Central. You can use your favourite dependency management tool to install it +Powertools for AWS Lambda (Java) is available in Maven Central. You can use your favourite dependency management tool to +install it #### Maven: + ```xml + ... software.amazon.lambda powertools-tracing - 1.16.0 + 1.16.1 software.amazon.lambda powertools-logging - 1.16.0 + 1.16.1 software.amazon.lambda powertools-metrics - 1.16.0 + 1.16.1 ... ``` -Next, configure the aspectj-maven-plugin to compile-time weave (CTW) the aws-lambda-powertools-java aspects into your project. A different configuration is needed for projects on Java 8. +Next, configure the aspectj-maven-plugin to compile-time weave (CTW) the aws-lambda-powertools-java aspects into your +project. A different configuration is needed for projects on Java 8.
Maven - Java 11 and newer - + ```xml + ... - dev.aspectj - aspectj-maven-plugin - 1.13.1 - - 1.8 - 1.8 - 1.8 - - - software.amazon.lambda - powertools-logging - - - software.amazon.lambda - powertools-tracing - - - software.amazon.lambda - powertools-metrics - - - - - - - compile - - - + dev.aspectj + aspectj-maven-plugin + 1.13.1 + + 1.8 + 1.8 + 1.8 + + + software.amazon.lambda + powertools-logging + + + software.amazon.lambda + powertools-tracing + + + software.amazon.lambda + powertools-metrics + + + + + + + compile + + + ... ``` +
Maven - Java 8 - + ```xml + ... - org.codehaus.mojo - aspectj-maven-plugin - 1.14.0 - - 1.8 - 1.8 - 1.8 - - - software.amazon.lambda - powertools-logging - - - software.amazon.lambda - powertools-tracing - - - software.amazon.lambda - powertools-metrics - - - - - - - compile - - - + org.codehaus.mojo + aspectj-maven-plugin + 1.14.0 + + 1.8 + 1.8 + 1.8 + + + software.amazon.lambda + powertools-logging + + + software.amazon.lambda + powertools-tracing + + + software.amazon.lambda + powertools-metrics + + + + + + + compile + + + ... ``` +
@@ -131,23 +147,24 @@ Next, configure the aspectj-maven-plugin to compile-time weave (CTW) the aws-lam ```groovy plugins { - id 'java' - id 'io.freefair.aspectj.post-compile-weaving' version '8.1.0' - } - - repositories { - mavenCentral() - } - - dependencies { - aspect 'software.amazon.lambda:powertools-logging:{{ powertools.version }}' - aspect 'software.amazon.lambda:powertools-tracing:{{ powertools.version }}' - aspect 'software.amazon.lambda:powertools-metrics:{{ powertools.version }}' - } - - sourceCompatibility = 11 - targetCompatibility = 11 + id 'java' + id 'io.freefair.aspectj.post-compile-weaving' version '8.1.0' +} + +repositories { + mavenCentral() +} + +dependencies { + aspect 'software.amazon.lambda:powertools-logging:{{ powertools.version }}' + aspect 'software.amazon.lambda:powertools-tracing:{{ powertools.version }}' + aspect 'software.amazon.lambda:powertools-metrics:{{ powertools.version }}' +} + +sourceCompatibility = 11 +targetCompatibility = 11 ``` +
@@ -155,36 +172,42 @@ Next, configure the aspectj-maven-plugin to compile-time weave (CTW) the aws-lam ```groovy plugins { - id 'java' - id 'io.freefair.aspectj.post-compile-weaving' version '6.6.3' - } - - repositories { - mavenCentral() - } - - dependencies { - aspect 'software.amazon.lambda:powertools-logging:{{ powertools.version }}' - aspect 'software.amazon.lambda:powertools-tracing:{{ powertools.version }}' - aspect 'software.amazon.lambda:powertools-metrics:{{ powertools.version }}' - } - - sourceCompatibility = 1.8 - targetCompatibility = 1.8 + id 'java' + id 'io.freefair.aspectj.post-compile-weaving' version '6.6.3' +} + +repositories { + mavenCentral() +} + +dependencies { + aspect 'software.amazon.lambda:powertools-logging:{{ powertools.version }}' + aspect 'software.amazon.lambda:powertools-tracing:{{ powertools.version }}' + aspect 'software.amazon.lambda:powertools-metrics:{{ powertools.version }}' +} + +sourceCompatibility = 1.8 +targetCompatibility = 1.8 ``` +
## Examples See the **[examples](examples)** directory for example projects showcasing usage of different utilities. -Have a demo project to contribute which showcase usage of different utilities from powertools? We are happy to accept it [here](CONTRIBUTING.md#security-issue-notifications). +Have a demo project to contribute which showcase usage of different utilities from powertools? We are happy to accept +it [here](CONTRIBUTING.md#security-issue-notifications). ## How to support Powertools for AWS Lambda (Java)? ### Becoming a reference customer -Knowing which companies are using this library is important to help prioritize the project internally. If your company is using Powertools for AWS Lambda (Java), you can request to have your name and logo added to the README file by raising a [Support Powertools for AWS Lambda (Java) (become a reference)](https://github.com/aws-powertools/powertools-lambda-java/issues/new?assignees=&labels=customer-reference&template=support_powertools.yml&title=%5BSupport+Lambda+Powertools%5D%3A+%3Cyour+organization+name%3E) issue. +Knowing which companies are using this library is important to help prioritize the project internally. If your company +is using Powertools for AWS Lambda (Java), you can request to have your name and logo added to the README file by +raising +a [Support Powertools for AWS Lambda (Java) (become a reference)](https://github.com/aws-powertools/powertools-lambda-java/issues/new?assignees=&labels=customer-reference&template=support_powertools.yml&title=%5BSupport+Lambda+Powertools%5D%3A+%3Cyour+organization+name%3E) +issue. The following companies, among others, use Powertools: diff --git a/mkdocs.yml b/mkdocs.yml index 5fd3206b0..da00b24d1 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -83,7 +83,7 @@ extra_javascript: extra: powertools: - version: 1.16.0 # to update after each release (we do not want snapshot version here) + version: 1.16.1 # to update after each release (we do not want snapshot version here) repo_url: https://github.com/aws-powertools/powertools-lambda-java edit_uri: edit/main/docs From e14d28d7214383057da0db405fec752b2ec976a6 Mon Sep 17 00:00:00 2001 From: Michele Ricciardi Date: Wed, 19 Jul 2023 12:54:29 +0200 Subject: [PATCH 3/4] docs: Update CHANGELOG.md for release 1.16.1 --- CHANGELOG.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index d4e3c9502..5619f0bbb 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -10,7 +10,10 @@ This project follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) fo ## [1.16.1] - 2023-07-19 - +* Fix: idempotency timeout bug (#1285) by @scottgerring +* Fix: ParamManager cannot provide default SSM & Secrets providers (#1282) by @jeromevdl +* Fix: Handle batch failures in FIFO queues correctly (#1183) by @scottgerring +* Deps: Bump third party dependencies to the latest versions. ## [1.16.0] - 2023-06-29 From 25b7d8e3a0f534f8718f1938f92be597588ff72e Mon Sep 17 00:00:00 2001 From: Jerome Van Der Linden Date: Wed, 19 Jul 2023 13:01:46 +0200 Subject: [PATCH 4/4] remove formatting --- README.md | 223 ++++++++++++++++++++++++------------------------------ 1 file changed, 100 insertions(+), 123 deletions(-) diff --git a/README.md b/README.md index ae3ebc3c1..a841e7df7 100644 --- a/README.md +++ b/README.md @@ -2,30 +2,19 @@ ![aws provider](https://img.shields.io/badge/provider-AWS-orange?logo=amazon-aws&color=ff9900) ![Build status](https://github.com/aws-powertools/powertools-lambda-java/actions/workflows/build.yml/badge.svg) ![Maven Central](https://img.shields.io/maven-central/v/software.amazon.lambda/powertools-parent) [![codecov.io](https://codecov.io/github/aws-powertools/powertools-lambda-java/branch/main/graphs/badge.svg)](https://app.codecov.io/gh/aws-powertools/powertools-lambda-java) -Powertools for AWS Lambda (Java) is a developer toolkit to implement Serverless best practices and increase developer -velocity. -> Also available -> in [Python](https://github.com/aws-powertools/powertools-lambda-python), [TypeScript](https://github.com/aws-powertools/powertools-lambda-typescript), -> and [.NET](https://github.com/aws-powertools/powertools-lambda-dotnet). +Powertools for AWS Lambda (Java) is a developer toolkit to implement Serverless best practices and increase developer velocity. -**[📜Documentation](https://docs.powertools.aws.dev/lambda-java/)** | * -*[Feature request](https://github.com/aws-powertools/powertools-lambda-java/issues/new?assignees=&labels=feature-request%2C+triage&template=feature_request.md&title=) -** | * -*[🐛Bug Report](https://github.com/aws-powertools/powertools-lambda-java/issues/new?assignees=&labels=bug%2C+triage&template=bug_report.md&title=) -** | * -*[Detailed blog post](https://aws.amazon.com/blogs/opensource/simplifying-serverless-best-practices-with-aws-lambda-powertools-java/) -** +> Also available in [Python](https://github.com/aws-powertools/powertools-lambda-python), [TypeScript](https://github.com/aws-powertools/powertools-lambda-typescript), and [.NET](https://github.com/aws-powertools/powertools-lambda-dotnet). + +**[📜Documentation](https://docs.powertools.aws.dev/lambda-java/)** | **[Feature request](https://github.com/aws-powertools/powertools-lambda-java/issues/new?assignees=&labels=feature-request%2C+triage&template=feature_request.md&title=)** | **[🐛Bug Report](https://github.com/aws-powertools/powertools-lambda-java/issues/new?assignees=&labels=bug%2C+triage&template=bug_report.md&title=)** | **[Detailed blog post](https://aws.amazon.com/blogs/opensource/simplifying-serverless-best-practices-with-aws-lambda-powertools-java/)** ### Installation -Powertools for AWS Lambda (Java) is available in Maven Central. You can use your favourite dependency management tool to -install it +Powertools for AWS Lambda (Java) is available in Maven Central. You can use your favourite dependency management tool to install it #### Maven: - ```xml - ... @@ -47,99 +36,94 @@ install it ``` -Next, configure the aspectj-maven-plugin to compile-time weave (CTW) the aws-lambda-powertools-java aspects into your -project. A different configuration is needed for projects on Java 8. +Next, configure the aspectj-maven-plugin to compile-time weave (CTW) the aws-lambda-powertools-java aspects into your project. A different configuration is needed for projects on Java 8.
Maven - Java 11 and newer - + ```xml - ... - dev.aspectj - aspectj-maven-plugin - 1.13.1 - - 1.8 - 1.8 - 1.8 - - - software.amazon.lambda - powertools-logging - - - software.amazon.lambda - powertools-tracing - - - software.amazon.lambda - powertools-metrics - - - - - - - compile - - - + dev.aspectj + aspectj-maven-plugin + 1.13.1 + + 1.8 + 1.8 + 1.8 + + + software.amazon.lambda + powertools-logging + + + software.amazon.lambda + powertools-tracing + + + software.amazon.lambda + powertools-metrics + + + + + + + compile + + + ... ``` -
Maven - Java 8 - + ```xml - ... - org.codehaus.mojo - aspectj-maven-plugin - 1.14.0 - - 1.8 - 1.8 - 1.8 - - - software.amazon.lambda - powertools-logging - - - software.amazon.lambda - powertools-tracing - - - software.amazon.lambda - powertools-metrics - - - - - - - compile - - - + org.codehaus.mojo + aspectj-maven-plugin + 1.14.0 + + 1.8 + 1.8 + 1.8 + + + software.amazon.lambda + powertools-logging + + + software.amazon.lambda + powertools-tracing + + + software.amazon.lambda + powertools-metrics + + + + + + + compile + + + ... ``` -
@@ -147,24 +131,23 @@ project. A different configuration is needed for projects on Java 8. ```groovy plugins { - id 'java' - id 'io.freefair.aspectj.post-compile-weaving' version '8.1.0' -} - -repositories { - mavenCentral() -} - -dependencies { - aspect 'software.amazon.lambda:powertools-logging:{{ powertools.version }}' - aspect 'software.amazon.lambda:powertools-tracing:{{ powertools.version }}' - aspect 'software.amazon.lambda:powertools-metrics:{{ powertools.version }}' -} - -sourceCompatibility = 11 -targetCompatibility = 11 + id 'java' + id 'io.freefair.aspectj.post-compile-weaving' version '8.1.0' + } + + repositories { + mavenCentral() + } + + dependencies { + aspect 'software.amazon.lambda:powertools-logging:{{ powertools.version }}' + aspect 'software.amazon.lambda:powertools-tracing:{{ powertools.version }}' + aspect 'software.amazon.lambda:powertools-metrics:{{ powertools.version }}' + } + + sourceCompatibility = 11 + targetCompatibility = 11 ``` -
@@ -172,42 +155,36 @@ targetCompatibility = 11 ```groovy plugins { - id 'java' - id 'io.freefair.aspectj.post-compile-weaving' version '6.6.3' -} - -repositories { - mavenCentral() -} - -dependencies { - aspect 'software.amazon.lambda:powertools-logging:{{ powertools.version }}' - aspect 'software.amazon.lambda:powertools-tracing:{{ powertools.version }}' - aspect 'software.amazon.lambda:powertools-metrics:{{ powertools.version }}' -} - -sourceCompatibility = 1.8 -targetCompatibility = 1.8 + id 'java' + id 'io.freefair.aspectj.post-compile-weaving' version '6.6.3' + } + + repositories { + mavenCentral() + } + + dependencies { + aspect 'software.amazon.lambda:powertools-logging:{{ powertools.version }}' + aspect 'software.amazon.lambda:powertools-tracing:{{ powertools.version }}' + aspect 'software.amazon.lambda:powertools-metrics:{{ powertools.version }}' + } + + sourceCompatibility = 1.8 + targetCompatibility = 1.8 ``` -
## Examples See the **[examples](examples)** directory for example projects showcasing usage of different utilities. -Have a demo project to contribute which showcase usage of different utilities from powertools? We are happy to accept -it [here](CONTRIBUTING.md#security-issue-notifications). +Have a demo project to contribute which showcase usage of different utilities from powertools? We are happy to accept it [here](CONTRIBUTING.md#security-issue-notifications). ## How to support Powertools for AWS Lambda (Java)? ### Becoming a reference customer -Knowing which companies are using this library is important to help prioritize the project internally. If your company -is using Powertools for AWS Lambda (Java), you can request to have your name and logo added to the README file by -raising -a [Support Powertools for AWS Lambda (Java) (become a reference)](https://github.com/aws-powertools/powertools-lambda-java/issues/new?assignees=&labels=customer-reference&template=support_powertools.yml&title=%5BSupport+Lambda+Powertools%5D%3A+%3Cyour+organization+name%3E) -issue. +Knowing which companies are using this library is important to help prioritize the project internally. If your company is using Powertools for AWS Lambda (Java), you can request to have your name and logo added to the README file by raising a [Support Powertools for AWS Lambda (Java) (become a reference)](https://github.com/aws-powertools/powertools-lambda-java/issues/new?assignees=&labels=customer-reference&template=support_powertools.yml&title=%5BSupport+Lambda+Powertools%5D%3A+%3Cyour+organization+name%3E) issue. The following companies, among others, use Powertools: