add delete event to File component

.changeset/full-flies-join.md

@@ -0,0 +1,10 @@
+---
+"@gradio/app": minor
+"@gradio/file": minor
+"@gradio/preview": minor
+"@gradio/tootils": minor
+"@gradio/upload": minor
+"gradio": minor
+---
+
+feat:8354 file delete

demo/file_component_events/run.ipynb

@@ -1 +1 @@
-{"cells": [{"cell_type": "markdown", "id": "302934307671667531413257853548643485645", "metadata": {}, "source": ["# Gradio Demo: file_component_events"]}, {"cell_type": "code", "execution_count": null, "id": "272996653310673477252411125948039410165", "metadata": {}, "outputs": [], "source": ["!pip install -q gradio "]}, {"cell_type": "code", "execution_count": null, "id": "288918539441861185822528903084949547379", "metadata": {}, "outputs": [], "source": ["import gradio as gr\n", "\n", "with gr.Blocks() as demo:\n", "    \n", "    with gr.Row():\n", "        with gr.Column():\n", "            file_component = gr.File(label=\"Upload Single File\", file_count=\"single\")\n", "        with gr.Column():\n", "            output_file_1 = gr.File(label=\"Upload Single File Output\", file_count=\"single\")\n", "            num_load_btn_1 = gr.Number(label=\"# Load Upload Single File\", value=0)\n", "            file_component.upload(lambda s,n: (s, n + 1), [file_component, num_load_btn_1], [output_file_1, num_load_btn_1])\n", "    with gr.Row():\n", "        with gr.Column():\n", "            file_component_multiple = gr.File(label=\"Upload Multiple Files\", file_count=\"multiple\")\n", "        with gr.Column():\n", "            output_file_2 = gr.File(label=\"Upload Multiple Files Output\", file_count=\"multiple\")\n", "            num_load_btn_2 = gr.Number(label=\"# Load Upload Multiple Files\", value=0)\n", "            file_component_multiple.upload(lambda s,n: (s, n + 1), [file_component_multiple, num_load_btn_2], [output_file_2, num_load_btn_2])\n", "    with gr.Row():\n", "        with gr.Column():\n", "            file_component_specific = gr.File(label=\"Upload Multiple Files Image/Video\", file_count=\"multiple\", file_types=[\"image\", \"video\"])\n", "        with gr.Column():\n", "            output_file_3 = gr.File(label=\"Upload Multiple Files Output Image/Video\", file_count=\"multiple\")\n", "            num_load_btn_3 = gr.Number(label=\"# Load Upload Multiple Files Image/Video\", value=0)\n", "            file_component_specific.upload(lambda s,n: (s, n + 1), [file_component_specific, num_load_btn_3], [output_file_3, num_load_btn_3])\n", "    with gr.Row():\n", "        with gr.Column():\n", "            file_component_pdf = gr.File(label=\"Upload PDF File\", file_types=[\"pdf\"])\n", "        with gr.Column():\n", "            output_file_4 = gr.File(label=\"Upload PDF File Output\")\n", "            num_load_btn_4 = gr.Number(label=\"# Load Upload PDF File\", value=0)\n", "            file_component_pdf.upload(lambda s,n: (s, n + 1), [file_component_pdf, num_load_btn_4], [output_file_4, num_load_btn_4])\n", "    with gr.Row():\n", "        with gr.Column():\n", "            file_component_invalid = gr.File(label=\"Upload File with Invalid file_types\", file_types=[\"invalid file_type\"])\n", "        with gr.Column():\n", "            output_file_5 = gr.File(label=\"Upload File with Invalid file_types Output\")\n", "            num_load_btn_5 = gr.Number(label=\"# Load Upload File with Invalid file_types\", value=0)\n", "            file_component_invalid.upload(lambda s,n: (s, n + 1), [file_component_invalid, num_load_btn_5], [output_file_5, num_load_btn_5])\n", "\n", "if __name__ == \"__main__\":\n", "    demo.launch()\n"]}], "metadata": {}, "nbformat": 4, "nbformat_minor": 5}
+{"cells": [{"cell_type": "markdown", "id": "302934307671667531413257853548643485645", "metadata": {}, "source": ["# Gradio Demo: file_component_events"]}, {"cell_type": "code", "execution_count": null, "id": "272996653310673477252411125948039410165", "metadata": {}, "outputs": [], "source": ["!pip install -q gradio "]}, {"cell_type": "code", "execution_count": null, "id": "288918539441861185822528903084949547379", "metadata": {}, "outputs": [], "source": ["import gradio as gr\n", "\n", "\n", "def delete_file(n: int, file: gr.DeletedFileData):\n", "    print(file.file.path, file.target)\n", "    return [file.file.path, n + 1]\n", "\n", "\n", "with gr.Blocks() as demo:\n", "\n", "    with gr.Row():\n", "        with gr.Column():\n", "            file_component = gr.File(label=\"Upload Single File\", file_count=\"single\")\n", "        with gr.Column():\n", "            output_file_1 = gr.File(\n", "                label=\"Upload Single File Output\", file_count=\"single\"\n", "            )\n", "            num_load_btn_1 = gr.Number(label=\"# Load Upload Single File\", value=0)\n", "            file_component.upload(\n", "                lambda s, n: (s, n + 1),\n", "                [file_component, num_load_btn_1],\n", "                [output_file_1, num_load_btn_1],\n", "            )\n", "    with gr.Row():\n", "        with gr.Column():\n", "            file_component_multiple = gr.File(\n", "                label=\"Upload Multiple Files\", file_count=\"multiple\"\n", "            )\n", "        with gr.Column():\n", "            output_file_2 = gr.File(\n", "                label=\"Upload Multiple Files Output\", file_count=\"multiple\"\n", "            )\n", "            num_load_btn_2 = gr.Number(label=\"# Load Upload Multiple Files\", value=0)\n", "            file_component_multiple.upload(\n", "                lambda s, n: (s, n + 1),\n", "                [file_component_multiple, num_load_btn_2],\n", "                [output_file_2, num_load_btn_2],\n", "            )\n", "    with gr.Row():\n", "        with gr.Column():\n", "            file_component_specific = gr.File(\n", "                label=\"Upload Multiple Files Image/Video\",\n", "                file_count=\"multiple\",\n", "                file_types=[\"image\", \"video\"],\n", "            )\n", "        with gr.Column():\n", "            output_file_3 = gr.File(\n", "                label=\"Upload Multiple Files Output Image/Video\", file_count=\"multiple\"\n", "            )\n", "            num_load_btn_3 = gr.Number(\n", "                label=\"# Load Upload Multiple Files Image/Video\", value=0\n", "            )\n", "            file_component_specific.upload(\n", "                lambda s, n: (s, n + 1),\n", "                [file_component_specific, num_load_btn_3],\n", "                [output_file_3, num_load_btn_3],\n", "            )\n", "    with gr.Row():\n", "        with gr.Column():\n", "            file_component_pdf = gr.File(label=\"Upload PDF File\", file_types=[\"pdf\"])\n", "        with gr.Column():\n", "            output_file_4 = gr.File(label=\"Upload PDF File Output\")\n", "            num_load_btn_4 = gr.Number(label=\"# Load Upload PDF File\", value=0)\n", "            file_component_pdf.upload(\n", "                lambda s, n: (s, n + 1),\n", "                [file_component_pdf, num_load_btn_4],\n", "                [output_file_4, num_load_btn_4],\n", "            )\n", "    with gr.Row():\n", "        with gr.Column():\n", "            file_component_invalid = gr.File(\n", "                label=\"Upload File with Invalid file_types\",\n", "                file_types=[\"invalid file_type\"],\n", "            )\n", "        with gr.Column():\n", "            output_file_5 = gr.File(label=\"Upload File with Invalid file_types Output\")\n", "            num_load_btn_5 = gr.Number(\n", "                label=\"# Load Upload File with Invalid file_types\", value=0\n", "            )\n", "            file_component_invalid.upload(\n", "                lambda s, n: (s, n + 1),\n", "                [file_component_invalid, num_load_btn_5],\n", "                [output_file_5, num_load_btn_5],\n", "            )\n", "    with gr.Row():\n", "        with gr.Column():\n", "            del_file_input = gr.File(label=\"Delete File\", file_count=\"multiple\")\n", "        with gr.Column():\n", "            del_file_data = gr.Textbox(label=\"Delete file data\")\n", "            num_load_btn_6 = gr.Number(label=\"# Deleted File\", value=0)\n", "            del_file_input.delete(\n", "                delete_file,\n", "                [num_load_btn_6],\n", "                [del_file_data, num_load_btn_6],\n", "            )\n", "    # f = gr.File(label=\"Upload many File\", file_count=\"multiple\")\n", "    # # f.delete(delete_file)\n", "    # f.delete(delete_file, inputs=None, outputs=None)\n", "\n", "if __name__ == \"__main__\":\n", "    demo.launch()\n"]}], "metadata": {}, "nbformat": 4, "nbformat_minor": 5}

