Add app engine app to mirror html docs from chromium.googlesource.com

docs-appengine/main.go

+// Copyright 2015 The Crashpad Authors. All rights reserved.

[Mark Mentovai, 2015/10/08 18:28:03]

Ought to be in doc/appengine

[Bons, 2015/10/08 18:55:17]

Done.

+//
+// 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 crashpad mirrors crashpad documentation from Chromium’s git repo.
+package crashpad
+
+import (
+        "io"
+        "net/http"
+
+        "google.golang.org/appengine"
+        "google.golang.org/appengine/urlfetch"
+)
+
+const baseURL = "http://docs.crashpad.googlecode.com/git"
+
+func init() {
+        http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
+                ctx := appengine.NewContext(r)
+                client := urlfetch.Client(ctx)
+
+                if r.URL.Path == "/" {
+                        http.Redirect(w, r, "/doc/index.html", http.StatusSeeOther)

[Robert Sesek, 2015/10/08 18:27:27]

303 is typically used in response to a POST request. I'd use 302 (Found)
instead. MovedPermanently is a candidate, but since we'll probably change the
URL structure after we move the docs off googlecode, Found is probably a better
choice.

[Mark Mentovai, 2015/10/08 18:28:03]

This one will become just index.html.

[Bons, 2015/10/08 18:55:17]

Will update once we have the repo url

[Bons, 2015/10/08 18:55:17]

Done.

+                        return
+                }

[Mark Mentovai, 2015/10/08 18:28:03]

/man or /man/ or both should become /man/index.html too.

Or, to cover both of these, if we detect we’re getting back a directory from
git, we can tack on index.html ourselves. That’s nice and flexible, and it’ll
cover /doxygen/ too, although we don’t currently have any bare links to
/doxygen/.

[Bons, 2015/10/08 18:55:17]

ditto when we can test on the real repo url

+
+                resp, err := client.Get(baseURL + r.URL.Path)

[Robert Sesek, 2015/10/08 18:27:27]

Prevent path traversal in Path.

[Bons, 2015/10/08 18:55:17]

app engine seems to be doing this already? o_O ¯\_(ツ)_/¯ 

+                if err != nil {
+                        http.Error(w, err.Error(), http.StatusInternalServerError)
+                        return
+                }
+                defer resp.Body.Close()
+                w.Header().Set("Content-Type", resp.Header.Get("Content-Type"))
+                io.Copy(w, resp.Body)
+        })
+}