/**
   * Returns the trailers if they're immediately available.
   */
  @Throws(IOException::class)
  fun peekTrailers(): Headers? {
    withLock {
      if (source.finished && source.receiveBuffer.exhausted() && source.readBuffer.exhausted()) {
        return source.trailers ?: Headers.EMPTY
      }
      if (errorCode != null) {
        throw errorException ?: StreamResetException(errorCode!!)
      }
      return null

  override fun sink(
    path: Path,
    mustCreate: Boolean,
  ): Sink {
    log("sink($path)")

    return super.sink(path, mustCreate)
  }

  override fun source(file: Path): Source {
    log("source($file)")

    return super.source(file)
  }

        //and placing them in the repository object
        SimpleClassMetaDataRepository<gradlebuild.docs.dsl.source.model.ClassMetaData> repository = new SimpleClassMetaDataRepository<gradlebuild.docs.dsl.source.model.ClassMetaData>()
        int counter = 0
        source.filter { File f -> f.name.endsWith(".java") || f.name.endsWith(".groovy") }.each { File f ->
            parse(f, repository)
            counter++

    }

  /**
   * A decompression algorithm such as Gzip. Must provide the Accept-Encoding value and decompress a Source.
   */
  interface DecompressionAlgorithm {
    val encoding: String

    fun decompress(compressedSource: BufferedSource): Source
  }

    }

    @Override
    public String toString() {
        return "[ " + "FROM:("
                + (source == null ? "no source" : (source.md == null ? "no source MD" : source.md.toString())) + ") "
                + "TO:(" + (target == null ? "no target" : (target.md == null ? "no target MD" : target.md.toString()))
                + ") " + "version=" + version + ", scope=" + (scope == null ? "null" : scope.getScope()) + ", depth="

    }

    /**
     * Adds an encoding mapping from source to target encoding.
     *
     * @param source the source encoding name
     * @param target the target encoding name
     * @throws IllegalArgumentException if source or target is blank
     */
    public void addEncodingMapping(final String source, final String target) {
        if (StringUtil.isBlank(source) || StringUtil.isBlank(target)) {

        context.logger.debug("Configured core extensions (in precedence order):");
        for (CoreExtensions source : configuredCoreExtensions) {
            context.logger.debug("* Source file: " + source.source());
            for (CoreExtension extension : source.coreExtensions()) {
                context.logger.debug("  - " + extension.getId() + " -> " + formatLocation(extension.getLocation("")));
            }

        Model source = Model.newBuilder().artifactId("SOURCE").build();

        Model merged = mavenMerger.merge(target, source, true, null);
        assertEquals(
                "SOURCE",
                merged.getArtifactId(),
                "Expected merged artifactId to be SOURCE but was " + merged.getArtifactId());

        merged = mavenMerger.merge(target, source, false, null);
        assertEquals(

        // Test with empty source array
        dest = new byte[8];
        nextOffset = NtlmMessage.writeSecurityBuffer(dest, 0, new byte[0]);
        assertEquals(4, nextOffset, "Should return correct next offset for empty source.");
        assertEquals(0, NtlmMessage.readUShort(dest, 0), "Length should be 0 for empty source.");
        assertEquals(0, NtlmMessage.readUShort(dest, 2), "Max length should be 0 for empty source.");
    }

     *
     * The source indicates whether the property is:
     * - Set by Maven itself at startup (SYSTEM_PROPERTIES)
     * - Configured by users through external means like CLI options (USER_PROPERTIES)
     * - Defined in the project's POM file (MODEL)
     *
     * @return the source of the configuration property, defaults to USER_PROPERTIES
     * @see Source for detailed information about each source type and when it's used
     */