Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

feat: add file upload/download utilities (#1669)

Viraj8a4b5bc28a4f
diff --git a/python/composio/core/models/_files.py b/python/composio/core/models/_files.py
new file mode 100644
index 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.py
index 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 FileHelper
from composio.core.models.base import Resource
from composio.core.models.custom_tools import CustomTools
from composio.core.provider import (
@@ -60,6 +61,7 @@ class Tools(Resource, t.Generic[TProvider]):
self._client = client
self._custom_tools = CustomTools(client)
self._tool_schemas: t.Dict[str, Tool] = {}
+ self._file_helper = FileHelper(client=self._client)
self.custom_tool = self._custom_tools.register
self.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.py
new file mode 100644
index 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)