docs(examples): add echo example (#235)

Author: felangel

.github/workflows/examples_echo.yaml

@@ -0,0 +1,23 @@
+name: examples/echo
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+on:
+  pull_request:
+    paths:
+      - "examples/echo/routes/**"
+      - "examples/echo/lib/**"
+      - "examples/echo/test/**"
+      - ".github/workflows/examples_echo.yaml"
+    branches:
+      - main
+
+jobs:
+  build:
+    uses: VeryGoodOpenSource/very_good_workflows/.github/workflows/dart_package.yml@v1
+    with:
+      working_directory: examples/echo
+      analyze_directories: "routes test"
+      report_on: "routes"

examples/echo/.gitignore

@@ -0,0 +1,13 @@
+# See https://www.dartlang.org/guides/libraries/private-files
+
+# Files and directories created by pub
+.dart_tool/
+.packages
+pubspec.lock
+
+# Files and directories created by dart_frog
+build/
+.dart_frog
+
+# Test related files
+coverage/

examples/echo/README.md

@@ -0,0 +1,11 @@
+# echo
+
+[![style: very good analysis][very_good_analysis_badge]][very_good_analysis_link]
+[![License: MIT][license_badge]][license_link]
+
+An example echo app built with `dart_frog`.
+
+[license_badge]: https://img.shields.io/badge/license-MIT-blue.svg
+[license_link]: https://opensource.org/licenses/MIT
+[very_good_analysis_badge]: https://img.shields.io/badge/style-very_good_analysis-B22C89.svg
+[very_good_analysis_link]: https://pub.dev/packages/very_good_analysis

examples/echo/analysis_options.yaml

@@ -0,0 +1,7 @@
+include: package:very_good_analysis/analysis_options.3.0.1.yaml
+analyzer:
+  exclude:
+    - build/**
+linter:
+  rules:
+    file_names: false

examples/echo/pubspec.yaml

@@ -0,0 +1,15 @@
+name: echo
+description: An example echo app built with Dart Frog.
+version: 1.0.0+1
+publish_to: none
+
+environment:
+  sdk: ">=2.17.0 <3.0.0"
+
+dependencies:
+  dart_frog: ^0.0.1-dev
+
+dev_dependencies:
+  mocktail: ^0.3.0
+  test: ^1.19.2
+  very_good_analysis: ^3.0.1

examples/echo/routes/[message].dart

@@ -0,0 +1,5 @@
+import 'package:dart_frog/dart_frog.dart';
+
+Response onRequest(RequestContext context, String message) {
+  return Response(body: message);
+}

examples/echo/test/routes/[message]_test.dart

@@ -0,0 +1,21 @@
+import 'dart:io';
+
+import 'package:dart_frog/dart_frog.dart';
+import 'package:mocktail/mocktail.dart';
+import 'package:test/test.dart';
+
+import '../../routes/[message].dart' as route;
+
+class _MockRequestContext extends Mock implements RequestContext {}
+
+void main() {
+  group('GET /<message>', () {
+    test('responds with a 200 and echos the message.', () async {
+      const message = 'echo';
+      final context = _MockRequestContext();
+      final response = route.onRequest(context, message);
+      expect(response.statusCode, equals(HttpStatus.ok));
+      expect(response.body(), completion(equals(message)));
+    });
+  });
+}