pkg/shelf: added `url` and `scriptName` named params to Request.change

pkg/shelf/lib/src/request.dart

Index: pkg/shelf/lib/src/request.dart
diff --git a/pkg/shelf/lib/src/request.dart b/pkg/shelf/lib/src/request.dart
index 4a08468750a1d6a37f8a01fe2fdaa44984fefcbe..052cc34f69f8ee7a17cf5445a392525479773015 100644
--- a/pkg/shelf/lib/src/request.dart
+++ b/pkg/shelf/lib/src/request.dart
@@ -134,6 +134,8 @@ class Request extends Message {
       throw new ArgumentError('requstedUri must be an absolute URI.');
     }
 
+    // TODO(kevmoo) if defined, check that scriptName is a fully-encoded, valid
+    // path component
     if (this.scriptName.isNotEmpty && !this.scriptName.startsWith('/')) {
       throw new ArgumentError('scriptName must be empty or start with "/".');
     }
@@ -168,13 +170,34 @@ class Request extends Message {
   ///
   /// All other context and header values from the [Request] will be included
   /// in the copied [Request] unchanged.
-  Request change({Map<String, String> headers, Map<String, Object> context}) {
+  ///
+  /// If [scriptName] is provided without [url], the corresponding path
+  /// component of [Request.url] is replaced in the new instance. In this case,
+  /// [scriptName] must match the beginning of the existing `path` component of
+  /// [Request.url] or an [ArgumentError] is thrown.

[nweiz, 2014/05/22 19:50:42]

This paragraph is confusing. I suggest: "If [scriptName] is provided and [url]
is not, [scriptName] must be a prefix of [this.url]. [url] will default to
[this.url] with this prefix removed."

It would also be nice to explain the purpose of this. Maybe "This allows routing
middleware to easily mount handlers under specific URLs."

[kevmoo, 2014/05/22 20:38:36]

Done.

[nweiz, 2014/05/23 21:43:34]

You didn't include any explanation of the purpose. Was that intentional?

+  Request change({Map<String, String> headers, Map<String, Object> context,
+    String scriptName, Uri url}) {
     headers = updateMap(this.headers, headers);
     context = updateMap(this.context, context);
 
+    if (scriptName != null && url == null) {
+      var path = this.url.path;
+      if (path.startsWith(scriptName)) {
+        path = path.substring(scriptName.length);
+        url = new Uri(path: path, query: this.url.query);
+      } else {
+        throw new ArgumentError('If scriptName is provided without url, it must'
+            ' match the beginning of the existing url path.');

[nweiz, 2014/05/22 19:50:42]

"match the beginning" -> "be a prefix"

[kevmoo, 2014/05/22 20:38:36]

Done.

+      }
+    }
+
+    if (url == null) url = this.url;
+

[nweiz, 2014/05/22 19:50:42]

Nit: I'd remove this newline.

[kevmoo, 2014/05/22 20:38:36]

Done.

+    if (scriptName == null) scriptName = this.scriptName;
+
     return new Request(this.method, this.requestedUri,
-        protocolVersion: this.protocolVersion, headers: headers, url: this.url,
-        scriptName: this.scriptName, body: this.read(), context: context);
+        protocolVersion: this.protocolVersion, headers: headers, url: url,
+        scriptName: scriptName, body: this.read(), context: context);
   }
 
   /// Takes control of the underlying request socket.
@@ -233,8 +256,7 @@ class _OnHijack {
 /// [ArgumentError].
 Uri _computeUrl(Uri requestedUri, Uri url, String scriptName) {
   if (url == null && scriptName == null) {
-    return new Uri(path: requestedUri.path, query: requestedUri.query,
-        fragment: requestedUri.fragment);
+    return new Uri(path: requestedUri.path, query: requestedUri.query);
   }
 
   if (url != null && scriptName != null) {