synapse-sdk 1.0.0b23__py3-none-any.whl → 2025.9.1__py3-none-any.whl

synapse_sdk/utils/file/video/transcode.py

@@ -0,0 +1,307 @@
+import asyncio
+import shutil
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Callable, Optional
+
+import ffmpeg
+
+
+# Exception classes
+class VideoTranscodeError(Exception):
+    """Base exception for video transcoding errors."""
+
+    pass
+
+
+class UnsupportedFormatError(VideoTranscodeError):
+    """Raised when input format is not supported."""
+
+    pass
+
+
+class FFmpegNotFoundError(VideoTranscodeError):
+    """Raised when FFmpeg is not installed or not in PATH."""
+
+    pass
+
+
+class TranscodingFailedError(VideoTranscodeError):
+    """Raised when FFmpeg transcoding process fails."""
+
+    pass
+
+
+@dataclass
+class TranscodeConfig:
+    """Video transcoding configuration."""
+
+    vcodec: str = 'libx264'  # Video codec
+    preset: str = 'medium'  # Encoding preset (ultrafast to veryslow)
+    crf: int = 28  # Constant Rate Factor (0-51, lower=better quality)
+    acodec: str = 'aac'  # Audio codec
+    audio_bitrate: str = '128k'  # Audio bitrate
+    movflags: str = '+faststart'  # MP4 optimization flags
+    resolution: Optional[str] = None  # Target resolution (e.g., '1920x1080')
+    fps: Optional[int] = None  # Target frame rate
+    start_time: Optional[float] = None  # Trim start time in seconds
+    duration: Optional[float] = None  # Trim duration in seconds
+
+
+# Supported input formats
+SUPPORTED_FORMATS = {'.mp4', '.avi', '.mov', '.mkv', '.webm', '.flv', '.wmv', '.mpeg', '.mpg', '.m4v', '.3gp', '.ogv'}
+
+
+def _check_ffmpeg_available():
+    """Check if FFmpeg is available in PATH."""
+    if not shutil.which('ffmpeg'):
+        raise FFmpegNotFoundError(
+            'FFmpeg is not installed or not found in PATH. Please install FFmpeg to use video transcoding features.'
+        )
+
+
+def validate_video_format(video_path: str | Path) -> bool:
+    """
+    Check if video format is supported for transcoding.
+
+    Args:
+        video_path (str | Path): Path to the video file
+
+    Returns:
+        bool: True if format is supported, False otherwise
+    """
+    path = Path(video_path)
+    return path.suffix.lower() in SUPPORTED_FORMATS
+
+
+def get_video_info(video_path: str | Path) -> dict:
+    """
+    Extract video metadata (resolution, duration, codecs, etc.).
+
+    Args:
+        video_path (str | Path): Path to the video file
+
+    Returns:
+        dict: Video metadata information
+
+    Raises:
+        VideoTranscodeError: If unable to probe video file
+    """
+    _check_ffmpeg_available()
+
+    try:
+        probe = ffmpeg.probe(str(video_path))
+
+        video_info = {}
+
+        # Get format information
+        if 'format' in probe:
+            format_info = probe['format']
+            video_info['duration'] = float(format_info.get('duration', 0))
+            video_info['size'] = int(format_info.get('size', 0))
+            video_info['bitrate'] = int(format_info.get('bit_rate', 0))
+
+        # Get stream information
+        video_streams = [stream for stream in probe['streams'] if stream['codec_type'] == 'video']
+        audio_streams = [stream for stream in probe['streams'] if stream['codec_type'] == 'audio']
+
+        if video_streams:
+            video_stream = video_streams[0]
+            video_info['width'] = int(video_stream.get('width', 0))
+            video_info['height'] = int(video_stream.get('height', 0))
+            video_info['video_codec'] = video_stream.get('codec_name', '')
+            video_info['fps'] = eval(video_stream.get('r_frame_rate', '0/1'))
+
+        if audio_streams:
+            audio_stream = audio_streams[0]
+            video_info['audio_codec'] = audio_stream.get('codec_name', '')
+            video_info['channels'] = int(audio_stream.get('channels', 0))
+            video_info['sample_rate'] = int(audio_stream.get('sample_rate', 0))
+
+        return video_info
+
+    except Exception as e:
+        raise VideoTranscodeError(f'Failed to probe video file: {str(e)}')
+
+
+def _build_ffmpeg_stream(input_path: str | Path, output_path: str | Path, config: TranscodeConfig):
+    """Build FFmpeg stream with configuration."""
+    stream = ffmpeg.input(str(input_path))
+
+    # Apply start time and duration trimming
+    if config.start_time is not None or config.duration is not None:
+        kwargs = {}
+        if config.start_time is not None:
+            kwargs['ss'] = config.start_time
+        if config.duration is not None:
+            kwargs['t'] = config.duration
+        stream = ffmpeg.input(str(input_path), **kwargs)
+
+    # Apply video filters
+    if config.resolution or config.fps:
+        if config.resolution:
+            width, height = config.resolution.split('x')
+            stream = ffmpeg.filter(stream, 'scale', width, height)
+        if config.fps:
+            stream = ffmpeg.filter(stream, 'fps', fps=config.fps)
+
+    # Build output with encoding parameters
+    output_kwargs = {
+        'vcodec': config.vcodec,
+        'preset': config.preset,
+        'crf': config.crf,
+        'acodec': config.acodec,
+        'audio_bitrate': config.audio_bitrate,
+        'movflags': config.movflags,
+    }
+
+    return ffmpeg.output(stream, str(output_path), **output_kwargs)
+
+
+def transcode_video(
+    input_path: str | Path,
+    output_path: str | Path,
+    config: Optional[TranscodeConfig] = None,
+    progress_callback: Optional[Callable[[float], None]] = None,
+) -> Path:
+    """
+    Transcode video with specified configuration.
+
+    Args:
+        input_path (str | Path): Path to input video file
+        output_path (str | Path): Path to output video file
+        config (Optional[TranscodeConfig]): Transcoding configuration
+        progress_callback (Optional[Callable[[float], None]]): Progress callback function
+
+    Returns:
+        Path: Path to the transcoded video file
+
+    Raises:
+        UnsupportedFormatError: If input format is not supported
+        FFmpegNotFoundError: If FFmpeg is not available
+        TranscodingFailedError: If transcoding fails
+    """
+    _check_ffmpeg_available()
+
+    input_path = Path(input_path)
+    output_path = Path(output_path)
+
+    if not validate_video_format(input_path):
+        raise UnsupportedFormatError(f'Unsupported video format: {input_path.suffix}')
+
+    if config is None:
+        config = TranscodeConfig()
+
+    # Ensure output directory exists
+    output_path.parent.mkdir(parents=True, exist_ok=True)
+
+    try:
+        # Build FFmpeg command
+        stream = _build_ffmpeg_stream(input_path, output_path, config)
+
+        # Run FFmpeg
+        if progress_callback:
+            # Get video duration for progress calculation
+            video_info = get_video_info(input_path)
+            total_duration = video_info.get('duration', 0)
+
+            # Run with progress monitoring
+            process = ffmpeg.run_async(stream, pipe_stderr=True, overwrite_output=True)
+
+            while True:
+                output = process.stderr.readline()
+                if output == b'' and process.poll() is not None:
+                    break
+                if output:
+                    line = output.decode('utf-8')
+                    # Parse progress from FFmpeg output
+                    if 'time=' in line and total_duration > 0:
+                        try:
+                            time_str = line.split('time=')[1].split()[0]
+                            hours, minutes, seconds = time_str.split(':')
+                            current_time = int(hours) * 3600 + int(minutes) * 60 + float(seconds)
+                            progress = min(current_time / total_duration, 1.0)
+                            progress_callback(progress)
+                        except (ValueError, IndexError):
+                            pass
+
+            if process.returncode != 0:
+                raise TranscodingFailedError('FFmpeg process failed')
+        else:
+            # Run without progress monitoring
+            ffmpeg.run(stream, overwrite_output=True, quiet=True)
+
+        return output_path
+
+    except ffmpeg.Error as e:
+        error_message = e.stderr.decode('utf-8') if e.stderr else str(e)
+        raise TranscodingFailedError(f'Transcoding failed: {error_message}')
+    except Exception as e:
+        raise VideoTranscodeError(f'Unexpected error during transcoding: {str(e)}')
+
+
+def optimize_for_web(video_path: str | Path, output_path: str | Path) -> Path:
+    """
+    Quick optimization for web streaming with default settings.
+
+    Args:
+        video_path (str | Path): Path to input video file
+        output_path (str | Path): Path to output video file
+
+    Returns:
+        Path: Path to the optimized video file
+    """
+    config = TranscodeConfig(
+        preset='fast',  # Faster encoding for web optimization
+        crf=23,  # Better quality for web
+        movflags='+faststart+frag_keyframe+empty_moov',  # Advanced web optimization
+    )
+    return transcode_video(video_path, output_path, config)
+
+
+async def atranscode_video(
+    input_path: str | Path, output_path: str | Path, config: Optional[TranscodeConfig] = None
+) -> Path:
+    """
+    Async version of transcode_video.
+
+    Args:
+        input_path (str | Path): Path to input video file
+        output_path (str | Path): Path to output video file
+        config (Optional[TranscodeConfig]): Transcoding configuration
+
+    Returns:
+        Path: Path to the transcoded video file
+    """
+    loop = asyncio.get_event_loop()
+    return await loop.run_in_executor(None, transcode_video, input_path, output_path, config)
+
+
+def transcode_batch(
+    video_paths: list[Path], output_dir: Path, config: Optional[TranscodeConfig] = None, max_workers: int = 4
+) -> list[Path]:
+    """
+    Process multiple videos concurrently.
+
+    Args:
+        video_paths (list[Path]): List of input video file paths
+        output_dir (Path): Directory for output files
+        config (Optional[TranscodeConfig]): Transcoding configuration
+        max_workers (int): Maximum number of concurrent workers
+
+    Returns:
+        list[Path]: List of paths to transcoded video files
+    """
+    import concurrent.futures
+
+    output_dir = Path(output_dir)
+    output_dir.mkdir(parents=True, exist_ok=True)
+
+    def process_video(video_path):
+        output_path = output_dir / f'{video_path.stem}_transcoded.mp4'
+        return transcode_video(video_path, output_path, config)
+
+    with concurrent.futures.ThreadPoolExecutor(max_workers=max_workers) as executor:
+        results = list(executor.map(process_video, video_paths))
+
+    return results

