* @param file the file path
         * @return the extracted document ID
         */
        protected String getDocId(final Path file) {
            final String s = file.toUri().toString();
            final String b = basePath.toUri().toString();
            final String id = s.replace(b, StringUtil.EMPTY).replace("." + imageExtention, StringUtil.EMPTY).replace("/", StringUtil.EMPTY);
            if (logger.isDebugEnabled()) {

        if (repositoryLayout instanceof ArtifactRepositoryLayout2 artifactRepositoryLayout2) {
            repository = artifactRepositoryLayout2.newMavenArtifactRepository(
                    id, path.toUri().toString(), snapshots, releases);
        } else {
            repository = new MavenArtifactRepository(id, path, repositoryLayout, snapshots, releases);
        }

        return repository;
    }

                    public Object getValue(String expression) {
                        if (projectDir != null && "baseUri".equals(expression)) {
                            return projectDir.getAbsoluteFile().toPath().toUri().toASCIIString();
                        }
                        return null;
                    }
                },
                PROJECT_PREFIXES,
                false);

    return this.subList(startIndex, size).indexOfFirst(predicate).let {
        if (it == -1) -1 else it + startIndex
    }
}


private
fun File.asClickableFileUrl(): String {
    return URI("file", "", toURI().getPath(), null, null).toASCIIString()

      // If the user specifies a proxy, try that and only that.
      if (proxy != null) return listOf(proxy)

      // If the URI lacks a host (as in "http://</"), don't call the ProxySelector.
      val uri = url.toUri()
      if (uri.host == null) return immutableListOf(Proxy.NO_PROXY)

      // Try each of the ProxySelector choices until one connection succeeds.
      val proxiesOrNull = address.proxySelector.select(uri)

                if ("file".equals(resource.getProtocol())) {
                    final File directory;
                    try {
                        directory = new File(resource.toURI());
                    } catch (final URISyntaxException e) {
                        logger.warn("Invalid URI for resource: url={}", resource, e);
                        continue;
                    }

      if (route.address.proxy == null && route.proxy.type() != Proxy.Type.DIRECT) {
        route.address.proxySelector.connectFailed(
          route.address.url.toUri(),
          route.proxy.address(),
          e,
        )
      }
      call.eventListener.connectFailed(call, route.socketAddress, route.proxy, null, e)

Si vous déclarez un `response_class=StreamingResponse` dans votre *fonction de chemin d'accès*, vous pouvez utiliser `yield` pour envoyer chaque bloc de données à son tour.

{* ../../docs_src/stream_data/tutorial001_py310.py ln[1:23] hl[20,23] *}

FastAPI transmettra chaque bloc de données à la `StreamingResponse` tel quel ; il n'essaiera pas de le convertir en JSON ni autre chose similaire.

Vous pouvez définir des modèles imbriqués à une profondeur arbitraire :

{* ../../docs_src/body_nested_models/tutorial007_py310.py hl[7,12,18,21,25] *}

/// info

Remarquez que `Offer` a une liste d’`Item`, qui à leur tour ont une liste optionnelle d’`Image`.

///

## Corps de listes pures { #bodies-of-pure-lists }

    if (failedRoute.proxy.type() != Proxy.Type.DIRECT) {
      val address = failedRoute.address
      address.proxySelector.connectFailed(
        address.url.toUri(),
        failedRoute.proxy.address(),
        failure,
      )
    }

    client.routeDatabase.failed(failedRoute)
  }

  /**