Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
feat: add file upload/download utilities (#1669)
Viraj8a4b5bc28a4f
diff --git a/python/composio/core/models/_files.py b/python/composio/core/models/_files.pynew file mode 100644index 000000000..7d931c707--- /dev/null+++ b/python/composio/core/models/_files.py@@ -0,0 +1,329 @@+from __future__ import annotations++import hashlib+import json+import os+import typing as t+from pathlib import Path++import requests+import typing_extensions as te+from composio_client import BaseModel as _ComposioBaseModel+from pydantic import BaseModel, ConfigDict, Field++from composio.client import HttpClient+from composio.client.types import Tool+from composio.exceptions import (+ ErrorDownloadingFile,+ ErrorUploadingFile,+ SDKFileNotFoundError,+)+from composio.utils import mimetypes+from composio.utils.logging import WithLogger++if t.TYPE_CHECKING:+ from .tools import ToolExecutionResponse++_DEFAULT_CHUNK_SIZE = 1024 * 1024+_FILE_UPLOAD = "/api/v3/files/upload/request"++LOCAL_CACHE_DIRECTORY_NAME = ".composio"+"""+Local cache directory name for composio CLI+"""++ENV_LOCAL_CACHE_DIRECTORY = "COMPOSIO_CACHE_DIR"+"""+Environment to set the composio caching directory.+"""++LOCAL_CACHE_DIRECTORY = Path(+ os.environ.get(+ ENV_LOCAL_CACHE_DIRECTORY,+ Path.home() / LOCAL_CACHE_DIRECTORY_NAME, # Fallback to user directory+ )+)+"""+Path to local caching directory.+"""++try:+ LOCAL_CACHE_DIRECTORY.mkdir(parents=True, exist_ok=True)+ if not os.access(LOCAL_CACHE_DIRECTORY, os.W_OK):+ raise OSError+except OSError as e:+ raise RuntimeError(+ f"Cache directory {LOCAL_CACHE_DIRECTORY} is not writable please "+ f"provide a path that is writable using {ENV_LOCAL_CACHE_DIRECTORY} "+ "environment variable."+ ) from e+++LOCAL_OUTPUT_FILE_DIRECTORY = LOCAL_CACHE_DIRECTORY / "outputs"+"""+Local output file directory name for composio tools+"""+++def get_md5(file: Path):+ obj = hashlib.md5()+ with file.open("rb") as fp:+ while True:+ line = fp.read(_DEFAULT_CHUNK_SIZE)+ if not line:+ break+ obj.update(line)+ return obj.hexdigest()+++def upload(url: str, file: Path) -> bool:+ with file.open("rb") as data:+ return requests.put(url=url, data=data).status_code in (200, 403)+++class _FileUploadResponse(_ComposioBaseModel):+ id: str+ key: str+ type: str+ new_presigned_url: str+++class FileUploadable(BaseModel):+ model_config = ConfigDict(json_schema_extra={"file_uploadable": True})++ name: str+ mimetype: str+ s3key: str++ @classmethod+ def from_path(+ cls,+ client: HttpClient,+ file: t.Union[str, Path],+ tool: str,+ toolkit: str,+ ) -> te.Self:+ file = Path(file)+ if not file.exists():+ raise SDKFileNotFoundError(+ f"File not found: {file}. Please provide a valid file path."+ )++ if not file.is_file():+ raise SDKFileNotFoundError(+ f"Not a file: {file}. Please provide a valid file path."+ )++ if not os.access(file, os.R_OK):+ raise SDKFileNotFoundError(+ f"File not readable: {file}. Please check the file permissions."+ )++ mimetype = mimetypes.guess(file=file)+ s3meta = client.post(+ path=_FILE_UPLOAD,+ body={+ "md5": get_md5(file=file),+ "filename": file.name,+ "mimetype": mimetype,+ "tool_slug": tool,+ "toolkit_slug": toolkit,+ },+ cast_to=_FileUploadResponse,+ )+ if not upload(url=s3meta.new_presigned_url, file=file):+ raise ErrorUploadingFile(f"Error uploading file: {file}")+ return cls(name=file.name, mimetype=mimetype, s3key=s3meta.key)+++class FileDownloadable(BaseModel):+ model_config = ConfigDict(json_schema_extra={"file_downloadable": True})++ name: str = Field(..., description="Name of the file")+ mimetype: str = Field(..., description="Mime type of the file.")+ s3url: str = Field(..., description="URL of the file.")++ def download(self, outdir: Path, chunk_size: int = _DEFAULT_CHUNK_SIZE) -> Path:+ outfile = outdir / self.name+ outdir.mkdir(exist_ok=True, parents=True)+ response = requests.get(url=self.s3url, stream=True)+ if response.status_code != 200:+ raise ErrorDownloadingFile(f"Error downloading file: {self.s3url}")++ with outfile.open("wb") as fd:+ for chunk in response.iter_content(chunk_size=chunk_size):+ fd.write(chunk)+ return outfile+++class FileHelper(WithLogger):+ def __init__(self, client: HttpClient):+ super().__init__()+ self._client = client++ def _file_uploadable(self, schema: t.Dict):+ if "allOf" in schema:+ return any(+ (+ _schema.get("file_uploadable", False)+ if isinstance(_schema, dict)+ else False+ )+ for _schema in schema["allOf"]+ )+ return schema.get("file_uploadable", False)++ def _process_file_uploadable(self, schema: t.Dict):+ return {+ "type": "string",+ "format": "path",+ "description": schema.get("description", "Path to file."),+ "title": schema.get("title"),+ }++ def process_schema_recursively(self, schema: t.Dict) -> t.Dict:+ required = schema.get("required") or []+ for _param, _schema in schema["properties"].items():+ if self._file_uploadable(schema=_schema):+ schema["properties"][_param] = self._process_file_uploadable(+ schema=_schema+ )++ if _schema.get("type") in ["string", "integer", "number", "boolean"]:+ ext = f"Please provide a value of type {_schema['type']}."+ description = _schema.get("description", "").rstrip(".")+ _schema["description"] = f"{description}. {ext}" if description else ext++ if _param in required:+ description = _schema.get("description")+ _schema["description"] = (+ (f"{description.rstrip('.')}. This parameter is required.")+ if description+ else "This parameter is required."+ )+ return schema++ def _substitute_file_uploads_recursively(+ self,+ tool: Tool,+ schema: t.Dict,+ request: t.Dict,+ ) -> t.Dict:+ if "properties" not in schema:+ return request++ params = schema["properties"]+ for _param in list(request.keys()):+ if _param not in params:+ continue++ if self._file_uploadable(schema=params[_param]):+ # skip if the file is not provided+ if request[_param] is None or request[_param] == "":+ del request[_param]+ continue++ request[_param] = FileUploadable.from_path(+ client=self._client,+ file=request[_param],+ tool=tool.slug,+ toolkit=tool.toolkit.slug,+ ).model_dump()+ continue++ if isinstance(request[_param], dict) and params[_param]["type"] == "object":+ request[_param] = self._substitute_file_uploads_recursively(+ schema=params[_param],+ request=request[_param],+ tool=tool,+ )+ continue++ return request++ def substitute_file_uploads(self, tool: Tool, request: t.Dict) -> t.Dict:+ return self._substitute_file_uploads_recursively(+ tool=tool,+ schema=tool.input_parameters,+ request=request,+ )++ def _is_file_downloadable(self, schema: t.Dict) -> bool:+ if "allOf" in schema:+ return any(+ (+ _schema.get("file_downloadable", False)+ if isinstance(_schema, dict)+ else False+ )+ for _schema in schema["allOf"]+ )+ return schema.get("file_downloadable", False)++ def _find_file_downloadable_from_any_of(+ self, schemas: list[dict]+ ) -> t.Optional[t.Dict]:+ for schema in schemas:+ if "type" not in schema or schema["type"] != "object":+ continue++ if self._is_file_downloadable(schema=schema):+ return schema++ # Hack to avoid recursive check, maybe use recursion+ if '"file_downloadable":true' in json.dumps(schema):+ return schema++ return None++ def _substitute_file_downloads_recursively(+ self,+ tool: Tool,+ schema: t.Dict,+ request: t.Dict,+ ) -> t.Dict:+ if "properties" not in schema:+ return request++ params = schema["properties"]+ for _param in request:+ if _param not in params:+ continue++ if self._is_file_downloadable(schema=params[_param]):+ request[_param] = str(+ FileDownloadable(**request[_param]).download(+ LOCAL_OUTPUT_FILE_DIRECTORY / tool.toolkit.slug / tool.slug+ )+ )+ continue++ if "anyOf" in params[_param]:+ obj = self._find_file_downloadable_from_any_of(params[_param]["anyOf"])+ if obj is None:+ continue+ params[_param] = obj++ if isinstance(request[_param], dict) and params[_param]["type"] == "object":+ request[_param] = self._substitute_file_downloads_recursively(+ schema=params[_param],+ request=request[_param],+ tool=tool,+ )+ continue++ return request++ def substitute_file_downloads(+ self,+ tool: Tool,+ response: ToolExecutionResponse,+ ) -> ToolExecutionResponse:+ return t.cast(+ "ToolExecutionResponse",+ self._substitute_file_downloads_recursively(+ tool=tool,+ schema=tool.output_parameters,+ request=t.cast(dict, response),+ ),+ )diff --git a/python/composio/core/models/tools.py b/python/composio/core/models/tools.pyindex e63cbc630..540e277fb 100644--- a/python/composio/core/models/tools.py+++ b/python/composio/core/models/tools.py@@ -12,6 +12,7 @@ from composio.client.types import (tool_proxy_params,tool_proxy_response,)+from composio.core.models._files import FileHelperfrom composio.core.models.base import Resourcefrom composio.core.models.custom_tools import CustomToolsfrom composio.core.provider import (@@ -60,6 +61,7 @@ class Tools(Resource, t.Generic[TProvider]):self._client = clientself._custom_tools = CustomTools(client)self._tool_schemas: t.Dict[str, Tool] = {}+ self._file_helper = FileHelper(client=self._client)self.custom_tool = self._custom_tools.registerself.provider = provider@@ -145,6 +147,11 @@ class Tools(Resource, t.Generic[TProvider]):]self._tool_schemas.update({tool.slug: tool for tool in tools_list})+ for tool in tools_list:+ tool.input_parameters = self._file_helper.process_schema_recursively(+ schema=tool.input_parameters,+ )+if issubclass(type(self.provider), NonAgenticProvider):t.cast(NonAgenticProvider, self.provider).set_execute_tool_fn(t.cast(@@ -356,6 +363,10 @@ class Tools(Resource, t.Generic[TProvider]):user_id = processed_params["user_id"]arguments = processed_params["arguments"]+ arguments = self._file_helper.substitute_file_uploads(+ tool=tool,+ request=arguments,+ )response = (self._execute_custom_tool(slug=slug, arguments=arguments)if self._custom_tools.get(slug) is not None@@ -369,7 +380,10 @@ class Tools(Resource, t.Generic[TProvider]):version=version,))-+ response = self._file_helper.substitute_file_downloads(+ tool=tool,+ response=response,+ )if modifiers is not None:response = apply_modifier_by_type(modifiers=modifiers,diff --git a/python/composio/utils/mimetypes.py b/python/composio/utils/mimetypes.pynew file mode 100644index 000000000..154cc9960--- /dev/null+++ b/python/composio/utils/mimetypes.py@@ -0,0 +1,510 @@+import typing as t+from pathlib import Path++_default = "application/octet-stream"+_types = {+ ".3dm": "x-world/x-3dmf",+ ".3dmf": "x-world/x-3dmf",+ ".7z": "application/x-7z-compressed",+ ".a": "application/octet-stream",+ ".aab": "application/x-authorware-bin",+ ".aam": "application/x-authorware-map",+ ".aas": "application/x-authorware-seg",+ ".abc": "text/vnd.abc",+ ".acgi": "text/html",+ ".afl": "video/animaflex",+ ".ai": "application/postscript",+ ".aif": "audio/x-aiff",+ ".aifc": "audio/x-aiff",+ ".aiff": "audio/x-aiff",+ ".aim": "application/x-aim",+ ".aip": "text/x-audiosoft-intra",+ ".ani": "application/x-navi-animation",+ ".aos": "application/x-nokia-9000-communicator-add-on-software",+ ".aps": "application/mime",+ ".arc": "application/octet-stream",+ ".arj": "application/octet-stream",+ ".art": "image/x-jg",+ ".asf": "video/x-ms-asf",+ ".asm": "text/x-asm",+ ".asp": "text/asp",+ ".asx": "video/x-ms-asf-plugin",+ ".au": "audio/basic",+ ".avi": "video/x-msvideo",+ ".avs": "video/avs-video",+ ".bcpio": "application/x-bcpio",+ ".bin": "application/octet-stream",+ ".bm": "image/bmp",+ ".bmp": "image/x-ms-bmp",+ ".boo": "application/book",+ ".book": "application/book",+ ".boz": "application/x-bzip2",+ ".bsh": "application/x-bsh",+ ".bz": "application/x-bzip",+ ".bz2": "application/x-bzip2",+ ".c": "text/plain",+ ".c+": "text/plain",+ ".cat": "application/vnd.ms-pki.seccat",+ ".cc": "text/x-c",+ ".ccad": "application/clariscad",+ ".cco": "application/x-cocoa",+ ".cdf": "application/x-netcdf",+ ".cer": "application/x-x509-ca-cert",+ ".cha": "application/x-chat",+ ".chat": "application/x-chat",+ ".class": "application/x-java-class",+ ".com": "text/plain",+ ".conf": "text/plain",+ ".cpio": "application/x-cpio",+ ".cpp": "text/x-c",+ ".cpt": "application/x-cpt",+ ".crl": "application/pkix-crl",+ ".crt": "application/x-x509-user-cert",+ ".csh": "application/x-csh",+ ".css": "text/css",+ ".csv": "text/csv",+ ".cxx": "text/plain",+ ".dcr": "application/x-director",+ ".deepv": "application/x-deepv",+ ".def": "text/plain",+ ".der": "application/x-x509-ca-cert",+ ".dif": "video/x-dv",+ ".dir": "application/x-director",+ ".dl": "video/x-dl",+ ".doc": "application/msword",+ ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",+ ".dot": "application/msword",+ ".dp": "application/commonground",+ ".drw": "application/drafting",+ ".dump": "application/octet-stream",+ ".dv": "video/x-dv",+ ".dvi": "application/x-dvi",+ ".dwf": "model/vnd.dwf",+ ".dwg": "image/x-dwg",+ ".dxf": "image/x-dwg",+ ".dxr": "application/x-director",+ ".el": "text/x-script.elisp",+ ".elc": "application/x-elc",+ ".env": "application/x-envoy",+ ".eot": "application/vnd.ms-fontobject",+ ".eps": "application/postscript",+ ".es": "application/x-esrehber",+ ".etx": "text/x-setext",+ ".evy": "application/x-envoy",+ ".exe": "application/octet-stream",+ ".f": "text/x-fortran",+ ".f77": "text/x-fortran",+ ".f90": "text/x-fortran",+ ".fdf": "application/vnd.fdf",+ ".fif": "image/fif",+ ".flac": "audio/flac",+ ".fli": "video/x-fli",+ ".flo": "image/florian",+ ".flx": "text/vnd.fmi.flexstor",+ ".fmf": "video/x-atomic3d-feature",+ ".for": "text/x-fortran",+ ".fpx": "image/vnd.net-fpx",+ ".frl": "application/freeloader",+ ".funk": "audio/make",+ ".g": "text/plain",+ ".g3": "image/g3fax",+ ".gif": "image/gif",+ ".gl": "video/x-gl",+ ".gsd": "audio/x-gsm",+ ".gsm": "audio/x-gsm",+ ".gsp": "application/x-gsp",+ ".gss": "application/x-gss",+ ".gtar": "application/x-gtar",+ ".gz": "application/x-gzip",+ ".gzip": "multipart/x-gzip",+ ".h": "text/plain",+ ".hdf": "application/x-hdf",+ ".help": "application/x-helpfile",+ ".hgl": "application/vnd.hp-hpgl",+ ".hh": "text/x-h",+ ".hlb": "text/x-script",+ ".hlp": "application/x-winhelp",+ ".hpg": "application/vnd.hp-hpgl",+ ".hpgl": "application/vnd.hp-hpgl",+ ".hqx": "application/x-mac-binhex40",+ ".hta": "application/hta",+ ".htc": "text/x-component",+ ".htm": "text/html",+ ".html": "text/html",+ ".htmls": "text/html",+ ".htt": "text/webviewhtml",+ ".htx": "text/html",+ ".ice": "x-conference/x-cooltalk",+ ".ico": "image/vnd.microsoft.icon",+ ".ics": "text/calendar",+ ".idc": "text/plain",+ ".ief": "image/ief",+ ".iefs": "image/ief",+ ".iges": "model/iges",+ ".igs": "model/iges",+ ".ima": "application/x-ima",+ ".imap": "application/x-httpd-imap",+ ".inf": "application/inf",+ ".ins": "application/x-internett-signup",+ ".ip": "application/x-ip2",+ ".isu": "video/x-isvideo",+ ".it": "audio/it",+ ".iv": "application/x-inventor",+ ".ivr": "i-world/i-vrml",+ ".ivy": "application/x-livescreen",+ ".jam": "audio/x-jam",+ ".jav": "text/x-java-source",+ ".java": "text/x-java-source",+ ".jcm": "application/x-java-commerce",+ ".jfif": "image/pjpeg",+ ".jfif-bnl": "image/jpeg",+ ".jpe": "image/jpeg",+ ".jpeg": "image/jpeg",+ ".jpg": "image/jpg",+ ".jps": "image/x-jps",+ ".js": "application/javascript",+ ".json": "application/json",+ ".jut": "image/jutvision",+ ".kar": "music/x-karaoke",+ ".ksh": "text/plain",+ ".la": "audio/x-nspaudio",+ ".lam": "audio/x-liveaudio",+ ".latex": "application/x-latex",+ ".lha": "application/x-lha",+ ".lhx": "application/octet-stream",+ ".list": "text/plain",+ ".lma": "audio/x-nspaudio",+ ".log": "text/plain",+ ".lsp": "text/x-script.lisp",+ ".lst": "text/plain",+ ".lsx": "text/x-la-asf",+ ".ltx": "application/x-latex",+ ".lzh": "application/x-lzh",+ ".lzx": "application/x-lzx",+ ".m": "text/x-m",+ ".m1v": "video/mpeg",+ ".m2a": "audio/mpeg",+ ".m2v": "video/mpeg",+ ".m3u": "application/vnd.apple.mpegurl",+ ".man": "application/x-troff-man",+ ".map": "application/x-navimap",+ ".mar": "text/plain",+ ".mbd": "application/mbedlet",+ ".mc": "application/x-magic-cap-package-1.0",+ ".mcd": "application/x-mathcad",+ ".mcf": "text/mcf",+ ".mcp": "application/netmc",+ ".me": "application/x-troff-me",+ ".mht": "message/rfc822",+ ".mhtml": "message/rfc822",+ ".mid": "audio/midi",+ ".midi": "audio/midi",+ ".mif": "application/x-mif",+ ".mime": "www/mime",+ ".mjf": "audio/x-vnd.audioexplosion.mjuicemediafile",+ ".mjpg": "video/x-motion-jpeg",+ ".mka": "audio/x-matroska",+ ".mkv": "video/x-matroska",+ ".mm": "application/x-meme",+ ".mme": "application/base64",+ ".mod": "audio/x-mod",+ ".moov": "video/quicktime",+ ".mov": "video/quicktime",+ ".movie": "video/x-sgi-movie",+ ".mp2": "audio/mpeg",+ ".mp3": "audio/mpeg",+ ".mp4": "video/mp4",+ ".mpa": "video/mpeg",+ ".mpc": "application/x-project",+ ".mpe": "video/mpeg",+ ".mpeg": "video/mpeg",+ ".mpg": "video/mpeg",+ ".mpga": "audio/mpeg",+ ".mpp": "application/vnd.ms-project",+ ".mpt": "application/x-project",+ ".mpv": "application/x-project",+ ".mpx": "application/x-project",+ ".mrc": "application/marc",+ ".ms": "application/x-troff-ms",+ ".mv": "video/x-sgi-movie",+ ".my": "audio/make",+ ".mzz": "application/x-vnd.audioexplosion.mzz",+ ".nap": "image/naplps",+ ".naplps": "image/naplps",+ ".nc": "application/x-netcdf",+ ".ncm": "application/vnd.nokia.configuration-message",+ ".nif": "image/x-niff",+ ".niff": "image/x-niff",+ ".nix": "application/x-mix-transfer",+ ".nsc": "application/x-conference",+ ".nvd": "application/x-navidoc",+ ".o": "application/octet-stream",+ ".oda": "application/oda",+ ".ogg": "video/ogg",+ ".omc": "application/x-omc",+ ".omcd": "application/x-omcdatamaker",+ ".omcr": "application/x-omcregerator",+ ".otf": "font/otf",+ ".p": "text/x-pascal",+ ".p10": "application/x-pkcs10",+ ".p12": "application/x-pkcs12",+ ".p7a": "application/x-pkcs7-signature",+ ".p7c": "application/pkcs7-mime",+ ".p7m": "application/x-pkcs7-mime",+ ".p7r": "application/x-pkcs7-certreqresp",+ ".p7s": "application/pkcs7-signature",+ ".part": "application/pro_eng",+ ".pas": "text/pascal",+ ".pbm": "image/x-portable-bitmap",+ ".pcl": "application/x-pcl",+ ".pct": "image/pict",+ ".pcx": "image/x-pcx",+ ".pdb": "chemical/x-pdb",+ ".pdf": "application/pdf",+ ".pfunk": "audio/make.my.funk",+ ".pgm": "image/x-portable-graymap",+ ".pic": "image/pict",+ ".pict": "image/pict",+ ".pkg": "application/x-newton-compatible-pkg",+ ".pko": "application/vnd.ms-pki.pko",+ ".pl": "text/plain",+ ".plx": "application/x-pixclscript",+ ".pm": "text/x-script.perl-module",+ ".pm4": "application/x-pagemaker",+ ".pm5": "application/x-pagemaker",+ ".png": "image/png",+ ".pnm": "image/x-portable-anymap",+ ".pot": "application/vnd.ms-powerpoint",+ ".pov": "model/x-pov",+ ".ppa": "application/vnd.ms-powerpoint",+ ".ppm": "image/x-portable-pixmap",+ ".pps": "application/vnd.ms-powerpoint",+ ".ppt": "application/vnd.ms-powerpoint",+ ".pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation",+ ".ppz": "application/mspowerpoint",+ ".pre": "application/x-freelance",+ ".prt": "application/pro_eng",+ ".ps": "application/postscript",+ ".psd": "application/octet-stream",+ ".pvu": "paleovu/x-pv",+ ".pwz": "application/vnd.ms-powerpoint",+ ".py": "text/x-python",+ ".pyc": "application/x-python-code",+ ".qcp": "audio/vnd.qcelp",+ ".qd3": "x-world/x-3dmf",+ ".qd3d": "x-world/x-3dmf",+ ".qif": "image/x-quicktime",+ ".qt": "video/quicktime",+ ".qtc": "video/x-qtc",+ ".qti": "image/x-quicktime",+ ".qtif": "image/x-quicktime",+ ".ra": "audio/x-pn-realaudio",+ ".ram": "application/x-pn-realaudio",+ ".ras": "image/x-cmu-raster",+ ".rast": "image/cmu-raster",+ ".rar": "application/vnd.rar",+ ".rexx": "text/x-script.rexx",+ ".rf": "image/vnd.rn-realflash",+ ".rgb": "image/x-rgb",+ ".rm": "audio/x-pn-realaudio",+ ".rmi": "audio/mid",+ ".rmm": "audio/x-pn-realaudio",+ ".rmp": "audio/x-pn-realaudio-plugin",+ ".rng": "application/vnd.nokia.ringing-tone",+ ".rnx": "application/vnd.rn-realplayer",+ ".roff": "application/x-troff",+ ".rp": "image/vnd.rn-realpix",+ ".rpm": "audio/x-pn-realaudio-plugin",+ ".rt": "text/vnd.rn-realtext",+ ".rtf": "application/rtf",+ ".rtx": "text/richtext",+ ".rv": "video/vnd.rn-realvideo",+ ".s": "text/x-asm",+ ".s3m": "audio/s3m",+ ".saveme": "application/octet-stream",+ ".sbk": "application/x-tbook",+ ".scm": "video/x-scm",+ ".sdml": "text/plain",+ ".sdp": "application/x-sdp",+ ".sdr": "application/sounder",+ ".sea": "application/x-sea",+ ".set": "application/set",+ ".sgm": "text/x-sgml",+ ".sgml": "text/x-sgml",+ ".sh": "application/x-sh",+ ".shar": "application/x-shar",+ ".shtml": "text/x-server-parsed-html",+ ".sid": "audio/x-psid",+ ".sit": "application/x-stuffit",+ ".skd": "application/x-koan",+ ".skm": "application/x-koan",+ ".skp": "application/x-koan",+ ".skt": "application/x-koan",+ ".sl": "application/x-seelogo",+ ".smi": "application/smil",+ ".smil": "application/smil",+ ".snd": "audio/basic",+ ".sol": "application/solids",+ ".spc": "text/x-speech",+ ".spl": "application/futuresplash",+ ".spr": "application/x-sprite",+ ".sprite": "application/x-sprite",+ ".src": "application/x-wais-source",+ ".ssi": "text/x-server-parsed-html",+ ".ssm": "application/streamingmedia",+ ".sst": "application/vnd.ms-pki.certstore",+ ".step": "application/step",+ ".stl": "application/x-navistyle",+ ".stp": "application/step",+ ".sv4cpio": "application/x-sv4cpio",+ ".sv4crc": "application/x-sv4crc",+ ".svf": "image/x-dwg",+ ".svg": "image/svg+xml",+ ".svr": "x-world/x-svr",+ ".swf": "application/x-shockwave-flash",+ ".t": "application/x-troff",+ ".talk": "text/x-speech",+ ".tar": "application/x-tar",+ ".tbk": "application/x-tbook",+ ".tcl": "application/x-tcl",+ ".tcsh": "text/x-script.tcsh",+ ".tex": "application/x-tex",+ ".texi": "application/x-texinfo",+ ".texinfo": "application/x-texinfo",+ ".text": "text/plain",+ ".tgz": "application/x-compressed",+ ".tif": "image/tiff",+ ".tiff": "image/tiff",+ ".tr": "application/x-troff",+ ".ts": "video/mp2t",+ ".tsi": "audio/tsp-audio",+ ".tsp": "audio/tsplayer",+ ".tsv": "text/tab-separated-values",+ ".turbot": "image/florian",+ ".txt": "text/plain",+ ".uil": "text/x-uil",+ ".uni": "text/uri-list",+ ".unis": "text/uri-list",+ ".unv": "application/i-deas",+ ".uri": "text/uri-list",+ ".uris": "text/uri-list",+ ".ustar": "application/x-ustar",+ ".uu": "text/x-uuencode",+ ".uue": "text/x-uuencode",+ ".vcd": "application/x-cdlink",+ ".vcs": "text/x-vcalendar",+ ".vda": "application/vda",+ ".vdo": "video/vdo",+ ".vew": "application/groupwise",+ ".viv": "video/vnd.vivo",+ ".vivo": "video/vnd.vivo",+ ".vmd": "application/vocaltec-media-desc",+ ".vmf": "application/vocaltec-media-file",+ ".voc": "audio/x-voc",+ ".vos": "video/vosaic",+ ".vox": "audio/voxware",+ ".vqe": "audio/x-twinvq-plugin",+ ".vqf": "audio/x-twinvq",+ ".vql": "audio/x-twinvq-plugin",+ ".vrml": "x-world/x-vrml",+ ".vrt": "x-world/x-vrt",+ ".vsd": "application/x-visio",+ ".vst": "application/x-visio",+ ".vsw": "application/x-visio",+ ".w60": "application/wordperfect6.0",+ ".w61": "application/wordperfect6.1",+ ".w6w": "application/msword",+ ".wav": "audio/x-wav",+ ".wb1": "application/x-qpro",+ ".wbmp": "image/vnd.wap.wbmp",+ ".web": "application/vnd.xara",+ ".webm": "video/webm",+ ".webp": "image/webp",+ ".wiz": "application/msword",+ ".wk1": "application/x-123",+ ".wmf": "windows/metafile",+ ".wml": "text/vnd.wap.wml",+ ".wmlc": "application/vnd.wap.wmlc",+ ".wmls": "text/vnd.wap.wmlscript",+ ".wmlsc": "application/vnd.wap.wmlscriptc",+ ".word": "application/msword",+ ".woff": "font/woff",+ ".woff2": "font/woff2",+ ".wp": "application/wordperfect",+ ".wp5": "application/wordperfect6.0",+ ".wp6": "application/wordperfect",+ ".wpd": "application/x-wpwin",+ ".wq1": "application/x-lotus",+ ".wri": "application/x-wri",+ ".wrl": "x-world/x-vrml",+ ".wrz": "x-world/x-vrml",+ ".wsc": "text/scriplet",+ ".wsrc": "application/x-wais-source",+ ".wtk": "application/x-wintalk",+ ".xbm": "image/x-xbitmap",+ ".xdr": "video/x-amt-demorun",+ ".xgz": "xgl/drawing",+ ".xif": "image/vnd.xiff",+ ".xl": "application/excel",+ ".xla": "application/x-msexcel",+ ".xlb": "application/vnd.ms-excel",+ ".xlc": "application/x-excel",+ ".xld": "application/x-excel",+ ".xlk": "application/x-excel",+ ".xll": "application/x-excel",+ ".xlm": "application/x-excel",+ ".xls": "application/vnd.ms-excel",+ ".xlt": "application/x-excel",+ ".xlv": "application/x-excel",+ ".xlw": "application/x-msexcel",+ ".xm": "audio/xm",+ ".xml": "text/xml",+ ".xmz": "xgl/movie",+ ".xpix": "application/x-vnd.ls-xpix",+ ".xpm": "image/x-xpixmap",+ ".x-ng": "image/png",+ ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",+ ".xsr": "video/x-amt-showrun",+ ".xwd": "image/x-xwindowdump",+ ".xyz": "chemical/x-pdb",+ ".yaml": "application/x-yaml",+ ".yml": "application/x-yaml",+ ".z": "application/x-compressed",+ ".zip": "application/zip",+ ".zoo": "application/octet-stream",+ ".zsh": "text/x-script.zsh",+ ".mjs": "application/javascript",+ ".webmanifest": "application/manifest+json",+ ".dll": "application/octet-stream",+ ".obj": "application/octet-stream",+ ".so": "application/octet-stream",+ ".m3u8": "application/vnd.apple.mpegurl",+ ".wasm": "application/wasm",+ ".h5": "application/x-hdf5",+ ".pfx": "application/x-pkcs12",+ ".pyo": "application/x-python-code",+ ".xsl": "application/xml",+ ".rdf": "application/xml",+ ".wsdl": "application/xml",+ ".xpdl": "application/xml",+ ".3gp": "audio/3gpp",+ ".3gpp": "audio/3gpp",+ ".3g2": "audio/3gpp2",+ ".3gpp2": "audio/3gpp2",+ ".aac": "audio/aac",+ ".adts": "audio/aac",+ ".loas": "audio/aac",+ ".ass": "audio/aac",+ ".opus": "audio/opus",+ ".heic": "image/heic",+ ".heif": "image/heif",+ ".eml": "message/rfc822",+ ".nws": "message/rfc822",+ ".bat": "text/plain",+ ".vcf": "text/x-vcard",+ ".xul": "text/xul",+}+++def guess(file: t.Union[str, Path]) -> str:+ return _types.get(Path(file).suffix, _default)