This is an automated email from the ASF dual-hosted git repository.

davidzollo pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/seatunnel-shade.git


The following commit(s) were added to refs/heads/main by this push:
     new ab62f00  [Improve][Shade] Prepare 3.0.2-SNAPSHOT and align README with 
3.0.1 (#29)
ab62f00 is described below

commit ab62f00a3c54acbe0a530ddf6e291325d18b5748
Author: zhiweiniu <[email protected]>
AuthorDate: Tue Nov 17 14:43:15 2026 +0800

    [Improve][Shade] Prepare 3.0.2-SNAPSHOT and align README with 3.0.1 (#29)
---
 README.md                              | 73 +++++++++++++++++++---------------
 pom.xml                                |  4 +-
 seatunnel-shade-arrow/pom.xml          |  2 +-
 seatunnel-shade-calcite/pom.xml        |  2 +-
 seatunnel-shade-commons-lang3/pom.xml  |  2 +-
 seatunnel-shade-guava/pom.xml          |  2 +-
 seatunnel-shade-hadoop-aws/pom.xml     |  2 +-
 seatunnel-shade-hadoop3-uber/pom.xml   |  2 +-
 seatunnel-shade-hazelcast/pom.xml      |  2 +-
 seatunnel-shade-hikari/pom.xml         |  2 +-
 seatunnel-shade-jackson-yaml/pom.xml   |  2 +-
 seatunnel-shade-jackson/pom.xml        |  2 +-
 seatunnel-shade-janino/pom.xml         |  2 +-
 seatunnel-shade-jetty/pom.xml          |  2 +-
 seatunnel-shade-scala-compiler/pom.xml |  2 +-
 seatunnel-shade-thrift-service/pom.xml |  2 +-
 16 files changed, 57 insertions(+), 48 deletions(-)

diff --git a/README.md b/README.md
index 8fecb2c..b748e49 100644
--- a/README.md
+++ b/README.md
@@ -4,11 +4,14 @@ Apache SeaTunnel Shade — shaded (relocated) JARs of 
third-party libraries for
 
 Each module wraps a single third-party library, relocating its packages under 
`org.apache.seatunnel.shade.*` to avoid classpath conflicts when SeaTunnel 
itself depends on different versions of the same libraries.
 
+The latest release is **3.0.1** (`v3.0.1`). The `main` branch builds 
**3.0.2-SNAPSHOT**.
+Release and consumer examples below use the published 3.0.1 baseline.
+
 ## Modules
 
-| Module                           | Library | Version |
+| Module                           | Library | Library version in 3.0.1 |
 |----------------------------------|---------|---------|
-| `seatunnel-shade-hazelcast`      | Hazelcast | 5.1 |
+| `seatunnel-shade-hazelcast`      | Hazelcast | 5.1.7 |
 | `seatunnel-shade-hadoop3-uber`   | Hadoop Client | 3.1.4 |
 | `seatunnel-shade-jackson`        | Jackson | 2.15.4 |
 | `seatunnel-shade-guava`          | Guava | 27.0-jre |
@@ -18,13 +21,15 @@ Each module wraps a single third-party library, relocating 
its packages under `o
 | `seatunnel-shade-thrift-service` | Apache Doris Thrift | 1.0.0 |
 | `seatunnel-shade-janino`         | Janino | 3.1.12 |
 | `seatunnel-shade-scala-compiler` | Scala Compiler | 2.12.15 |
-| `seatunnel-shade-jetty`          | Jetty | 9.4.56 |
+| `seatunnel-shade-jetty`          | Jetty | 9.4.56.v20240826 |
 | `seatunnel-shade-commons-lang3`  | Commons Lang3 | 3.18.0 |
 | `seatunnel-shade-calcite`        | Apache Calcite | 1.38.0 |
 | `seatunnel-shade-jackson-yaml`   | Jackson | 2.15.4 |
 
 ## Build
 
+Builds from `main` use the `3.0.2-SNAPSHOT` shade suffix, for example 
`5.1.7-3.0.2-SNAPSHOT` for Hazelcast.
+
 ```bash
 # Full build (skip tests, skip RAT license check)
 mvn -B -DskipTests -Drat.skip=true clean install
@@ -43,7 +48,9 @@ mvn -B -DskipTests -pl seatunnel-shade-guava clean install
 
 ### Full release
 
-Deploy all modules:
+Deploy all modules from a prepared release checkout. Set both the root POM 
version and
+`seatunnel.shade.version`, together with every child POM's parent version, to 
the release
+version before deploying. For 3.0.1, all three use `3.0.1`.
 
 ```bash
 mvn -B -DskipTests -Drat.skip=true clean deploy
@@ -71,60 +78,62 @@ mvn -B -DskipTests -Drat.skip=true \
 
 **Key points**:
 
-- **First release (all modules)**: Set `seatunnel.shade.version` in root 
`pom.xml` and use `${library.version}-${seatunnel.shade.version}` for all 
module versions. Root POM `<version>` must be the actual release version (e.g. 
`3.0.0`, not `${revision}`), otherwise Nexus will reject the deployment.
+- **Full release (all modules)**: Set `seatunnel.shade.version` in root 
`pom.xml` and use `${library.version}-${seatunnel.shade.version}` for all 
module versions. Root POM `<version>` and every child POM's parent version must 
be the actual release version (e.g. `3.0.1`, not `${revision}`).
 - **Incremental release (partial modules)**: After the parent POM is released, 
its `<properties>` cannot be updated in a new release. Override the library 
version in the child module's own `<properties>` block, then use the same 
`${lib.version}-${seatunnel.shade.version}` expression — it will resolve to the 
child's property value, not the parent's. The version string must differ from 
already-published artifacts to avoid a Nexus 400 conflict.
-- **Never** run `mvn clean deploy` without `-pl` — unchanged modules will be 
redeployed, and Nexus will reject them with a 400 error.
+- **For a partial release**, run `mvn clean deploy` with `-pl` — unchanged 
modules must not be redeployed, or Nexus will reject them with a 400 error.
 - If only the shade plugin configuration changed (not the library version), 
you must bump the version manually before deploying.
 
-**Background**: The shade project must release before its consumers (e.g. 
`apache/seatunnel`) can build. Once `seatunnel-shade:3.0.0` is published, its 
POM properties are frozen. A child module that continues referencing the 
parent's property will resolve to the old value, since the parent's 
`<properties>` cannot be updated in an incremental release. The fix is to 
declare the updated property in the child module's own `<properties>` block — 
Maven child properties override parent properti [...]
+**Background**: The shade project must release before its consumers (e.g. 
`apache/seatunnel`) can build. Once `seatunnel-shade:3.0.1` is published, its 
POM properties are frozen. A child module that continues referencing the 
parent's property will resolve to the old value, since the parent's 
`<properties>` cannot be updated in an incremental release. The fix is to 
declare the updated property in the child module's own `<properties>` block — 
Maven child properties override parent properti [...]
 
-**Incremental release example** (upgrading janino `3.0.11` → `3.1.12`):
+**Incremental release example** (upgrading Hazelcast `5.1.7` → `5.3.5`):
 
 Parent `pom.xml` (already released, cannot be changed):
 ```xml
-<janino.verion>3.0.11</janino.verion>
+<hazelcast.version>5.1.7</hazelcast.version>
 ```
 
-Child `seatunnel-shade-janino/pom.xml` **before** incremental release:
+Child `seatunnel-shade-hazelcast/pom.xml` **before** incremental release:
 ```xml
 <parent>
     <groupId>org.apache.seatunnel</groupId>
     <artifactId>seatunnel-shade</artifactId>
-    <version>3.0.0</version>
+    <version>3.0.1</version>
 </parent>
 
-<artifactId>seatunnel-shade-janino</artifactId>
-<version>${janino.verion}-${seatunnel.shade.version}</version>
+<artifactId>seatunnel-shade-hazelcast</artifactId>
+<version>${hazelcast.version}-${seatunnel.shade.version}</version>
 ```
 
-Child `seatunnel-shade-janino/pom.xml` **after** incremental release:
+Child `seatunnel-shade-hazelcast/pom.xml` **after** incremental release:
 ```xml
 <parent>
     <groupId>org.apache.seatunnel</groupId>
     <artifactId>seatunnel-shade</artifactId>
-    <version>3.0.0</version>
+    <version>3.0.1</version>
 </parent>
 
+<artifactId>seatunnel-shade-hazelcast</artifactId>
+<version>${hazelcast.version}-${seatunnel.shade.version}</version>   <!-- 
resolves to 5.3.5-3.0.1 -->
+
 <properties>
-    <janino.verion>3.1.12</janino.verion>   <!-- overrides parent's property 
-->
+    <hazelcast.version>5.3.5</hazelcast.version>   <!-- overrides parent's 
property -->
 </properties>
-
-<artifactId>seatunnel-shade-janino</artifactId>
-<version>${janino.verion}-${seatunnel.shade.version}</version>   <!-- resolves 
to 3.1.12-3.0.0 -->
 ```
 
 Deploy with `-pl` to avoid touching unchanged modules:
 ```bash
-mvn -B -DskipTests -Drat.skip=true -pl seatunnel-shade-janino clean deploy
+mvn -B -DskipTests -Drat.skip=true -pl seatunnel-shade-hazelcast clean deploy
 ```
 
 ### Tagging
 
 ```bash
-git tag v3.0.0.fix
-git push origin v3.0.0.fix
+git tag v3.0.1
+git push origin v3.0.1
 ```
 
+`v3.0.1` is the existing release tag; use a new tag for the next release.
+
 ## Adding a new module
 
 1. Add the new module to `<modules>` and `<properties>` in root `pom.xml`.
@@ -137,7 +146,7 @@ git push origin v3.0.0.fix
     <parent>
         <groupId>org.apache.seatunnel</groupId>
         <artifactId>seatunnel-shade</artifactId>
-        <version>3.0.0</version>
+        <version>3.0.2-SNAPSHOT</version>
     </parent>
 
     <artifactId>seatunnel-shade-xxx</artifactId>
@@ -205,25 +214,26 @@ In SeaTunnel's root `pom.xml`, each shade module has a 
corresponding version pro
 
 ```xml
 <properties>
-    <seatunnel.shade.version>3.0.0</seatunnel.shade.version>
+    <seatunnel.shade.version>3.0.1</seatunnel.shade.version>
+    
<seatunnel.shade.hazelcast.version>5.1.7</seatunnel.shade.hazelcast.version>
     <seatunnel.shade.guava.version>27.0-jre</seatunnel.shade.guava.version>
-    <seatunnel.shade.janino.version>3.0.11</seatunnel.shade.janino.version>
+    <seatunnel.shade.janino.version>3.1.12</seatunnel.shade.janino.version>
     
<seatunnel.shade.scala-compiler.version>2.12.15</seatunnel.shade.scala-compiler.version>
     <seatunnel.shade.calcite.version>1.38.0</seatunnel.shade.calcite.version>
     <!-- ... other shade modules ... -->
 </properties>
 ```
 
-The effective dependency version is assembled as 
`${seatunnel.shade.<lib>.version}-${seatunnel.shade.version}` (e.g. 
`1.38.0-3.0.0`).
+The effective dependency version is assembled as 
`${seatunnel.shade.<lib>.version}-${seatunnel.shade.version}` (e.g. 
`1.38.0-3.0.1`).
 
-When a shade module is updated, bump the corresponding `<lib>.version` 
property. For example, after upgrading janino from `3.0.11` to `3.1.12`:
+When a shade module is updated, bump the corresponding `<lib>.version` 
property. For example, after a partial release upgrading Hazelcast from `5.1.7` 
to `5.3.5`:
 
 ```diff
-- <seatunnel.shade.janino.version>3.0.11</seatunnel.shade.janino.version>
-+ <seatunnel.shade.janino.version>3.1.12</seatunnel.shade.janino.version>
+- <seatunnel.shade.hazelcast.version>5.1.7</seatunnel.shade.hazelcast.version>
++ <seatunnel.shade.hazelcast.version>5.3.5</seatunnel.shade.hazelcast.version>
 ```
 
-If the `seatunnel.shade.version` itself changes (e.g. `3.0.0` → `3.0.1`), it 
affects **all** shade dependencies and every module must be republished.
+If the `seatunnel.shade.version` itself changes (e.g. `3.0.1` → `3.0.2`), it 
affects **all** shade dependencies and every module must be republished.
 
 ### 2. Declare the shaded dependency
 
@@ -237,7 +247,7 @@ All shade modules are centrally managed in SeaTunnel's root 
`<dependencyManageme
 </dependency>
 ```
 
-Existing entries (all 13 modules):
+Existing modules (14 in total) follow this pattern:
 
 ```xml
 <dependency>
@@ -261,7 +271,6 @@ Existing entries (all 13 modules):
     
<version>${seatunnel.shade.calcite.version}-${seatunnel.shade.version}</version>
 </dependency>
 <!-- ... remaining modules follow the same pattern ... -->
-</dependency>
 ```
 
 ### Summary checklist
diff --git a/pom.xml b/pom.xml
index bb0f999..7a3a1fb 100644
--- a/pom.xml
+++ b/pom.xml
@@ -30,7 +30,7 @@
 
     <groupId>org.apache.seatunnel</groupId>
     <artifactId>seatunnel-shade</artifactId>
-    <version>3.0.1</version>
+    <version>3.0.2-SNAPSHOT</version>
     <packaging>pom</packaging>
     <name>SeaTunnel : Shade :</name>
 
@@ -88,7 +88,7 @@
         
<maven-dependency-plugin.version>3.1.1</maven-dependency-plugin.version>
         
<maven-scm-provider-jgit.version>1.9.5</maven-scm-provider-jgit.version>
         
<seatunnel.shade.package>org.apache.seatunnel.shade</seatunnel.shade.package>
-        <seatunnel.shade.version>3.0.1</seatunnel.shade.version>
+        <seatunnel.shade.version>3.0.2-SNAPSHOT</seatunnel.shade.version>
         <jackson.version>2.15.4</jackson.version>
         <arrow.version>15.0.1</arrow.version>
         <enableSourceJarCreation>true</enableSourceJarCreation>
diff --git a/seatunnel-shade-arrow/pom.xml b/seatunnel-shade-arrow/pom.xml
index 35d8727..3a858c4 100644
--- a/seatunnel-shade-arrow/pom.xml
+++ b/seatunnel-shade-arrow/pom.xml
@@ -23,7 +23,7 @@
     <parent>
         <groupId>org.apache.seatunnel</groupId>
         <artifactId>seatunnel-shade</artifactId>
-        <version>3.0.1</version>
+        <version>3.0.2-SNAPSHOT</version>
     </parent>
 
     <artifactId>seatunnel-shade-arrow</artifactId>
diff --git a/seatunnel-shade-calcite/pom.xml b/seatunnel-shade-calcite/pom.xml
index b378329..146806d 100644
--- a/seatunnel-shade-calcite/pom.xml
+++ b/seatunnel-shade-calcite/pom.xml
@@ -23,7 +23,7 @@
     <parent>
         <groupId>org.apache.seatunnel</groupId>
         <artifactId>seatunnel-shade</artifactId>
-        <version>3.0.1</version>
+        <version>3.0.2-SNAPSHOT</version>
     </parent>
 
     <artifactId>seatunnel-shade-calcite</artifactId>
diff --git a/seatunnel-shade-commons-lang3/pom.xml 
b/seatunnel-shade-commons-lang3/pom.xml
index 708b4cd..77cd7f2 100644
--- a/seatunnel-shade-commons-lang3/pom.xml
+++ b/seatunnel-shade-commons-lang3/pom.xml
@@ -23,7 +23,7 @@
     <parent>
         <groupId>org.apache.seatunnel</groupId>
         <artifactId>seatunnel-shade</artifactId>
-        <version>3.0.1</version>
+        <version>3.0.2-SNAPSHOT</version>
     </parent>
 
     <artifactId>seatunnel-shade-commons-lang3</artifactId>
diff --git a/seatunnel-shade-guava/pom.xml b/seatunnel-shade-guava/pom.xml
index 27c00bf..14f9c9a 100644
--- a/seatunnel-shade-guava/pom.xml
+++ b/seatunnel-shade-guava/pom.xml
@@ -23,7 +23,7 @@
     <parent>
         <groupId>org.apache.seatunnel</groupId>
         <artifactId>seatunnel-shade</artifactId>
-        <version>3.0.1</version>
+        <version>3.0.2-SNAPSHOT</version>
     </parent>
 
     <artifactId>seatunnel-shade-guava</artifactId>
diff --git a/seatunnel-shade-hadoop-aws/pom.xml 
b/seatunnel-shade-hadoop-aws/pom.xml
index 7397f60..1109783 100644
--- a/seatunnel-shade-hadoop-aws/pom.xml
+++ b/seatunnel-shade-hadoop-aws/pom.xml
@@ -23,7 +23,7 @@
     <parent>
         <groupId>org.apache.seatunnel</groupId>
         <artifactId>seatunnel-shade</artifactId>
-        <version>3.0.1</version>
+        <version>3.0.2-SNAPSHOT</version>
     </parent>
 
     <artifactId>seatunnel-shade-hadoop-aws</artifactId>
diff --git a/seatunnel-shade-hadoop3-uber/pom.xml 
b/seatunnel-shade-hadoop3-uber/pom.xml
index 3f965c1..577bb66 100644
--- a/seatunnel-shade-hadoop3-uber/pom.xml
+++ b/seatunnel-shade-hadoop3-uber/pom.xml
@@ -23,7 +23,7 @@
     <parent>
         <groupId>org.apache.seatunnel</groupId>
         <artifactId>seatunnel-shade</artifactId>
-        <version>3.0.1</version>
+        <version>3.0.2-SNAPSHOT</version>
     </parent>
 
     <artifactId>seatunnel-shade-hadoop3-uber</artifactId>
diff --git a/seatunnel-shade-hazelcast/pom.xml 
b/seatunnel-shade-hazelcast/pom.xml
index 00d26dc..595a618 100644
--- a/seatunnel-shade-hazelcast/pom.xml
+++ b/seatunnel-shade-hazelcast/pom.xml
@@ -23,7 +23,7 @@
     <parent>
         <groupId>org.apache.seatunnel</groupId>
         <artifactId>seatunnel-shade</artifactId>
-        <version>3.0.1</version>
+        <version>3.0.2-SNAPSHOT</version>
     </parent>
 
     <artifactId>seatunnel-shade-hazelcast</artifactId>
diff --git a/seatunnel-shade-hikari/pom.xml b/seatunnel-shade-hikari/pom.xml
index 3fb7a80..131dc2a 100644
--- a/seatunnel-shade-hikari/pom.xml
+++ b/seatunnel-shade-hikari/pom.xml
@@ -23,7 +23,7 @@
     <parent>
         <groupId>org.apache.seatunnel</groupId>
         <artifactId>seatunnel-shade</artifactId>
-        <version>3.0.1</version>
+        <version>3.0.2-SNAPSHOT</version>
     </parent>
 
     <artifactId>seatunnel-shade-hikari</artifactId>
diff --git a/seatunnel-shade-jackson-yaml/pom.xml 
b/seatunnel-shade-jackson-yaml/pom.xml
index 88c4e04..c592edf 100644
--- a/seatunnel-shade-jackson-yaml/pom.xml
+++ b/seatunnel-shade-jackson-yaml/pom.xml
@@ -19,7 +19,7 @@
     <parent>
         <groupId>org.apache.seatunnel</groupId>
         <artifactId>seatunnel-shade</artifactId>
-        <version>3.0.1</version>
+        <version>3.0.2-SNAPSHOT</version>
     </parent>
 
     <artifactId>seatunnel-shade-jackson-yaml</artifactId>
diff --git a/seatunnel-shade-jackson/pom.xml b/seatunnel-shade-jackson/pom.xml
index b0cbd80..3a8184e 100644
--- a/seatunnel-shade-jackson/pom.xml
+++ b/seatunnel-shade-jackson/pom.xml
@@ -23,7 +23,7 @@
     <parent>
         <groupId>org.apache.seatunnel</groupId>
         <artifactId>seatunnel-shade</artifactId>
-        <version>3.0.1</version>
+        <version>3.0.2-SNAPSHOT</version>
     </parent>
 
     <artifactId>seatunnel-shade-jackson</artifactId>
diff --git a/seatunnel-shade-janino/pom.xml b/seatunnel-shade-janino/pom.xml
index 47f2907..f918175 100644
--- a/seatunnel-shade-janino/pom.xml
+++ b/seatunnel-shade-janino/pom.xml
@@ -24,7 +24,7 @@
     <parent>
         <groupId>org.apache.seatunnel</groupId>
         <artifactId>seatunnel-shade</artifactId>
-        <version>3.0.1</version>
+        <version>3.0.2-SNAPSHOT</version>
     </parent>
 
     <artifactId>seatunnel-shade-janino</artifactId>
diff --git a/seatunnel-shade-jetty/pom.xml b/seatunnel-shade-jetty/pom.xml
index 886fbe3..7b7db9a 100644
--- a/seatunnel-shade-jetty/pom.xml
+++ b/seatunnel-shade-jetty/pom.xml
@@ -23,7 +23,7 @@
     <parent>
         <groupId>org.apache.seatunnel</groupId>
         <artifactId>seatunnel-shade</artifactId>
-        <version>3.0.1</version>
+        <version>3.0.2-SNAPSHOT</version>
     </parent>
 
     <artifactId>seatunnel-shade-jetty</artifactId>
diff --git a/seatunnel-shade-scala-compiler/pom.xml 
b/seatunnel-shade-scala-compiler/pom.xml
index a9d9aa2..a3a6b50 100644
--- a/seatunnel-shade-scala-compiler/pom.xml
+++ b/seatunnel-shade-scala-compiler/pom.xml
@@ -24,7 +24,7 @@
     <parent>
         <groupId>org.apache.seatunnel</groupId>
         <artifactId>seatunnel-shade</artifactId>
-        <version>3.0.1</version>
+        <version>3.0.2-SNAPSHOT</version>
     </parent>
 
     <properties>
diff --git a/seatunnel-shade-thrift-service/pom.xml 
b/seatunnel-shade-thrift-service/pom.xml
index 04d8954..b5fa845 100644
--- a/seatunnel-shade-thrift-service/pom.xml
+++ b/seatunnel-shade-thrift-service/pom.xml
@@ -23,7 +23,7 @@
     <parent>
         <groupId>org.apache.seatunnel</groupId>
         <artifactId>seatunnel-shade</artifactId>
-        <version>3.0.1</version>
+        <version>3.0.2-SNAPSHOT</version>
     </parent>
 
     <artifactId>seatunnel-shade-thrift-service</artifactId>

Reply via email to