karatelabs · codehackerr · Sep 22, 2023 · Sep 22, 2023 · Sep 22, 2023 · Sep 25, 2023
diff --git a/.github/workflows/maven-build.yml b/.github/workflows/maven-build.yml
@@ -2,7 +2,7 @@ name: maven-build
 
 on:
   push:
-    branches: [ master, develop, java11 ]
+    branches: [ master, develop ]
   pull_request:
     branches: [ master, develop ]
 
@@ -13,11 +13,11 @@ jobs:
     steps:
     - name: git checkout
       uses: actions/checkout@v4    
-    - name: set up jdk 11
-      uses: actions/setup-java@v3
+    - name: set up jdk 17
+      uses: actions/setup-java@v4
       with:
         distribution: adopt
-        java-version: 11
+        java-version: 17
     - name: cache maven packages
       uses: actions/cache@v4
       with:

diff --git a/.github/workflows/maven-release.yml b/.github/workflows/maven-release.yml
@@ -4,9 +4,14 @@ on:
   workflow_dispatch:
     inputs:
       version:
-        description: version
         required: true
         default: 'X.X.X.RCX'
+      docker:
+        required: true  
+        type: choice
+        options:
+        - 'enabled'
+        - 'disabled'         
 
 jobs:
   build:
@@ -15,11 +20,11 @@ jobs:
     steps:
     - name: git checkout
       uses: actions/checkout@v4
-    - name: set up jdk 11
-      uses: actions/setup-java@v3
+    - name: set up jdk 17
+      uses: actions/setup-java@v4
       with:
         distribution: adopt
-        java-version: 11
+        java-version: 17
         server-id: ossrh
         server-username: MAVEN_USERNAME
         server-password: MAVEN_PASSWORD
@@ -29,23 +34,26 @@ jobs:
       run: |
         mvn versions:set versions:commit -B -ntp -DnewVersion=${{ github.event.inputs.version }}
     - name: docker build
+      if: ( github.event.inputs.docker == 'enabled' )
       run: |
         mvn clean install -B -ntp -DskipTests -P pre-release
         ./build-docker.sh
     - name: docker login
+      if: ( github.event.inputs.docker == 'enabled' )
       uses: docker/login-action@343f7c4344506bcbf9b4de18042ae17996df046d
       with:
         username: ${{ secrets.DOCKER_USERNAME }}
         password: ${{ secrets.DOCKER_PASSWORD }}
     - name: docker push
+      if: ( github.event.inputs.docker == 'enabled' )
       run: |        
         docker tag karate-chrome karatelabs/karate-chrome:${{ github.event.inputs.version }}
         docker tag karate-chrome karatelabs/karate-chrome:latest
         docker push karatelabs/karate-chrome:${{ github.event.inputs.version }}
         docker push karatelabs/karate-chrome:latest
     - name: maven deploy to central
       env:
-        MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }}
+        MAVEN_USERNAME: ${{ secrets.OSSRH_TOKEN_USER }}
         MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }}
         MAVEN_GPG_PASSPHRASE: ${{ secrets.OSSRH_GPG_SECRET_KEY_PASSWORD }}
       run: |

diff --git a/README.md b/README.md
@@ -47,8 +47,8 @@
   </a>
 </div>
 <div>
-  <a href="https://central.sonatype.com/namespace/com.intuit.karate">
-    <img src="https://img.shields.io/maven-central/v/com.intuit.karate/karate-core.svg"/>
+  <a href="https://central.sonatype.com/namespace/io.karatelabs">
+    <img src="https://img.shields.io/maven-central/v/io.karatelabs/karate-core.svg"/>
   </a>
   <a href="https://github.com/karatelabs/karate/actions?query=workflow%3Amaven-build">
     <img src="https://github.com/karatelabs/karate/actions/workflows/maven-build.yml/badge.svg?branch=develop"/>
