extension

sjkingo · sjkingo · commit e98f1b5d287e · 2015-06-23T11:51:29.000+10:00
diff --git a/README.md b/README.md
@@ -0,0 +1,18 @@
+# Python Docs Version Switcher extension
+
+This is an extension for Google Chrome that allows you to persistently set the
+version on `docs.python.org` to use. For instance, setting it to `3.5` and then
+browsing to the docs for `2.7` will automatically redirect you to the version
+you specified.
+
+## Installation
+
+Simply download the extension (version 1.0) and run it in chrome:
+
+```bash
+$ google-chome python_docs_version_switcher.crx
+```
+
+No warranty is given - use at your own risk!
+
+Tested on Google Chrome 44 beta (Linux) but should work anywhere.
diff --git a/python_docs_version_switcher/assets/jquery-2.1.4.min.js b/python_docs_version_switcher/assets/jquery-2.1.4.min.js
diff --git a/python_docs_version_switcher/assets/popup.html b/python_docs_version_switcher/assets/popup.html
@@ -0,0 +1,28 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+    <title>Python Docs Version Switcher</title>
+    <style>
+    body {
+        font-family: "Segoe UI", "Lucida Grande", Tahoma, sans-serif;
+        font-size: 0.8em;
+    }
+    h1 {
+        font-size: 1.4em;
+    }
+    div.wrapper {
+        min-width: 300px;
+        max-width: 400px;
+    }
+    </style>
+</head>
+<body>
+    <div class="wrapper">
+        <h1>Python Docs Version Switcher</h1>
+        <p>Change version by clicking <a href="https://docs.python.org/" target="_blank">here</a> and selecting a version in the top-left.</p>
+    </div>
+</body>
+
+</html>
+
diff --git a/python_docs_version_switcher/assets/python-128x.png b/python_docs_version_switcher/assets/python-128x.png
diff --git a/python_docs_version_switcher/assets/version_switcher.js b/python_docs_version_switcher/assets/version_switcher.js
@@ -0,0 +1,37 @@
+var url_pattern = new RegExp("docs.python.org/([.0-9]+)/*");
+var change_selector = "span.version_switcher_placeholder select";
+var storage_key = "preferred_version";
+
+/* Set version of docs from dropdown to local storage and return the
+ * new value.
+ */
+function setVersionToStorage()
+{
+    var v = $(change_selector).val();
+    localStorage.setItem(storage_key, v);
+    return v;
+}
+
+(function() {
+    var preferred_version, match;
+    
+    /* Pick up previously set version, or if we haven't set one yet, whatever
+     * Python redirects us to.
+     */
+    preferred_version = localStorage.getItem("preferred_version");
+    if (!preferred_version) {
+        preferred_version = setVersionToStorage();
+    }
+
+    /* Handle changing the version with the version dropdown box */
+    $(change_selector).change(function() {
+        preferred_version = setVersionToStorage();
+    });
+
+    /* Check if we are on a non-preferred version of the docs and redirect */
+    match = url_pattern.exec(window.location);
+    if (match && match[1] != preferred_version) {
+        var new_url = window.location.href.replace(match[1], preferred_version);
+        window.location.replace(new_url);
+    }
+}).call(this);
diff --git a/python_docs_version_switcher/manifest.json b/python_docs_version_switcher/manifest.json
@@ -0,0 +1,18 @@
+{
+    "manifest_version": 2,
+    "name": "Python Docs Version Switcher",
+    "description": "A version switcher for the docs.python.org site",
+    "version": "1.0",
+    "icons": {
+        "128": "assets/python-128x.png"
+    },
+    "browser_action": {
+        "default_popup": "assets/popup.html"
+    },
+    "content_scripts": [
+        {
+            "matches": ["https://docs.python.org/*"],
+            "js": ["assets/jquery-2.1.4.min.js", "assets/version_switcher.js"]
+        }
+    ]
+}
