gh-44968: Add "Reload from Disk" feature to IDLE

Doc/whatsnew/3.15.rst

@@ -533,6 +533,12 @@ http.cookies
 * Allow '``"``' double quotes in cookie values.
   (Contributed by Nick Burns and Senthil Kumaran in :gh:`92936`.)
 
+idle
+----
+
+*   Add a "Reload from Disk" item to the File menu. This allows discarding
+    unsaved changes and reloading the current version of the file from the disk.
+    Patch by Shamil Abdulaev. (Contributed by Shamil Abdulaev in :gh:`44968`.)
 
 inspect
 -------

Lib/idlelib/idle_test/test_iomenu.py

@@ -2,6 +2,7 @@
 
 from idlelib import iomenu
 import unittest
+from unittest.mock import patch, mock_open
 from test.support import requires
 from tkinter import Tk
 from idlelib.editor import EditorWindow
@@ -57,6 +58,83 @@ def test_fixnewlines_end(self):
         eq(text.get('1.0', 'end-1c'), 'a\n')
         eq(fix(), 'a'+io.eol_convention)
 
+    def test_reload_no_file(self):
+        # Test reload when no file is associated
+        io = self.io
+        io.filename = None
+
+        with patch.object(iomenu.messagebox, 'showinfo') as mock_showinfo:
+            result = io.reload(None)
+            self.assertEqual(result, "break")
+            mock_showinfo.assert_called_once()
+            args, kwargs = mock_showinfo.call_args
+            self.assertIn("File Not Found", args[0])
+
+    def test_reload_with_file(self):
+        # Test reload with an actual file
+        io = self.io
+        text = io.editwin.text
+        io.filename = "/dummy/path/test.py"
+
+        original_content = "# Original content\n"
+        modified_content = "# Modified content\n"
+
+        m = mock_open()
+        m.side_effect = [
+            mock_open(read_data=original_content).return_value,
+            mock_open(read_data=modified_content).return_value,
+        ]
+
+        with patch('builtins.open', m):
+            io.loadfile(io.filename)
+            self.assertEqual(text.get('1.0', 'end-1c'), original_content)
+            result = io.reload(None)
+
+        self.assertEqual(result, "break")
+        self.assertEqual(text.get('1.0', 'end-1c'), modified_content)
+
+    def test_reload_with_unsaved_changes_cancel(self):
+        # Test reload with unsaved changes and user cancels
+        io = self.io
+        text = io.editwin.text
+        io.filename = "/dummy/path/test.py"
+        original_content = "# Original content\n"
+        unsaved_content = original_content + "\n# Unsaved change"
+
+        # Mock the initial file load.
+        with patch('builtins.open', mock_open(read_data=original_content)):
+            io.loadfile(io.filename)
+
+        text.insert('end', "\n# Unsaved change")
+        io.set_saved(False)
+
+        with patch('idlelib.iomenu.messagebox.askokcancel', return_value=False) as mock_ask:
+            result = io.reload(None)
+            self.assertEqual(result, "break")
+            # Content should not change.
+            self.assertEqual(text.get('1.0', 'end-1c'), unsaved_content)
+            mock_ask.assert_called_once()
+
+    def test_reload_with_unsaved_changes_confirm(self):
+        # Test reload with unsaved changes and user confirms
+        io = self.io
+        text = io.editwin.text
+        io.filename = "/dummy/path/test.py"
+        original_content = "# Original content\n"
+
+        with patch('builtins.open', mock_open(read_data=original_content)):
+            io.loadfile(io.filename)
+            text.insert('end', "\n# Unsaved change")
+            io.set_saved(False)
+
+            with patch('idlelib.iomenu.messagebox.askokcancel', return_value=True) as mock_ask:
+                result = io.reload(None)
+
+        self.assertEqual(result, "break")
+        # Content should be reverted to original.
+        self.assertEqual(text.get('1.0', 'end-1c'), original_content)
+        mock_ask.assert_called_once()
+
 
 def _extension_in_filetypes(extension):
     return any(

Lib/idlelib/iomenu.py

@@ -31,6 +31,7 @@ def __init__(self, editwin):
                                           self.save_as)
         self.__id_savecopy = self.text.bind("<<save-copy-of-window-as-file>>",
                                             self.save_a_copy)
+        self.__id_reload = self.text.bind("<<reload-window>>", self.reload)
         self.fileencoding = 'utf-8'
         self.__id_print = self.text.bind("<<print-window>>", self.print_window)
 
@@ -40,6 +41,7 @@ def close(self):
         self.text.unbind("<<save-window>>", self.__id_save)
         self.text.unbind("<<save-window-as-file>>",self.__id_saveas)
         self.text.unbind("<<save-copy-of-window-as-file>>", self.__id_savecopy)
+        self.text.unbind("<<reload-window>>", self.__id_reload)
         self.text.unbind("<<print-window>>", self.__id_print)
         # Break cycles
         self.editwin = None
@@ -237,6 +239,35 @@ def save_a_copy(self, event):
         self.updaterecentfileslist(filename)
         return "break"
 
+    def reload(self, event):
+        """Reload the file from disk, discarding any unsaved changes.
+
+        If the file has unsaved changes, ask the user to confirm.
+        """
+        if not self.filename:
+            messagebox.showinfo(
+                "File Not Found",
+                "This window has no associated file to reload.",
+                parent=self.text)
+            self.text.focus_set()
+            return "break"
+
+        if not self.get_saved():
+            confirm = messagebox.askokcancel(
+                title="Reload File",
+                message=f"Discard changes to {self.filename}?",
+                default=messagebox.CANCEL,
+                parent=self.text)
+            if not confirm:
+                self.text.focus_set()
+                return "break"
+
+        # Reload the file
+        self.loadfile(self.filename)
+
+        self.text.focus_set()
+        return "break"
+
     def writefile(self, filename):
         text = self.fixnewlines()
         chars = self.encode(text)

Lib/idlelib/mainmenu.py

@@ -31,6 +31,7 @@
    ('_Save', '<<save-window>>'),
    ('Save _As...', '<<save-window-as-file>>'),
    ('Save Cop_y As...', '<<save-copy-of-window-as-file>>'),
+   ('Re_load from Disk', '<<reload-window>>'),
    None,
    ('Prin_t Window', '<<print-window>>'),
    None,

Misc/NEWS.d/next/IDLE/2025-11-14-20-58-55.gh-issue-44968.rL9dK3.rst

@@ -0,0 +1,4 @@
+Add "Reload from Disk" menu item to IDLE's File menu. This allows users to
+easily reload a file from disk, discarding any unsaved changes in the editor.
+The feature is particularly useful when working with version control systems
+or when external tools modify files. Patch by Shamil Abdulaev.