Add Response.unauthorized (401) constructor (#262)

Author: develogo

pkgs/shelf/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 1.4.0-dev
+
+* Add Response.unauthorized() constructor
+
 ## 1.3.2
 
 * `shelf_io.dart`

pkgs/shelf/lib/src/response.dart

@@ -180,6 +180,25 @@ class Response extends Message {
           encoding: encoding,
         );
 
+  /// Constructs a 401 Unauthorized response.
+  ///
+  /// This indicates indicates that the client request has not been completed
+  /// because it lacks valid authentication credentials.
+  ///
+  /// {@macro shelf_response_body_and_encoding_param}
+  Response.unauthorized(
+    Object? body, {
+    Map<String, /* String | List<String> */ Object>? headers,
+    Encoding? encoding,
+    Map<String, Object>? context,
+  }) : this(
+          401,
+          headers: body == null ? _adjustErrorHeaders(headers) : headers,
+          body: body ?? 'Unauthorized',
+          context: context,
+          encoding: encoding,
+        );
+
   /// Constructs a 403 Forbidden response.
   ///
   /// This indicates that the server is refusing to fulfill the request.

pkgs/shelf/pubspec.yaml

@@ -1,5 +1,5 @@
 name: shelf
-version: 1.3.2
+version: 1.4.0-dev
 description: >
   A model for web server middleware that encourages composition and easy reuse.
 repository: https://github.com/dart-lang/shelf/tree/master/pkgs/shelf

pkgs/shelf/test/response_test.dart

@@ -106,6 +106,15 @@ void main() {
     });
   });
 
+  group('Response.unauthorized:', () {
+    test('sets body', () {
+      var response = Response.unauthorized('request unauthorized');
+      expect(
+          response.readAsString(), completion(equals('request unauthorized')));
+      expect(response.statusCode, 401);
+    });
+  });
+
   group('Response redirect', () {
     test('sets the location header for a String', () {
       var response = Response.found('/foo');