build.gradle

buildscript {
    repositories {
        mavenCentral()
        //Add only for SNAPSHOT versions
        //maven { url "https://oss.sonatype.org/content/repositories/snapshots/" }
    }
}

plugins {
    id "java"
    id "maven-publish"
    id "io.github.gradle-nexus.publish-plugin" version "1.1.0"
    id "signing"
    id "jacoco"
    id "io.freefair.lombok" version "6.3.0"
    id "com.diffplug.spotless" version "6.4.0"
    id "net.ltgt.errorprone" version "2.0.2"
    id "com.github.kt3k.coveralls" version "2.12.0"
    id "biz.aQute.bnd.builder" version "6.1.0"
    id "org.ajoberstar.git-publish" version "3.0.1"
}

sourceCompatibility = JavaVersion.VERSION_1_8
targetCompatibility = JavaVersion.VERSION_1_8
group = GROUP
version = VERSION_NAME

tasks.withType(JavaCompile) {
    JavaVersion compilerJavaVersionEnum = JavaVersion.current()
    if (compilerJavaVersionEnum != JavaVersion.VERSION_17) {
        throw new GradleException("JDK 17 is required to build Stripe")
    }

    options.fork = true
    options.forkOptions.jvmArgs += ['-Xms512M', '-Xmx1g']

    options.release = project.targetCompatibility.majorVersion as Integer

    options.compilerArgs << "-Xlint:all" << "-Xlint:-options" << "-Xlint:-processing"
    options.encoding = "UTF-8"

    options.errorprone {
      // This check causes warnings with autogenerated Javadoc strings.
      check("InvalidParam", net.ltgt.gradle.errorprone.CheckSeverity.OFF)

      // Some methods in autogen'd files (defined via overrides) lack a summary. Should be trivial
      // to fix by adding the missing summaries.
      check("MissingSummary", net.ltgt.gradle.errorprone.CheckSeverity.OFF)

      // This check is disabled because multiple nested classes may have the same name in a given
      // file. E.g. in `main/java/com/stripe/param/AccountUpdateParams.java`:
      // The name `Address` refers to [com.stripe.param.AccountUpdateParams.Company.Address,
      // com.stripe.param.AccountUpdateParams.Individual.Address] within this file.)
      // We should fix this by having autogen use the fully-qualified class to eliminate ambiguity.
      check("SameNameButDifferent", net.ltgt.gradle.errorprone.CheckSeverity.OFF)

      // InlineMe (https://errorprone.info/docs/inlineme) seems neat, but in order to add these annotations
      // we would be imposing another dependency on `errorprone` to our users, not worth it.
      check("InlineMeSuggester", net.ltgt.gradle.errorprone.CheckSeverity.OFF)
    }
}

tasks.withType(Test) {
    // Check if JAVA_TEST_HOME environment variable is specified
    String home = System.getenv("JAVA_TEST_HOME")
    if (home && !home.allWhitespace) {
        test.executable = "${home}/bin/java"
    }
    // Github CI should always set JAVA_TEST_HOME
    else if (System.getenv("GITHUB_ACTIONS"))
    {
        throw new GradleException("JAVA_TEST_HOME should be set when running in CI")
    }
}

compileJava {
    options.compilerArgs << "-Werror"
}

configurations.all {
}

repositories {
    mavenCentral()
}

dependencies {
    errorprone group: "com.google.errorprone", name: "error_prone_core", version: "2.10.0"
    errorproneJavac group: "com.google.errorprone", name: "javac", version:"9+181-r4173-1"
    implementation group: "com.google.code.gson", name: "gson", version:"2.10.1"
    testImplementation group: "com.google.guava", name: "guava", version:"31.0.1-jre"
    testImplementation group: "com.squareup.okhttp3", name: "mockwebserver", version: "4.9.1"
    testImplementation group: "org.mockito", name: "mockito-core", version:"4.1.0"
    testImplementation group: "org.junit.jupiter", name: "junit-jupiter-api", version: "5.8.2"
    testRuntimeOnly group: "org.junit.jupiter", name: "junit-jupiter-engine", version: "5.8.2"
    testRuntimeOnly group: "org.slf4j", name: "slf4j-api", version: "1.7.32"
}

jar {
    manifest {
        attributes("Implementation-Title": POM_NAME,
                   "Implementation-Version": VERSION_NAME,
                   "Implementation-Vendor": VENDOR_NAME,
                   "Bundle-SymbolicName": POM_ARTIFACT_ID,
                   "Export-Package": "com.stripe.*")

        archiveVersion = VERSION_NAME
    }
}

lombok {
    version = "1.18.22"
}

delombok {
    // empty format option, otherwise the default is to use pretty formatting which overrides
    // options Lombok config options and does not add generated annotations.
    format = [:]
}

apply from: "deploy.gradle"

test {
    useJUnitPlatform()
    testLogging {
        events "passed", "skipped", "failed"
        exceptionFormat "full"
    }

    systemProperty "stripe.disallowGlobalResponseGetterFallback", "true"
}

spotless {
    java {
        googleJavaFormat("1.7") // 1.7 is the last version that supports Java 8
        removeUnusedImports()
    }
}

jacocoTestReport {
    reports {
        xml.required = true // coveralls plugin depends on xml format report
        html.required = true
    }
}

coveralls {
    jacocoReportPath "build/reports/jacoco/test/jacocoTestReport.xml"
}

gitPublish {
    repoUri = 'https://github.com/stripe/stripe-java.git'
    branch = 'gh-pages'
    sign = false // disable commit signing

    contents {
        from(javadoc) {
            into '.'
        }
    }
}
jacoco
{
    // test code instrumentation for Java 18
    toolVersion = "0.8.8"
}


// Used when developing in vscode-java; some of our examples use
// com.sun.net.httpserver.  This is safe to do because the JDK
// team has committed to ensuring jdk.httpserver is exported.
// See https://openjdk.org/jeps/403, "Exported com.sun APIs"
import org.gradle.plugins.ide.eclipse.model.AccessRule

apply plugin: 'eclipse'

eclipse {
    classpath {
        file {
            whenMerged {
                def jre = entries.find { it.path.contains 'org.eclipse.jdt.launching.JRE_CONTAINER' }
                jre.accessRules.add(new AccessRule('0', 'com/sun/net/httpserver/**'))
            }
        }
    }
}