FileEntry e;
        HashMap map;

        if (p.lastIndexOf('/') != p.length() - 1) {
            throw new SmbException(url.toString() + " directory must end with '/'");
        }
        if (getType() != TYPE_SERVER) {
            throw new SmbException("The requested list operations is invalid: " + url.toString());
        }

        map = new HashMap();

            <option value="$PROJECT_DIR$/platforms/core-execution/file-watching" />
            <option value="$PROJECT_DIR$/platforms/core-execution/hashing" />
            <option value="$PROJECT_DIR$/platforms/core-execution/persistent-cache" />
            <option value="$PROJECT_DIR$/platforms/core-execution/request-handler-worker" />

     *
     * @return metrics map containing rotation statistics
     */
    public java.util.Map<String, Long> getKeyRotationMetrics() {
        java.util.Map<String, Long> metrics = new java.util.HashMap<>();
        metrics.put("totalRotations", totalKeyRotations.get());
        metrics.put("lastRotationTime", lastKeyRotationTime.get());
        metrics.put("bytesEncryptedSinceLastRotation", bytesEncrypted.get());

Esta combinación de Flask, Flask-apispec con Marshmallow y Webargs fue mi stack de backend favorito hasta construir **FastAPI**.

Usarlo llevó a la creación de varios generadores de full-stack para Flask. Estos son los principales stacks que yo (y varios equipos externos) hemos estado usando hasta ahora:

import com.google.errorprone.annotations.concurrent.LazyInit;
import java.nio.charset.Charset;
import java.nio.charset.IllegalCharsetNameException;
import java.nio.charset.UnsupportedCharsetException;
import java.util.HashMap;
import java.util.Map;
import java.util.Map.Entry;
import org.jspecify.annotations.Nullable;

/**
 * Represents an <a href="http://en.wikipedia.org/wiki/Internet_media_type">Internet Media Type</a>

     * {@code " x "} (space, letter x, space), followed by the count.
     */
    @Override
    String toString();
  }

  // Comparison and hashing

  /**
   * Compares the specified object with this multiset for equality. Returns {@code true} if the
   * given object is also a multiset and contains equal elements with equal counts, regardless of
   * order.

import static com.google.common.collect.CollectPreconditions.checkRemove;
import static com.google.common.collect.CompactHashing.UNSET;
import static com.google.common.collect.Hashing.smearedHash;
import static java.lang.Math.max;
import static java.lang.Math.min;
import static java.util.Objects.requireNonNull;

import com.google.common.annotations.GwtIncompatible;

participant operation as Path Operation
participant tasks as Background tasks

    Note over client,operation: Puede lanzar excepciones, incluyendo HTTPException
    client ->> dep: Iniciar request
    Note over dep: Ejecutar código hasta yield
    opt raise Exception
        dep -->> handler: Lanzar Exception
        handler -->> client: Response HTTP de error
    end
    dep ->> operation: Ejecutar dependencia, por ejemplo, sesión de BD

   */
  default void forEachEntry(ObjIntConsumer<? super E> action) {
    checkNotNull(action);
    entrySet().forEach(entry -> action.accept(entry.getElement(), entry.getCount()));
  }

  // Comparison and hashing

  /**
   * Compares the specified object with this multiset for equality. Returns {@code true} if the
   * given object is also a multiset and contains equal elements with equal counts, regardless of
   * order.

Hasta aquí, todo funcionaría normalmente.

Pero luego, cuando abres la UI integrada de los docs (el frontend), esperaría obtener el esquema de OpenAPI en `/openapi.json`, en lugar de `/api/v1/openapi.json`.