feat(dart_frog): createStaticFileHandler (#103)

Author: felangel

packages/dart_frog/lib/dart_frog.dart

@@ -11,6 +11,7 @@ export 'src/_internal.dart'
         Response,
         Router,
         serve;
+export 'src/create_static_file_handler.dart' show createStaticFileHandler;
 export 'src/handler.dart' show Handler;
 export 'src/hot_reload.dart' show hotReload;
 export 'src/http_method.dart' show HttpMethod;

packages/dart_frog/lib/src/create_static_file_handler.dart

@@ -0,0 +1,9 @@
+import 'package:dart_frog/dart_frog.dart';
+import 'package:dart_frog/src/_internal.dart';
+import 'package:shelf_static/shelf_static.dart';
+
+/// Creates a [Handler] that serves static files within provided [path].
+/// Defaults to the `public` directory.
+Handler createStaticFileHandler({String path = 'public'}) {
+  return fromShelfHandler(createStaticHandler(path));
+}

packages/dart_frog/pubspec.yaml

@@ -10,6 +10,7 @@ dependencies:
   http_methods: ^1.1.0
   shelf: ^1.1.0
   shelf_hotreload: ^1.3.0
+  shelf_static: ^1.1.1
 
 dev_dependencies:
   http: ^0.13.4

packages/dart_frog/test/src/create_static_file_handler_test.dart

@@ -0,0 +1,54 @@
+import 'dart:convert';
+import 'dart:io';
+
+import 'package:dart_frog/dart_frog.dart';
+import 'package:http/http.dart' as http;
+import 'package:path/path.dart' as path;
+import 'package:test/test.dart';
+
+void main() {
+  group('createStaticFileHandler', () {
+    test('serves static files', () async {
+      const port = 3003;
+      final tempDir = Directory.systemTemp.createTempSync();
+
+      const messageContents = 'hello world';
+      File(
+        path.join(tempDir.path, 'message.txt'),
+      ).writeAsStringSync(messageContents);
+
+      final profileContents = json.encode(
+        <String, dynamic>{'name': 'dash', 'age': 42, 'lovesDart': true},
+      );
+      File(
+        path.join(tempDir.path, 'profile.json'),
+      ).writeAsStringSync(profileContents);
+
+      final server = await serve(
+        createStaticFileHandler(path: tempDir.path),
+        'localhost',
+        port,
+      );
+
+      final messageResponse = await http.get(
+        Uri.parse('http://localhost:$port/message.txt'),
+      );
+      expect(messageResponse.statusCode, equals(HttpStatus.ok));
+      expect(messageResponse.body, equals(messageContents));
+
+      final profileResponse = await http.get(
+        Uri.parse('http://localhost:$port/profile.json'),
+      );
+      expect(profileResponse.statusCode, equals(HttpStatus.ok));
+      expect(profileResponse.body, equals(profileContents));
+
+      final notFoundResponse = await http.get(
+        Uri.parse('http://localhost:$port/not-found'),
+      );
+      expect(notFoundResponse.statusCode, equals(HttpStatus.notFound));
+
+      await server.close();
+      tempDir.delete(recursive: true).ignore();
+    });
+  });
+}