Extract folder scanning module

b2sdk/_v3/exception.py

@@ -144,7 +144,7 @@
     'UnknownHost',
     'UnrecognizedBucketType',
     'UnableToCreateDirectory',
-    'UnSyncableFilename',
+    'UnsupportedFilename',
     'UnsatisfiableRange',
     'UnusableFileName',
     'interpret_b2_error',

b2sdk/scan/exception.py

@@ -57,9 +57,9 @@ def __str__(self):
         return "%s %s" % (self.parameter_name, self.message)
 
 
-class UnSyncableFilename(B2Error):
+class UnsupportedFilename(B2Error):
     """
-    Raised when a filename is not supported by the sync operation
+    Raised when a filename is not supported by the scan operation
     """
 
     def __init__(self, message, filename):

b2sdk/scan/folder.py

@@ -15,7 +15,7 @@
 import sys
 
 from abc import ABCMeta, abstractmethod
-from .exception import EmptyDirectory, EnvironmentEncodingError, UnSyncableFilename, NotADirectory, UnableToCreateDirectory
+from .exception import EmptyDirectory, EnvironmentEncodingError, UnsupportedFilename, NotADirectory, UnableToCreateDirectory
 from .path import B2SyncPath, LocalSyncPath
 from .report import SyncReport
 from .scan_policies import DEFAULT_SCAN_MANAGER, ScanPoliciesManager
@@ -148,7 +148,7 @@ def make_full_path(self, file_name):
 
         # Ensure the new full_path is inside the self.root directory
         if common_prefix != self.root:
-            raise UnSyncableFilename("illegal file name", full_path)
+            raise UnsupportedFilename("illegal file name", full_path)
 
         return full_path
 
@@ -208,8 +208,8 @@ def _walk_relative_paths(
                 name = self._handle_non_unicode_file_name(name)
 
             if '/' in name:
-                raise UnSyncableFilename(
-                    "sync does not support file names that include '/'",
+                raise UnsupportedFilename(
+                    "scan does not support file names that include '/'",
                     "%s in dir %s" % (name, local_dir)
                 )
 
@@ -374,18 +374,18 @@ def get_file_versions(self):
     def _validate_file_name(self, file_name):
         # Do not allow relative paths in file names
         if RELATIVE_PATH_MATCHER.search(file_name):
-            raise UnSyncableFilename(
-                "sync does not support file names that include relative paths", file_name
+            raise UnsupportedFilename(
+                "scan does not support file names that include relative paths", file_name
             )
         # Do not allow absolute paths in file names
         if ABSOLUTE_PATH_MATCHER.search(file_name):
-            raise UnSyncableFilename(
-                "sync does not support file names with absolute paths", file_name
+            raise UnsupportedFilename(
+                "scan does not support file names with absolute paths", file_name
             )
         # On Windows, do not allow drive letters in file names
         if platform.system() == "Windows" and DRIVE_MATCHER.search(file_name):
-            raise UnSyncableFilename(
-                "sync does not support file names with drive letters", file_name
+            raise UnsupportedFilename(
+                "scan does not support file names with drive letters", file_name
             )
 
     def folder_type(self):

b2sdk/v2/__init__.py

@@ -9,6 +9,7 @@
 ######################################################################
 
 from b2sdk._v3 import *  # noqa
+from b2sdk._v3 import UnsupportedFilename as UnSyncableFilename
 
 from .api import B2Api
 from .b2http import B2Http

test/unit/sync/test_exception.py

@@ -14,7 +14,7 @@
     EnvironmentEncodingError,
     InvalidArgument,
     IncompleteSync,
-    UnSyncableFilename,
+    UnsupportedFilename,
     check_invalid_argument,
 )
 
@@ -41,10 +41,10 @@ def test_incomplete_sync(self):
         except IncompleteSync as e:
             assert str(e) == 'Incomplete sync: ', str(e)
 
-    def test_unsyncablefilename_error(self):
+    def test_unsupportedfilename_error(self):
         try:
-            raise UnSyncableFilename('message', 'filename')
-        except UnSyncableFilename as e:
+            raise UnsupportedFilename('message', 'filename')
+        except UnsupportedFilename as e:
             assert str(e) == 'message: filename', str(e)