synapse-sdk 1.0.0b23__py3-none-any.whl → 1.0.0b24__py3-none-any.whl

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synapse-sdk
-Version: 1.0.0b23
+Version: 1.0.0b24
 Summary: synapse sdk
 Author-email: datamaker <developer@datamaker.io>
 License: MIT
@@ -23,6 +23,7 @@ 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: python-nmap; extra == "all"

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

@@ -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=mmK694nU10W7c_Z_2PBY_4qvqiL7ADZTP1Ew2CxWVA4,7581
 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=sVdBRg4g7x0O9bJ0JP1fzzDc74Z9swGl8jDlbpBbCeA,8346
 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-1.0.0b24.dist-info/licenses/LICENSE,sha256=bKzmC5YAg4V1Fhl8OO_tqY8j62hgdncAkN7VrdjmrGk,1101
+synapse_sdk-1.0.0b24.dist-info/METADATA,sha256=tZXjgzMFe1phEDqypqt3HjsxjvYfKS7lm_MfRgcKHNc,3781
+synapse_sdk-1.0.0b24.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+synapse_sdk-1.0.0b24.dist-info/entry_points.txt,sha256=VNptJoGoNJI8yLXfBmhgUefMsmGI0m3-0YoMvrOgbxo,48
+synapse_sdk-1.0.0b24.dist-info/top_level.txt,sha256=ytgJMRK1slVOKUpgcw3LEyHHP7S34J6n_gJzdkcSsw8,12
+synapse_sdk-1.0.0b24.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.

synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/api/utils/file.md

