synapse-sdk 2025.10.4__py3-none-any.whl → 2025.10.5__py3-none-any.whl

synapse_sdk/devtools/docs/docs/plugins/categories/upload-plugins/upload-plugin-overview.md

@@ -97,6 +97,31 @@ Each asset has its own path and recursive setting. Perfect for distributed data
 }
 ```
 
+**Optional File Specs:**
+
+In multi-path mode, file specifications can be marked as optional in the data collection's file specification template:
+
+- **Required specs** (`is_required: true`): Must have an asset path in the `assets` parameter
+- **Optional specs** (`is_required: false`): Can be omitted from `assets` - the system will skip them
+
+Example with optional spec omitted:
+
+```json
+{
+  "name": "Multi-Source Upload",
+  "use_single_path": false,
+  "assets": {
+    "pcd_1": {"path": "/sensors/lidar", "is_recursive": false},
+    "image_1": {"path": "/cameras/front", "is_recursive": true}
+    // "json_meta_1" is optional and omitted
+  },
+  "storage": 1,
+  "data_collection": 5
+}
+```
+
+The system logs: `"Skipping optional spec json_meta_1: no asset path configured"`
+
 ## Basic Usage
 
 ### CLI Usage

synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/plugins/categories/upload-plugins/upload-plugin-overview.md

@@ -97,6 +97,31 @@ sidebar_position: 1
 }
 ```
 
+**선택적 파일 사양:**
+
+다중 경로 모드에서는 데이터 컬렉션의 파일 사양 템플릿에서 파일 사양을 선택적으로 표시할 수 있습니다:
+
+- **필수 사양** (`is_required: true`): `assets` 매개변수에 자산 경로가 반드시 있어야 합니다
+- **선택적 사양** (`is_required: false`): `assets`에서 생략 가능 - 시스템이 건너뜁니다
+
+선택적 사양이 생략된 예제:
+
+```json
+{
+  "name": "다중 소스 업로드",
+  "use_single_path": false,
+  "assets": {
+    "pcd_1": {"path": "/sensors/lidar", "is_recursive": false},
+    "image_1": {"path": "/cameras/front", "is_recursive": true}
+    // "json_meta_1"은 선택사항이며 생략됨
+  },
+  "storage": 1,
+  "data_collection": 5
+}
+```
+
+시스템 로그: `"Skipping optional spec json_meta_1: no asset path configured"`
+
 ## 기본 사용법
 
 ### CLI 사용법

synapse_sdk/plugins/categories/upload/actions/upload/action.py

@@ -173,11 +173,18 @@ class UploadAction(Action):
         organized_files = context.get('organized_files', [])
         file_specification_template = context.get('file_specification_template', {})
         pathlib_cwd = context.get('pathlib_cwd')
+        use_single_path = context.get_param('use_single_path', True)
 
-        if not organized_files or not file_specification_template or not pathlib_cwd:
+        # Validate required data based on mode
+        if not organized_files or not file_specification_template:
             raise ActionError('Required data not available from workflow steps')
 
+        # In single-path mode, pathlib_cwd is required
+        if use_single_path and not pathlib_cwd:
+            raise ActionError('pathlib_cwd is required in single-path mode')
+
         # CRITICAL: Integrate with existing uploader mechanism
+        # In multi-path mode, pathlib_cwd may be None, but uploader should still work
         uploader = self.get_uploader(pathlib_cwd, file_specification_template, organized_files, self.params)
         organized_files = uploader.handle_upload_files()
 

synapse_sdk/plugins/categories/upload/actions/upload/context.py

@@ -87,7 +87,6 @@ class UploadContext:
             'generated_data_units_count': len(self.data_units),
             'success': len(self.errors) == 0,
             'errors': self.errors,
-            'metrics': self.metrics,
         }
 
     def has_errors(self) -> bool:

synapse_sdk/plugins/categories/upload/actions/upload/steps/generate.py

@@ -31,7 +31,9 @@ class GenerateDataUnitsStep(BaseStep):
             context.run.log_message_with_code(LogCode.GENERATING_DATA_UNITS)
 
             # Initialize metrics
-            context.update_metrics('data_units', {'stand_by': upload_result_count, 'success': 0, 'failed': 0})
+            initial_metrics = {'stand_by': upload_result_count, 'success': 0, 'failed': 0}
+            context.update_metrics('data_units', initial_metrics)
+            context.run.set_metrics(initial_metrics, category='data_units')
 
             # Get batch size from parameters
             batch_size = context.get_param('creating_data_unit_batch_size', 1)
@@ -49,7 +51,9 @@ class GenerateDataUnitsStep(BaseStep):
                 )
 
             # Update final metrics
-            context.update_metrics('data_units', {'stand_by': 0, 'success': len(generated_data_units), 'failed': 0})
+            final_metrics = {'stand_by': 0, 'success': len(generated_data_units), 'failed': 0}
+            context.update_metrics('data_units', final_metrics)
+            context.run.set_metrics(final_metrics, category='data_units')
 
             # Complete progress
             context.run.set_progress(upload_result_count, upload_result_count, category='generate_data_units')

synapse_sdk/plugins/categories/upload/actions/upload/steps/initialize.py

