feat: Rename Session.attached_window -> Session.active_window

Deprecate Session.attached_window

Author: tony

src/libtmux/session.py

@@ -353,7 +353,7 @@ def select_window(self, target_window: t.Union[str, int]) -> "Window":
     # Computed properties
     #
     @property
-    def attached_window(self) -> "Window":
+    def active_window(self) -> "Window":
         """Return active :class:`Window` object."""
         active_windows = self.windows.filter(window_active="1")
 
@@ -676,6 +676,24 @@ def name(self) -> t.Optional[str]:
     #
     # Legacy: Redundant stuff we want to remove
     #
+    @property
+    def attached_window(self) -> "Window":
+        """Return active :class:`Window` object.
+
+        Notes
+        -----
+        .. deprecated:: 0.31
+
+           Deprecated in favor of :meth:`.active_window`.
+        """
+        warnings.warn(
+            "Session.attached_window() is deprecated in favor of "
+            + "Session.active_window()",
+            category=DeprecationWarning,
+            stacklevel=2,
+        )
+        return self.active_window
+
     def attach_session(self) -> "Session":
         """Return ``$ tmux attach-session`` aka alias: ``$ tmux attach``.