skipper: Index | Files

package rfc

import ""

Package rfc provides standards related functions.


Package Files

doc.go patchpath.go

func PatchPath Uses

func PatchPath(parsed, raw string) string

PatchPath attempts to patch a request path based on an interpretation of the standards RFC 2616 and RFC 3986 where the reserved characters should not be unescaped. Currently the Go stdlib does unescape these characters (v1.12.5).

It expects the parsed path as found in http.Request.URL.Path and the raw path as found in http.Request.URL.RawPath. It returns a path where characters e.g. like '/' have the escaped form of %2F, if it was detected that they are unescaped in the raw path.

It only returns the patched variant, if the only difference between the parsed and raw paths are the encoding of the chars, according to RFC 3986. If it detects any other difference between the two, it returns the original parsed path as provided. It tolerates an empty argument for the raw path, which can happen when the URL parsed via the stdlib url package, and there is no difference between the parsed and the raw path. This basically means that the following code is correct:

req.URL.Path = rfc.PatchPath(req.URL.Path, req.URL.RawPath)

Links: - and -

Package rfc is imported by 4 packages. Updated 2019-06-11. Refresh now. Tools for package owners.