Add switchHomeUser method to PlexServer

Author: JonnyWong16

plexapi/myplex.py

@@ -497,13 +497,18 @@ def removeHomeUser(self, user):
         url = self.HOMEUSER.format(userId=user.id)
         return self.query(url, self._session.delete)
 
-    def switchHomeUser(self, user, pin=None):
-        """ Returns a new :class:`~plexapi.myplex.MyPlexAccount` object switched to the given home user.
+    def switchHomeUser(self, user, pin=None, session=None, timeout=None):
+        """ Returns a new :class:`~plexapi.myplex.MyPlexAccount` object switched to the given Plex Home user.
 
             Parameters:
                 user (:class:`~plexapi.myplex.MyPlexUser` or str): :class:`~plexapi.myplex.MyPlexUser`,
-                    username, or email of the home user to switch to.
-                pin (str): PIN for the home user (required if the home user has a PIN set).
+                    username, or email of the Plex Home user to switch to.
+                pin (str): PIN for the Plex Home user (required if the Plex Home user has a PIN set).
+                session (requests.Session, optional): Use your own session object if you want to
+                    cache the http responses from the server. This will default to the same
+                    session as the current account if no new session is provided.
+                timeout (int, optional): Timeout in seconds on initial connection to the server.
+                    This will default to the same timeout as the current account if no new timeout is provided.
 
             Example:
 
@@ -523,7 +528,11 @@ def switchHomeUser(self, user, pin=None):
             params['pin'] = pin
         data = self.query(url, self._session.post, params=params)
         userToken = data.attrib.get('authenticationToken')
-        return MyPlexAccount(token=userToken, session=self._session)
+        if session is None:
+            session = self._session
+        if timeout is None:
+            timeout = self._timeout
+        return MyPlexAccount(token=userToken, session=session, timeout=timeout)
 
     def setPin(self, newPin, currentPin=None):
         """ Set a new Plex Home PIN for the account.

plexapi/playlist.py

@@ -443,13 +443,13 @@ def create(cls, server, title, section=None, items=None, smart=False, limit=None
             return cls._create(server, title, items)
 
     def copyToUser(self, user):
-        """ Copy playlist to another user account.
+        """ Copy playlist to another Plex Home user account.
 
             Parameters:
                 user (:class:`~plexapi.myplex.MyPlexUser` or str): `MyPlexUser` object, username,
-                    email, or user id of the user to copy the playlist to.
+                    email, or user id of the Plex Home user to copy the playlist to.
         """
-        userServer = self._server.switchUser(user)
+        userServer = self._server.switchHomeUser(user)
         return self.create(server=userServer, title=self.title, items=self.items())
 
     def sync(self, videoQuality=None, photoResolution=None, audioBitrate=None, client=None, clientId=None, limit=None,

plexapi/server.py

@@ -234,8 +234,10 @@ def createToken(self, type='delegation', scope='all'):
         q = self.query(f'/security/token?type={type}&scope={scope}')
         return q.attrib.get('token')
 
+    @utils.deprecated('switchUser is deprecated, use switchHomeUser instead')
     def switchUser(self, user, session=None, timeout=None):
-        """ Returns a new :class:`~plexapi.server.PlexServer` object logged in as the given username.
+        """ Deprecated. Use :meth:`~plexapi.server.PlexServer.switchHomeUser` instead.
+            Returns a new :class:`~plexapi.server.PlexServer` object logged in as the given username.
             Note: Only the admin account can switch to other users.
 
             Parameters:
@@ -258,14 +260,38 @@ def switchUser(self, user, session=None, timeout=None):
                     # Login to the same Plex server using a different account
                     userPlex = plex.switchUser("Username")
 
+        """
+        return self.switchHomeUser(user, session=session, timeout=timeout)
+
+    def switchHomeUser(self, user, pin=None, session=None, timeout=None):
+        """ Returns a new :class:`~plexapi.server.PlexServer` object logged in as the given Plex Home user.
+            Note: Only the admin account can switch to other users.
+
+            Parameters:
+                user (:class:`~plexapi.myplex.MyPlexUser` or str): :class:`~plexapi.myplex.MyPlexUser`,
+                    username, or email of the Plex Home user to switch to.
+                pin (str): PIN for the Plex Home user (required if the Plex Home user has a PIN set).
+                session (requests.Session, optional): Use your own session object if you want to
+                    cache the http responses from the server. This will default to the same
+                    session as the current account if no new session is provided.
+                timeout (int, optional): Timeout in seconds on initial connection to the server.
+                    This will default to the same timeout as the current account if no new timeout is provided.
+
+            Example:
+
+                .. code-block:: python
+
+                    from plexapi.server import PlexServer
+                    # Login to the Plex server using the admin token
+                    plex = PlexServer('http://plexserver:32400', token='2ffLuB84dqLswk9skLos')
+                    # Login to the same Plex server using a different Plex Home user account
+                    userPlex = plex.switchHomeUser("Username")
+
         """
         from plexapi.myplex import MyPlexUser
         user = user if isinstance(user, MyPlexUser) else self.myPlexAccount().user(user)
-        userToken = user.get_token(self.machineIdentifier)
-        if session is None:
-            session = self._session
-        if timeout is None:
-            timeout = self._timeout
+        userAccount = self.myPlexAccount().switchHomeUser(user, pin=pin, session=session, timeout=timeout)
+        userToken = userAccount.resource(self.machineIdentifier).accessToken
         return PlexServer(self._baseurl, token=userToken, session=session, timeout=timeout)
 
     @cached_data_property