Update fwe samples (pt2 of 3) - Resubmission

examples/fwe/rolodex/pubspec.yaml

@@ -14,7 +14,7 @@ dependencies:
 dev_dependencies:
   flutter_test:
     sdk: flutter
-  flutter_lints: ^3.0.0
+  flutter_lints: ^6.0.0
 
 flutter:
   uses-material-design: true

examples/fwe/wikipedia_reader/README.md

@@ -0,0 +1,3 @@
+# wikipedia_reader
+
+Code excerpts for the Wikipedia reader app in the Flutter tutorial.

examples/fwe/wikipedia_reader/lib/step1_main.dart

@@ -0,0 +1,34 @@
+// ignore_for_file: unused_import
+
+// #docregion All
+import 'dart:convert';
+import 'dart:io';
+
+import 'package:flutter/material.dart';
+import 'package:http/http.dart';
+
+import 'summary.dart';
+
+// #docregion main
+void main() {
+  runApp(const MainApp());
+}
+// #enddocregion main
+
+// #docregion MainApp
+class MainApp extends StatelessWidget {
+  const MainApp({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    return MaterialApp(
+      home: Scaffold(
+        appBar: AppBar(title: const Text('Wikipedia Flutter')),
+        body: const Center(child: Text('Loading...')),
+      ),
+    );
+  }
+}
+// #enddocregion MainApp
+
+// #enddocregion All

examples/fwe/wikipedia_reader/lib/step2_main.dart

@@ -0,0 +1,44 @@
+import 'dart:convert';
+import 'dart:io';
+
+import 'package:flutter/material.dart';
+import 'package:http/http.dart';
+
+import 'summary.dart';
+
+void main() {
+  runApp(const MainApp());
+}
+
+class MainApp extends StatelessWidget {
+  const MainApp({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    return MaterialApp(
+      home: Scaffold(
+        appBar: AppBar(title: const Text('Wikipedia Flutter')),
+        body: const Center(child: Text('Loading...')),
+      ),
+    );
+  }
+}
+
+// #docregion ArticleModel
+class ArticleModel {
+  Future<Summary> getRandomArticleSummary() async {
+    final uri = Uri.https(
+      'en.wikipedia.org',
+      '/api/rest_v1/page/random/summary',
+    );
+    final response = await get(uri);
+
+    if (response.statusCode != 200) {
+      throw const HttpException('Failed to update resource');
+    }
+
+    return Summary.fromJson(jsonDecode(response.body) as Map<String, Object?>);
+  }
+}
+
+// #enddocregion ArticleModel

examples/fwe/wikipedia_reader/lib/step2a_main.dart

@@ -0,0 +1,34 @@
+// ignore_for_file: unused_import
+
+import 'dart:convert';
+import 'dart:io';
+
+import 'package:flutter/material.dart';
+import 'package:http/http.dart';
+
+import 'summary.dart';
+
+void main() {
+  runApp(const MainApp());
+}
+
+class MainApp extends StatelessWidget {
+  const MainApp({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    return MaterialApp(
+      home: Scaffold(
+        appBar: AppBar(title: const Text('Wikipedia Flutter')),
+        body: const Center(child: Text('Loading...')),
+      ),
+    );
+  }
+}
+
+// #docregion ArticleModel
+class ArticleModel {
+  // Properties and methods will be added here.
+}
+
+// #enddocregion ArticleModel

examples/fwe/wikipedia_reader/lib/step2b_main.dart

@@ -0,0 +1,43 @@
+// ignore_for_file: unused_import, unused_local_variable
+
+import 'dart:convert';
+import 'dart:io';
+
+import 'package:flutter/material.dart';
+import 'package:http/http.dart';
+
+import 'summary.dart';
+
+void main() {
+  runApp(const MainApp());
+}
+
+class MainApp extends StatelessWidget {
+  const MainApp({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    return MaterialApp(
+      home: Scaffold(
+        appBar: AppBar(title: const Text('Wikipedia Flutter')),
+        body: const Center(child: Text('Loading...')),
+      ),
+    );
+  }
+}
+
+// #docregion ArticleModel
+class ArticleModel {
+  Future<Summary> getRandomArticleSummary() async {
+    final uri = Uri.https(
+      'en.wikipedia.org',
+      '/api/rest_v1/page/random/summary',
+    );
+    final response = await get(uri);
+
+    // TODO: Add error handling and JSON parsing.
+    throw UnimplementedError();
+  }
+}
+
+// #enddocregion ArticleModel

examples/fwe/wikipedia_reader/lib/step2c_main.dart

@@ -0,0 +1,47 @@
+// ignore_for_file: unused_import
+
+import 'dart:convert';
+import 'dart:io';
+
+import 'package:flutter/material.dart';
+import 'package:http/http.dart';
+
+import 'summary.dart';
+
+void main() {
+  runApp(const MainApp());
+}
+
+class MainApp extends StatelessWidget {
+  const MainApp({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    return MaterialApp(
+      home: Scaffold(
+        appBar: AppBar(title: const Text('Wikipedia Flutter')),
+        body: const Center(child: Text('Loading...')),
+      ),
+    );
+  }
+}
+
+// #docregion ArticleModel
+class ArticleModel {
+  Future<Summary> getRandomArticleSummary() async {
+    final uri = Uri.https(
+      'en.wikipedia.org',
+      '/api/rest_v1/page/random/summary',
+    );
+    final response = await get(uri);
+
+    if (response.statusCode != 200) {
+      throw const HttpException('Failed to update resource');
+    }
+
+    // TODO: Parse JSON and return Summary.
+    throw UnimplementedError();
+  }
+}
+
+// #enddocregion ArticleModel

examples/fwe/wikipedia_reader/lib/step3_main.dart

@@ -0,0 +1,71 @@
+// ignore_for_file: unused_import
+
+import 'dart:convert';
+import 'dart:io';
+
+import 'package:flutter/material.dart';
+import 'package:http/http.dart';
+
+import 'summary.dart';
+
+void main() {
+  runApp(const MainApp());
+}
+
+class MainApp extends StatelessWidget {
+  const MainApp({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    return MaterialApp(
+      home: Scaffold(
+        appBar: AppBar(title: const Text('Wikipedia Flutter')),
+        body: const Center(child: Text('Loading...')),
+      ),
+    );
+  }
+}
+
+class ArticleModel {
+  Future<Summary> getRandomArticleSummary() async {
+    final uri = Uri.https(
+      'en.wikipedia.org',
+      '/api/rest_v1/page/random/summary',
+    );
+    final response = await get(uri);
+
+    if (response.statusCode != 200) {
+      throw const HttpException('Failed to update resource');
+    }
+
+    return Summary.fromJson(jsonDecode(response.body) as Map<String, Object?>);
+  }
+}
+
+class ArticleViewModel extends ChangeNotifier {
+  ArticleViewModel({required this.model});
+  final ArticleModel model;
+
+  Summary? _summary;
+  Summary? get summary => _summary;
+  bool _isLoading = false;
+  bool get isLoading => _isLoading;
+  Exception? _error;
+  Exception? get error => _error;
+
+  Future<void> fetchArticle() async {
+    _isLoading = true;
+    _error = null;
+    notifyListeners();
+
+    try {
+      _summary = await model.getRandomArticleSummary();
+      _error = null;
+    } on Exception catch (e) {
+      _error = e;
+    } finally {
+      _isLoading = false;
+      notifyListeners();
+    }
+  }
+}

examples/fwe/wikipedia_reader/lib/step3a_main.dart

@@ -0,0 +1,42 @@
+// ignore_for_file: unused_import
+
+import 'dart:convert';
+import 'dart:io';
+
+import 'package:flutter/material.dart';
+import 'package:http/http.dart';
+
+import 'summary.dart';
+
+void main() {
+  runApp(const MainApp());
+}
+
+class MainApp extends StatelessWidget {
+  const MainApp({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    return const MaterialApp(
+      home: Scaffold(body: Center(child: Text('Loading...'))),
+    );
+  }
+}
+
+class ArticleModel {
+  Future<Summary> getRandomArticleSummary() async {
+    return throw UnimplementedError();
+  }
+}
+
+// #docregion ArticleViewModel
+class ArticleViewModel extends ChangeNotifier {
+  final ArticleModel model;
+  Summary? summary;
+  Exception? error;
+  bool isLoading = false;
+
+  ArticleViewModel(this.model);
+}
+
+// #enddocregion ArticleViewModel

examples/fwe/wikipedia_reader/lib/step3b_main.dart

@@ -0,0 +1,32 @@
+// ignore_for_file: unused_import
+
+import 'dart:convert';
+import 'dart:io';
+
+import 'package:flutter/material.dart';
+import 'package:http/http.dart';
+
+import 'summary.dart';
+
+class ArticleModel {
+  Future<Summary> getRandomArticleSummary() async {
+    throw UnimplementedError();
+  }
+}
+
+// #docregion ArticleViewModel
+class ArticleViewModel extends ChangeNotifier {
+  final ArticleModel model;
+  Summary? summary;
+  Exception? error;
+  bool isLoading = false;
+
+  ArticleViewModel(this.model) {
+    fetchArticle();
+  }
+
+  // Methods will be added next.
+  Future<void> fetchArticle() async {}
+}
+
+// #enddocregion ArticleViewModel