<field>
          <name>id</name>
          <required>true</required>
          <version>1.0.0+</version>
          <type>String</type>
          <description>The ID of this phase, e.g., {@code generate-sources}.</description>
        </field>
        <field xml.attribute="true">
          <name>executionPoint</name>
          <required>false</required>
          <version>2.0.0+</version>
          <type>String</type>

 * and files.
 *
 * <p>At the core of this package are the Source/Sink types: {@link ByteSource ByteSource}, {@link
 * CharSource CharSource}, {@link ByteSink ByteSink} and {@link CharSink CharSink}. They are
 * factories for I/O streams that provide many convenience methods that handle both opening and
 * closing streams for you.
 *
 * <p>This package is a part of the open-source <a href="https://github.com/google/guava">Guava</a>

import java.util.Optional;

import org.apache.maven.api.annotations.Nonnull;

/**
 * A root directory of source files.
 * The sources may be Java main classes, test classes, resources or anything else identified by the scope.
 *
 * <h2>Default values</h2>
 * The properties in this interface are defined in the {@code <Source>} element of the
 * {@linkplain org.apache.maven.api.model.Model Maven project descriptor}.

            include("**/*.jar")
            // https://github.com/gradle/gradle-private/issues/4253
            // Only a few tests need the sources jar in tooling-api subproject
            if (projectName != "tooling-api") {
                exclude("**/*-sources.jar")
            }
            exclude("**/*-javadoc.jar")
        }.files.toSortedSet()

    /**

*-----------------------+---------------+------------+-----------+-----------------------+-----------------------+
| <<<java-source>>>     | <<<sources>>> | <<<jar>>>  | java      |                       |                       |
*-----------------------+---------------+------------+-----------+-----------------------+-----------------------+

# /---------------------------------------------------------------------------
# sourceCopyright: (NotRequired - Default '')
#
# The copyright for all class sources.
# This property is NOT map style.
# You should specify before your first generating.
#
#/*
# * Copyright(c) DBFlute TestCo.,TestLtd. All Rights Reserved.
# */

        </configuration>
        <executions>
          <execution>
            <id>velocity</id>
            <goals>
              <goal>velocity</goal>
            </goals>
            <phase>generate-sources</phase>
            <configuration>
              <templates>
                <template>merger.vm</template>
                <template>transformer.vm</template>
                <template>reader-stax.vm</template>

          </excludePackageNames>
          <!-- Ignore some tags that are found in Java 11 sources but not recognized... under -source 8, I think it was? I can no longer reproduce the failure. -->
          <tags>
            <tag>
              <name>apiNote</name>
              <placement>X</placement>
            </tag>

        assertEquals("sources", depArtifact.getClassifier());
        assertEquals("jar", depArtifact.getExtension());
        assertEquals("java", depArtifact.getProperty("language", null));
        assertEquals(
                "jar", depArtifact.getProperty("type", null)); // shouldn't it be java-sources given the classifier?
        assertEquals(
                "true",

 * limitations under the License.
 */

package com.google.common.io;

import org.jspecify.annotations.NullUnmarked;

/**
 * Options controlling the behavior of sources/sinks/streams for testing.
 *
 * @author Colin Decker
 */
@NullUnmarked
public enum TestOption {
  OPEN_THROWS,
  SKIP_THROWS,
  READ_THROWS,
  WRITE_THROWS,
  CLOSE_THROWS,
  AVAILABLE_ALWAYS_ZERO