@@ -1790,6 +1790,8 @@ This can be easily solved by using `java.math.BigDecimal`:
 * match json == '{"num":123123123123}'
 ```
 
+For more tips, refer [here](https://stackoverflow.com/a/77576066/143475).
+
 ## `doc`
 Karate has a built-in HTML templating engine that can be used to insert additional custom HTML into the test-reports. Here is an [example](karate-core/src/test/java/com/intuit/karate/core/users-doc.feature):
 

diff --git a/build-docker.sh b/build-docker.sh
@@ -11,9 +11,9 @@ mvn versions:set versions:commit -B -ntp -DnewVersion=${KARATE_VERSION} -f examp
 mvn clean test -B -ntp -f examples/gatling/pom.xml
 
 # copy only karate jars to a place where the docker image build can add from
-KARATE_REPO=karate-docker/karate-chrome/target/repository/com/intuit
+KARATE_REPO=karate-docker/karate-chrome/target/repository/io/karatelabs
 mkdir -p ${KARATE_REPO}
-cp -r ~/.m2/repository/com/intuit/karate ${KARATE_REPO}
+cp -r ~/.m2/repository/io/karatelabs ${KARATE_REPO}
 
 # create / copy the karate fatjar so that the docker image build can add it
 mvn package -B -ntp -P fatjar -DskipTests -f karate-core/pom.xml

diff --git a/examples/consumer-driven-contracts/payment-consumer/pom.xml b/examples/consumer-driven-contracts/payment-consumer/pom.xml
@@ -3,7 +3,7 @@
     <modelVersion>4.0.0</modelVersion>
 
     <parent>
-        <groupId>com.intuit.karate.examples</groupId>
+        <groupId>io.karatelabs.examples</groupId>
         <artifactId>examples-cdc</artifactId>
         <version>1.0-SNAPSHOT</version>
     </parent>
@@ -13,7 +13,7 @@
 
     <dependencies>
         <dependency>
-            <groupId>com.intuit.karate.examples</groupId>
+            <groupId>io.karatelabs.examples</groupId>
             <artifactId>examples-cdc-producer</artifactId>
             <version>${project.version}</version>
         </dependency>

diff --git a/examples/consumer-driven-contracts/payment-producer/pom.xml b/examples/consumer-driven-contracts/payment-producer/pom.xml
@@ -3,7 +3,7 @@
     <modelVersion>4.0.0</modelVersion>
 
     <parent>
-        <groupId>com.intuit.karate.examples</groupId>
+        <groupId>io.karatelabs.examples</groupId>
         <artifactId>examples-cdc</artifactId>
         <version>1.0-SNAPSHOT</version>
     </parent>

diff --git a/examples/consumer-driven-contracts/pom.xml b/examples/consumer-driven-contracts/pom.xml
@@ -2,7 +2,7 @@
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
 
-    <groupId>com.intuit.karate.examples</groupId>
+    <groupId>io.karatelabs.examples</groupId>
     <artifactId>examples-cdc</artifactId>
     <version>1.0-SNAPSHOT</version>
     <packaging>pom</packaging>
@@ -24,7 +24,7 @@
 
     <dependencies>
         <dependency>
-            <groupId>com.intuit.karate</groupId>
+            <groupId>io.karatelabs</groupId>
             <artifactId>karate-core</artifactId>
             <version>${karate.version}</version>
             <scope>test</scope>

diff --git a/examples/gatling/build.gradle b/examples/gatling/build.gradle
@@ -3,11 +3,11 @@ plugins {
 }
 
 ext {
-    karateVersion = '1.4.1'
+    karateVersion = '1.5.0.RC1'
 }
 
 dependencies {
-    testImplementation "com.intuit.karate:karate-gatling:${karateVersion}"
+    testImplementation "io.karatelabs:karate-gatling:${karateVersion}"
 }
 
 repositories {

diff --git a/examples/gatling/pom.xml b/examples/gatling/pom.xml
@@ -2,7 +2,7 @@
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
 
-    <groupId>com.intuit.karate.examples</groupId>
+    <groupId>io.karatelabs.examples</groupId>
     <artifactId>examples-gatling</artifactId>
     <version>1.5.0-SNAPSHOT</version>
     <packaging>jar</packaging>       
@@ -18,15 +18,15 @@
 
     <dependencies>
         <dependency>
-            <groupId>com.intuit.karate</groupId>
+            <groupId>io.karatelabs</groupId>
             <artifactId>karate-core</artifactId>
             <version>${karate.version}</version>
             <scope>test</scope>
             <!-- next line is normally not required, but is here for testing karate release process -->
             <classifier>all</classifier>            
         </dependency>        
         <dependency>
-            <groupId>com.intuit.karate</groupId>
+            <groupId>io.karatelabs</groupId>
             <artifactId>karate-gatling</artifactId>
             <version>${karate.version}</version>
             <scope>test</scope>

diff --git a/examples/image-comparison/pom.xml b/examples/image-comparison/pom.xml
@@ -2,7 +2,7 @@
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
 
-    <groupId>com.intuit.karate.examples</groupId>
+    <groupId>io.karatelabs.examples</groupId>
     <artifactId>image-comparison-test</artifactId>
     <version>1.0-SNAPSHOT</version>
     <packaging>jar</packaging>
@@ -16,7 +16,7 @@
 
     <dependencies>
         <dependency>
-            <groupId>com.intuit.karate</groupId>
+            <groupId>io.karatelabs</groupId>
             <artifactId>karate-junit5</artifactId>
             <version>${karate.version}</version>
             <scope>test</scope>

diff --git a/examples/mobile-test/pom.xml b/examples/mobile-test/pom.xml
@@ -2,7 +2,7 @@
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
 
-    <groupId>com.intuit.karate.examples</groupId>
+    <groupId>io.karatelabs.examples</groupId>
     <artifactId>mobile-test</artifactId>
     <version>1.0-SNAPSHOT</version>
     <packaging>jar</packaging>
@@ -17,7 +17,7 @@
 
     <dependencies>
         <dependency>
-            <groupId>com.intuit.karate</groupId>
+            <groupId>io.karatelabs</groupId>
             <artifactId>karate-junit5</artifactId>
             <version>${karate.version}</version>
             <scope>test</scope>

diff --git a/examples/profiling-test/pom.xml b/examples/profiling-test/pom.xml
@@ -2,7 +2,7 @@
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
 
-    <groupId>com.intuit.karate.examples</groupId>
+    <groupId>io.karatelabs.examples</groupId>
     <artifactId>profiling-test</artifactId>
     <version>1.0-SNAPSHOT</version>
     <packaging>jar</packaging>
@@ -17,7 +17,7 @@
 
     <dependencies>
         <dependency>
-            <groupId>com.intuit.karate</groupId>
+            <groupId>io.karatelabs</groupId>
             <artifactId>karate-gatling</artifactId>
             <version>${karate.version}</version>
             <scope>test</scope>

diff --git a/examples/robot-test/pom.xml b/examples/robot-test/pom.xml
@@ -2,7 +2,7 @@
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
 
-    <groupId>com.intuit.karate.examples</groupId>
+    <groupId>io.karatelabs.examples</groupId>
     <artifactId>examples-robot-test</artifactId>
     <version>1.0-SNAPSHOT</version>
     <packaging>jar</packaging>
@@ -17,7 +17,7 @@
 
     <dependencies>
         <dependency>
-            <groupId>com.intuit.karate</groupId>
+            <groupId>io.karatelabs</groupId>
             <artifactId>karate-robot</artifactId>
             <version>${karate.version}</version>
             <scope>test</scope>

diff --git a/examples/ui-test/pom.xml b/examples/ui-test/pom.xml
@@ -2,7 +2,7 @@
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
 
-    <groupId>com.intuit.karate.examples</groupId>
+    <groupId>io.karatelabs.examples</groupId>
     <artifactId>examples-ui-test</artifactId>
     <version>1.0-SNAPSHOT</version>
     <packaging>jar</packaging>
@@ -16,7 +16,7 @@
 
     <dependencies>           
         <dependency>
-            <groupId>com.intuit.karate</groupId>
+            <groupId>io.karatelabs</groupId>
             <artifactId>karate-junit5</artifactId>
             <version>${karate.version}</version>
             <scope>test</scope>

diff --git a/jbang-catalog.json b/jbang-catalog.json
@@ -2,7 +2,7 @@
   "catalogs": {},
   "aliases": {
     "karate": {
-      "script-ref": "com.intuit.karate:karate-core:1.4.1:all"
+      "script-ref": "io.karatelabs:karate-core:1.5.0.RC1:all"
     }
   }
 }
diff --git a/karate-archetype/pom.xml b/karate-archetype/pom.xml
@@ -3,9 +3,9 @@
     <modelVersion>4.0.0</modelVersion>
 
     <parent>
-        <groupId>com.intuit.karate</groupId>
+        <groupId>io.karatelabs</groupId>
         <artifactId>karate-parent</artifactId>
-        <version>1.4.1</version>
+        <version>1.6.0-SNAPSHOT</version>
     </parent>
     <artifactId>karate-archetype</artifactId>
     <packaging>jar</packaging>

diff --git a/karate-archetype/src/main/resources/archetype-resources/pom.xml b/karate-archetype/src/main/resources/archetype-resources/pom.xml
@@ -12,12 +12,12 @@
         <java.version>11</java.version>
         <maven.compiler.version>3.11.0</maven.compiler.version>
         <maven.surefire.version>3.0.0</maven.surefire.version>
-        <karate.version>1.4.1</karate.version>
+        <karate.version>1.5.0.RC1</karate.version>
     </properties>    
 
     <dependencies>         
         <dependency>
-            <groupId>com.intuit.karate</groupId>
+            <groupId>io.karatelabs</groupId>
             <artifactId>karate-junit5</artifactId>
             <version>${karate.version}</version>
             <scope>test</scope>

diff --git a/karate-core/README.md b/karate-core/README.md
@@ -25,6 +25,7 @@
     | <a href="#karate-chrome">Docker / <code>karate-chrome</code></a>
     | <a href="#driver-types">Driver Types</a> 
     | <a href="#playwright">Playwright</a> 
+    | <a href="#playwright-legacy">Playwright Legacy</a> 
     | <a href="#timeout"><code>timeout()</code></a>
     | <a href="#driversessionid"><code>driver.sessionId</code></a>
   </td>
@@ -346,7 +347,36 @@ Note that some capabilities such as "headless" may be possible via the command-l
 
 Also see [`driver.sessionId`](#driversessionid).
 
+
 ### Playwright
+
+Driver that leverages [Playwright](https://playwright.dev) java native APIs.
+
+To use it, add the following dependency:
+```xml
+<dependency>
+    <groupId>io.karate</groupId>
+    <artifactId>karate-playwright</artifactId>
+    <scope>test</scope>
+</dependency>
+```
+
+And make sure it is declared before `io.karate:karate-core`.
+
+A server will be automatically started and made available to Karate without any extra-script. If you have one pre-started, you can still use the [`playwrightUrl`](#configure-driver) driver config.
+
+### `playwrightOptions`
+When using [Playwright](#playwright) you can omit this in which case Karate will default to Chrome (within Playwright) and the default browser window size.
+
+This can take the following keys:
+* `browserType` - defaults to `chromium`, can be set to the other [types that Playwright supports](https://playwright.dev/docs/core-concepts#browser), e.g. `firefox` and `webkit`
+* `context` - JSON which will be passed as the argument of the Playwright [`browser.newContext()`](https://playwright.dev/docs/api/class-browser#browsernewcontextoptions) call, needed typically to set the page dimensions
+* `channel` - defaults to chrome, for the `chromium` browserType, allows to specify which [flavor](https://playwright.dev/docs/browsers#google-chrome--microsoft-edge) to use
+* `installBrowsers` - defaults to `true`, whether or not all the supported browsers will be downloaded and installed by Playwright (once).  
+
+Note that there is a top-level config flag for `headless` mode. The default is: `* configure driver = { headless: false }`
+
+### Playwright Legacy
 To use [Playwright](https://playwright.dev), you need to start a Playwright server. If you have one pre-started, you need to use the [`playwrightUrl`](#configure-driver) driver config.
 
 Or you can set up an executable that can do it and log the URL to the console when the server is ready. The websocket URL will look like this: `ws://127.0.0.1:4444/0e0bd1c0bb2d4eb550d02c91046dd6e0`.
