// unless it's actually going to be used; validate() is called for all set method calls, so it
    // needs to be fast.
    // (We could instead generate the message once, when the set is created, but zero is better.)
    if (!validator.get()) {
      throw new IllegalStateException(errorMessage.get());
    }
  }

 */
public abstract class Javadocs {
    /**
     * Link to Java API to use when generating Javadoc
     */
    public abstract Property<URI> getJavaApi();

    /**
     * Package list of the Java API used to generate Javadoc offline
     */
    public abstract DirectoryProperty getJavaPackageListLoc();

    /**
     * Link to Groovy API to use when generating Javadoc
     */
    public abstract Property<URI> getGroovyApi();

     * The bearer string.
     */
    protected static final String BEARER = "Bearer";

    /**
     * The random instance.
     */
    protected Random random = new SecureRandom();

    /**
     * Generate the access token.
     * @return The access token.
     */
    public String generateAccessToken() {

When the Kotlin DSL was introduced, we made an effort to add non-Groovy equivalents for all APIs.
This has been mostly done, but there remain a few holdouts (fixing these is out of scope).

To keep the Groovy DSL ergonomic, we generate methods as necessary from the non-Groovy equivalents.

Doing this provides the following specific benefits:
- **Reduce the API surface** - We no longer need to maintain two methods.

            assertEquals(2000000L, basicInfo.getLastWriteTime());
            assertEquals(0L, basicInfo.getSize()); // Basic info always returns 0 for size
        }

        @Test
        @DisplayName("Should generate correct toString for basic info")
        void testBasicInfoToString() {
            Trans2QueryPathInformationResponse.SmbQueryFileBasicInfo basicInfo = response.new SmbQueryFileBasicInfo();

      <fields>
        <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>

 *
 * @author George van den Driessche
 */
@GwtCompatible
@NullMarked
public interface TestContainerGenerator<T, E extends @Nullable Object> {
  /** Returns the sample elements that this generate populates its container with. */
  SampleElements<E> samples();

  /**
   * Creates a new container containing the given elements. TODO: would be nice to figure out how to

     */
    boolean generate(String thumbnailId, File outputFile);

    /**
     * Checks if this generator can handle the given document.
     * @param docMap The document map containing metadata.
     * @return True if this generator can handle the document, false otherwise.
     */
    boolean isTarget(Map<String, Object> docMap);

    /**
     * Checks if this thumbnail generator is available for use.

If you want to play with JWT tokens and see how they work, check [https://jwt.io](https://jwt.io/).

## Install `PyJWT` { #install-pyjwt }

We need to install `PyJWT` to generate and verify the JWT tokens in Python.

Make sure you create a [virtual environment](../../virtual-environments.md), activate it, and then install `pyjwt`:

<div class="termy">

```console
$ pip install pyjwt

  val table =
    FileSystem.RESOURCES.read(path) {
      readPlainTextIdnaMappingTable()
    }
  return buildIdnaMappingTableData(table)
}

/**
 * Generate a file containing the mapping table's string literals, like this:
 *
 * ```
 * internal val IDNA_MAPPING_TABLE: IdnaMappingTable = IdnaMappingTable(
 *   sections = "...",
 *   ranges = "...",
 *   mappings = "",