# Conditional OpenAPI

If you needed to, you could use settings and environment variables to configure OpenAPI conditionally depending on the environment, and even disable it entirely.

## About security, APIs, and docs

Hiding your documentation user interfaces in production *shouldn't* be the way to protect your API.

That doesn't add any extra security to your API, the *path operations* will still be available where they are.

Nils Lindemann <******@****.***> 1711822693 +0100

Sebastián Ramírez <******@****.***> 1692474844 +0200

Sebastián Ramírez <******@****.***> 1692474844 +0200

plugins {
    java
    `maven-publish`
    signing
}

group = "gradle"

// tag::conditional-signing[]
version = "1.0-SNAPSHOT"
extra["isReleaseVersion"] = !version.toString().endsWith("SNAPSHOT")

// end::conditional-signing[]
publishing {
    publications {
        create<MavenPublication>("main") {
            from(components["java"])
        }
    }
    repositories {
        maven {
            name = "localRepo"

plugins {
    id 'java'
    id 'maven-publish'
    id 'signing'
}

group = 'gradle'

// tag::conditional-signing[]
version = '1.0-SNAPSHOT'
ext.isReleaseVersion = !version.endsWith("SNAPSHOT")

// end::conditional-signing[]
publishing {
    publications {
        main(MavenPublication) {
            from components.java
        }
    }
    repositories {
        maven {
            name = "localRepo"

        using m2
    }

    @UsesSample('signing/conditional')
    def "conditional signing with dsl #dsl"() {
        given:
        inDirectory(sample.dir.file(dsl))

        when:
        run "publish"

        then:
        skipped(":signMainPublication")

        and:
        def module = repoFor(dsl).module('gradle', 'conditional', '1.0-SNAPSHOT')

        dsl << ['groovy', 'kotlin']
    }

    @UsesSample("maven-publish/conditional-publishing")
    def "conditional publishing with #dsl dsl"() {
        using m2

        given:
        def sampleDir = sampleProject.dir.file(dsl)
        inDirectory(sampleDir)

        and:
        def artifactId = "maven-conditional-publishing"
        def version = "1.0"

        where:
        dsl << ['groovy', 'kotlin']
    }

    @UsesSample("ivy-publish/conditional-publishing/groovy")
    def conditionalPublishing() {
        given:
        sample sampleProject

        and:
        def artifactId = "maven-conditional-publishing"
        def version = "1.0"
        def externalRepo = ivy(sampleProject.dir.file("build/repos/external"))

rootProject.name = 'conditional'...