Sort imports

- annotations import in all files using typehints
- typehint specific imports under type_checking condition
- native library imports > installed libs > module import

Author: Dr-Blank

plexapi/base.py

@@ -1,11 +1,11 @@
 # -*- coding: utf-8 -*-
 from __future__ import annotations
-from datetime import datetime
 
 import re
-from typing import Any, Callable, Dict, List, Optional, Set, Type, TypeVar, Union, cast, overload, TYPE_CHECKING
 import weakref
 from functools import cached_property
+from typing import (TYPE_CHECKING, Any, Callable, Dict, List, Optional, Set,
+                    Type, TypeVar, Union, cast, overload)
 from urllib.parse import urlencode
 from xml.etree import ElementTree
 from xml.etree.ElementTree import Element
@@ -14,9 +14,11 @@
 from plexapi.exceptions import BadRequest, NotFound, UnknownType, Unsupported
 
 if TYPE_CHECKING:
+    from datetime import datetime
+
+    from plexapi.library import LibrarySection
     from plexapi.media import Session
     from plexapi.server import PlexServer
-    from plexapi.library import LibrarySection
 
 FunctionCheck = Callable[[Any, Any], bool]
 PlexObjectT = TypeVar('PlexObjectT', bound='PlexObject')

plexapi/client.py

@@ -1,15 +1,21 @@
 # -*- coding: utf-8 -*-
+from __future__ import annotations
+
 import time
+from typing import TYPE_CHECKING
 from xml.etree import ElementTree
-from xml.etree.ElementTree import Element
 
 import requests
+from requests.status_codes import _codes as codes
 
 from plexapi import BASE_HEADERS, CONFIG, TIMEOUT, log, logfilter, utils
 from plexapi.base import PlexObject
 from plexapi.exceptions import BadRequest, NotFound, Unauthorized, Unsupported
 from plexapi.playqueue import PlayQueue
-from requests.status_codes import _codes as codes
+
+if TYPE_CHECKING:
+    from xml.etree.ElementTree import Element
+
 
 DEFAULT_MTYPE = 'video'
 

plexapi/collection.py

@@ -1,19 +1,22 @@
 # -*- coding: utf-8 -*-
+from __future__ import annotations
+
 from pathlib import Path
+from typing import TYPE_CHECKING
 from urllib.parse import quote_plus
-from xml.etree.ElementTree import Element
 
 from plexapi import media, utils
 from plexapi.base import PlexPartialObject
 from plexapi.exceptions import BadRequest, NotFound, Unsupported
 from plexapi.library import LibrarySection, ManagedHub
-from plexapi.mixins import (
-    AdvancedSettingsMixin, SmartFilterMixin, HubsMixin, RatingMixin,
-    ArtMixin, PosterMixin, ThemeMixin,
-    CollectionEditMixins
-)
+from plexapi.mixins import (AdvancedSettingsMixin, ArtMixin,
+                            CollectionEditMixins, HubsMixin, PosterMixin,
+                            RatingMixin, SmartFilterMixin, ThemeMixin)
 from plexapi.utils import deprecated
 
