chore: import upstream snapshot with attribution

2026-07-13 13:34:58 +08:00
commit a203934033
1368 changed files with 175001 additions and 0 deletions
@@ -0,0 +1,122 @@
+# Copyright (c) ModelScope Contributors. All rights reserved.
+import json
+import os
+import torch.distributed as dist
+from accelerate.utils import gather_object
+from queue import Queue
+from threading import Thread
+from typing import Any, Dict, List, Literal, Union
+
+from .env import is_last_rank, is_master
+from .logger import get_logger
+from .utils import check_json_format
+
+logger = get_logger()
+
+
+def read_from_jsonl(fpath: str, encoding: str = 'utf-8') -> List[Any]:
+    res: List[Any] = []
+    with open(fpath, 'r', encoding=encoding) as f:
+        for line in f:
+            res.append(json.loads(line))
+    return res
+
+
+def write_to_jsonl(fpath: str, obj_list: List[Any], encoding: str = 'utf-8') -> None:
+    res: List[str] = []
+    for obj in obj_list:
+        res.append(json.dumps(obj, ensure_ascii=False))
+    with open(fpath, 'w', encoding=encoding) as f:
+        text = '\n'.join(res)
+        f.write(f'{text}\n')
+
+
+class JsonlWriter:
+
+    def __init__(self,
+                 fpath: str,
+                 *,
+                 encoding: str = 'utf-8',
+                 strict: bool = True,
+                 enable_async: bool = False,
+                 write_on_rank: Literal['master', 'last'] = 'master'):
+        if write_on_rank == 'master':
+            self.is_write_rank = is_master()
+        elif write_on_rank == 'last':
+            self.is_write_rank = is_last_rank()
+        else:
+            raise ValueError(f"Invalid `write_on_rank`: {write_on_rank}, should be 'master' or 'last'")
+        self.fpath = os.path.abspath(os.path.expanduser(fpath)) if self.is_write_rank else None
+        self.encoding = encoding
+        self.strict = strict
+        self.enable_async = enable_async
+        self._queue = Queue()
+        self._thread = None
+
+    def _append_worker(self):
+        while True:
+            item = self._queue.get()
+            self._append(**item)
+
+    def _append(self, obj: Union[Dict, List[Dict]], gather_obj: bool = False):
+        if isinstance(obj, (list, tuple)) and all(isinstance(item, dict) for item in obj):
+            obj_list = obj
+        else:
+            obj_list = [obj]
+        if gather_obj and dist.is_initialized():
+            obj_list = gather_object(obj_list)
+        if not self.is_write_rank:
+            return
+        obj_list = check_json_format(obj_list)
+        for i, _obj in enumerate(obj_list):
+            obj_list[i] = json.dumps(_obj, ensure_ascii=False) + '\n'
+        self._write_buffer(''.join(obj_list))
+
+    def append(self, obj: Union[Dict, List[Dict]], gather_obj: bool = False):
+        if self.enable_async:
+            if self._thread is None:
+                self._thread = Thread(target=self._append_worker, daemon=True)
+                self._thread.start()
+            self._queue.put({'obj': obj, 'gather_obj': gather_obj})
+        else:
+            self._append(obj, gather_obj=gather_obj)
+
+    def _write_buffer(self, text: str):
+        if not text:
+            return
+        assert self.is_write_rank, f'self.is_write_rank: {self.is_write_rank}'
+        try:
+            os.makedirs(os.path.dirname(self.fpath), exist_ok=True)
+            with open(self.fpath, 'a', encoding=self.encoding) as f:
+                f.write(text)
+        except Exception:
+            if self.strict:
+                raise
+            logger.error(f'Cannot write content to jsonl file. text: {text}')
+
+
+def append_to_jsonl(fpath: str,
+                    obj: Union[Dict, List[Dict]],
+                    *,
+                    encoding: str = 'utf-8',
+                    strict: bool = True,
+                    write_on_rank: Literal['master', 'last'] = 'master') -> None:
+    jsonl_writer = JsonlWriter(fpath, encoding=encoding, strict=strict, write_on_rank=write_on_rank)
+    jsonl_writer.append(obj)
+
+
+def get_file_mm_type(file_name: str) -> Literal['image', 'video', 'audio']:
+    video_extensions = {'.mp4', '.mkv', '.mov', '.avi', '.wmv', '.flv', '.webm'}
+    audio_extensions = {'.mp3', '.wav', '.aac', '.flac', '.ogg', '.m4a'}
+    image_extensions = {'.jpg', '.jpeg', '.png', '.gif', '.bmp', '.tiff', '.webp'}
+
+    _, ext = os.path.splitext(file_name)
+
+    if ext.lower() in video_extensions:
+        return 'video'
+    elif ext.lower() in audio_extensions:
+        return 'audio'
+    elif ext.lower() in image_extensions:
+        return 'image'
+    else:
+        raise ValueError(f'file_name: {file_name}, ext: {ext}')