demo/file_component_events/run.py

@@ -1,42 +1,100 @@
 import gradio as gr
 
+
+def delete_file(n: int, file: gr.DeletedFileData):
+    return [file.file.path, n + 1]
+
+
 with gr.Blocks() as demo:
-    
+
     with gr.Row():
         with gr.Column():
             file_component = gr.File(label="Upload Single File", file_count="single")
         with gr.Column():
-            output_file_1 = gr.File(label="Upload Single File Output", file_count="single")
+            output_file_1 = gr.File(
+                label="Upload Single File Output", file_count="single"
+            )
             num_load_btn_1 = gr.Number(label="# Load Upload Single File", value=0)
-            file_component.upload(lambda s,n: (s, n + 1), [file_component, num_load_btn_1], [output_file_1, num_load_btn_1])
+            file_component.upload(
+                lambda s, n: (s, n + 1),
+                [file_component, num_load_btn_1],
+                [output_file_1, num_load_btn_1],
+            )
     with gr.Row():
         with gr.Column():
-            file_component_multiple = gr.File(label="Upload Multiple Files", file_count="multiple")
+            file_component_multiple = gr.File(
+                label="Upload Multiple Files", file_count="multiple"
+            )
         with gr.Column():
-            output_file_2 = gr.File(label="Upload Multiple Files Output", file_count="multiple")
+            output_file_2 = gr.File(
+                label="Upload Multiple Files Output", file_count="multiple"
+            )
             num_load_btn_2 = gr.Number(label="# Load Upload Multiple Files", value=0)
