# Static Files { #static-files }

You can serve static files automatically from a directory using `StaticFiles`.

## Use `StaticFiles` { #use-staticfiles }

* Import `StaticFiles`.
* "Mount" a `StaticFiles()` instance in a specific path.

{* ../../docs_src/static_files/tutorial001.py hl[2,6] *}

/// note | Technical Details

You could also use `from starlette.staticfiles import StaticFiles`.

```

This is because uploaded files are sent as "form data".

///

## Import `File` { #import-file }

Import `File` and `UploadFile` from `fastapi`:

{* ../../docs_src/request_files/tutorial001_an_py39.py hl[3] *}

## Define `File` Parameters { #define-file-parameters }

Create file parameters the same way you would for `Body` or `Form`:

{* ../../docs_src/request_files/tutorial001_an_py39.py hl[9] *}

/// info

# Request Forms and Files { #request-forms-and-files }

You can define files and form fields at the same time using `File` and `Form`.

/// info

To receive uploaded files and/or form data, first install <a href="https://github.com/Kludex/python-multipart" class="external-link" target="_blank">`python-multipart`</a>.

Make sure you create a [virtual environment](../virtual-environments.md){.internal-link target=_blank}, activate it, and then install it, for example:

        Files.createDirectory(testuser2Dir);

        Files.writeString(usersDir.resolve("file1.txt"), "file1");
        Path dir1 = usersDir.resolve("dir1");
        Files.createDirectory(dir1);
        Files.writeString(dir1.resolve("file2.txt"), "file2");
        Path dir2 = dir1.resolve("dir2");
        Files.createDirectory(dir2);
        Files.writeString(dir2.resolve("file3.txt"), "file3");
        Path dir3 = usersDir.resolve("dir3");

        entry.updateChild("file1.txt", 1024L, 1000L, false, 0x20, 500L, 800L);
        entry.markComplete();

        // Test FILE_REMOVED
        directoryLeaseManager.handleDirectoryChange(directoryPath, "file1.txt", DirectoryChangeNotifier.DirectoryChangeType.FILE_REMOVED);
        assertFalse(entry.hasChild("file1.txt"));

        // Test FILE_MODIFIED
        entry.updateChild("file2.txt", 2048L, 2000L, false, 0x20, 600L, 900L);

        }

        // Test basic properties
        assertTrue(file.exists(), "File should exist");
        assertTrue(file.canRead(), "File should be readable");
        assertTrue(file.canWrite(), "File should be writable");
        assertEquals(content.length(), file.length(), "File length should match");

        // Test timestamps
        long lastModified = file.lastModified();

        tempDir = Files.createTempDirectory("theme-test");
        Files.createDirectories(Paths.get("target", "fess", "WEB-INF", "view"));
        Files.createDirectories(Paths.get("target", "fess", "WEB-INF", "plugin"));
        Files.createDirectories(Paths.get("target", "fess", "images"));
        Files.createDirectories(Paths.get("target", "fess", "css"));
        Files.createDirectories(Paths.get("target", "fess", "js"));

    Files.createParentDirs(file);
  }

  public void testCreateParentDirs_relativePath() throws IOException {
    File file = file("nonexistent.file");
    assertNull(file.getParentFile());
    assertNotNull(file.getCanonicalFile().getParentFile());
    Files.createParentDirs(file);
  }

  public void testCreateParentDirs_noParentsNeeded() throws IOException {
    File file = file(getTempDir(), "nonexistent.file");

        // Clean up temp directory
        if (tempDir != null && Files.exists(tempDir)) {
            Files.walk(tempDir)
                    .sorted((a, b) -> b.compareTo(a)) // Delete files before directories
                    .forEach(path -> {
                        try {
                            Files.delete(path);
                        } catch (IOException e) {

        /**
         * The total number of log files.
         */
        protected long total = 0;

        /**
         * Sets the list of log files.
         * @param files The list of log files.
         * @return This ApiLogFilesResponse instance.
         */
        public ApiLogFilesResponse files(final List<Map<String, Object>> files) {
            this.files = files;
            return this;
        }