*                 If null, the path string representation is used
         */
        protected PathSource(Path path, String location) {
            this.path = requireNonNull(path, "path").normalize();
            this.location = location != null ? location : this.path.toString();
        }

        @Override
        @Nullable
        public Path getPath() {
            return path;
        }

                sb.append(curChar);
            }
        }
        return sb.toString();
    }

    /**
     * Normalizes a permission name based on configuration settings.
     *
     * @param name the permission name to normalize
     * @return the normalized permission name
     */
    public String normalizePermissionName(final String name) {
        if (fessConfig.isLdapLowercasePermissionName()) {

    /**
     * PDF config file path.
     */
    public static final String TIKA_PDF_CONFIG = "tika.pdf.config";

    /**
     * A parameter key to normalize a text.
     */
    public static final String NORMALIZE_TEXT = "normalize_text";

    private static final String FILE_PASSWORD = "fess.file.password";

    /**
     * Output encoding.
     */

        if (StringUtil.isBlank(path)) {
            throw new IllegalArgumentException("File path cannot be empty");
        }
        try {
            final Path filePath = Paths.get(path).normalize();
            final String normalizedPath = filePath.toString();
            if (normalizedPath.contains("..")) {
                throw new IllegalArgumentException("Invalid file path");
            }

            dr.pathConsumed = consumed;

            /*
             * Samba has a tendency to return pathConsumed values so that they consume a trailing slash of the
             * requested path. Normalize this here.
             */
            if (reqPath.charAt(consumed - 1) == '\\') {
                if (log.isDebugEnabled()) {
                    log.debug("Server consumed trailing slash of request path, adjusting");

                } else {
                    Path topDirectory = mavenSession.getTopDirectory();
                    Path locationPath = Paths.get(location).toAbsolutePath().normalize();
                    if (locationPath.startsWith(topDirectory)) {
                        locationPath = topDirectory.relativize(locationPath);
                    }

            if (retValue.length() >= 2 && retValue.charAt(1) == '|') {
                retValue = retValue.charAt(0) + ":" + retValue.substring(2);
            }

            // normalize separators
            retValue = new File(retValue).getPath();
        }

        if (retValue == null) {
            retValue = "/";
        }
        return retValue.trim();
    }

    /**

        if (StringUtil.isBlank(fileName)) {
            throwValidationError(messages -> messages.addErrorsDesignFileNameIsNotFound("designFile"), this::asListHtml);
        }

        File uploadFile;
        // normalize filename
        if (checkFileType(fileName, fessConfig.getSupportedUploadedMediaExtentionsAsArray())
                && checkFileType(uploadedFileName, fessConfig.getSupportedUploadedMediaExtentionsAsArray())) {

	// check for quoted string (string may not contain a quote)
	if match, err := regexp.MatchString("^\"[^\"]+\"$", name); err != nil {
		return err
	} else if match {
		return nil
	}

	// normalize the name to letters, digits, _ or $
	valid := true
	cleaned := strings.Map(func(r rune) rune {
		switch {
		case unicode.IsLetter(r):
			return 'a'
		case unicode.IsDigit(r):
			return '0'

                        if (isGroupRecordStarted) {
                            currentDirectiveList.clear();
                            isGroupRecordStarted = false;
                        }
                        // Normalize user-agent to lowercase
                        final String userAgent = value.toLowerCase(Locale.ENGLISH);
                        Directive currentDirective = robotsTxt.getDirective(userAgent);