-            file_component_multiple.upload(lambda s,n: (s, n + 1), [file_component_multiple, num_load_btn_2], [output_file_2, num_load_btn_2])
+            file_component_multiple.upload(
+                lambda s, n: (s, n + 1),
+                [file_component_multiple, num_load_btn_2],
+                [output_file_2, num_load_btn_2],
+            )
     with gr.Row():
         with gr.Column():
-            file_component_specific = gr.File(label="Upload Multiple Files Image/Video", file_count="multiple", file_types=["image", "video"])
+            file_component_specific = gr.File(
+                label="Upload Multiple Files Image/Video",
+                file_count="multiple",
+                file_types=["image", "video"],
+            )
         with gr.Column():
-            output_file_3 = gr.File(label="Upload Multiple Files Output Image/Video", file_count="multiple")
-            num_load_btn_3 = gr.Number(label="# Load Upload Multiple Files Image/Video", value=0)
-            file_component_specific.upload(lambda s,n: (s, n + 1), [file_component_specific, num_load_btn_3], [output_file_3, num_load_btn_3])
+            output_file_3 = gr.File(
+                label="Upload Multiple Files Output Image/Video", file_count="multiple"
+            )
+            num_load_btn_3 = gr.Number(
+                label="# Load Upload Multiple Files Image/Video", value=0
+            )
+            file_component_specific.upload(
+                lambda s, n: (s, n + 1),
+                [file_component_specific, num_load_btn_3],
+                [output_file_3, num_load_btn_3],
+            )
     with gr.Row():
         with gr.Column():
             file_component_pdf = gr.File(label="Upload PDF File", file_types=["pdf"])
         with gr.Column():
             output_file_4 = gr.File(label="Upload PDF File Output")
             num_load_btn_4 = gr.Number(label="# Load Upload PDF File", value=0)
-            file_component_pdf.upload(lambda s,n: (s, n + 1), [file_component_pdf, num_load_btn_4], [output_file_4, num_load_btn_4])
+            file_component_pdf.upload(
+                lambda s, n: (s, n + 1),
+                [file_component_pdf, num_load_btn_4],
+                [output_file_4, num_load_btn_4],
+            )
     with gr.Row():
         with gr.Column():
-            file_component_invalid = gr.File(label="Upload File with Invalid file_types", file_types=["invalid file_type"])
+            file_component_invalid = gr.File(
+                label="Upload File with Invalid file_types",
+                file_types=["invalid file_type"],
+            )
         with gr.Column():
             output_file_5 = gr.File(label="Upload File with Invalid file_types Output")
