Update pokeapi example to riverpod v2

.gitattributes

@@ -0,0 +1,2 @@
+*.freezed.dart linguist-generated=true
+*.g.dart linguist-generated=true

example/pokeapi_functional/README.md

@@ -4,13 +4,6 @@ A new Flutter project.
 
 ## Getting Started
 
-This project is a starting point for a Flutter application.
-
-A few resources to get you started if this is your first Flutter project:
-
-- [Lab: Write your first Flutter app](https://flutter.dev/docs/get-started/codelab)
-- [Cookbook: Useful Flutter samples](https://flutter.dev/docs/cookbook)
-
-For help getting started with Flutter, view our
-[online documentation](https://flutter.dev/docs), which offers tutorials,
-samples, guidance on mobile development, and a full API reference.
+- `flutter pub get`
+- `flutter pub run build_runner build`
+- `flutter run -d chrome`

example/pokeapi_functional/lib/api/fetch_pokemon.dart

@@ -52,3 +52,8 @@ TaskEither<String, Pokemon> fetchPokemon(int pokemonId) => TaskEither.tryCatch(
 /// All the functions are simply chained together following the principle of composability.
 TaskEither<String, Pokemon> fetchPokemonFromUserInput(String pokemonId) =>
     _validateUserPokemonId(pokemonId).flatMapTask(fetchPokemon);
+
+TaskEither<String, Pokemon> fetchRandomPokemon() => randomInt(
+      Constants.minimumPokemonId,
+      Constants.maximumPokemonId + 1,
+    ).toIOEither<String>().flatMapTask(fetchPokemon);

example/pokeapi_functional/lib/controllers/pokemon_provider.dart

@@ -1,25 +1,16 @@
 import 'package:fpdart/fpdart.dart';
-import 'package:hooks_riverpod/hooks_riverpod.dart';
-import 'package:pokeapi_functional/api/fetch_pokemon.dart';
-import 'package:pokeapi_functional/constants/constants.dart';
-import 'package:pokeapi_functional/models/pokemon.dart';
-import 'package:pokeapi_functional/unions/request_status.dart';
+import 'package:riverpod_annotation/riverpod_annotation.dart';
 
-/// Manage the [Pokemon] state using [Either] ([TaskEither]) to handle possible errors.
-///
-/// Each [RequestStatus] changes the UI displayed to the user.
-class PokemonState extends StateNotifier<RequestStatus> {
-  PokemonState() : super(const RequestStatus.initial());
+import '../api/fetch_pokemon.dart';
+import '../models/pokemon.dart';
 
-  /// Initial request, fetch random pokemon passing the pokemon id.
-  Future<Unit> fetchRandom() async => _pokemonRequest(
-        () => fetchPokemon(
-          randomInt(
-            Constants.minimumPokemonId,
-            Constants.maximumPokemonId + 1,
-          ).run(),
-        ),
-      );
+part 'pokemon_provider.g.dart';
+
+@riverpod
+class PokemonState extends _$PokemonState {
+  @override
+  FutureOr<Pokemon> build() async =>
+      fetchRandomPokemon().getOrElse((l) => throw Exception(l)).run();
 
   /// User request, try to convert user input to [int] and then
   /// request the pokemon if successful.
@@ -31,17 +22,12 @@ class PokemonState extends StateNotifier<RequestStatus> {
   Future<Unit> _pokemonRequest(
     TaskEither<String, Pokemon> Function() request,
   ) async {
-    state = RequestStatus.loading();
+    state = AsyncLoading();
     final pokemon = request();
     state = (await pokemon.run()).match(
-      (error) => RequestStatus.error(error),
-      (pokemon) => RequestStatus.success(pokemon),
+      (error) => AsyncError(error, StackTrace.current),
+      (pokemon) => AsyncData(pokemon),
     );
     return unit;
   }
 }
-
-/// Create and expose provider.
-final pokemonProvider = StateNotifierProvider<PokemonState, RequestStatus>(
-  (_) => PokemonState(),
-);

example/pokeapi_functional/lib/main.dart

@@ -1,5 +1,5 @@
 import 'package:flutter/material.dart';
-import 'package:flutter_hooks/flutter_hooks.dart';
+import 'package:flutter_hooks/flutter_hooks.dart' show useTextEditingController;
 import 'package:hooks_riverpod/hooks_riverpod.dart';
 import 'package:pokeapi_functional/controllers/pokemon_provider.dart';
 
@@ -13,14 +13,8 @@ class MyApp extends HookConsumerWidget {
   Widget build(BuildContext context, WidgetRef ref) {
     /// [TextEditingController] using hooks
     final controller = useTextEditingController();
-    final requestStatus = ref.watch(pokemonProvider);
-    useEffect(() {
-      /// Fetch the initial pokemon information (random pokemon).
-      Future.delayed(Duration.zero, () {
-        ref.read(pokemonProvider.notifier).fetchRandom();
-      });
-      return;
-    }, []);
+    final requestStatus = ref.watch(pokemonStateProvider);
+    final pokemonNotifier = ref.watch(pokemonStateProvider.notifier);
 
     return MaterialApp(
       title: 'Fpdart PokeAPI',
@@ -29,45 +23,31 @@ class MyApp extends HookConsumerWidget {
           children: [
             /// [TextField] and [ElevatedButton] to input pokemon id to fetch
             TextField(
+              textInputAction: TextInputAction.next,
+              textAlign: TextAlign.center,
               controller: controller,
               decoration: InputDecoration(
                 hintText: 'Insert pokemon id number',
               ),
             ),
             ElevatedButton(
-              onPressed: () => ref
-                  .read(
-                    pokemonProvider.notifier,
-                  )
-                  .fetch(
-                    controller.text,
-                  ),
+              onPressed: () => pokemonNotifier.fetch(controller.text),
               child: Text('Get my pokemon!'),
             ),
 
-            /// Map each [RequestStatus] to a different UI
+            /// Map each [AsyncValue] to a different UI
             requestStatus.when(
-              initial: () => Center(
-                child: Column(
-                  children: [
-                    Text('Loading intial pokemon'),
-                    CircularProgressIndicator(),
-                  ],
-                ),
-              ),
-              loading: () => Center(
-                child: CircularProgressIndicator(),
-              ),
+              loading: () => Center(child: CircularProgressIndicator()),
 
               /// When either is [Left], display error message 💥
-              error: (error) => Text(error),
+              error: (error, stackTrace) => Text(error.toString()),
 
               /// When either is [Right], display pokemon 🤩
-              success: (pokemon) => Card(
+              data: (pokemon) => Card(
                 child: Column(
                   children: [
                     Image.network(
-                      pokemon.sprites.front_default,
+                      pokemon.sprites.frontDefault,
                       width: 200,
                       height: 200,
                     ),

example/pokeapi_functional/lib/models/pokemon.dart

@@ -1,28 +1,20 @@
 import 'package:pokeapi_functional/models/sprite.dart';
+import 'package:freezed_annotation/freezed_annotation.dart';
 
-/// Pokemon information, with method to deserialize json
-class Pokemon {
-  final int id;
-  final String name;
-  final int height;
-  final int weight;
-  final Sprite sprites;
+part 'pokemon.freezed.dart';
+part 'pokemon.g.dart';
 
-  const Pokemon({
-    required this.id,
-    required this.name,
-    required this.height,
-    required this.weight,
-    required this.sprites,
-  });
+/// Pokemon information, with method to deserialize json
+@freezed
+class Pokemon with _$Pokemon {
+  const factory Pokemon({
+    required int id,
+    required String name,
+    required int height,
+    required int weight,
+    required Sprite sprites,
+  }) = _Pokemon;
 
-  static Pokemon fromJson(Map<String, dynamic> json) {
-    return Pokemon(
-      id: json['id'] as int,
-      name: json['name'] as String,
-      weight: json['weight'] as int,
-      height: json['height'] as int,
-      sprites: Sprite.fromJson(json['sprites'] as Map<String, dynamic>),
-    );
-  }
+  factory Pokemon.fromJson(Map<String, Object?> json) =>
+      _$PokemonFromJson(json);
 }