restructure for v1 (#99)

* remove remote.core.processors package

* finalise restructure

* clean up code

* update release history

docs/_howto/scripts/local.playlist.load-save/p3_wrangler.py

@@ -1,5 +1,5 @@
 from p3 import *
 
-from musify.libraries.remote.spotify.processors import SpotifyDataWrangler
+from musify.libraries.remote.spotify.wrangle import SpotifyDataWrangler
 
 playlist = asyncio.run(load_playlist("<PATH TO A PLAYLIST>", remote_wrangler=SpotifyDataWrangler()))

docs/_howto/scripts/local.track.load-save/p1_wrangler.py

@@ -1,5 +1,5 @@
 from p1_load import *
 
-from musify.libraries.remote.spotify.processors import SpotifyDataWrangler
+from musify.libraries.remote.spotify.wrangle import SpotifyDataWrangler
 
 track = asyncio.run(load_track("<PATH TO A TRACK>", remote_wrangler=SpotifyDataWrangler()))

docs/_howto/scripts/setup.py

@@ -1,6 +1,6 @@
 import logging
 import sys
 
-from musify.log import STAT
+from musify.logger import STAT
 
 logging.basicConfig(format="%(message)s", level=STAT, stream=sys.stdout)

docs/_howto/scripts/sync/p1.py

@@ -4,8 +4,8 @@
 
 from musify.libraries.core.collection import MusifyCollection
 from musify.libraries.remote.core.factory import RemoteObjectFactory
-from musify.libraries.remote.core.processors.search import RemoteItemSearcher
-from musify.libraries.remote.core.processors.check import RemoteItemChecker
+from musify.processors.search import RemoteItemSearcher
+from musify.processors.check import RemoteItemChecker
 from musify.processors.match import ItemMatcher
 
 

docs/release-history.rst

@@ -100,6 +100,11 @@ Changed
 * :py:class:`.RemoteItemChecker` also uses the new :py:meth:`.RemoteAPI.follow_playlist` method
   when creating playlists to ensure that a user is following the playlists it creates to avoid 'ghost playlist' issue.
 * :py:meth:`.SpotifyAPI.create_playlist` now returns the full response rather than just the URL of the playlist.
+* Moved :py:class:`.RemoteItemChecker` and :py:class:`.RemoteItemSearcher` to `musify.processors` package.
+* Moved :py:class:`.RemoteDataWrangler` up a level to `musify.libraries.remote.core`.
+* Renamed `musify.libraries.remote.spotify.processors` module to `musify.libraries.remote.spotify.wrangle`.
+* Moved `musify.logger` module to `musify` base package.
+* Restructured contents of `musify.core` package to modules in `musify` base package.
 
 Fixed
 -----
@@ -128,6 +133,8 @@ Removed
 * ThreadPoolExecutor use on :py:class:`.RemoteItemSearcher`. Now uses asynchronous logic instead.
 * `last_modified` field as attribute to ignore when getting attributes
   to print on `LocalCollection` to improve performance
+* Removed logger filters and handlers. Moved to CLI repo.
+* Deleted `musify.libraries.remote.core.processors` package.
 
 Documentation
 -------------

musify/api/authorise.py

@@ -16,7 +16,7 @@
 
 from musify import PROGRAM_NAME
 from musify.api.exception import APIError
-from musify.log.logger import MusifyLogger
+from musify.logger import MusifyLogger
 
 
 class APIAuthoriser:

musify/api/cache/backend/base.py

@@ -5,12 +5,12 @@
 from datetime import datetime, timedelta
 from typing import Any, Self
 
-from dateutil.relativedelta import relativedelta
 from aiohttp import RequestInfo, ClientRequest, ClientResponse
+from dateutil.relativedelta import relativedelta
 from yarl import URL
 
 from musify.api.exception import CacheError
-from musify.log.logger import MusifyLogger
+from musify.logger import MusifyLogger
 from musify.types import UnitCollection
 from musify.utils import to_collection
 

musify/api/cache/backend/sqlite.py

@@ -8,8 +8,8 @@
 from tempfile import gettempdir
 from typing import Any, Self
 
-from dateutil.relativedelta import relativedelta
 from aiohttp import RequestInfo, ClientRequest, ClientResponse
+from dateutil.relativedelta import relativedelta
 from yarl import URL
 
 from musify import PROGRAM_NAME

musify/api/request.py

@@ -20,7 +20,7 @@
 from musify.api.cache.backend import ResponseCache
 from musify.api.cache.session import CachedSession
 from musify.api.exception import APIError, RequestError
-from musify.log.logger import MusifyLogger
+from musify.logger import MusifyLogger
 from musify.utils import clean_kwargs
 
 

musify/core/base.py → musify/base.py

@@ -4,12 +4,22 @@
 from __future__ import annotations
 
 from abc import ABCMeta, abstractmethod
+from dataclasses import dataclass
 from typing import Any
 
-from musify.core.enum import TagField
-from musify.core.printer import AttributePrinter
+from musify.field import TagField
+from musify.printer import AttributePrinter
 
 
+@dataclass(frozen=True)
+class Result(metaclass=ABCMeta):
+    """Stores the results of an operation"""
+    pass
+
+
+###########################################################################
+## Core item/object types
+###########################################################################
 class MusifyObject(AttributePrinter, metaclass=ABCMeta):
     """Generic base class for any nameable and taggable object."""