-            num_load_btn_5 = gr.Number(label="# Load Upload File with Invalid file_types", value=0)
-            file_component_invalid.upload(lambda s,n: (s, n + 1), [file_component_invalid, num_load_btn_5], [output_file_5, num_load_btn_5])
+            num_load_btn_5 = gr.Number(
+                label="# Load Upload File with Invalid file_types", value=0
+            )
+            file_component_invalid.upload(
+                lambda s, n: (s, n + 1),
+                [file_component_invalid, num_load_btn_5],
+                [output_file_5, num_load_btn_5],
+            )
+    with gr.Row():
+        with gr.Column():
+            del_file_input = gr.File(label="Delete File", file_count="multiple")
+        with gr.Column():
+            del_file_data = gr.Textbox(label="Delete file data")
+            num_load_btn_6 = gr.Number(label="# Deleted File", value=0)
+            del_file_input.delete(
+                delete_file,
+                [num_load_btn_6],
+                [del_file_data, num_load_btn_6],
+            )
+    # f = gr.File(label="Upload many File", file_count="multiple")
+    # # f.delete(delete_file)
+    # f.delete(delete_file, inputs=None, outputs=None)
 
 if __name__ == "__main__":
     demo.launch()

gradio/__init__.py

@@ -60,7 +60,14 @@
 from gradio.components.audio import WaveformOptions
 from gradio.components.image_editor import Brush, Eraser
 from gradio.data_classes import FileData
-from gradio.events import EventData, KeyUpData, LikeData, SelectData, on
+from gradio.events import (
+    DeletedFileData,
+    EventData,
+    KeyUpData,
+    LikeData,
+    SelectData,
+    on,
+)
 from gradio.exceptions import Error
 from gradio.external import load
 from gradio.flagging import (

gradio/components/file.py

@@ -26,7 +26,7 @@ class File(Component):
     Demo: zip_files, zip_to_json
     """
 
-    EVENTS = [Events.change, Events.select, Events.clear, Events.upload]
+    EVENTS = [Events.change, Events.select, Events.clear, Events.upload, Events.delete]
 
     def __init__(
         self,

gradio/data_classes.py

@@ -8,7 +8,7 @@
 import shutil
 from abc import ABC, abstractmethod
 from enum import Enum, auto
-from typing import TYPE_CHECKING, Any, List, Optional, Tuple, Union
+from typing import TYPE_CHECKING, Any, List, Optional, Tuple, Union, TypedDict
 
 from fastapi import Request
 from gradio_client.utils import traverse
@@ -189,6 +189,16 @@ def from_json(cls, x) -> GradioRootModel:
 GradioDataModel = Union[GradioModel, GradioRootModel]
 
 
+class FileDataDict(TypedDict):
+    path: str  # server filepath
+    url: Optional[str]  # normalised server url
+    size: Optional[int]  # size in bytes
+    orig_name: Optional[str]  # original filename
+    mime_type: Optional[str]
+    is_stream: bool
+    meta: dict
+
+
 class FileData(GradioModel):
     path: str  # server filepath
     url: Optional[str] = None  # normalised server url

gradio/events.py

@@ -7,6 +7,7 @@
 from functools import partial, wraps
 from typing import TYPE_CHECKING, Any, Callable, Literal, Sequence
 
+from gradio.data_classes import FileData, FileDataDict
 from gradio_client.documentation import document
 from jinja2 import Template
 
@@ -139,6 +140,15 @@ def __init__(self, target: Block | None, data: Any):
         """
 
 
+class DeletedFileData(EventData):
+    def __init__(self, target: Block | None, data: FileDataDict):
+        super().__init__(target, data)
+        self.file: FileData = FileData(**data)
+        """
+        The file that was deleted.
+        """
+
+
 @dataclasses.dataclass
 class EventListenerMethod:
     block: Block | None
@@ -547,6 +557,10 @@ class Events:
         "apply",
         doc="This listener is triggered when the user applies changes to the {{ component }} through an integrated UI action.",
     )
+    delete = EventListener(
+        "delete",
+        doc="This listener is triggered when the user deletes and item from the {{ component }}. Uses event data gradio.SelectData to carry `value` referring to the path of the {{ component }}. See EventData documentation on how to use this event data",
+    )
 
 
 class LikeData(EventData):