@@ -399,14 +429,6 @@ For convenience, Karate assumes by default that the executable name is `playwrig
 
 Based on the above details, you should be able to come up with a custom strategy to connect Karate to Playwright. And you can consider a [`driverTarget`](#custom-target) approach for complex needs such as using a Docker container for CI.
 
-### `playwrightOptions`
-When using [Playwright](#playwright) you can omit this in which case Karate will default to Chrome (within Playwright) and the default browser window size.
-
-This can take the following keys:
-* `browserType` - defaults to `chromium`, can be set to the other [types that Playwright supports](https://playwright.dev/docs/core-concepts#browser), e.g. `firefox` and `webkit`
-* `context` - JSON which will be passed as the argument of the Playwright [`browser.newContext()`](https://playwright.dev/docs/api/class-browser#browsernewcontextoptions) call, needed typically to set the page dimensions
-
-Note that there is a top-level config flag for `headless` mode. The default is: `* configure driver = { headless: false }`
 
 ## `configure driverTarget`
 The [`configure driver`](#configure-driver) options are fine for testing on "`localhost`" and when not in `headless` mode. But when the time comes for running your web-UI automation tests on a continuous integration server, things get interesting. To support all the various options such as Docker, headless Chrome, cloud-providers etc., Karate introduces the concept of a pluggable [`Target`](src/main/java/com/intuit/karate/driver/Target.java) where you just have to implement two methods:
@@ -1950,7 +1972,7 @@ Scenario:
 * screenshot()
 ```
 
-* `driver.intercept()` is supported only for the driver type `chrome`
+* `driver.intercept()` is fully supported only for the driver type `chrome`. [`Playwright`](#playwright) supports only [urlPatterns](https://chromedevtools.github.io/devtools-protocol/tot/Fetch/#type-RequestPattern)
 * you can route multiple URL patterns to the same Karate mock-feature, the format of each array-element under `patterns` can be found [here](https://chromedevtools.github.io/devtools-protocol/tot/Fetch/#type-RequestPattern).
   * the `*` wildcard (most likely what you need) will match any number of characters, e.g. `*myhost/some/path/*`
   * `?` will match any single character