@@ -1,195 +0,0 @@
----
-id: file
-title: 파일 유틸리티
-sidebar_position: 1
----
-
-# 파일 유틸리티
-
-파일 작업 및 처리 유틸리티입니다.
-
-## 파일 작업
-
-### 아카이브 함수
-
-플러그인 아카이브를 생성하고 추출하는 함수입니다.
-
-### 다운로드 함수
-
-URL에서 파일을 다운로드하는 유틸리티입니다.
-
-```python
-from synapse_sdk.utils.file import download_file
-
-local_path = download_file(url, destination)
-```
-
-### 업로드 함수
-
-청크 업로드 지원을 포함한 파일 업로드 유틸리티입니다.
-
-## 청크 파일 작업
-
-### read_file_in_chunks
-
-효율적인 메모리 사용을 위해 파일을 청크 단위로 읽습니다. 대용량 파일이나 업로드 또는 해싱을 위해 파일을 청크 단위로 처리할 때 특히 유용합니다.
-
-```python
-from synapse_sdk.utils.file import read_file_in_chunks
-
-# 기본 50MB 청크로 파일 읽기
-for chunk in read_file_in_chunks('/path/to/large_file.bin'):
-    process_chunk(chunk)
-
-# 사용자 정의 청크 크기로 읽기 (10MB)
-for chunk in read_file_in_chunks('/path/to/file.bin', chunk_size=1024*1024*10):
-    upload_chunk(chunk)
-```
-
-**매개변수:**
-
-- `file_path` (str | Path): 읽을 파일의 경로
-- `chunk_size` (int, 선택사항): 각 청크의 바이트 크기. 기본값은 50MB (52,428,800바이트)
-
-**반환값:**
-
-- 파일 내용 청크를 바이트로 생성하는 제너레이터
-
-**예외:**
-
-- `FileNotFoundError`: 파일이 존재하지 않는 경우
-- `PermissionError`: 권한으로 인해 파일을 읽을 수 없는 경우
-- `OSError`: 파일 읽기 시 OS 수준 오류가 발생한 경우
-
-### 사용 사례
-
-**대용량 파일 처리**: 메모리에 맞지 않는 대용량 파일을 효율적으로 처리합니다:
-
-```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()
-```
-
-**청크 업로드 통합**: 이 함수는 `CoreClientMixin.create_chunked_upload` 메서드와 완벽하게 통합됩니다:
-
-```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')
-```
-
-**모범 사례:**
-
-- 최적의 업로드 성능을 위해 기본 청크 크기(50MB) 사용
-- 사용 가능한 메모리와 네트워크 조건에 따라 청크 크기 조정
-- 매우 큰 파일(>1GB)의 경우, 더 나은 진행 상황 추적을 위해 작은 청크 사용 고려
-- 파일 작업 시 항상 예외 처리
-
-## 체크섬 함수
-
-### get_checksum_from_file
-
-Django 의존성 없이 파일 형태 객체의 체크섬을 계산합니다. 이 함수는 `read()` 메서드가 있는 모든 파일 형태 객체와 함께 작동하며, Django의 File 객체, BytesIO, StringIO, 일반 파일 객체와 호환됩니다.
-
-```python
-import hashlib
-from io import BytesIO
-from synapse_sdk.utils.file import get_checksum_from_file
-
-# BytesIO와 기본 사용법 (기본값은 SHA1)
-data = BytesIO(b'Hello, world!')
-checksum = get_checksum_from_file(data)
-print(checksum)  # 16진수 문자열로 된 SHA1 해시
-
-# 다른 해시 알고리즘 사용
-checksum_md5 = get_checksum_from_file(data, digest_mod=hashlib.md5)
-checksum_sha256 = get_checksum_from_file(data, digest_mod=hashlib.sha256)
-
-# 실제 파일 객체와 함께 사용
-with open('/path/to/file.txt', 'rb') as f:
-    checksum = get_checksum_from_file(f)
-
-# StringIO와 함께 사용 (텍스트 파일)
-from io import StringIO
-text_data = StringIO('Hello, world!')
-checksum = get_checksum_from_file(text_data)  # 자동으로 UTF-8로 인코딩
-```
-
-**매개변수:**
-
-- `file` (IO[Any]): 청크 단위로 읽기를 지원하는 read() 메서드가 있는 파일 형태 객체
-- `digest_mod` (Callable[[], Any], 선택사항): hashlib의 해시 알고리즘. 기본값은 `hashlib.sha1`
-
-**반환값:**
-
-- `str`: 파일 내용의 16진수 다이제스트
-
-**주요 기능:**
-
-- **메모리 효율적**: 대용량 파일을 처리하기 위해 4KB 청크로 파일 읽기
-- **자동 파일 포인터 리셋**: 파일 객체가 시킹을 지원하는 경우 시작 위치로 리셋
-- **텍스트/바이너리 무관**: 텍스트(StringIO)와 바이너리(BytesIO) 파일 객체 모두 처리
-- **Django 의존성 없음**: Django File 객체와 호환되면서도 Django 없이 작동
-- **유연한 해시 알고리즘**: 모든 hashlib 알고리즘 지원 (SHA1, SHA256, MD5 등)
-
-**사용 사례:**
-
-**Django 파일 객체 호환성**: Django를 요구하지 않으면서도 Django의 File 객체와 함께 작동합니다:
-
-```python
-# Django File 형태 동작 시뮬레이션
-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)
-```
-
-**대용량 파일 처리**: 대용량 파일의 체크섬을 효율적으로 계산합니다:
-
-```python
-# 메모리 효율성을 갖춘 대용량 파일 처리
-with open('/path/to/large_file.bin', 'rb') as large_file:
-    checksum = get_checksum_from_file(large_file, digest_mod=hashlib.sha256)
-```
-
-**다중 해시 알고리즘**: 같은 파일에 대해 다른 체크섬을 계산합니다:
-
-```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)  # 파일 포인터 리셋
-        checksums[name] = get_checksum_from_file(f, digest_mod=algo)
-```
-
-## 경로 유틸리티
-
-경로 조작 및 검증을 위한 함수입니다.
-
-## 임시 파일
-
-임시 파일 관리 및 정리를 위한 유틸리티입니다.