/**
     * Returns the length of the file.
     *
     * @return the file length in bytes
     * @throws SmbException if an I/O error occurs
     */
    public long length() throws SmbException {
        return file.length();
    }

    /**
     * Sets the length of the file. The file will be truncated or extended as necessary.
     *
     * @param newLength the new file length in bytes

<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements.  See the NOTICE file
distributed with this work for additional information
regarding copyright ownership.  The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License.  You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

        // WEB-INF/env/crawler/lib
        appendJarFile(cpSeparator, buf, new File(servletContext.getRealPath("/WEB-INF/env/" + getExecuteType() + "/lib")),
                "WEB-INF" + File.separator + "env" + File.separator + getExecuteType() + File.separator + "lib" + File.separator);
        // WEB-INF/plugin
        appendJarFile(cpSeparator, buf, new File(servletContext.getRealPath("/WEB-INF/plugin")),

                }
            }
    }

    /**
     * Zip a list of files with same root directory to a zip file.
     *
     * @param destZip the target zip file
     * @param srcFiles the mapping of relative path to the file
     */
    private
    fun zip(destZip: File, srcFiles: List<Pair<String, File>>) {
        if (srcFiles.isEmpty()) {
            return
        }
        destZip.parentFile.mkdirs()

    // information levels

    /**
     * File end-of-file information class constant.
     */
    byte FILE_ENDOFFILE_INFO = 20;

    /**
     * File basic information class constant.
     */
    byte FILE_BASIC_INFO = 0x4;
    /**
     * File standard information class constant.
     */
    byte FILE_STANDARD_INFO = 0x5;

    /**
     * File internal information class constant.
     */

    protected
    fun File.withFile(path: String, text: String = ""): File =
        resolve(path).apply {
            parentFile.mkdirs()
            writeText(text.trimIndent())
        }

    protected
    fun File.withKotlinFile(path: String, @Language("kotlin") text: String): File = withFile(path, text)

    protected

        pathMapping.setRegex("file:///home/");
        pathMapping.setReplacement("http://localhost/");
        pathMappingList.add(pathMapping);

        pathMappingHelper.cachedPathMappingList = pathMappingList;

        String text = "\"file:///home/\"";
        assertEquals("\"http://localhost/\"", pathMappingHelper.replaceUrls(text));

        text = "\"file:///home/user/\"";

        )

    private
    fun toIncubatingDescription(node: Node, unit: CompilationUnit, file: File): IncubatingDescription {
        val nodeName = nodeName(node, unit, file)
        return IncubatingDescription(
            name = nodeName,
            sourceRelativePath = repositoryRoot.relativize(file.toPath()),
            lineNumber = node.begin.map { it.line }.orElse(-1)
        )
    }

    private

    /**
     * Directory to read license files
     */
    @Optional
    @InputDirectory
    private File licensesDir = new File(getProject().getProjectDir(), "licenses").exists()
        ? new File(getProject().getProjectDir(), "licenses")
        : null;

    @OutputFile
    private File outputFile = new File(getProject().getBuildDir(), "reports/dependencies/dependencies.csv");
    private LinkedHashMap<String, String> mappings;

    log("delete($path)")

    super.delete(path, mustExist)
  }

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

    return super.sink(file, mustCreate)
  }

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

    return super.source(file)
  }