*/

package org.jetbrains.kotlin.analysis.api.resolve.extensions

import org.jetbrains.kotlin.name.FqName
import org.jetbrains.kotlin.name.Name

/**
 * Represents the Kotlin file which provides additional, generated declarations for resolution.
 *
 * All member implementations should:
 * - consider caching the results for subsequent invocations.
 * - be lightweight and not build the whole file structure inside.

 *
 * @since 8.6
 */
@Incubating
public interface ProblemReporter {

    /**
     * Configures and reports a new problem.
     * <p>
     * The spec must specify the problem label and the category. Any additional configuration is optional.
     *
     * @param spec the problem configuration
     * @since 8.6
     */
    void reporting(Action<ProblemSpec> spec);

    /**

/**
 * A component which can declare additional variants corresponding to
 * features. When published to Maven POMs, the dependencies of those variants
 * are exposed as optional dependencies. When published to Gradle metadata, the
 * variants are published as is.
 *
 * @since 5.3
 */
public interface AdhocComponentWithVariants extends SoftwareComponent {

    /**

commands: [{
    executable: gradle
    args: clean alwaysInstrumentClasses
    allow-additional-output: true
    allow-disordered-output: true
},{
    executable: gradle
    args: alwaysInstrumentClasses
    expected-output-file: incrementalBuildUpToDateWhenAgain.out
    allow-additional-output: true
    allow-disordered-output: true

plugins {
    idea
    `java-library`
}

// tag::mark-additional-sourcesets-as-test[]
sourceSets {
    create("intTest") {
        java {
            setSrcDirs(listOf("src/integration"))
        }
    }
}

idea {
    module {
        testSources.from(sourceSets["intTest"].java.srcDirs)
    }
}

commands: [{
  executable: gradle
  args: help
  expected-output-file: store.out
  allow-additional-output: true
}, {
  executable: gradle
  args: help
  expected-output-file: load.out
  allow-additional-output: true

# Advanced User Guide

## Additional Features

The main [Tutorial - User Guide](../tutorial/index.md){.internal-link target=_blank} should be enough to give you a tour through all the main features of **FastAPI**.

In the next sections you will see other options, configurations, and additional features.

!!! tip
    The next sections are **not necessarily "advanced"**.

    And it's possible that for your use case, the solution is in one of them.

!!! tip
    This is a low level extension point.

    If you only need to declare additional responses, a more convenient way to do it is with [Additional Responses in OpenAPI](additional-responses.md){.internal-link target=_blank}.

You can extend the OpenAPI schema for a *path operation* using the parameter `openapi_extra`.

### OpenAPI Extensions

plugins {
    id 'idea'
    id 'java-library'
}

// tag::mark-additional-sourcesets-as-test[]
sourceSets {
    intTest {
        java {
            srcDirs = ['src/integration']
        }
    }
}

idea {
    module {
        testSources.from(sourceSets.intTest.java.srcDirs)
    }
}

        and:
        outputs.noneRecompiled()

        where:
        testCase                       | headerDirs
        "extra header dir after"       | '"src/main/headers", "src/additional-headers"'
        "extra header dir before"      | '"src/additional-headers", "src/main/headers"'
        "replacement header dir after" | '"src/main/headers", "src/replacement-headers"'
    }