doc(arch): add fully featured example

2022-11-08 20:09:18 -05:00
parent db67491876
commit 6602db215f
109 changed files with 4499 additions and 29 deletions
@@ -0,0 +1,118 @@
+// Copyright (C) 2022 WYATT GROUP
+// Please see the AUTHORS file for details.
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import 'package:architecture_example/domain/data_sources/local/favorite_local_data_source.dart';
+import 'package:architecture_example/domain/data_sources/remote/album_remote_data_source.dart';
+import 'package:architecture_example/domain/data_sources/remote/photo_remote_data_source.dart';
+import 'package:architecture_example/domain/entities/album.dart';
+import 'package:architecture_example/domain/entities/photo.dart';
+import 'package:architecture_example/domain/repositories/photo_repository.dart';
+import 'package:wyatt_architecture/wyatt_architecture.dart';
+import 'package:wyatt_type_utils/wyatt_type_utils.dart';
+
+class PhotoRepositoryImpl extends PhotoRepository {
+  final PhotoRemoteDataSource _photoRemoteDataSource;
+  final AlbumRemoteDataSource _albumRemoteDataSource;
+  final FavoriteLocalDataSource _favoriteLocalDataSource;
+
+  PhotoRepositoryImpl(
+    this._photoRemoteDataSource,
+    this._albumRemoteDataSource,
+    this._favoriteLocalDataSource,
+  );
+
+  @override
+  FutureResult<void> addPhotoToFavorites(Photo photo) => Result.tryCatchAsync(
+        () => _favoriteLocalDataSource.addPhotoToFavorites(photo),
+        (error) => ClientException('Cannot add photo to favorites.'),
+      );
+
+  @override
+  FutureResult<bool> checkIfPhotoIsInFavorites(int id) => Result.tryCatchAsync(
+        () => _favoriteLocalDataSource.checkIfPhotoIsInFavorites(id),
+        (error) =>
+            ClientException('Cannot check if photo `$id` is in favorites.'),
+      );
+
+  @override
+  FutureResult<void> deletePhotoFromFavorites(int id) => Result.tryCatchAsync(
+        () => _favoriteLocalDataSource.deletePhotoFromFavorites(id),
+        (error) => ClientException('Cannot delete photo `$id` from favorites.'),
+      );
+
+  @override
+  FutureResult<Album> getAlbum(int id) => Result.tryCatchAsync(
+        () => _albumRemoteDataSource.getAlbum(id),
+        (error) => ServerException('Cannot retrieve album $id.'),
+      );
+
+  @override
+  FutureResult<List<Album>> getAllAlbums({int? start, int? limit}) =>
+      Result.tryCatchAsync(
+        () => _albumRemoteDataSource.getAllAlbums(start: start, limit: limit),
+        (error) => ServerException('Cannot retrieve all albums.'),
+      );
+
+  @override
+  FutureResult<List<Photo>> getAllPhotos({int? start, int? limit}) async =>
+      Result.tryCatchAsync(
+        () => _photoRemoteDataSource.getAllPhotos(start: start, limit: limit),
+        (error) => ServerException('Cannot retrieve all photos.'),
+      );
+
+  @override
+  FutureResult<List<Photo>> getAllPhotosFromFavorites() async {
+    try {
+      final response = <Photo>[];
+      final favorites =
+          await _favoriteLocalDataSource.getAllPhotosFromFavorites();
+      final photos = await _photoRemoteDataSource.getAllPhotos();
+
+      for (final photo in photos) {
+        if (favorites.any((favId) => photo.id == favId)) {
+          response.add(photo);
+        }
+      }
+      return Ok(response);
+    } catch (_) {
+      return Err(
+        ClientException('Cannot retrieve all photos from favorites.'),
+      );
+    }
+  }
+
+  @override
+  FutureResult<Photo> getPhoto(int id) => Result.tryCatchAsync(
+        () => _photoRemoteDataSource.getPhoto(id),
+        (error) => ServerException('Cannot retrieve photo $id.'),
+      );
+
+  @override
+  FutureResult<List<Photo>> getPhotosFromAlbum(
+    int albumId, {
+    int? start,
+    int? limit,
+  }) async =>
+      Result.tryCatchAsync(
+        () => _photoRemoteDataSource.getPhotosFromAlbum(
+          albumId,
+          start: start,
+          limit: limit,
+        ),
+        (error) =>
+            ServerException('Cannot retrieve all photos from album $albumId'),
+      );
+}