Skip to content

feat(fs): Add filesystem validation test suite and related cof. #12095

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
+834 −0
Open

feat(fs): Add filesystem validation test suite and related cof. #12095

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
b67360f
feat(fs): Add filesystem validation test suite and related configurat…
JakubAndrysek Dec 2, 2025
a9a4e99
refactor(fs): Remove unused CI configuration and simplify test functi…
JakubAndrysek Dec 3, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 44 additions & 0 deletions tests/validation/fs/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
# Filesystem Validation Test Suite

This test suite validates the functionality of different filesystem implementations available for ESP32: SPIFFS, FFat, and LittleFS.

## Overview

The test suite uses Unity testing framework to run a comprehensive set of filesystem operations across all three filesystem implementations. Each test is executed for each filesystem to ensure consistent behavior and identify filesystem-specific differences.

## Tested Filesystems

- **SPIFFS** (`/spiffs`) - SPI Flash File System
- **FFat** (`/ffat`) - FAT filesystem implementation
- **LittleFS** (`/littlefs`) - Little File System

## Test Cases

The suite includes the following test categories:

- **Basic Operations**: File write, read, append
- **Directory Operations**: Create directories, list files, nested directories
- **File Management**: Rename, remove, exists checks
- **Binary Operations**: Binary data write/read, seek operations
- **Edge Cases**: Empty files, seek edge cases, file truncation
- **Multiple Handles**: Concurrent file operations
- **Space Tracking**: Free space monitoring
- **Error Handling**: Non-existent file operations
- **Large Files**: Operations with larger file sizes
- **Write/Read Patterns**: Sequential and random access patterns
- **Open Files Limit**: Maximum concurrent open files testing

## Known Filesystem-Specific Behaviors

### SPIFFS

- **Directory Support**: SPIFFS does not have true directory support. Opening a directory always returns `true`, and closing it also always returns `true`, regardless of whether the directory actually exists or not. This is a limitation of the SPIFFS implementation.
- **Error Handling**: Some error case tests are skipped for SPIFFS due to different error handling behavior compared to other filesystems.

### LittleFS

- **Open Files Limit**: LittleFS does not enforce a maximum open files limit at the same time. The `test_max_open_files_limit()` test is skipped for LittleFS as it doesn't have this constraint.

### FFat

- FFat follows standard FAT filesystem behavior and supports all tested operations including proper directory handling and open files limits.
Loading
Loading