@@ -29,19 +29,34 @@ class InitializeStep(BaseStep):
         except Exception as e:
             return self.create_error_result(f'Failed to get storage {storage_id}: {str(e)}')
 
-        # Get and validate path
+        # Check if we're in multi-path mode
+        use_single_path = context.get_param('use_single_path', True)
+
+        # Get and validate path (only required in single-path mode)
         path = context.get_param('path')
-        if path is None:
-            return self.create_error_result('Path parameter is required')
+        pathlib_cwd = None
 
-        try:
-            pathlib_cwd = get_pathlib(storage, path)
-            context.set_pathlib_cwd(pathlib_cwd)
-        except Exception as e:
-            return self.create_error_result(f'Failed to get path {path}: {str(e)}')
+        if use_single_path:
+            # Single-path mode: global path is required
+            if path is None:
+                return self.create_error_result('Path parameter is required in single-path mode')
+
+            try:
+                pathlib_cwd = get_pathlib(storage, path)
+                context.set_pathlib_cwd(pathlib_cwd)
+            except Exception as e:
+                return self.create_error_result(f'Failed to get path {path}: {str(e)}')
+        else:
+            # Multi-path mode: global path is optional (each asset has its own path)
+            if path:
+                try:
+                    pathlib_cwd = get_pathlib(storage, path)
+                    context.set_pathlib_cwd(pathlib_cwd)
+                except Exception as e:
+                    return self.create_error_result(f'Failed to get path {path}: {str(e)}')
 
         # Return success with rollback data
