BPJ is a Java 17+ interpolation library that lets you write readable placeholders like {name}, {product.value} and {user.getName()} in print, println, and format.

• Reduce Java boilerplate when building dynamic messages.
• Keep source code readable with template-style strings.
• Return interpolated strings with BPJ.format(...).
• Print interpolated text with BPJ.print(...) / BPJ.println(...).
• Choose between explicit runtime context or automatic build-time injection.

flowchart LR
  A["BPJ.println('Hello {user.name}')"] --> B{"Plugin active?"}
  B -->|No| C["Use explicit context overloads"]
  B -->|Yes| D["Build rewrites source and injects context"]
  C --> E["Resolved runtime output"]
  D --> E

<dependency>
  <groupId>io.github.oriontheprogrammer</groupId>
  <artifactId>bpj</artifactId>
  <version>0.3.1</version>
</dependency>

implementation "io.github.oriontheprogrammer:bpj:0.3.1"

Option A (bpj-starter-parent, easiest):

<parent>
  <groupId>io.github.oriontheprogrammer</groupId>
  <artifactId>bpj-starter-parent</artifactId>
  <version>0.3.1</version>
</parent>

Option B (bpj-spring-boot-parent, Spring Boot friendly):

<parent>
  <groupId>io.github.oriontheprogrammer</groupId>
  <artifactId>bpj-spring-boot-parent</artifactId>
  <version>0.3.1</version>
</parent>

Option C (manual plugin, for custom parent including spring-boot-starter-parent):

<build>
  <plugins>
    <plugin>
      <groupId>io.github.oriontheprogrammer</groupId>
      <artifactId>bpj-maven-plugin</artifactId>
      <version>0.3.1</version>
      <executions>
        <execution>
          <goals>
            <goal>prepare</goal>
          </goals>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

Recommended plugin DSL:

// settings.gradle
pluginManagement {
  repositories {
    gradlePluginPortal()
    mavenCentral()
  }
}

// build.gradle
plugins {
  id "java"
  id "io.github.oriontheprogrammer.bpj" version "0.3.1"
}

repositories {
  mavenCentral()
}

dependencies {
  implementation "io.github.oriontheprogrammer:bpj:0.3.1"
}

Legacy buildscript mode is still supported. See docs below.

Use this section if you want one-argument BPJ calls like:

BPJ.println("Hello {name}");

to resolve values automatically.

1. Add BPJ runtime dependency in pom.xml.
2. Activate one Maven option:
   • Parent option: bpj-starter-parent or bpj-spring-boot-parent.
   • Manual option: add bpj-maven-plugin with goal prepare.
3. Build through Maven:

mvn clean compile

Then verify generated files exist in:

• target/generated-sources/bpj

1. Add BPJ runtime dependency in build.gradle.
2. Add BPJ plugin id in build.gradle:

plugins {
  id "java"
  id "io.github.oriontheprogrammer.bpj" version "0.3.1"
}

3. Ensure pluginManagement includes gradlePluginPortal() and mavenCentral() in settings.gradle.
4. Build through Gradle:

./gradlew clean compileJava

Then verify generated files exist in:

• build/generated/sources/bpj/main

If you run main() directly from IDE without delegated Maven/Gradle build, transformation may be skipped. Run from terminal or enable delegated build/run in your IDE.

In Java, this is invalid inside static methods. Prefer:

BPJ.print("El error es: {e}");

with plugin activation, or explicit map context if plugin is disabled.

Compatibility behavior:

• Since 0.3.1, BPJ plugins also auto-fix BPJ.print("...", this) when used in static context, rewriting it to generated map context.
• Recommended style is still one-argument BPJ calls when plugin is active.

String text = BPJ.format("Product value: {product.value}", Map.of("product", product));
String text2 = BPJ.format("Hello {name}, age {age}", "name", name, "age", age);
BPJ.println("Welcome {name}", this);

BPJ.println("Hello {name}");
BPJ.println("Welcome {user.name}");
BPJ.println("Method call: {user.getName()}");

String text = BPJ.format("Final price: {finalPrice}");

BPJ works for returned values, not only console output:

public String retornarTexto(String name, int edad) {
    return BPJ.format("Hola {name}, tienes {edad}");
}

Important:

• The no-extra-args form above requires plugin activation.
• If plugin is not active, use BPJ.format("Hola {name}, tienes {edad}", this) or explicit map/key-values.

Maven:

mvn clean compile

Check generated sources:

• target/generated-sources/bpj

Gradle:

./gradlew clean compileJava

Check generated sources:

• build/generated/sources/bpj/main

1. Check latest published versions:
   • Runtime: https://central.sonatype.com/artifact/io.github.oriontheprogrammer/bpj
   • Maven plugin: https://central.sonatype.com/artifact/io.github.oriontheprogrammer/bpj-maven-plugin
   • Gradle plugin: https://central.sonatype.com/artifact/io.github.oriontheprogrammer/bpj-gradle-plugin
2. Replace 0.3.1 in your pom.xml / build.gradle.
3. Rebuild:
   • Maven: mvn -B -ntp clean verify
   • Gradle: ./gradlew clean build

• API reference
• Plugin activation guide
• Maven plugin guide
• Gradle plugin guide
• Spring Boot parent guide

Badges and icons are powered by:

• Shields.io
• Simple Icons