feat: Migrate java-test-helpers to java-core. (#90)

Author: kinyoklion

.github/workflows/manual-publish-docs.yml

@@ -8,6 +8,7 @@ on:
         options:
           - lib/shared/common
           - lib/shared/internal
+          - lib/shared/test-helpers
           - lib/sdk/server
           - lib/java-server-sdk-otel
           - lib/java-server-sdk-redis-store

.github/workflows/manual-publish.yml

@@ -9,6 +9,7 @@ on:
         options:
           - lib/shared/common
           - lib/shared/internal
+          - lib/shared/test-helpers
           - lib/sdk/server
           - lib/java-server-sdk-otel
           - lib/java-server-sdk-redis-store

.github/workflows/release-please.yml

@@ -12,6 +12,7 @@ jobs:
     outputs:
       package-sdk-common-released: ${{ steps.release.outputs['lib/shared/common--release_created'] }}
       package-sdk-internal-released: ${{ steps.release.outputs['lib/shared/internal--release_created'] }}
+      package-test-helpers-released: ${{ steps.release.outputs['lib/shared/test-helpers--release_created'] }}
       package-server-sdk-released: ${{ steps.release.outputs['lib/sdk/server--release_created'] }}
       package-server-sdk-otel-released: ${{ steps.release.outputs['lib/java-server-sdk-otel--release_created'] }}
       package-server-sdk-redis-store-released: ${{ steps.release.outputs['lib/java-server-sdk-redis-store--release_created'] }}
@@ -188,3 +189,36 @@ jobs:
           sonatype_password: ${{ env.SONATYPE_PASSWORD }}
           aws_role: ${{ vars.AWS_ROLE_ARN }}
           token: ${{ secrets.GITHUB_TOKEN }}
+
+  release-test-helpers:
+    runs-on: ubuntu-latest
+    needs: release-please
+    permissions:
+      id-token: write
+      contents: write
+      pull-requests: write
+    if: ${{ needs.release-please.outputs.package-test-helpers-released == 'true'}}
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: launchdarkly/gh-actions/actions/[email protected]
+        name: Get secrets
+        with:
+          aws_assume_role: ${{ vars.AWS_ROLE_ARN }}
+          ssm_parameter_pairs: '/production/common/releasing/sonatype/central/username = SONATYPE_USER_NAME,
+          /production/common/releasing/sonatype/central/password = SONATYPE_PASSWORD,
+          /production/common/releasing/java/keyId = SIGNING_KEY_ID'
+          s3_path_pairs: 'launchdarkly-releaser/java/code-signing-keyring.gpg = code-signing-keyring.gpg'
+
+      - uses: ./.github/actions/full-release
+        with:
+          workspace_path: lib/shared/test-helpers
+          dry_run: false
+          prerelease: false
+          code_signing_keyring: ${{ github.workspace }}/code-signing-keyring.gpg
+          signing_key_id: ${{ env.SIGNING_KEY_ID }}
+          signing_key_passphrase: ''
+          sonatype_username: ${{ env.SONATYPE_USER_NAME }}
+          sonatype_password: ${{ env.SONATYPE_PASSWORD }}
+          aws_role: ${{ vars.AWS_ROLE_ARN }}
+          token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/test-helpers.yml

@@ -0,0 +1,33 @@
+name: test-helpers
+
+on:
+  push:
+    branches: [main, 'feat/**']
+    paths-ignore:
+      - '**.md' #Do not need to run CI for markdown changes.
+  pull_request:
+    branches: [main, 'feat/**']
+    paths-ignore:
+      - '**.md'
+
+jobs:
+  build-test-helpers:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        java-version: [8, 11, 17, 19]
+        os: [ubuntu-latest]
+        include:
+          - java-version: 11
+            os: windows-latest
+          - java-version: 17
+            os: windows-latest
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Shared CI Steps
+        uses: ./.github/actions/ci
+        with:
+          workspace_path: 'lib/shared/test-helpers'
+          java_version: ${{ matrix.java-version }}

.release-please-manifest.json

@@ -3,5 +3,6 @@
   "lib/java-server-sdk-redis-store": "3.0.1",
   "lib/shared/common": "2.1.2",
   "lib/shared/internal": "1.5.1",
+  "lib/shared/test-helpers": "2.0.2",
   "lib/sdk/server": "7.10.2"
 }

lib/shared/test-helpers/.gitignore

@@ -0,0 +1,24 @@
+# Eclipse project files
+.classpath
+.project
+.settings
+
+# Intellij project files
+*.iml
+*.ipr
+*.iws
+.idea/
+ 
+#Gradle
+.gradletasknamecache
+.gradle/
+build/
+bin/
+out/
+classes/
+buildSrc/build
+buildSrc/.gradle
+
+# Test code that gets temporarily copied by our Android CI build
+src/androidTest/java/com/launchdarkly/sdk/**/*.java
+!src/androidTest/java/com/launchdarkly/sdk/BaseTest.java

lib/shared/test-helpers/CHANGELOG.md

