}

    /**
     * Validate and normalize a path
     *
     * @param path the path to validate
     * @return normalized safe path
     * @throws SmbException if path is invalid or dangerous
     */
    public String validatePath(String path) throws SmbException {
        if (path == null || path.isEmpty()) {
            throw new SmbException("Path cannot be null or empty");
        }

        // Check length

            assertEquals(Integer.valueOf(expire), provider.provideDefaultExpire());
        }
    }

    // Test with different path values
    public void test_differentPathValues() {
        String[] testPaths = { "/", "/app", "/test/path", "/a/b/c/d", "" };

        for (String path : testPaths) {
            ComponentUtil.setFessConfig(new FessConfig.SimpleImpl() {
                private static final long serialVersionUID = 1L;

    protected static final String GROOVY_MATCHER = "groovy:";

    /** Map of path mappings by process type. */
    protected final Map<String, List<PathMapping>> pathMappingMap = new HashMap<>();

    /** Cached list of path mappings. */
    protected volatile List<PathMapping> cachedPathMappingList = null;

    /**
     * Initializes the path mapping helper.
     */
    @PostConstruct
    public void init() {

        @CsvSource({ "'', 4", "'a', 6", "'\\\\', 8", "'\\\\server', 20", "'\\\\server\\share', 32", "'\\\\server\\share\\path', 42",
                "'\\\\server\\share\\very\\long\\path\\with\\many\\segments', 100" })
        void testSizeCalculation(String path, int expectedSize) {
            buffer = new DfsReferralRequestBuffer(path, 3);

		adminRouter.Methods(http.MethodPost).Path(adminVersion + "/tier/{tier}").HandlerFunc(adminMiddleware(adminAPI.EditTierHandler))
		adminRouter.Methods(http.MethodGet).Path(adminVersion + "/tier").HandlerFunc(adminMiddleware(adminAPI.ListTierHandler))
		adminRouter.Methods(http.MethodDelete).Path(adminVersion + "/tier/{tier}").HandlerFunc(adminMiddleware(adminAPI.RemoveTierHandler))

It is just a function that can take all the same parameters that a *path operation function* can take:

{* ../../docs_src/dependencies/tutorial001_an_py310.py hl[8:9] *}

That's it.

**2 lines**.

And it has the same shape and structure that all your *path operation functions* have.

You can think of it as a *path operation function* without the "decorator" (without the `@app.get("/some-path")`).

And it can return anything you want.

        // Test task creation with null document map
        String path = "/path/to/document.pdf";

        Tuple3<String, String, String> task = thumbnailGenerator.createTask(path, null);
        assertNull(task);
    }

    public void test_createTask_withEmptyDocMap() {
        // Test task creation with empty document map
        String path = "/path/to/document.pdf";
        Map<String, Object> docMap = new HashMap<>();

        if (path.length() > MAX_PATH_SIZE) {
            failedValidations.incrementAndGet();
            log.warn("Path exceeds maximum length: {}", path.length());
            throw new SmbException("Path exceeds maximum length");
        }

        // Check for directory traversal
        if (path.contains("..") || path.contains("./") || path.contains(".\\")) {
            failedValidations.incrementAndGet();

        // dunc is "\\" + path + remaining  - note: path may not have leading backslashes
        assertTrue(newUnc.contains("dfs/path") || newUnc.contains("dfs\\path"));
        assertEquals(dr, l.getDfsReferral());
        assertEquals("dfs-server", l.getServerWithDfs());
        assertEquals("smb://dfs-server/dfs-share" + l.getUNCPath().replace('\\', '/'), l.getDfsPath());

      parse("http://example.com/foo/bar".toHttpUrl(), "a=b; path=quux")!!.path,
    ).isEqualTo("/foo")
    assertThat(parse("http://example.com/foo/bar".toHttpUrl(), "a=b; path=")!!.path)
      .isEqualTo("/foo")
  }

  @Test fun pathAttributeDoesntNeedToMatch() {
    assertThat(parse("http://example.com/".toHttpUrl(), "a=b; path=/quux")!!.path)
      .isEqualTo("/quux")