feat(java): java implementation of dotprompt

Author: yesudeep

.github/workflows/publish_java.yml

@@ -0,0 +1,56 @@
+# Copyright 2025 Google LLC
+#
+# 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.
+#
+# SPDX-License-Identifier: Apache-2.0
+
+name: Publish Java Package
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  publish-java:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Set up JDK 21
+        uses: actions/setup-java@v4
+        with:
+          java-version: '21'
+          distribution: 'temurin'
+          
+      - name: Setup Bazel
+        uses: bazelbuild/setup-bazelisk@v3
+        
+      - name: Import GPG key
+        id: import_gpg
+        uses: crazy-max/ghaction-import-gpg@v6
+        with:
+          gpg_private_key: ${{ secrets.MAVEN_GPG_PRIVATE_KEY }}
+          passphrase: ${{ secrets.MAVEN_GPG_PASSPHRASE }}
+
+      - name: Publish to Maven Central
+        env:
+          MAVEN_USERNAME: ${{ secrets.OSSRH_USERNAME }}
+          MAVEN_PASSWORD: ${{ secrets.OSSRH_TOKEN }}
+        run: |
+          ./scripts/publish-java.sh \
+            "${{ steps.import_gpg.outputs.keyring }}" \
+            "${{ secrets.MAVEN_GPG_PASSPHRASE }}" \
+            "$MAVEN_USERNAME" \
+            "$MAVEN_PASSWORD"

docs/contributing/coding_guidelines.md

@@ -7,6 +7,13 @@ You are an expert Python developer contributing to the Google Dotprompt project.
 - **Language**: Python.
 - **Environment Management**: Use `uv` for packaging and environment management.
 
+### Libraries
+- **JSON**: Use **Jackson** for JSON parsing and serialization. Avoid Gson.
+- **Testing**: Use **Google Truth** (`com.google.truth.Truth`) for assertions. Use JUnit 4/5 for test runners.
+- **Async**: Use **Dagger Producers** for asynchronous operations where applicable.
+- **Utilities**: Use **Guava** for immutable collections and common utilities.
+- **Dependency Injection**: Use **Dagger** for dependency injection.
+
 ## 2. Typing & Style
 - **Type Unions**: Use the pipe operator `|` (PEP 604) for union types (e.g., `int | str`) instead of `typing.Union`. Use `| None` for optional types.
 - **Generics**: Use standard collection generics (PEP 585) like `list`, `dict`, `tuple` (lowercase) for type hints instead of `typing.List`, `typing.Dict`.

java.MODULE.bazel

@@ -50,6 +50,12 @@ maven.install(
         "com.google.truth:truth:1.4.4",
         "com.github.jknack:handlebars:4.4.0",
         "com.google.guava:guava:33.4.8-jre",
+        "com.google.dagger:dagger:2.55",
+        "com.google.dagger:dagger-compiler:2.55",
+        "com.google.dagger:dagger-producers:2.55",
+        "com.fasterxml.jackson.core:jackson-databind:2.18.2",
+        "com.fasterxml.jackson.dataformat:jackson-dataformat-yaml:2.18.2",
+        "javax.inject:javax.inject:1",
     ],
     lock_file = "//:maven_install.json",
     repositories = [

java/com/google/dotprompt/BUILD.bazel

@@ -13,3 +13,83 @@
 # limitations under the License.
 #
 # SPDX-License-Identifier: Apache-2.0
+
+load("@rules_java//java:defs.bzl", "java_library", "java_test")
+load("@rules_jvm_external//:defs.bzl", "java_export")
+
+java_library(
+    name = "dotprompt",
+    srcs = glob(
+        ["**/*.java"],
+        exclude = ["**/*Test.java"],
+    ),
+    deps = [
+        "@maven//:com_fasterxml_jackson_core_jackson_annotations",
+        "@maven//:com_fasterxml_jackson_core_jackson_core",
+        "@maven//:com_fasterxml_jackson_core_jackson_databind",
+        "@maven//:com_fasterxml_jackson_dataformat_jackson_dataformat_yaml",
+        "@maven//:com_github_jknack_handlebars",
+        "@maven//:com_google_dagger_dagger",
+        "@maven//:com_google_dagger_dagger_producers",
+        "@maven//:com_google_guava_guava",
+        "@maven//:javax_inject_javax_inject",
+    ],
+    visibility = ["//visibility:public"],
+)
+
+java_export(
+    name = "dotprompt_pkg",
+    maven_coordinates = "com.google.dotprompt:dotprompt:0.1.0",
+    pom_template = "pom_template.xml",
+    visibility = ["//visibility:public"],
+    runtime_deps = [":dotprompt"],
+)
+
+java_test(
+    name = "DotpromptTest",
+    srcs = ["DotpromptTest.java"],
+    test_class = "com.google.dotprompt.DotpromptTest",
+    deps = [
+        ":dotprompt",
+        "@maven//:com_google_guava_guava",
+        "@maven//:com_google_truth_truth",
+        "@maven//:junit_junit",
+    ],
+)
+
+java_test(
+    name = "SpecTest",
+    srcs = ["SpecTest.java"],
+    data = ["//spec"],
+    test_class = "com.google.dotprompt.SpecTest",
+    deps = [
+        ":dotprompt",
+        "@maven//:com_fasterxml_jackson_core_jackson_databind",
+        "@maven//:com_fasterxml_jackson_dataformat_jackson_dataformat_yaml",
+        "@maven//:com_google_guava_guava",
+        "@maven//:com_google_truth_truth",
+        "@maven//:junit_junit",
+    ],
+)
+
+java_test(
+    name = "PromptLoaderTest",
+    srcs = ["PromptLoaderTest.java"],
+    test_class = "com.google.dotprompt.PromptLoaderTest",
+    deps = [
+        ":dotprompt",
+        "@maven//:com_google_truth_truth",
+        "@maven//:junit_junit",
+    ],
+)
+
+java_test(
+    name = "ModelTest",
+    srcs = ["ModelTest.java"],
+    test_class = "com.google.dotprompt.ModelTest",
+    deps = [
+        ":dotprompt",
+        "@maven//:com_google_truth_truth",
+        "@maven//:junit_junit",
+    ],
+)