Add licensing, versioning and tests (#9)

* Add LICENSE and NOTICE

Signed-off-by: teodordelibasic-db <[email protected]>

* Add CHANGELOG.md and NEXT_CHANGELOG.md

Signed-off-by: teodordelibasic-db <[email protected]>

* Add generate proto tool

Signed-off-by: teodordelibasic-db <[email protected]>

* Clean up usage of gRPC stubs and channels

Signed-off-by: teodordelibasic-db <[email protected]>

* Update README.md

Signed-off-by: teodordelibasic-db <[email protected]>

* Add tests

Signed-off-by: teodordelibasic-db <[email protected]>

* Fix formatting

Signed-off-by: teodordelibasic-db <[email protected]>

* Update pom.xml and README.md

Signed-off-by: teodordelibasic-db <[email protected]>

* Fix flaky test

Signed-off-by: teodordelibasic-db <[email protected]>

* Fix formatting

Signed-off-by: teodordelibasic-db <[email protected]>

* Uncomment token fetching

Signed-off-by: teodordelibasic-db <[email protected]>

* Use Maven central for publishing

Signed-off-by: teodordelibasic-db <[email protected]>

* Fix CONTRIBUTING.md

* Fix formatting

---------

Signed-off-by: teodordelibasic-db <[email protected]>

Author: teodordelibasic-db

.github/workflows/push.yml

@@ -7,25 +7,47 @@ on:
     types: [checks_requested]
 
 jobs:
+  tests-ubuntu:
+    uses: ./.github/workflows/test.yml
+    strategy:
+      fail-fast: false
+      matrix:
+        javaVersion: ['11', '17', '21']
+    with:
+      os: linux-ubuntu-latest
+      javaVersion: ${{ matrix.javaVersion }}
+
+  tests-windows:
+    uses: ./.github/workflows/test.yml
+    strategy:
+      fail-fast: false
+      matrix:
+        javaVersion: ['11', '17', '21']
+    with:
+      os: windows-server-latest
+      javaVersion: ${{ matrix.javaVersion }}
+
   fmt:
     runs-on:
       group: databricks-protected-runner-group
       labels: linux-ubuntu-latest
-    steps:
-      - name: Set up JDK 11
-        uses: actions/setup-java@v1
-        with:
-          java-version: 11
 
+    steps:
       - name: Checkout
         uses: actions/checkout@v4
 
-      - name: Cache Maven packages
-        uses: actions/cache@v4
+      - name: Set up JDK 11
+        uses: actions/setup-java@v4
         with:
-          path: ~/.m2
-          key: ${{ runner.os }}-m2-${{ hashFiles('**/pom.xml') }}
-          restore-keys: ${{ runner.os }}-m2
+          java-version: 11
+          distribution: 'temurin'
+          cache: 'maven'
 
       - name: Check formatting
-        run: mvn --errors spotless:check
+        run: mvn spotless:check
+
+      - name: Fail on formatting differences
+        if: failure()
+        run: |
+          echo "Code formatting issues detected. Run 'mvn spotless:apply' to fix."
+          exit 1

.github/workflows/test.yml

@@ -0,0 +1,48 @@
+name: Test Workflow
+
+on:
+  workflow_call:
+    inputs:
+      os:
+        required: true
+        type: string
+      javaVersion:
+        required: true
+        type: string
+
+jobs:
+  test:
+    strategy:
+      fail-fast: false
+    runs-on:
+      group: databricks-protected-runner-group
+      labels: ${{ inputs.os }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Unshallow
+        run: git fetch --prune --unshallow
+
+      - name: Set up JDK ${{ inputs.javaVersion }}
+        uses: actions/setup-java@v4
+        with:
+          java-version: ${{ inputs.javaVersion }}
+          distribution: 'temurin'
+          cache: 'maven'
+
+      - name: Build with Maven
+        run: mvn clean compile
+
+      - name: Run tests
+        run: mvn test
+
+      - name: Upload test results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: test-results-${{ inputs.os }}-java-${{ inputs.javaVersion }}
+          path: |
+            target/surefire-reports/
+            target/test-classes/
+          retention-days: 7

CHANGELOG.md

@@ -0,0 +1,17 @@
+# Version changelog
+
+## Release v0.1.0
+
+Initial release of the Databricks Zerobus Ingest SDK for Java.
+
+### API Changes
+
+- Added `ZerobusSdk` class for creating ingestion streams
+- Added `ZerobusStream` class for managing stateful gRPC streams
+- Added `RecordAcknowledgment` for blocking until record acknowledgment
+- Added `TableProperties` for configuring table schema and name
+- Added `StreamConfigurationOptions` for stream behavior configuration
+- Added `ZerobusException` and `NonRetriableException` for error handling
+- Added `StreamState` enum for tracking stream lifecycle
+- Added utility methods in `ZerobusSdkStubUtils` for gRPC stub management
+- Support for Java 8 and higher