Adds Request/Response Logging

example/example.dart

@@ -13,6 +13,7 @@ void main() async {
 
   var credentials = SpotifyApiCredentials(keyMap['id'], keyMap['secret']);
   var spotify = SpotifyApi(credentials);
+  spotify.enableLogging(enable: true);
 
   print('\nExpannd shortened spotify link of https://spotify.link/hRkBrwub9xb');
   var longLink = await spotify.expandLink('https://spotify.link/hRkBrwub9xb');

lib/spotify.dart

@@ -6,18 +6,21 @@ library spotify;
 
 import 'dart:async';
 import 'dart:convert';
+import 'dart:typed_data';
 
 import 'package:http/http.dart' as http;
 import 'package:oauth2/oauth2.dart' as oauth2;
 import 'package:spotify/spotify.dart';
+import 'package:meta/meta.dart';
+import 'dart:developer';
 
 import 'src/models/_models.dart';
 
 export 'package:oauth2/oauth2.dart'
     show AuthorizationException, ExpirationException;
 
 export 'src/models/_models.dart';
-
+part 'src/spotify_logger.dart';
 part 'src/endpoints/albums.dart';
 part 'src/endpoints/artists.dart';
 part 'src/endpoints/audio_analysis.dart';
@@ -42,3 +45,4 @@ part 'src/spotify_credentials.dart';
 part 'src/spotify_exception.dart';
 part 'src/utils.dart';
 part 'src/authorization_scope.dart';
+part 'src/spotify_client.dart';

lib/src/spotify_api.dart

@@ -17,8 +17,7 @@ class SpotifyApi extends SpotifyApiBase {
       {Function(SpotifyApiCredentials)? onCredentialsRefreshed})
       : super(credentials, http.Client(), onCredentialsRefreshed);
 
-  SpotifyApi.fromClient(FutureOr<oauth2.Client> super.client)
-      : super.fromClient();
+  SpotifyApi.fromClient(super.client) : super.fromClient();
 
   SpotifyApi.fromAuthCodeGrant(super.grant, super.responseUri)
       : super.fromAuthCodeGrant();

lib/src/spotify_base.dart

@@ -11,8 +11,11 @@ abstract class SpotifyApiBase {
 
   bool _shouldWait = false;
 
-  late FutureOr<oauth2.Client> _client;
-  FutureOr<oauth2.Client> get client => _client;
+  late SpotifyClient _spotifyClient;
+  SpotifyClient get spotifyClient => _spotifyClient;
+
+  @visibleForTesting
+  FutureOr<oauth2.Client> get client => _spotifyClient._inner;
 
   late Artists _artists;
   Artists get artists => _artists;
@@ -62,8 +65,8 @@ abstract class SpotifyApiBase {
   late Shows _shows;
   Shows get shows => _shows;
 
-  SpotifyApiBase.fromClient(FutureOr<http.BaseClient> client) {
-    _client = client as FutureOr<oauth2.Client>;
+  SpotifyApiBase.fromClient(FutureOr<oauth2.Client> client) {
+    _spotifyClient = SpotifyClient(client);
 
     _artists = Artists(this);
     _albums = Albums(this);
@@ -177,6 +180,19 @@ abstract class SpotifyApiBase {
     );
   }
 
+  /// [enable]s logging of the requests and responses on the debug console.
+  /// [loggingDetail] controls the logging verbosity. Default's set
+  /// to [LoggingDetail.simple].
+  /// If required [logger] is also possible for e.g. saving logs into a file etc.
+  void enableLogging(
+      {required bool enable,
+      LoggingDetail loggingDetail = LoggingDetail.simple,
+      SpotifyLogger? logger}) {
+    _spotifyClient.enableLogging = enable;
+    _spotifyClient.loggingDetail = loggingDetail;
+    _spotifyClient.logger = logger;
+  }
+
   /// Expands shortened spotify [url]
   Future<String> expandLink(String url) async =>
       _streamedHeadImpl(url, const {});
@@ -202,18 +218,18 @@ abstract class SpotifyApiBase {
     return await _requestWrapper(() async {
       final request = http.Request('HEAD', Uri.parse(url));
       request.headers.addAll(headers);
-      return (await _client).send(request);
+      return _spotifyClient.send(request);
     });
   }
 
   Future<String> _getImpl(String url, Map<String, String> headers) async {
-    return await _requestWrapper(() async =>
-        await (await _client).get(Uri.parse(url), headers: headers));
+    return await _requestWrapper(
+        () async => await _spotifyClient.get(Uri.parse(url), headers: headers));
   }
 
   Future<String> _postImpl(
       String url, Map<String, String> headers, dynamic body) async {
-    return await _requestWrapper(() async => await (await _client)
+    return await _requestWrapper(() async => await _spotifyClient
         .post(Uri.parse(url), headers: headers, body: body));
   }
 
@@ -223,15 +239,14 @@ abstract class SpotifyApiBase {
       final request = http.Request('DELETE', Uri.parse(url));
       request.headers.addAll(headers);
       request.body = body;
-      return await http.Response.fromStream(
-          await (await _client).send(request));
+      return await http.Response.fromStream(await _spotifyClient.send(request));
     });
   }
 
   Future<String> _putImpl(
       String url, Map<String, String> headers, dynamic body) async {
-    return await _requestWrapper(() async => await (await _client)
-        .put(Uri.parse(url), headers: headers, body: body));
+    return await _requestWrapper(() async =>
+        await _spotifyClient.put(Uri.parse(url), headers: headers, body: body));
   }
 
   // the reason we are using [http.BaseResponse] is because
@@ -267,7 +282,7 @@ abstract class SpotifyApiBase {
   }
 
   Future<SpotifyApiCredentials> getCredentials() async {
-    return SpotifyApiCredentials._fromClient(await _client);
+    return SpotifyApiCredentials._fromClient(await client);
   }
 
   String handleResponseWithBody(http.Response response) {