Merge branch 'feature/fatfsparse-enable-automatic-detection-wl-lfn' into 'master'

fatfsparse.py: enable automatic detection of lfn

Closes IDF-5622

See merge request espressif/esp-idf!20007

Author: Martin Gano

components/fatfs/fatfsparse.py

@@ -55,9 +55,8 @@ def traverse_folder_tree(directory_bytes_: bytes,
         try:
             obj_: dict = Entry.ENTRY_FORMAT_SHORT_NAME.parse(
                 directory_bytes_[obj_address_: obj_address_ + FATDefaults.ENTRY_SIZE])
-        except (construct.core.ConstError, UnicodeDecodeError) as e:
-            if not args.long_name_support:
-                raise e
+        except (construct.core.ConstError, UnicodeDecodeError):
+            args.long_name_support = True
             continue
 
         if obj_['DIR_Attr'] == 0:  # empty entry
@@ -90,7 +89,7 @@ def traverse_folder_tree(directory_bytes_: bytes,
                                  help='Path to the image that will be parsed and extracted.')
     argument_parser.add_argument('--long-name-support',
                                  action='store_true',
-                                 help='Set flag to enable long names support.')
+                                 help=argparse.SUPPRESS)
 
     argument_parser.add_argument('--wear-leveling',
                                  action='store_true',

components/fatfs/test_fatfsgen/test_fatfsparse.py

@@ -320,7 +320,7 @@ def test_e2e_very_deep_long(self) -> None:
             f'{os.path.join(os.path.dirname(__file__), "..", "fatfsgen.py")}',
             'testf', '--long_name_support'
         ], stderr=STDOUT)
-        run(['python', '../fatfsparse.py', 'fatfs_image.img', '--long-name-support'], stderr=STDOUT)
+        run(['python', '../fatfsparse.py', 'fatfs_image.img'], stderr=STDOUT)
         assert compare_folders('testf', 'Espressif')
 
 

docs/en/api-reference/storage/fatfs.rst

@@ -144,4 +144,4 @@ It is a reverse tool of (:component_file:`fatfsgen.py<fatfs/fatfsgen.py>`), i.e.
 
 Usage::
 
-    ./fatfsparse.py [-h] [--long-name-support] [--wear-leveling] fatfs_image.img
+    ./fatfsparse.py [-h] [--wear-leveling] fatfs_image.img

docs/zh_CN/api-reference/storage/fatfs.rst

@@ -144,4 +144,4 @@ FatFs 分区分析器
 
 您可以使用::
 
-    ./fatfsparse.py [-h] [--long-name-support] [--wear-leveling] fatfs_image.img
+    ./fatfsparse.py [-h] [--wear-leveling] fatfs_image.img