package to create, list and delete folder and files. It uses LittleFS

- LittleFS Arduino library 3.0.5

- Compiled and tested with esp32 by Espressif Systems v3.0.7
- unitTest example used for tests

The library will create a hierarchy of folders and files like unix filesystem. A folder will only be deleted if has no files inside. To delete the files inside you need to pass the level of depth that you want to delete those files. Folders cannot contain "." in the name and files are mandatory to contain "." in the name

SYSFILE()

SYSFILE(HardwareSerial* serial_port)

bool init()

bool format()

bool create_dir(const char* dir)

int16_t delete_dir(const char* dir,int8_t level)

void list_filesystem(uint8_t level)

void list_filesystem(const char* dir, uint8_t level)

bool write_file(const char* filename, const char* data, uint16_t len)

bool read_file(const char * filename, char* data, uint16_t* len)

String get_next_file(const char

bool delete_file(const char * filename)

int16_t countFiles(const char* dir, uint8_t levels=1)

uint16_t iterateDir(const char * dirname, uint32_t timeout, bool(*callback)(String))

void deleteEmptySubDirectories(const char * dirname, uint32_t timeout, bool(*callback)(String))

uint32_t get_lfs_available_space()

Run programs inside examples folder to check how it works

Call all available public methods

For now and unless LITTLEFS could be compiled with clang, this library will be tested directly with the hardware

Run program "unitTest.ino" inside examples/unitTest to test library

SYSFILE()

• @serial_port - serial port for debug

SYSFILE(HardwareSerial* serial_port)

• Init filesystem
• return true if filesystem has been correctly inited

bool init();

• Formats filesystem
• return true if filesystem has been formatted

bool format();

• Create all necessary folders until full path are completed
• @dir - directory to be created
• return true if folder exists or has been created

bool create_dir(const char* dir);

• delete contained folders and files
• increase level to delete its subfolders
• @dir - directory to be deleted
• @level - depth of folder to be listed
• return number of files and folders deleted

int16_t delete_dir(const char* dir,int8_t level);

• @dir - directory to be listed
• @level - depth of folder to be listed

void list_filesystem(const char* dir, uint8_t level);

• starts to list on root folder '/'
• @level - depth of folder to be listed

void list_filesystem(uint8_t level);

• @filename - path + file extension
• @data - pointer to buffer
• @len - size of buffer
• return true if file was written successfully

bool write_file(const char* filename, const char* data, uint16_t len);

• @filename - path + file extension
• @data - pointer to buffer
• @len - size of buffer (returns new length)
• return true if file was read successfully

bool read_file(const char * filename, char* data, uint16_t* len);

• @dirname - path
• return name of next file inside folder / returns "" if no file was found

String get_next_file(const char * dirname);

• @filename - path + filename (extensions must include a '.')
• return result

bool delete_file(const char * filename);

• Count files and folders inside a directory
• @dir - path to directory
• @levels - depth of folder to be analyzed
• return number of files and folders

int16_t countFiles(const char* dir, uint8_t levels=1);

• Iterate files inside a folder and call callback function on each iteration
• @dirname - path to directory
• @timeout - available time to execute operation
• @callback - function to be executed on each iteration
• return number of iterations

uint16_t iterateDir(const char * dirname, uint32_t timeout, bool(*callback)(String));

• Deletes all empty subdirectories inside folder
• @dirname - path to directory
• @timeout - available time to execute operation

void deleteEmptySubDirectories(const char * dirname, uint32_t timeout, bool(*callback)(String))

• get available space on filesystem
• return available space

uint32_t get_lfs_available_space();