{synapse_sdk-1.0.0b23.dist-info → synapse_sdk-2025.9.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synapse-sdk
-Version: 1.0.0b23
+Version: 2025.9.1
 Summary: synapse sdk
 Author-email: datamaker <developer@datamaker.io>
 License: MIT
@@ -23,8 +23,9 @@ Requires-Dist: fsspec[gcs,s3,sftp]
 Requires-Dist: inquirer
 Requires-Dist: pillow
 Requires-Dist: websockets
+Requires-Dist: ffmpeg-python==0.2.0
 Provides-Extra: all
-Requires-Dist: ray[all]==2.44.1; extra == "all"
+Requires-Dist: ray[all]==2.49.1; extra == "all"
 Requires-Dist: python-nmap; extra == "all"
 Requires-Dist: hyperopt; extra == "all"
 Requires-Dist: bayesian-optimization==1.4.3; extra == "all"

{synapse_sdk-1.0.0b23.dist-info → synapse_sdk-2025.9.1.dist-info}/RECORD

@@ -29,7 +29,7 @@ synapse_sdk/clients/exceptions.py,sha256=ylv7x10eOp4aA3a48jwonnvqvkiYwzJYXjkVkRT
 synapse_sdk/clients/utils.py,sha256=8pPJTdzHiRPSbZMoQYHAgR2BAMO6u_R_jMV6a2p34iQ,392
 synapse_sdk/clients/agent/__init__.py,sha256=FqYbtzMJdzRfuU2SA-Yxdc0JKmVP1wxH6OlUNmB4lH8,2230
 synapse_sdk/clients/agent/core.py,sha256=aeMSzf8BF7LjVcmHaL8zC7ofBZUff8kIeqkW1xUJ6Sk,745
-synapse_sdk/clients/agent/ray.py,sha256=TfRiFv4QqwvxGAoNY7PmAWa3k6XgZaF1-fmLU-laqeM,12111
+synapse_sdk/clients/agent/ray.py,sha256=xs-X5ObKPbDN23gmDxs2lhI8h6K6iocGk7PAN9hBTjc,13990
 synapse_sdk/clients/agent/service.py,sha256=s7KuPK_DB1nr2VHrigttV1WyFonaGHNrPvU8loRxHcE,478
 synapse_sdk/clients/backend/__init__.py,sha256=9FzjQn0ljRhtdaoG3n38Mdgte7GFwIh4OtEmoqVg2_E,2098
 synapse_sdk/clients/backend/annotation.py,sha256=t9KnSdCJ7NvDRkAOKn4lm5hgoawbLCwIHMeo45QiIlQ,1249
@@ -53,7 +53,7 @@ synapse_sdk/devtools/docs/README.md,sha256=yBzWf0K1ef4oymFXDaHo0nYWEgMQJqsOyrkNh
 synapse_sdk/devtools/docs/docusaurus.config.ts,sha256=K1b002RS0x0tsOyib_6CSgUlASEULC9vAX8YDpbsRN4,3229
 synapse_sdk/devtools/docs/package-lock.json,sha256=dtepgbPC8gq5uz-hdcac4hIU-Cs209tX0sfBuB7RfEQ,705694
 synapse_sdk/devtools/docs/package.json,sha256=8veqayA4U3OLpdQaz6AzB59RQwTU-5soeYlYYWIxq28,1187
-synapse_sdk/devtools/docs/sidebars.ts,sha256=mvTBax6592aFOHth_ejBTEqlqA60xM_A1UMIHbTe6Qg,1593
+synapse_sdk/devtools/docs/sidebars.ts,sha256=1Gwh74epym2d_ebV9bcz8Yg8fKJTq_Fk6T1eG-Kl4TM,1573
 synapse_sdk/devtools/docs/tsconfig.json,sha256=O9BNlRPjPiaVHW2_boShMbmTnh0Z2k0KQO6Alf9FMVY,215
 synapse_sdk/devtools/docs/blog/2019-05-28-first-blog-post.md,sha256=iP7gl_FPqo-qX13lkSRcRoT6ayJNmCkXoyvlm7GH248,312
 synapse_sdk/devtools/docs/blog/2019-05-29-long-blog-post.md,sha256=cM-dhhTeurEWMcdn0Kx-NpNts2YUUraSI_XFk_gVHEE,3122
@@ -71,23 +71,23 @@ synapse_sdk/devtools/docs/docs/installation.md,sha256=TUXPQ9zhWW68WdimH85GihGMBG
 synapse_sdk/devtools/docs/docs/introduction.md,sha256=qaZaU9E8raOm3Eqf7Zxpi9qG26gyS91OK1pWHsnPPMA,1581
 synapse_sdk/devtools/docs/docs/quickstart.md,sha256=7h6JvNwkEuUuWE8cD3s0UhNeKG6U2_Svbq5XYhx_Zmo,1520
 synapse_sdk/devtools/docs/docs/troubleshooting.md,sha256=vFxo_ejj-fIW-GgmhEHgCmgWUf8KxFD4xyYRKlaVe0M,11137
-synapse_sdk/devtools/docs/docs/api/index.md,sha256=NsVizrDwBdwyQeM4NgBWnXmO1TSABIXtgnQ2B1_r9tQ,1331
+synapse_sdk/devtools/docs/docs/api/index.md,sha256=l5EA65asRKZpPLKp1agn8jIQjzURzaOxlo2HNAzazio,1381
 synapse_sdk/devtools/docs/docs/api/clients/agent.md,sha256=QbtdFQA-7rZhtnOh9tGSE9tKQQFeYGE7Z7RmxjVJzuw,786
 synapse_sdk/devtools/docs/docs/api/clients/backend.md,sha256=j0NYx82rEiydlMtNQvqkWIXLVHjxckRaZOh-JiVr4LM,1453
 synapse_sdk/devtools/docs/docs/api/clients/base.md,sha256=IxRGjYFI9KjZU3TFkjdWVdw9sgH40WAtOgIPJjORysc,720
-synapse_sdk/devtools/docs/docs/api/clients/ray.md,sha256=ur2Q89RVF2NJslFEyL95fyFfAmivJHyI38lyjwrmaNE,7569
+synapse_sdk/devtools/docs/docs/api/clients/ray.md,sha256=dnrqIT3MeCUnCH-9yUH59RSm46ZUtdRuncpfjFoPMXY,8089
 synapse_sdk/devtools/docs/docs/api/plugins/categories.md,sha256=8zRHyyl3JQ2p0zKU86-nE-NDeWZLMwp0bh8ZF-PSx9M,839
 synapse_sdk/devtools/docs/docs/api/plugins/models.md,sha256=XRMTD2DBilZwmO6AmPhLgdzNfBpcFkAdrBg9mgOMTUs,1060
 synapse_sdk/devtools/docs/docs/api/plugins/utils.md,sha256=39soJ1JLROm_mygR9UWG6XqZ1i5ESmTeZGijrAfUh-o,8389
-synapse_sdk/devtools/docs/docs/api/utils/file.md,sha256=wmYX9KUIWupMpSUKATLtUM9UetsNMAc51iK97xlLYZM,5596
-synapse_sdk/devtools/docs/docs/api/utils/network.md,sha256=1FMLDjJkZVF3Ni1kjbtEP6shnpWM4GMLxWy1WHnveqg,9727
-synapse_sdk/devtools/docs/docs/api/utils/storage.md,sha256=uIpc37trKUm4XHe1fd4auw56vMq3DvAMjJveSfN4rqU,1000
-synapse_sdk/devtools/docs/docs/api/utils/types.md,sha256=l84J1Ooa40xBYdvK1YpeKBT9kaqaWQUMNIFPUiC2e_U,1046
 synapse_sdk/devtools/docs/docs/concepts/index.md,sha256=ezn67P568PvFRPVE4T74j5MuEikgVOX7DV6MxIQBOHo,760
 synapse_sdk/devtools/docs/docs/examples/index.md,sha256=IZnF8veO7PqJYtAQevL1VHt1rBzieCSaXoWTQoXS4lA,504
 synapse_sdk/devtools/docs/docs/features/index.md,sha256=FD2hUzTzFgKa5pcDWPtA6eVw9pLLiRajYi4xA8aJTHg,963
 synapse_sdk/devtools/docs/docs/features/converters/index.md,sha256=W5d5UO8nbOLWs1G9IgdTutlMl-d6M0hDLMJbg8DrCQ8,12713
-synapse_sdk/devtools/docs/docs/plugins/export-plugins.md,sha256=W8u8o9PWZQJ-rBvwuw-daWtqsOfFod_j_4yNj4zbOj0,27028
+synapse_sdk/devtools/docs/docs/features/utils/file.md,sha256=H4vzxZiJ0X-US8OCfgfvUeXTp56BTg7NnmXU5wSTfb0,11869
+synapse_sdk/devtools/docs/docs/features/utils/network.md,sha256=IOYMhC7bM6BwpvaJosj9vxHXr0Vc5_qP09HP8OVuM64,9734
+synapse_sdk/devtools/docs/docs/features/utils/storage.md,sha256=uIpc37trKUm4XHe1fd4auw56vMq3DvAMjJveSfN4rqU,1000
+synapse_sdk/devtools/docs/docs/features/utils/types.md,sha256=l84J1Ooa40xBYdvK1YpeKBT9kaqaWQUMNIFPUiC2e_U,1046
+synapse_sdk/devtools/docs/docs/plugins/export-plugins.md,sha256=GDdAxcFyxoy96pMkGmodUXrKTxfFerk1Dt10QNHXTNA,32103
 synapse_sdk/devtools/docs/docs/plugins/plugins.md,sha256=2WMjbTKjIXTAdeODeTvJkDSsR9PiA58_VnCFuBnWRw4,24358
 synapse_sdk/devtools/docs/docs/plugins/upload-plugins.md,sha256=6-IE6QNimgggIJF5BxeGBUhKfV76WPglGH1-olU_R8Q,18489
 synapse_sdk/devtools/docs/docs/tutorial-basics/_category_.json,sha256=qQVHZ1p0CxHg5Gb4CYNxUSeqZ3LVo4nXN_N0yUMVpDM,180
@@ -113,21 +113,21 @@ synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/install
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/introduction.md,sha256=TE1XUd4axGRqodFduAUxAI0h72PDToWWE2WeTz-D0bg,1646
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/quickstart.md,sha256=SjQD0q6L16zIwk6LE7HDXlbZdcnZbnwSmGZz-0KWiL8,1683
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/troubleshooting.md,sha256=OvXUtf_CkQlCZ6PzTSUM_YdWFTknEkgvttO8Ywy1qTo,11793
-synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/api/index.md,sha256=o1wXl8lgCrpN_9sPj8AeajRqAdjJfaKg31Q7qLxyhnU,1474
+synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/api/index.md,sha256=60fhoQsnjuhdjFVVKCNd2qu6cY8f9A4PeZNx08obcdo,1524
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/api/clients/agent.md,sha256=UVllVNexQYmiHAk6dVVvd0MPQt6S9vBcK5Ur-BeLP2M,827
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/api/clients/backend.md,sha256=3XUZv_LYBuFfmY60t-0ZNeH4U61EzHrmI9ggfs7vS_8,1505
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/api/clients/base.md,sha256=cn8B5Py1TQjQc3a1B8wT_UuOGmb9eCk2IrKWSZnPlmA,804
-synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/api/clients/ray.md,sha256=CsI9mSPijmq1dz79BGD_74eR3Jb7ARsSi4M4-YHJ490,8334
-synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/api/utils/file.md,sha256=mPfds1ChrMR2yTcLTbBSQHSI7wit_76dI4_m6JIyebY,6107
-synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/api/utils/network.md,sha256=pIboIn7vB7VZbtvtFvJT-9rnP5fHu2kNVvZKbZ3i3wk,10341
-synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/api/utils/storage.md,sha256=V-IIUSVJjwh9n6KVZI5DxrU_T0l3AOtcCrAC2PRs43Q,1048
-synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/api/utils/types.md,sha256=JdDMC2FKovAU55pPEBoIUPPniU5mKAvA5w1Zb36u9AE,1207
+synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/api/clients/ray.md,sha256=m7yxYeDMnRdYPrzTPuSk9EHuDRjEMZRY6q-ty4-HmGs,8931
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/concepts/index.md,sha256=6o-8H7khfiMhQSXBAvkYpf6jzOEndPje1QAGdlGfskw,843
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/examples/index.md,sha256=pMAc1VLUXnHCv2xvvx-GBqVQ1Uh4h-u4nrco5UZ2z-Y,613
-synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/features/index.md,sha256=ogU60hHjgRSUlxdoEFTlM7jwbZ3fharaTFuYHp3vya4,1051
+synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/features/index.md,sha256=X0haPkqUY89K5R3LiGLQX9Boh_BpLxUsHA13skTTAp8,1015
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/features/converters/index.md,sha256=WpXcLBqC-xlvuoh-AhNOtFSo4qmnBIbR_wqLlazT7zo,1366
-synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/plugins/export-plugins.md,sha256=f1fe6zWV5t60QZwCev7e-GIW50itfZviZ8zVZTaoka0,28371
-synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/plugins/plugins.md,sha256=63auCIr_5_IFZgvPDd9XSovM1cv3TSx9U0zQRjrsxkI,3108
+synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/features/utils/file.md,sha256=1H-gv5w55BDjANFDrT7yIx2o-xM4g0E4At7hXFTCX5s,12546
+synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/features/utils/network.md,sha256=_jYDA25anaQ7FdfJmapACjqDvw3D2J8wj0RWCnXXpLY,10348
+synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/features/utils/storage.md,sha256=V-IIUSVJjwh9n6KVZI5DxrU_T0l3AOtcCrAC2PRs43Q,1048
+synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/features/utils/types.md,sha256=JdDMC2FKovAU55pPEBoIUPPniU5mKAvA5w1Zb36u9AE,1207
+synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/plugins/export-plugins.md,sha256=DSnhvWk54V6qlMXaeaiwgTJ9l0DVzkc36p0rOyqBjlE,33567
+synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/plugins/plugins.md,sha256=wUuuOmQQY1dURZzJ0HSpiABaJWqKbxQn31Xfn-wUf8E,4947
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/plugins/upload-plugins.md,sha256=E-xplOw6ZEgB0rtarshmSqRIFpYL12Ax5mXULI4VWXo,24740
 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
@@ -185,7 +185,7 @@ synapse_sdk/plugins/categories/export/enums.py,sha256=gtyngvQ1DKkos9iKGcbecwTVQQ
 synapse_sdk/plugins/categories/export/actions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 synapse_sdk/plugins/categories/export/actions/export.py,sha256=BO8N1LT8X9ImDmsqMdrbCUePsMEtOhazCuVtwp_ZmXs,13706
 synapse_sdk/plugins/categories/export/templates/config.yaml,sha256=fAqi-9dH7qEkFDSDFvt0BcZ72d2qbyt1P83L2ti6ELM,58
-synapse_sdk/plugins/categories/export/templates/plugin/__init__.py,sha256=jr88AziO-yi6dO9-O4a6HF6I6EBQjqP3h6dOrjYrDsU,15374
+synapse_sdk/plugins/categories/export/templates/plugin/__init__.py,sha256=9pEo-TUCDugi-UVL5x9iz8gnMqGabsDTaKIm-SeQf7s,16042
 synapse_sdk/plugins/categories/export/templates/plugin/export.py,sha256=3dZUEdhj-4YySJ-cPyNAqQvj5xcAXIX4KmXKcacTtd0,2754
 synapse_sdk/plugins/categories/neural_net/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 synapse_sdk/plugins/categories/neural_net/actions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -257,7 +257,7 @@ synapse_sdk/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU
 synapse_sdk/utils/dataset.py,sha256=zWTzFmv589izFr62BDuApi3r5FpTsdm-5AmriC0AEdM,1865
 synapse_sdk/utils/debug.py,sha256=F7JlUwYjTFZAMRbBqKm6hxOIz-_IXYA8lBInOS4jbS4,100
 synapse_sdk/utils/encryption.py,sha256=KMARrAk5aIHfBLC8CvdXiSIuaGvxljluubjF9PVLf7c,5100
-synapse_sdk/utils/file.py,sha256=lDyvSdw8_lV1mIwBWzO0DiCjPcv0BgC4qJNsr-ymbDQ,9162
+synapse_sdk/utils/file.py.backup,sha256=lDyvSdw8_lV1mIwBWzO0DiCjPcv0BgC4qJNsr-ymbDQ,9162
 synapse_sdk/utils/http.py,sha256=yRxYfru8tMnBVeBK-7S0Ga13yOf8oRHquG5e8K_FWcI,4759
 synapse_sdk/utils/module_loading.py,sha256=chHpU-BZjtYaTBD_q0T7LcKWtqKvYBS4L0lPlKkoMQ8,1020
 synapse_sdk/utils/network.py,sha256=4zWUbuEPcMXb_NVVeuUJ8zSl10ZAlWVHfzqbR25aez8,11978
@@ -275,6 +275,15 @@ synapse_sdk/utils/converters/pascal/to_dm.py,sha256=bQNUepahOCot4J23LCPOlFOhIZJ8
 synapse_sdk/utils/converters/yolo/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 synapse_sdk/utils/converters/yolo/from_dm.py,sha256=-JDCQLk4g1_FIVoOwZ1Tcs2kWFkhXRCAPVLKLXz6sLU,16180
 synapse_sdk/utils/converters/yolo/to_dm.py,sha256=XcSkyPickvdPR2JZ-PMMPEf1-uWQL76_pO78-4aPYcQ,10614
+synapse_sdk/utils/file/__init__.py,sha256=1FFrQVddZ8GgjcXkpWh4YcKLdzzCIB0p8bGmE3PPE5o,967
+synapse_sdk/utils/file/archive.py,sha256=Wdn4f7vkqePNCE2JPMzZnyIfLrQ33LuPRvEGwB4Ieg4,1107
+synapse_sdk/utils/file/checksum.py,sha256=9TArSECBHVwb0-NmtlJyNjZXXXMMOtwGxXW1p350B1g,1570
+synapse_sdk/utils/file/chunking.py,sha256=IC1FPMqRwtuDFTZOZDvhCuUfo2LBMIC4Tf-LeLB0A1Q,1088
+synapse_sdk/utils/file/download.py,sha256=Zsd0ik7ajRexwcRoQvx7AlZbe4uD9hhurZYs3eGw_1s,3931
+synapse_sdk/utils/file/encoding.py,sha256=wcmWJuqhOnO94Umz03z_7znhtKwgpKIK9CsEagNdIwc,1124
+synapse_sdk/utils/file/io.py,sha256=fl_PvRrdnAkGMmxcDth6nshudv94nalibkPOaI7KIOk,447
+synapse_sdk/utils/file/video/__init__.py,sha256=mlmTtmx22-XZmrf5acPTOo2Ra2MMtVxUkxkDdQht4UE,614
+synapse_sdk/utils/file/video/transcode.py,sha256=KKn2Mi9rP2ew33q4P-cn9O5JSVQODR5rg1FDPU6fjxo,10375
 synapse_sdk/utils/pydantic/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 synapse_sdk/utils/pydantic/config.py,sha256=1vYOcUI35GslfD1rrqhFkNXXJOXt4IDqOPSx9VWGfNE,123
 synapse_sdk/utils/pydantic/errors.py,sha256=0v0T12eQBr1KrFiEOBu6KMaPK4aPEGEC6etPJGoR5b4,1061
@@ -287,9 +296,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-1.0.0b23.dist-info/licenses/LICENSE,sha256=bKzmC5YAg4V1Fhl8OO_tqY8j62hgdncAkN7VrdjmrGk,1101
-synapse_sdk-1.0.0b23.dist-info/METADATA,sha256=9Ei8_lzCHlc2TOUN7xLUzRf41GqlAbLc8V83Icw0PVw,3745
-synapse_sdk-1.0.0b23.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-synapse_sdk-1.0.0b23.dist-info/entry_points.txt,sha256=VNptJoGoNJI8yLXfBmhgUefMsmGI0m3-0YoMvrOgbxo,48
-synapse_sdk-1.0.0b23.dist-info/top_level.txt,sha256=ytgJMRK1slVOKUpgcw3LEyHHP7S34J6n_gJzdkcSsw8,12
-synapse_sdk-1.0.0b23.dist-info/RECORD,,
+synapse_sdk-2025.9.1.dist-info/licenses/LICENSE,sha256=bKzmC5YAg4V1Fhl8OO_tqY8j62hgdncAkN7VrdjmrGk,1101
+synapse_sdk-2025.9.1.dist-info/METADATA,sha256=ZIeAof3DTKvJG72NhD8WlTJXhHpkXAZexGaH0i5lFrM,3781
+synapse_sdk-2025.9.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+synapse_sdk-2025.9.1.dist-info/entry_points.txt,sha256=VNptJoGoNJI8yLXfBmhgUefMsmGI0m3-0YoMvrOgbxo,48
+synapse_sdk-2025.9.1.dist-info/top_level.txt,sha256=ytgJMRK1slVOKUpgcw3LEyHHP7S34J6n_gJzdkcSsw8,12
+synapse_sdk-2025.9.1.dist-info/RECORD,,

synapse_sdk/devtools/docs/docs/api/utils/file.md

@@ -1,195 +0,0 @@
----
-id: file
-title: File Utilities
-sidebar_position: 1
----
-
-# File Utilities
-
-File operations and handling utilities.
-
-## File Operations
-
-### Archive Functions
-
-Functions for creating and extracting plugin archives.
-
-### Download Functions
-
-Utilities for downloading files from URLs.
-
-```python
-from synapse_sdk.utils.file import download_file
-
-local_path = download_file(url, destination)
-```
-
-### Upload Functions
-
-File upload utilities with chunked upload support.
-
-## Chunked File Operations
-
-### read_file_in_chunks
-
-Read files in chunks for efficient memory usage, particularly useful for large files or when processing files in chunks for uploading or hashing.
-
-```python
-from synapse_sdk.utils.file import read_file_in_chunks
-
-# Read a file in default 50MB chunks
-for chunk in read_file_in_chunks('/path/to/large_file.bin'):
-    process_chunk(chunk)
-
-# Read with custom chunk size (10MB)
-for chunk in read_file_in_chunks('/path/to/file.bin', chunk_size=1024*1024*10):
-    upload_chunk(chunk)
-```
-
-**Parameters:**
-
-- `file_path` (str | Path): Path to the file to read
-- `chunk_size` (int, optional): Size of each chunk in bytes. Defaults to 50MB (52,428,800 bytes)
-
-**Returns:**
-
-- Generator yielding file content chunks as bytes
-
-**Raises:**
-
-- `FileNotFoundError`: If the file doesn't exist
-- `PermissionError`: If the file can't be read due to permissions
-- `OSError`: If there's an OS-level error reading the file
-
-### Use Cases
-
-**Large File Processing**: Efficiently process files that are too large to fit in memory:
-
-```python
-import hashlib
-
-def calculate_hash_for_large_file(file_path):
-    hash_md5 = hashlib.md5()
-    for chunk in read_file_in_chunks(file_path):
-        hash_md5.update(chunk)
-    return hash_md5.hexdigest()
-```
-
-**Chunked Upload Integration**: The function integrates seamlessly with the `CoreClientMixin.create_chunked_upload` method:
-
-```python
-from synapse_sdk.clients.backend.core import CoreClientMixin
-
-client = CoreClientMixin(base_url='https://api.example.com')
-result = client.create_chunked_upload('/path/to/large_file.zip')
-```
-
-**Best Practices:**
-
-- Use default chunk size (50MB) for optimal upload performance
-- Adjust chunk size based on available memory and network conditions
-- For very large files (>1GB), consider using smaller chunks for better progress tracking
-- Always handle exceptions when working with file operations
-
-## Checksum Functions
-
-### get_checksum_from_file
-
-Calculate checksum for file-like objects without requiring Django dependencies. This function works with any file-like object that has a `read()` method, making it compatible with Django's File objects, BytesIO, StringIO, and regular file objects.
-
-```python
-import hashlib
-from io import BytesIO
-from synapse_sdk.utils.file import get_checksum_from_file
-
-# Basic usage with BytesIO (defaults to SHA1)
-data = BytesIO(b'Hello, world!')
-checksum = get_checksum_from_file(data)
-print(checksum)  # SHA1 hash as hexadecimal string
-
-# Using different hash algorithms
-checksum_md5 = get_checksum_from_file(data, digest_mod=hashlib.md5)
-checksum_sha256 = get_checksum_from_file(data, digest_mod=hashlib.sha256)
-
-# With real file objects
-with open('/path/to/file.txt', 'rb') as f:
-    checksum = get_checksum_from_file(f)
-
-# With StringIO (text files)
-from io import StringIO
-text_data = StringIO('Hello, world!')
-checksum = get_checksum_from_file(text_data)  # Automatically UTF-8 encoded
-```
-
-**Parameters:**
-
-- `file` (IO[Any]): File-like object with read() method that supports reading in chunks
-- `digest_mod` (Callable[[], Any], optional): Hash algorithm from hashlib. Defaults to `hashlib.sha1`
-
-**Returns:**
-
-- `str`: Hexadecimal digest of the file contents
-
-**Key Features:**
-
-- **Memory Efficient**: Reads files in 4KB chunks to handle large files
-- **Automatic File Pointer Reset**: Resets to beginning if the file object supports seeking
-- **Text/Binary Agnostic**: Handles both text (StringIO) and binary (BytesIO) file objects
-- **No Django Dependency**: Works without Django while being compatible with Django File objects
-- **Flexible Hash Algorithms**: Supports any hashlib algorithm (SHA1, SHA256, MD5, etc.)
-
-**Use Cases:**
-
-**Django File Object Compatibility**: Works with Django's File objects without requiring Django:
-
-```python
-# Simulating Django File-like behavior
-class FileWrapper:
-    def __init__(self, data):
-        self._data = data
-        self._pos = 0
-
-    def read(self, size=None):
-        if size is None:
-            result = self._data[self._pos:]
-            self._pos = len(self._data)
-        else:
-            result = self._data[self._pos:self._pos + size]
-            self._pos += len(result)
-        return result
-
-file_obj = FileWrapper(b'File content')
-checksum = get_checksum_from_file(file_obj)
-```
-
-**Large File Processing**: Efficiently calculate checksums for large files:
-
-```python
-# Large file processing with memory efficiency
-with open('/path/to/large_file.bin', 'rb') as large_file:
-    checksum = get_checksum_from_file(large_file, digest_mod=hashlib.sha256)
-```
-
-**Multiple Hash Algorithms**: Calculate different checksums for the same file:
-
-```python
-algorithms = [
-    ('MD5', hashlib.md5),
-    ('SHA1', hashlib.sha1),
-    ('SHA256', hashlib.sha256),
-]
-
-with open('/path/to/file.bin', 'rb') as f:
-    checksums = {}
-    for name, algo in algorithms:
-        f.seek(0)  # Reset file pointer
-        checksums[name] = get_checksum_from_file(f, digest_mod=algo)
-```
-
-## Path Utilities
-
-Functions for path manipulation and validation.
-
-## Temporary Files
-
-Utilities for managing temporary files and cleanup.