// Normal extensions should be allowed
        assertEquals("\\share\\file.txt", validator.validatePath("\\share\\file.txt"));
        assertEquals("\\share\\document.docx", validator.validatePath("\\share\\document.docx"));
        assertEquals("\\share\\archive.tar.gz", validator.validatePath("\\share\\archive.tar.gz"));
    }

    @Test
    public void testInternationalCharacters() throws Exception {

    }

    @ParameterizedTest
    @DisplayName("Test decode with various file names")
    @CsvSource({ "a.txt", "very_long_filename_with_many_characters_to_test_buffer_handling.docx", "file with spaces.pdf", "文件.txt", // Unicode filename
            "file-with-special-chars!@#$%^&().bin" })
    void testDecodeWithVariousFileNames(String fileName) throws SMBProtocolDecodingException {

    void testGetFilename() throws SMBProtocolDecodingException {
        // Prepare test data
        String expectedFilename = "longfilename.docx";
        byte[] buffer = createValidBuffer(expectedFilename, "LONGFI~1.DOC", true);

        // Decode
        fileBothDirectoryInfo.decode(buffer, 0, buffer.length);

        // Verify

        Map<String, Object> doc1 = new HashMap<>();
        doc1.put("title", "Doc1");
        Map<String, Object> doc2 = new HashMap<>();
        doc2.put("title", "Doc2");
        Map<String, Object> doc3 = new HashMap<>();
        doc3.put("title", "Doc3");
        documentList.add(doc1);
        documentList.add(doc2);
        documentList.add(doc3);

        with:
          python-version: 3.x

      - run: pip install mkdocs-material mkdocs-redirects

      - name: Generate Docs
        run: ./test_docs.sh

      - uses: actions/upload-artifact@v4
        with:
          name: docs

        Map<String, Object> doc1 = new HashMap<>();
        doc1.put("title", "Test Document 1");
        doc1.put("content", "Test content 1");
        documentItems.add(doc1);

        Map<String, Object> doc2 = new HashMap<>();
        doc2.put("title", "Test Document 2");
        doc2.put("content", "Test content 2");
        documentItems.add(doc2);

        searchRenderData.setDocumentItems(documentItems);

      - name: Verify Docs
        run: python ./scripts/docs.py verify-docs
      - name: Export Language Codes
        id: show-langs
        run: |
          echo "langs=$(python ./scripts/docs.py langs-json)" >> $GITHUB_OUTPUT

  build-docs:
    needs:
      - changes
      - langs
    if: ${{ needs.changes.outputs.docs == 'true' }}
    runs-on: ubuntu-latest
    strategy:
      matrix:

# OpenAPI `docs`

Utilities to handle OpenAPI automatic UI documentation, including Swagger UI (by default at `/docs`) and ReDoc (by default at `/redoc`).

::: fastapi.openapi.docs.get_swagger_ui_html

::: fastapi.openapi.docs.get_redoc_html

::: fastapi.openapi.docs.get_swagger_ui_oauth2_redirect_html

        Map<String, Object> doc1 = new HashMap<>();
        doc1.put("id", "1");
        doc1.put("title", "Document 1");

        Map<String, Object> doc2 = new HashMap<>();
        doc2.put("id", "2");
        doc2.put("title", "Document 2");

        SearchResult result = SearchResult.create().addDocument(doc1).addDocument(doc2).allRecordCount(2L).queryTime(25L).build();

        DocList docList = new DocList();

        Map<String, Object> doc1 = new HashMap<>();
        doc1.put("id", "1");
        doc1.put("title", "Test Document 1");

        Map<String, Object> doc2 = new HashMap<>();
        doc2.put("id", "2");
        doc2.put("title", "Test Document 2");

        docList.add(doc1);
        docList.add(doc2);

        assertEquals(2, docList.size());