@@ -0,0 +1,43 @@
+# Change log
+
+All notable changes to the project will be documented in this file. This project adheres to [Semantic Versioning](http://semver.org).
+
+## [2.0.2] - 2023-06-27
+### Changed:
+- Bumping Guava version to incorporate CVE fixes.
+
+## [2.0.1] - 2022-12-18
+(This release replaces the broken 2.0.0 release, which was accidentally duplicated from 1.3.0.)
+
+This release improves compatibility of the library with Android code by removing usage of Java 8 APIs that are not supported in Android. It also revises the embedded HTTP mechanism to use a fork of `nanohttpd` rather than the heavier-weight Jetty.
+
+### Changed:
+- All methods that took a `java.time.Duration` now take `long, TimeUnit` instead.
+- The `HttpServer` class is now based on a fork of the lightweight `nanohttpd` (https://github.com/launchdarkly-labs/nanohttpd) library. This should work correctly in any server-side Java environment; it has not been validated in Android, but the previous Jetty implementation did not work in Android anyway.
+
+## [2.0.0] - 2022-11-17
+This release improves compatibility of the library with Android code by removing usage of Java 8 APIs that are not supported in Android. It also revises the embedded HTTP mechanism to use a fork of `nanohttpd` rather than the heavier-weight Jetty.
+
+### Changed:
+- All methods that took a `java.time.Duration` now take `long, TimeUnit` instead.
+- The `HttpServer` class is now based on a fork of the lightweight `nanohttpd` (https://github.com/launchdarkly-labs/nanohttpd) library. This should work correctly in any server-side Java environment; it has not been validated in Android, but the previous Jetty implementation did not work in Android anyway.
+
+## [1.3.0] - 2022-08-29
+### Added:
+- `com.launchdarkly.testhelpers.tcptest`: this package is analogous to `httptest` but much simpler, providing a basic TCP listener that can be configured with behaviors like "close connections without sending a response" or "forward the connection to another port".
+- `com.launchdarkly.testhelpers.httptest.SpecialHttpConfigurations`: test helpers to validate several standard kinds of HTTP client configurations.
+
+## [1.2.0] - 2022-07-08
+### Added:
+- `TypeBehavior.singletonValueFactory` is a new method that can be used with `TypeBehavior.checkEqualsAndHashCode` to allow testing of types that have interned/singleton values.
+
+## [1.1.1] - 2022-06-17
+### Fixed:
+- Fixed Hamcrest dependency to use `hamcrest-library` rather than `hamcrest-all`, because JUnit (which is commonly used in any unit test code that would also use Hamcrest) has a transitive dependency on `hamcrest-library` and using both would result in duplication on the classpath.
+
+## [1.1.0] - 2021-07-21
+### Added:
+- `Assertions`, `ConcurrentHelpers`, `JsonAssertions`, `TempDir`, `TempFile`, `TypeBehavior`.
+
+## [1.0.0] - 2021-06-25
+Initial release.

lib/shared/test-helpers/CONTRIBUTING.md

@@ -0,0 +1,39 @@
+# Contributing to this project
+
+## Submitting bug reports and feature requests
+
+The LaunchDarkly SDK team monitors the [issue tracker](https://github.com/launchdarkly/java-core/issues) in the GitHub repository. Bug reports and feature requests specific to this project should be filed in this issue tracker. The SDK team will respond to all newly filed issues within two business days.
+
+## Submitting pull requests
+
+We encourage pull requests and other contributions from the community. Before submitting pull requests, ensure that all temporary or unintended code is removed. Don't worry about adding reviewers to the pull request; the LaunchDarkly SDK team will add themselves. The SDK team will acknowledge all pull requests within two business days.
+
+## Build instructions
+ 
+### Prerequisites
+ 
+The project builds with [Gradle](https://gradle.org/) and should be built against Java 8.
+ 
+### Building
+
+To build the project without running any tests:
+```
+./gradlew jar
+```
+
+If you wish to clean your working directory between builds, you can clean it by running:
+```
+./gradlew clean
+```
+
+If you wish to use your generated artifact by another Maven/Gradle project, you will likely want to publish the artifact to your local Maven repository so that your other project can access it.
+```
+./gradlew publishToMavenLocal
+```
+
+### Testing
+ 
+To build the project and run all unit tests:
+```
+./gradlew test
+```

lib/shared/test-helpers/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2021 Catamorphic, Co.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

lib/shared/test-helpers/NOTICE

@@ -0,0 +1,24 @@
+java-test-helpers
+Copyright 2021 Catamorphic, Co.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+================================================================================
+
+This project bundles the following dependencies under the BSD 3-Clause License.
+See bundled license files for details.
+
+- NanoHttpd (core module)
+  https://github.com/NanoHttpd/nanohttpd
+  Copyright (c) 2012-2013 by Paul S. Hawke, 2001, 2005-2013 by Jarno Elonen, 2010 by Konstantinos Togias
+  Files: com.launchdarkly.testhelpers.httptest.nanohttpd.*