-        rollback_data = {'storage_id': storage_id, 'path': path}
+        rollback_data = {'storage_id': storage_id, 'path': path, 'use_single_path': use_single_path}
 
         return self.create_success_result(
             data={'storage': storage, 'pathlib_cwd': pathlib_cwd}, rollback_data=rollback_data

synapse_sdk/plugins/categories/upload/actions/upload/steps/metadata.py

@@ -61,9 +61,15 @@ class ProcessMetadataStep(BaseStep):
                 excel_metadata = metadata_strategy.extract(excel_path)
             else:
                 # Look for default metadata files (meta.xlsx, meta.xls)
-                excel_path = self._find_excel_metadata_file(context.pathlib_cwd)
-                if excel_path:
-                    excel_metadata = metadata_strategy.extract(excel_path)
+                # Only possible in single-path mode where pathlib_cwd is set
+                if context.pathlib_cwd:
+                    excel_path = self._find_excel_metadata_file(context.pathlib_cwd)
+                    if excel_path:
+                        excel_metadata = metadata_strategy.extract(excel_path)
+                else:
+                    context.run.log_message(
+                        'No Excel metadata specified and multi-path mode - skipping metadata processing'
+                    )
 
             # Validate extracted metadata
             if excel_metadata:
@@ -136,9 +142,13 @@ class ProcessMetadataStep(BaseStep):
         if path.exists() and path.is_file():
             return path, False
 
-        # Try relative to cwd
-        path = context.pathlib_cwd / excel_path_str
-        return (path, False) if path.exists() else (None, False)
+        # Try relative to cwd (only if pathlib_cwd is set)
+        if context.pathlib_cwd:
+            path = context.pathlib_cwd / excel_path_str
+            return (path, False) if path.exists() else (None, False)
+
+        # In multi-path mode without pathlib_cwd, can only use absolute paths
+        return (None, False)
 
     def _resolve_excel_path_from_base64(
         self, excel_config: dict | ExcelMetadataFile, context: UploadContext
@@ -179,7 +189,17 @@ class ProcessMetadataStep(BaseStep):
             return None, False
 
     def _find_excel_metadata_file(self, pathlib_cwd: Path) -> Path:
-        """Find default Excel metadata file."""
+        """Find default Excel metadata file.
+
+        Args:
+            pathlib_cwd: Working directory path (must not be None)
+
+        Returns:
+            Path to Excel metadata file, or None if not found
+        """
+        if not pathlib_cwd:
+            return None
+
         # Check .xlsx first as it's more common
         excel_path = pathlib_cwd / 'meta.xlsx'
         if excel_path.exists():

synapse_sdk/plugins/categories/upload/actions/upload/steps/organize.py

@@ -90,25 +90,40 @@ class OrganizeFilesStep(BaseStep):
         if not assets:
             return self.create_error_result('Multi-path mode requires assets configuration')
 
+        # Validate that all required specs have asset paths
+        required_specs = [spec['name'] for spec in context.file_specifications if spec.get('is_required', False)]
+        missing_required = [spec for spec in required_specs if spec not in assets]
+
+        if missing_required:
+            return self.create_error_result(
+                f'Multi-path mode requires asset paths for required specs: {", ".join(missing_required)}'
+            )
+
         context.run.log_message(f'Using multi-path mode with {len(assets)} asset configurations')
         context.run.log_message_with_code(LogCode.FILE_ORGANIZATION_STARTED)
 
-        all_organized_files = []
+        # Collect all files and specs first
+        all_files = []
         type_dirs = {}
+        specs_with_files = []
 
         for spec in context.file_specifications:
             spec_name = spec['name']
+            is_required = spec.get('is_required', False)
 
-            # Skip if no asset configuration for this spec
+            # Skip if no asset configuration for this spec (only allowed for optional specs)
             if spec_name not in assets:
-                context.run.log_message(f'Skipping {spec_name}: no asset path configured')
+                if is_required:
+                    # This should not happen due to validation above, but double-check
+                    return self.create_error_result(f'Required spec {spec_name} missing asset path')
+                context.run.log_message(f'Skipping optional spec {spec_name}: no asset path configured')
                 continue
 
             asset_config = assets[spec_name]
 
             # Get the asset path from storage
             try:
-                asset_path = get_pathlib(context.storage, asset_config.path)
+                asset_path = get_pathlib(context.storage, asset_config.get('path', ''))
                 type_dirs[spec_name] = asset_path
             except Exception as e:
                 context.run.log_message(f'Error accessing path for {spec_name}: {str(e)}', 'WARNING')
@@ -119,9 +134,9 @@ class OrganizeFilesStep(BaseStep):
                 continue
 
             # Discover files for this asset
-            is_recursive = asset_config.is_recursive
+            is_recursive = asset_config.get('is_recursive', True)
             context.run.log_message(
-                f'Discovering files for {spec_name} at {asset_config.path} (recursive={is_recursive})'
+                f'Discovering files for {spec_name} at {asset_config.get("path", "")} (recursive={is_recursive})'
             )
 
             files = file_discovery_strategy.discover(asset_path, is_recursive)
@@ -130,14 +145,23 @@ class OrganizeFilesStep(BaseStep):
                 context.run.log_message(f'No files found for {spec_name}', 'WARNING')
                 continue
 
-            # Organize files for this specific spec
-            organized = file_discovery_strategy.organize(files, [spec], context.metadata or {}, {spec_name: asset_path})
+            all_files.extend(files)
+            specs_with_files.append(spec)
+            context.run.log_message(f'Found {len(files)} files for {spec_name}')
 
-            all_organized_files.extend(organized)
-            context.run.log_message(f'Found {len(organized)} files for {spec_name}')
+        # Organize all files together to group by dataset_key
+        all_organized_files = []
+        if all_files and specs_with_files:
+            context.run.log_message(f'Organizing {len(all_files)} files across {len(specs_with_files)} specs')
+            context.run.log_message(f'Type directories: {list(type_dirs.keys())}')
+
+            all_organized_files = file_discovery_strategy.organize(
+                all_files, specs_with_files, context.metadata or {}, type_dirs
+            )
 
         if all_organized_files:
             context.run.log_message_with_code(LogCode.FILES_DISCOVERED, len(all_organized_files))
+            context.run.log_message(f'Created {len(all_organized_files)} data units from {len(all_files)} files')
             context.add_organized_files(all_organized_files)
         else:
             context.run.log_message_with_code(LogCode.NO_FILES_FOUND_WARNING)
@@ -159,8 +183,17 @@ class OrganizeFilesStep(BaseStep):
 
     def validate_prerequisites(self, context: UploadContext) -> None:
         """Validate prerequisites for file organization."""
-        if not context.pathlib_cwd:
-            raise ValueError('Working directory path not set')
+        use_single_path = context.get_param('use_single_path', True)
+
+        # In single-path mode, pathlib_cwd is required
+        if use_single_path and not context.pathlib_cwd:
+            raise ValueError('Working directory path not set in single-path mode')
+
+        # In multi-path mode, pathlib_cwd is optional (each asset has its own path)
+        if not use_single_path:
+            assets = context.get_param('assets', {})
+            if not assets:
+                raise ValueError('Multi-path mode requires assets configuration')
 
         if not context.file_specifications:
             raise ValueError('File specifications not available')

synapse_sdk/plugins/categories/upload/actions/upload/steps/upload.py

@@ -34,7 +34,9 @@ class UploadFilesStep(BaseStep):
             context.run.log_message_with_code(LogCode.UPLOADING_DATA_FILES)
 
             # Initialize metrics
-            context.update_metrics('data_files', {'stand_by': organized_files_count, 'success': 0, 'failed': 0})
+            initial_metrics = {'stand_by': organized_files_count, 'success': 0, 'failed': 0}
+            context.update_metrics('data_files', initial_metrics)
+            context.run.set_metrics(initial_metrics, category='data_files')
 
             # Create upload configuration
             upload_config = UploadConfig(
@@ -55,10 +57,13 @@ class UploadFilesStep(BaseStep):
                 context.run.log_data_file(uploaded_file, UploadStatus.SUCCESS)
 
             # Update final metrics
-            context.update_metrics(
-                'data_files',
-                {'stand_by': 0, 'success': len(uploaded_files), 'failed': organized_files_count - len(uploaded_files)},
-            )
+            final_metrics = {
+                'stand_by': 0,
+                'success': len(uploaded_files),
+                'failed': organized_files_count - len(uploaded_files),
+            }
+            context.update_metrics('data_files', final_metrics)
+            context.run.set_metrics(final_metrics, category='data_files')
 
             # Complete progress
             context.run.set_progress(organized_files_count, organized_files_count, category='upload_data_files')

synapse_sdk/plugins/categories/upload/actions/upload/strategies/file_discovery/flat.py

@@ -10,7 +10,11 @@ class FlatFileDiscoveryStrategy(FileDiscoveryStrategy):
 
     def discover(self, path: Path, recursive: bool) -> List[Path]:
         """Discover files non-recursively in the given path."""
-        return [file_path for file_path in path.glob('*') if file_path.is_file()]
+        # Exclude system files
+        excluded_files = {'.DS_Store', 'Thumbs.db', 'desktop.ini'}
+        return [
+            file_path for file_path in path.glob('*') if file_path.is_file() and file_path.name not in excluded_files
+        ]
 
     def organize(self, files: List[Path], specs: Dict, metadata: Dict, type_dirs: Dict = None) -> List[Dict]:
         """Organize files according to specifications with metadata."""
@@ -39,9 +43,14 @@ class FlatFileDiscoveryStrategy(FileDiscoveryStrategy):
         # Performance optimization 2: Build metadata index for faster lookups
         metadata_index = self._build_metadata_index(metadata)
 
-        # Group files by dataset (flat discovery)
+        # Group files by dataset_key (stem-based matching) - flat discovery (no subdirectories)
+        # Strategy:
+        # 1. Group all files (required + optional) by their file stem
+        # 2. Only create data units for groups that have ALL required files
+        # 3. Optional files are automatically included if they match the stem
         dataset_files = {}
         required_specs = [spec['name'] for spec in specs if spec.get('is_required', False)]
+        optional_specs = [spec['name'] for spec in specs if not spec.get('is_required', False)]
 
         for file_path in files:
             # Determine which type directory this file belongs to
@@ -64,20 +73,36 @@ class FlatFileDiscoveryStrategy(FileDiscoveryStrategy):
                             # If stat fails, keep existing file
                             pass
 
-        # Create organized files for datasets with all required files
+        # Create organized files ONLY for datasets with ALL required files
+        # Optional files are included automatically if they match the stem
         for file_name, files_dict in sorted(dataset_files.items()):
-            if all(req in files_dict for req in required_specs):
-                # Calculate most common file extension (optimized)
+            # Check if all required files are present
+            has_all_required = all(req in files_dict for req in required_specs)
+
+            if has_all_required:
+                # Extract original file stem from actual file paths (more reliable)
+                # Collect stems from all files in the group
+                file_stems = {}
                 file_extensions = {}
+
                 for file_path in files_dict.values():
+                    stem = file_path.stem
                     ext = file_path.suffix.lower()
+
+                    # Count stems (to handle multiple files with slightly different names)
+                    if stem:
+                        file_stems[stem] = file_stems.get(stem, 0) + 1
+
+                    # Count extensions
                     if ext:
                         file_extensions[ext] = file_extensions.get(ext, 0) + 1
 
+                # Use the most common stem (usually they're all the same)
+                original_stem = max(file_stems, key=file_stems.get) if file_stems else file_name
                 origin_file_extension = max(file_extensions, key=file_extensions.get) if file_extensions else ''
 
                 meta_data = {
-                    'origin_file_stem': file_name,
+                    'origin_file_stem': original_stem,
                     'origin_file_extension': origin_file_extension,
                     'created_at': datetime.now().isoformat(),
                 }

synapse_sdk/plugins/categories/upload/actions/upload/strategies/file_discovery/recursive.py

@@ -10,7 +10,14 @@ class RecursiveFileDiscoveryStrategy(FileDiscoveryStrategy):
 
     def discover(self, path: Path, recursive: bool) -> List[Path]:
         """Discover files recursively in the given path."""
-        return [file_path for file_path in path.rglob('*') if file_path.is_file()]
+        # Exclude system directories
+        excluded_dirs = {'@eaDir', '.@__thumb', '@Recycle', '#recycle', '.DS_Store', 'Thumbs.db', '.synology'}
+
+        def exclude_dirs(file_path: Path) -> bool:
+            """Check if file path contains excluded directories."""
+            return any(excluded_dir in file_path.parts for excluded_dir in excluded_dirs)
+
+        return [file_path for file_path in path.rglob('*') if file_path.is_file() and not exclude_dirs(file_path)]
 
     def organize(self, files: List[Path], specs: Dict, metadata: Dict, type_dirs: Dict = None) -> List[Dict]:
         """Organize files according to specifications with metadata."""
@@ -42,57 +49,78 @@ class RecursiveFileDiscoveryStrategy(FileDiscoveryStrategy):
         # Performance optimization 2: Build metadata index for faster lookups
         metadata_index = self._build_metadata_index(metadata)
 
-        # Group files by dataset
+        # Group files by dataset_key (stem-based matching)
+        # Strategy:
+        # 1. Group all files (required + optional) by their file stem
+        # 2. Only create data units for groups that have ALL required files
+        # 3. Optional files are automatically included if they match the stem
         dataset_files = {}
         required_specs = [spec['name'] for spec in specs if spec.get('is_required', False)]
 
         for file_path in files:
             # Determine which type directory this file belongs to
-            file_path_str = str(file_path)
+            matched = False
             for spec_name, dir_path in type_dirs.items():
-                dir_path_str = path_cache[dir_path]
-                if file_path_str.startswith(dir_path_str):
-                    # Create unique dataset key using relative path from spec directory
+                # Check if file is under this spec's directory
+                # Use try/except for relative_to to ensure proper path matching
+                try:
                     relative_path = file_path.relative_to(dir_path)
-                    # Use parent directory + stem as unique key to group related files
-                    if relative_path.parent != Path('.'):
-                        dataset_key = f'{relative_path.parent}_{file_path.stem}'
-                    else:
-                        dataset_key = file_path.stem
-
-                    if dataset_key not in dataset_files:
-                        dataset_files[dataset_key] = {}
-
-                    if spec_name not in dataset_files[dataset_key]:
-                        dataset_files[dataset_key][spec_name] = file_path
-                    else:
-                        # Keep the most recent file - only stat when needed
-                        existing_file = dataset_files[dataset_key][spec_name]
-                        try:
-                            if file_path.stat().st_mtime > existing_file.stat().st_mtime:
-                                dataset_files[dataset_key][spec_name] = file_path
-                        except (OSError, IOError):
-                            # If stat fails, keep existing file
-                            pass
-
-        # Create organized files for datasets with all required files
-        for dataset_key, files_dict in sorted(dataset_files.items()):
-            if all(req in files_dict for req in required_specs):
-                # Extract original file stem from dataset_key
-                # If dataset_key contains path info (parent_stem), extract just the stem part
-                if '_' in dataset_key and len(dataset_key.split('_')) >= 2:
-                    # Extract the last part after the last underscore as the original stem
-                    original_stem = dataset_key.split('_')[-1]
+                    matched = True
+                except ValueError:
+                    # File is not under this directory
+                    continue
+
+                # Create unique dataset key using relative path from spec directory
+                # Use parent directory + stem as unique key to group related files
+                if relative_path.parent != Path('.'):
+                    dataset_key = f'{relative_path.parent}_{file_path.stem}'
+                else:
+                    dataset_key = file_path.stem
+
+                if dataset_key not in dataset_files:
+                    dataset_files[dataset_key] = {}
+
+                if spec_name not in dataset_files[dataset_key]:
+                    dataset_files[dataset_key][spec_name] = file_path
                 else:
-                    original_stem = dataset_key
+                    # Keep the most recent file - only stat when needed
+                    existing_file = dataset_files[dataset_key][spec_name]
+                    try:
+                        if file_path.stat().st_mtime > existing_file.stat().st_mtime:
+                            dataset_files[dataset_key][spec_name] = file_path
+                    except (OSError, IOError):
+                        # If stat fails, keep existing file
+                        pass
+
+                # Found matching directory, move to next file
+                break
+
+        # Create organized files ONLY for datasets with ALL required files
+        # Optional files are included automatically if they match the stem
+        for dataset_key, files_dict in sorted(dataset_files.items()):
+            # Check if all required files are present
+            has_all_required = all(req in files_dict for req in required_specs)
 
-                # Calculate most common file extension (optimized)
+            if has_all_required:
+                # Extract original file stem from actual file paths (more reliable than parsing dataset_key)
+                # Collect stems from all files in the group
+                file_stems = {}
                 file_extensions = {}
+
                 for file_path in files_dict.values():
+                    stem = file_path.stem
                     ext = file_path.suffix.lower()
+
+                    # Count stems (to handle multiple files with slightly different names)
+                    if stem:
+                        file_stems[stem] = file_stems.get(stem, 0) + 1
+
+                    # Count extensions
                     if ext:
                         file_extensions[ext] = file_extensions.get(ext, 0) + 1
 
+                # Use the most common stem (usually they're all the same)
+                original_stem = max(file_stems, key=file_stems.get) if file_stems else dataset_key
                 origin_file_extension = max(file_extensions, key=file_extensions.get) if file_extensions else ''
 
                 meta_data = {

synapse_sdk/plugins/categories/upload/actions/upload/strategies/validation/default.py

@@ -12,12 +12,24 @@ class DefaultValidationStrategy(ValidationStrategy):
         """Validate action parameters."""
         errors = []
 
-        # Check required parameters
-        required_params = ['storage', 'data_collection', 'path', 'name']
+        # Check required parameters (common to all modes)
+        required_params = ['storage', 'data_collection', 'name']
         for param in required_params:
             if param not in params:
                 errors.append(f'Missing required parameter: {param}')
 
+        # Check mode-specific requirements
+        use_single_path = params.get('use_single_path', True)
+
+        if use_single_path:
+            # Single-path mode: 'path' is required
+            if 'path' not in params:
+                errors.append("Missing required parameter 'path' in single-path mode")
+        else:
+            # Multi-path mode: 'assets' is required
+            if 'assets' not in params:
+                errors.append("Missing required parameter 'assets' in multi-path mode")
+
         # Check parameter types
         if 'storage' in params and not isinstance(params['storage'], int):
             errors.append("Parameter 'storage' must be an integer")
@@ -28,6 +40,9 @@ class DefaultValidationStrategy(ValidationStrategy):
         if 'is_recursive' in params and not isinstance(params['is_recursive'], bool):
             errors.append("Parameter 'is_recursive' must be a boolean")
 
+        if 'use_single_path' in params and not isinstance(params['use_single_path'], bool):
+            errors.append("Parameter 'use_single_path' must be a boolean")
+
         return ValidationResult(valid=len(errors) == 0, errors=errors)
 
     def validate_files(self, files: List[Dict], specs: Dict) -> ValidationResult:

{synapse_sdk-2025.10.4.dist-info → synapse_sdk-2025.10.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synapse-sdk
-Version: 2025.10.4
+Version: 2025.10.5
 Summary: synapse sdk
 Author-email: datamaker <developer@datamaker.io>
 License: MIT

{synapse_sdk-2025.10.4.dist-info → synapse_sdk-2025.10.5.dist-info}/RECORD

@@ -101,7 +101,7 @@ synapse_sdk/devtools/docs/docs/plugins/categories/pre-annotation-plugins/to-task
 synapse_sdk/devtools/docs/docs/plugins/categories/pre-annotation-plugins/to-task-overview.md,sha256=J-z2KkLt5WWTgbJGRxvqrZQxfHvur_QtCGA6iT5a0Og,17134
 synapse_sdk/devtools/docs/docs/plugins/categories/pre-annotation-plugins/to-task-template-development.md,sha256=ARirm2jq5X2fVXWpZFX6ezh0aSIK5PCWvYC9nvsXIwY,41159
 synapse_sdk/devtools/docs/docs/plugins/categories/upload-plugins/upload-plugin-action.md,sha256=GmTZYLyPDuUC9WzjNjf_zNh5FkN-VYzLuSo_dQzewWw,30796
-synapse_sdk/devtools/docs/docs/plugins/categories/upload-plugins/upload-plugin-overview.md,sha256=E42ycC5Jfb19DBdLZ2QnCiABUuXkJW4a0ZEQwnXi2ZY,15740
+synapse_sdk/devtools/docs/docs/plugins/categories/upload-plugins/upload-plugin-overview.md,sha256=Q4jqN_W3AB-7PEDpkCxwKjmrjERGpb-UNqYA9I0O63Y,16513
 synapse_sdk/devtools/docs/docs/plugins/categories/upload-plugins/upload-plugin-template.md,sha256=HpqGQ9yUYy4673gkdPNsqFZRdAXnDv3xbrC87brG50o,22288
 synapse_sdk/devtools/docs/docs/tutorial-basics/_category_.json,sha256=qQVHZ1p0CxHg5Gb4CYNxUSeqZ3LVo4nXN_N0yUMVpDM,180
 synapse_sdk/devtools/docs/docs/tutorial-basics/congratulations.md,sha256=zJbcwKNVYGpLAGJO7e3cTdptFhb6m_NUzYDU5i6MWgc,1078
@@ -154,7 +154,7 @@ synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/plugins
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/plugins/categories/pre-annotation-plugins/to-task-overview.md,sha256=InL4EI0BkVXgjs-j7cPRYaRXDVxxMgBYYLs_9FdyKxk,18408
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/plugins/categories/pre-annotation-plugins/to-task-template-development.md,sha256=Ab8EeSYMWZclb_qxvBaLaz4IdCXySrKN2o68s24VT6I,42441
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/plugins/categories/upload-plugins/upload-plugin-action.md,sha256=zaodG2yGwNQiPLrI59dhShB0WxZ1EMNdXnQx9E5Kzlk,32523
-synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/plugins/categories/upload-plugins/upload-plugin-overview.md,sha256=mcqq_bbC13KAgNZX6OUEbHxt03QhGMN9vF2MmU0WW-A,17111
+synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/plugins/categories/upload-plugins/upload-plugin-overview.md,sha256=7xo-N4NwDvF3QFVKafZosjG1IbtwI-BzTTTyo4kzU44,17953
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/plugins/categories/upload-plugins/upload-plugin-template.md,sha256=Rldxjo5DKmHfEBMoF86yLkgYGoip99gVkF7gBSkqNxM,23603
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-theme-classic/footer.json,sha256=SCLmysIhJ6XEEfnL7cOQb3s08EG4LA-ColdRRxecIH8,1601
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-theme-classic/navbar.json,sha256=M-ly81cWnesYYtCRcfMvOsKl5P0z52K9kiw0T6GIQ60,429
@@ -274,8 +274,8 @@ synapse_sdk/plugins/categories/smart_tool/templates/plugin/auto_label.py,sha256=
 synapse_sdk/plugins/categories/upload/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 synapse_sdk/plugins/categories/upload/actions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 synapse_sdk/plugins/categories/upload/actions/upload/__init__.py,sha256=ShmALSr3rncCMHYlSJkYwdvEOsEHUxAzG5-hoERhmI0,548
-synapse_sdk/plugins/categories/upload/actions/upload/action.py,sha256=fFAZpNk_pZImaipeCcVKL4HdCnnj3BMr12mPduE-Cg0,9993
-synapse_sdk/plugins/categories/upload/actions/upload/context.py,sha256=RbAt1aag42H5h-m7VWv98e0X_7rVjlfBfILsQqrsK_c,6329
+synapse_sdk/plugins/categories/upload/actions/upload/action.py,sha256=RtOV-Q2oG5oLggJQ5A2FKFj7axmIJT8wUcaF0zJTTZo,10357
+synapse_sdk/plugins/categories/upload/actions/upload/context.py,sha256=4sBWs-IRstzK5U-9N-Ag1vuux6zos_D1P8MFQMaPrKk,6292
 synapse_sdk/plugins/categories/upload/actions/upload/enums.py,sha256=TQ-HiGI_-15rc11XQiCT6O5hRzmjkdCnRhX3Ci3bKk0,7856
 synapse_sdk/plugins/categories/upload/actions/upload/exceptions.py,sha256=QIpts9h78OD8GWCIGjX9jSV4v3Gb0cqH9Eo-6OwN1Qk,1223
 synapse_sdk/plugins/categories/upload/actions/upload/factory.py,sha256=n8PE_LEz8ajLWmRg-CacBt0Bo0vhpDp89_QhvY2VMnQ,6336
@@ -288,11 +288,11 @@ synapse_sdk/plugins/categories/upload/actions/upload/steps/__init__.py,sha256=-O
 synapse_sdk/plugins/categories/upload/actions/upload/steps/base.py,sha256=yzOmjQKlcsmlB5XZqGgQbCyNwwUiKa9nWd2-Pn22Vls,3682
 synapse_sdk/plugins/categories/upload/actions/upload/steps/cleanup.py,sha256=JAc1L9UfiEhNQ2NWnBMX2Bs4Vej08QPYML6Mb0-a0jg,2200
 synapse_sdk/plugins/categories/upload/actions/upload/steps/collection.py,sha256=zLm4BOuu4d8YqXOjOEDhbEUFQ2t4eSsPJB5e_FKYczI,2345
-synapse_sdk/plugins/categories/upload/actions/upload/steps/generate.py,sha256=ooShRR1w7lAaA2STAtOo3LaLPnK_tC08oefP3dZ2V60,3366
-synapse_sdk/plugins/categories/upload/actions/upload/steps/initialize.py,sha256=ymnTfsaVJj58r7U8nWIbjHgIdm0kXFjZlvl2PHJWksI,2401
-synapse_sdk/plugins/categories/upload/actions/upload/steps/metadata.py,sha256=xgBVneUZQFeHe6l2MWc5ZZ5PCGtq_l7AHX8NLdmEQvg,8473
-synapse_sdk/plugins/categories/upload/actions/upload/steps/organize.py,sha256=ftphDYloGG0G0pmRHyMAF8pIpQPiofxYyHRR4RTxxAU,6932
-synapse_sdk/plugins/categories/upload/actions/upload/steps/upload.py,sha256=cuWjxfWrmHrklTt5rcM8XYJ40qE7IRXE4KdY5oK5ga4,3893
+synapse_sdk/plugins/categories/upload/actions/upload/steps/generate.py,sha256=dekCGjg-uSTBY7eNcM7emptl9Yxr038xup86Kfea-NE,3604
+synapse_sdk/plugins/categories/upload/actions/upload/steps/initialize.py,sha256=JaPK1Mn7Cq4z69AIYps6iOsvVztownW5RnvyhbKhiGk,3137
+synapse_sdk/plugins/categories/upload/actions/upload/steps/metadata.py,sha256=bQ9V8BaZ0LW42_cCsojA3hyQoa7RUCUGOzEaNCqN9wM,9197
+synapse_sdk/plugins/categories/upload/actions/upload/steps/organize.py,sha256=0MqkqeFxDjVFt5Jn_eOwHCrjhUNJU6xnS8H71eGkPdE,8712
+synapse_sdk/plugins/categories/upload/actions/upload/steps/upload.py,sha256=GPw5RyTZLAPY2uPeay1iTMf0U86lTDT3n99FdRsBzgA,4147
 synapse_sdk/plugins/categories/upload/actions/upload/steps/validate.py,sha256=31N7lb41G1-LlwLaGkCQkKB8ep4FPxxtLhp0sv3-1Vs,2427
 synapse_sdk/plugins/categories/upload/actions/upload/strategies/__init__.py,sha256=JXysLlVGJDVtqZYFE6WIGcKgFNHcjqTzC0HO233Sak0,54
 synapse_sdk/plugins/categories/upload/actions/upload/strategies/base.py,sha256=fMzTpZA6M-qqi9ZHBQ134a5w97QChiafHoi03AqwTpA,2488
@@ -300,8 +300,8 @@ synapse_sdk/plugins/categories/upload/actions/upload/strategies/data_unit/__init
 synapse_sdk/plugins/categories/upload/actions/upload/strategies/data_unit/batch.py,sha256=YzKq5wHvrQ1_Tv__1xsX1ArLOEwgJNkDilZHg9k7GTY,1475
 synapse_sdk/plugins/categories/upload/actions/upload/strategies/data_unit/single.py,sha256=bjvWu5t_nAK9Z8AWM_n1uwusMWd9G-7ddqSmwsH39l0,1344
 synapse_sdk/plugins/categories/upload/actions/upload/strategies/file_discovery/__init__.py,sha256=ELVncVuhTFvPrbGUjZZAD7upvV3IEsaRi9eTXyjaOU8,42
-synapse_sdk/plugins/categories/upload/actions/upload/strategies/file_discovery/flat.py,sha256=OW_EyZJYi40Qgri4MhRKGj98M-0SOUz58ldM-de00Cc,9866
-synapse_sdk/plugins/categories/upload/actions/upload/strategies/file_discovery/recursive.py,sha256=gdIaOFB9QyO7MZTQTnX_iI_fn_ysEfRLKQRyRHzZkLE,11072
+synapse_sdk/plugins/categories/upload/actions/upload/strategies/file_discovery/flat.py,sha256=QLd8pS9y3NyeNRQf1Ch5xFkwGRFjJoYXgV6QmHAn8hs,11155
+synapse_sdk/plugins/categories/upload/actions/upload/strategies/file_discovery/recursive.py,sha256=Q2tvBmuhlNndBVHR9asBaRH_N2Sx7N4doCXT1uLkP-M,12243
 synapse_sdk/plugins/categories/upload/actions/upload/strategies/metadata/__init__.py,sha256=d3sSL9boHCmYmbWupbJ7s8LOBakGCgjiPKRQIbfDCs8,36
 synapse_sdk/plugins/categories/upload/actions/upload/strategies/metadata/excel.py,sha256=LlykEvwfyuRRCWozExQoolvIfHH1-B4vHOu7dykSTnQ,7333
 synapse_sdk/plugins/categories/upload/actions/upload/strategies/metadata/none.py,sha256=RGcSmc4N9JnqxC8R-AEo_4_wmg1KS0lij1PxXij9ipk,507
@@ -309,7 +309,7 @@ synapse_sdk/plugins/categories/upload/actions/upload/strategies/upload/__init__.
 synapse_sdk/plugins/categories/upload/actions/upload/strategies/upload/async_upload.py,sha256=Jn-yK0BqLgx1zRmIh9AJCDPsM2B9Yzu_0im5U305vnw,5720
 synapse_sdk/plugins/categories/upload/actions/upload/strategies/upload/sync.py,sha256=IkRpy561HMHE1Ji0l2Nv21CfH9ZiCrm4qBCADeZFTXs,1875
 synapse_sdk/plugins/categories/upload/actions/upload/strategies/validation/__init__.py,sha256=aq-sI8tScvc0rX21qlLeBgJyKaVpC0hziMB5vcg5K3Y,38
-synapse_sdk/plugins/categories/upload/actions/upload/strategies/validation/default.py,sha256=3v-nBoI8osnRKCYE0YqXRiA-yqe2_JRklVQ-Lo03LgY,1830
+synapse_sdk/plugins/categories/upload/actions/upload/strategies/validation/default.py,sha256=3_jLBqw2snnBAtDuKKwVS6ImMwDZHeOSnqph_jCq2nE,2515
 synapse_sdk/plugins/categories/upload/templates/README.md,sha256=30BC3CpHrPmjPeLExFtjnYi6qZrBcDdn4fOc5F-uMmc,8995
 synapse_sdk/plugins/categories/upload/templates/config.yaml,sha256=xrLMhK6QTvxnqep7ulrEuq8DxVPS7TOI2cogCaBxK2g,1127
 synapse_sdk/plugins/categories/upload/templates/plugin/__init__.py,sha256=G8xv24PGWmL84Y77tElaEJhbjyjxklkqqdmxmZ834L0,11239
@@ -376,9 +376,9 @@ synapse_sdk/utils/storage/providers/gcp.py,sha256=i2BQCu1Kej1If9SuNr2_lEyTcr5M_n
 synapse_sdk/utils/storage/providers/http.py,sha256=2DhIulND47JOnS5ZY7MZUex7Su3peAPksGo1Wwg07L4,5828
 synapse_sdk/utils/storage/providers/s3.py,sha256=ZmqekAvIgcQBdRU-QVJYv1Rlp6VHfXwtbtjTSphua94,2573
 synapse_sdk/utils/storage/providers/sftp.py,sha256=_8s9hf0JXIO21gvm-JVS00FbLsbtvly4c-ETLRax68A,1426
-synapse_sdk-2025.10.4.dist-info/licenses/LICENSE,sha256=bKzmC5YAg4V1Fhl8OO_tqY8j62hgdncAkN7VrdjmrGk,1101
-synapse_sdk-2025.10.4.dist-info/METADATA,sha256=PlcCqkFByX8o9NHv9QZQiCy79fkfz_kUL-jMCTCPd9I,4186
-synapse_sdk-2025.10.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-synapse_sdk-2025.10.4.dist-info/entry_points.txt,sha256=VNptJoGoNJI8yLXfBmhgUefMsmGI0m3-0YoMvrOgbxo,48
-synapse_sdk-2025.10.4.dist-info/top_level.txt,sha256=ytgJMRK1slVOKUpgcw3LEyHHP7S34J6n_gJzdkcSsw8,12
-synapse_sdk-2025.10.4.dist-info/RECORD,,
+synapse_sdk-2025.10.5.dist-info/licenses/LICENSE,sha256=bKzmC5YAg4V1Fhl8OO_tqY8j62hgdncAkN7VrdjmrGk,1101
+synapse_sdk-2025.10.5.dist-info/METADATA,sha256=N1gJlSwg8kEhRTkXxmHMAJntzig0DtxmmV_t1Z5uPkE,4186
+synapse_sdk-2025.10.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+synapse_sdk-2025.10.5.dist-info/entry_points.txt,sha256=VNptJoGoNJI8yLXfBmhgUefMsmGI0m3-0YoMvrOgbxo,48
+synapse_sdk-2025.10.5.dist-info/top_level.txt,sha256=ytgJMRK1slVOKUpgcw3LEyHHP7S34J6n_gJzdkcSsw8,12
+synapse_sdk-2025.10.5.dist-info/RECORD,,