/usr/share/gocode/src/github.com/jacobsa/gcloud/httputil/path.go is in golang-github-jacobsa-gcloud-dev 0.0~git20150709-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 | // Copyright 2015 Google Inc. All Rights Reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package httputil
// Percent-encode the supplied string so that it matches the grammar laid out
// for the 'segment' category in RFC 3986.
func EncodePathSegment(s string) string {
// Scan the string once to count how many bytes must be escaped.
escapeCount := 0
for i := 0; i < len(s); i++ {
c := s[i]
if shouldEscapeForPathSegment(c) {
escapeCount++
}
}
// Fast path: is there anything to do?
if escapeCount == 0 {
return s
}
// Make a buffer that is large enough, then fill it in.
t := make([]byte, len(s)+2*escapeCount)
j := 0
for i := 0; i < len(s); i++ {
c := s[i]
// Escape if necessary.
if shouldEscapeForPathSegment(c) {
t[j] = '%'
t[j+1] = "0123456789ABCDEF"[c>>4]
t[j+2] = "0123456789ABCDEF"[c&15]
j += 3
} else {
t[j] = c
j++
}
}
return string(t)
}
func shouldEscapeForPathSegment(c byte) bool {
// According to the following sections of the RFC:
//
// http://tools.ietf.org/html/rfc3986#section-3.3
// http://tools.ietf.org/html/rfc3986#section-3.4
//
// The grammar for a segment is:
//
// segment = *pchar
// pchar = unreserved / pct-encoded / sub-delims / ":" / "@"
// unreserved = ALPHA / DIGIT / "-" / "." / "_" / "~"
// pct-encoded = "%" HEXDIG HEXDIG
// sub-delims = "!" / "$" / "&" / "'" / "(" / ")"
// / "*" / "+" / "," / ";" / "="
//
// So we need to escape everything that is not in unreserved, sub-delims, or
// ":" and "@".
// unreserved (alphanumeric)
if 'A' <= c && c <= 'Z' || 'a' <= c && c <= 'z' || '0' <= c && c <= '9' {
return false
}
switch c {
// unreserved (non-alphanumeric)
case '-', '.', '_', '~':
return false
// sub-delims
case '!', '$', '&', '\'', '(', ')', '*', '+', ',', ';', '=':
return false
// other pchars
case ':', '@':
return false
}
// Everything else must be escaped.
return true
}
|