+if TYPE_CHECKING:
+    from xml.etree.ElementTree import Element
+
 
 @utils.registerPlexObject
 class Collection(

plexapi/library.py

@@ -1,20 +1,25 @@
 # -*- coding: utf-8 -*-
+from __future__ import annotations
+
 import re
 from datetime import datetime
 from functools import cached_property
+from typing import TYPE_CHECKING
 from urllib.parse import parse_qs, quote_plus, urlencode, urlparse
-from xml.etree.ElementTree import Element
 
 from plexapi import log, media, utils
 from plexapi.base import OPERATORS, PlexObject
 from plexapi.exceptions import BadRequest, NotFound
-from plexapi.mixins import (
-    MovieEditMixins, ShowEditMixins, SeasonEditMixins, EpisodeEditMixins,
-    ArtistEditMixins, AlbumEditMixins, TrackEditMixins, PhotoalbumEditMixins, PhotoEditMixins
-)
+from plexapi.mixins import (AlbumEditMixins, ArtistEditMixins,
+                            EpisodeEditMixins, MovieEditMixins,
+                            PhotoalbumEditMixins, PhotoEditMixins,
+                            SeasonEditMixins, ShowEditMixins, TrackEditMixins)
 from plexapi.settings import Setting
 from plexapi.utils import deprecated
 
+if TYPE_CHECKING:
+    from xml.etree.ElementTree import Element
+
 
 class Library(PlexObject):
     """ Represents a PlexServer library. This contains all sections of media defined

plexapi/media.py

@@ -1,14 +1,20 @@
 # -*- coding: utf-8 -*-
+from __future__ import annotations
+
 import xml
 from pathlib import Path
+from typing import TYPE_CHECKING
 from urllib.parse import quote_plus
-from xml.etree.ElementTree import Element
 
 from plexapi import log, settings, utils
 from plexapi.base import PlexObject
 from plexapi.exceptions import BadRequest
 from plexapi.utils import deprecated
 
+if TYPE_CHECKING:
+    from xml.etree.ElementTree import Element
+
+
 
 @utils.registerPlexObject
 class Media(PlexObject):

plexapi/myplex.py

@@ -1,24 +1,29 @@
 # -*- coding: utf-8 -*-
+from __future__ import annotations
+
 import copy
 import html
 import threading
 import time
+from typing import TYPE_CHECKING
 from urllib.parse import parse_qsl, urlencode, urlsplit, urlunsplit
 from xml.etree import ElementTree
-from xml.etree.ElementTree import Element
 
 import requests
+from requests.status_codes import _codes as codes
 
-from plexapi import (BASE_HEADERS, CONFIG, TIMEOUT, X_PLEX_ENABLE_FAST_CONNECT, X_PLEX_IDENTIFIER,
-                     log, logfilter, utils)
+from plexapi import (BASE_HEADERS, CONFIG, TIMEOUT, X_PLEX_ENABLE_FAST_CONNECT,
+                     X_PLEX_IDENTIFIER, log, logfilter, utils)
 from plexapi.base import PlexObject
 from plexapi.client import PlexClient
 from plexapi.exceptions import BadRequest, NotFound, Unauthorized
 from plexapi.library import LibrarySection
 from plexapi.server import PlexServer
 from plexapi.sonos import PlexSonosClient
 from plexapi.sync import SyncItem, SyncList
-from requests.status_codes import _codes as codes
+
+if TYPE_CHECKING:
+    from xml.etree.ElementTree import Element
 
 
 class MyPlexAccount(PlexObject):

plexapi/photo.py

@@ -1,17 +1,20 @@
 # -*- coding: utf-8 -*-
+from __future__ import annotations
+
 import os
 from pathlib import Path
+from typing import TYPE_CHECKING
 from urllib.parse import quote_plus
-from xml.etree.ElementTree import Element
 
 from plexapi import media, utils, video
 from plexapi.base import Playable, PlexPartialObject, PlexSession
 from plexapi.exceptions import BadRequest
-from plexapi.mixins import (
-    RatingMixin,
-    ArtUrlMixin, ArtMixin, PosterUrlMixin, PosterMixin,
-    PhotoalbumEditMixins, PhotoEditMixins
-)
+from plexapi.mixins import (ArtMixin, ArtUrlMixin, PhotoalbumEditMixins,
+                            PhotoEditMixins, PosterMixin, PosterUrlMixin,
+                            RatingMixin)
+
+if TYPE_CHECKING:
+    from xml.etree.ElementTree import Element
 
 
 @utils.registerPlexObject

plexapi/playlist.py

@@ -1,16 +1,21 @@
 # -*- coding: utf-8 -*-
+from __future__ import annotations
+
 import re
 from pathlib import Path
+from typing import TYPE_CHECKING
 from urllib.parse import quote_plus, unquote
-from xml.etree.ElementTree import Element
 
 from plexapi import media, utils
 from plexapi.base import Playable
 from plexapi.exceptions import BadRequest, NotFound, Unsupported
 from plexapi.library import LibrarySection, MusicSection
-from plexapi.mixins import SmartFilterMixin, ArtMixin, PosterMixin
+from plexapi.mixins import ArtMixin, PosterMixin, SmartFilterMixin
 from plexapi.utils import deprecated
 
+if TYPE_CHECKING:
+    from xml.etree.ElementTree import Element
+
 
 @utils.registerPlexObject
 class Playlist(

plexapi/playqueue.py

@@ -1,11 +1,16 @@
 # -*- coding: utf-8 -*-
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
 from urllib.parse import quote_plus
-from xml.etree.ElementTree import Element
 
 from plexapi import utils
 from plexapi.base import PlexObject
 from plexapi.exceptions import BadRequest
 
+if TYPE_CHECKING:
+    from xml.etree.ElementTree import Element
+
 
 class PlayQueue(PlexObject):
     """Control a PlayQueue.

plexapi/server.py

@@ -1,36 +1,40 @@
 # -*- coding: utf-8 -*-
-from datetime import datetime
+from __future__ import annotations
+
 import os
+from datetime import datetime
 from functools import cached_property
-from typing import Optional, Union
+from typing import TYPE_CHECKING, Optional, Union
 from urllib.parse import urlencode
 from xml.etree import ElementTree
-from xml.etree.ElementTree import Element
 
 import requests
+from requests.status_codes import _codes as codes
 
-from plexapi import BASE_HEADERS, CONFIG, TIMEOUT, log, logfilter
+# Need these imports to populate utils.PLEXOBJECTS
+from plexapi import BASE_HEADERS, CONFIG, TIMEOUT
+from plexapi import audio as _audio  # noqa: F401
+from plexapi import collection as _collection  # noqa: F401
+from plexapi import log, logfilter
+from plexapi import media as _media  # noqa: F401
+from plexapi import photo as _photo  # noqa: F401
+from plexapi import playlist as _playlist  # noqa: F401
 from plexapi import utils
+from plexapi import video as _video  # noqa: F401
 from plexapi.alert import AlertListener
 from plexapi.base import PlexObject
 from plexapi.client import PlexClient
 from plexapi.collection import Collection
 from plexapi.exceptions import BadRequest, NotFound, Unauthorized
-from plexapi.library import Hub, Library, Path, File
+from plexapi.library import File, Hub, Library, Path
 from plexapi.media import Conversion, Optimized
 from plexapi.playlist import Playlist
 from plexapi.playqueue import PlayQueue
 from plexapi.settings import Settings
 from plexapi.utils import deprecated
-from requests.status_codes import _codes as codes
 
-# Need these imports to populate utils.PLEXOBJECTS
-from plexapi import audio as _audio  # noqa: F401
-from plexapi import collection as _collection  # noqa: F401
-from plexapi import media as _media  # noqa: F401
-from plexapi import photo as _photo  # noqa: F401
-from plexapi import playlist as _playlist  # noqa: F401
-from plexapi import video as _video  # noqa: F401
+if TYPE_CHECKING:
+    from xml.etree.ElementTree import Element
 
 
 class PlexServer(PlexObject):