docs(examples): add hello world example (#233)

Author: felangel

.github/workflows/examples_hello_world.yaml

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

examples/hello_world/.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/hello_world/README.md

@@ -0,0 +1,11 @@
+# Hello World
+
+[![style: very good analysis][very_good_analysis_badge]][very_good_analysis_link]
+[![License: MIT][license_badge]][license_link]
+
+A hello world example 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/hello_world/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/hello_world/public/favicon.ico

@@ -0,0 +1,15 @@
+name: hello_world
+description: A hello world example 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/hello_world/pubspec.yaml

@@ -0,0 +1,5 @@
+import 'package:dart_frog/dart_frog.dart';
+
+Response onRequest(RequestContext context) {
+  return Response(body: 'Welcome to Dart Frog!');
+}

examples/hello_world/routes/index.dart

@@ -0,0 +1,23 @@
+import 'dart:io';
+
+import 'package:dart_frog/dart_frog.dart';
+import 'package:mocktail/mocktail.dart';
+import 'package:test/test.dart';
+
+import '../../routes/index.dart' as route;
+
+class _MockRequestContext extends Mock implements RequestContext {}
+
+void main() {
+  group('GET /', () {
+    test('responds with a 200 and "Welcome to Dart Frog!".', () {
+      final context = _MockRequestContext();
+      final response = route.onRequest(context);
+      expect(response.statusCode, equals(HttpStatus.ok));
+      expect(
+        response.body(),
+        completion(equals('Welcome to Dart Frog!')),
+      );
+    });
+  });
+}