Add "Go to latest version" link for outdated docs

Closes: #57

Author: onur

src/web/mod.rs

@@ -329,6 +329,41 @@ fn render_markdown(text: &str) -> String {
 
 
 
+/// Returns latest version if required version is not the latest
+/// req_version must be an exact version
+fn latest_version(versions_json: &Json, req_version: &str) -> Option<String> {
+    let req_version = match Version::parse(req_version) {
+        Ok(v) => v,
+        Err(_) => return None,
+    };
+    let versions = {
+        let mut versions: Vec<Version> = Vec::new();
+        for version in versions_json.as_array().unwrap() {
+            let version: String = version.as_string().unwrap().to_owned();
+            let version = match Version::parse(&version) {
+                Ok(v) => v,
+                Err(_) => return None,
+            };
+            versions.push(version);
+        }
+
+        versions.sort();
+        versions.reverse();
+        versions
+    };
+
+    if req_version != versions[0] {
+        for i in 1..versions.len() {
+            if req_version == versions[i]  {
+                return Some(format!("{}", versions[0]))
+            }
+        }
+    }
+    None
+}
+
+
+
 /// Starts cratesfyi web server
 pub fn start_web_server(sock_addr: Option<&str>) {
     let cratesfyi = CratesfyiHandler::new();
@@ -441,4 +476,21 @@ mod test {
         let _ = env_logger::init();
         start_web_server(None);
     }
+
+    #[test]
+    fn test_latest_version() {
+        let json = r#"
+        [
+            "1.0.0",
+            "1.1.0",
+            "0.9.0",
+            "0.9.1"
+        ]
+        "#;
+        let json = Json::from_str(json).unwrap();
+        assert_eq!(latest_version(&json, "1.1.0"), None);
+        assert_eq!(latest_version(&json, "1.0.0"), Some("1.1.0".to_owned()));
+        assert_eq!(latest_version(&json, "0.9.0"), Some("1.1.0".to_owned()));
+        assert_eq!(latest_version(&json, "invalidversion"), None);
+    }
 }

src/web/rustdoc.rs

@@ -4,6 +4,7 @@
 use super::pool::Pool;
 use super::file::File;
 use super::MetaData;
+use super::latest_version;
 use iron::prelude::*;
 use iron::{status, Url};
 use iron::modifiers::Redirect;
@@ -180,13 +181,14 @@ pub fn rustdoc_html_server_handler(req: &mut Request) -> IronResult<Response> {
     }
 
     // content.metadata = MetaData::from_crate(&conn, &name, &version);
-    let (metadata, platforms) = {
+    let (metadata, platforms, latest_version) = {
         let rows = ctry!(conn.query("SELECT crates.name,
                                             releases.version,
                                             releases.description,
                                             releases.target_name,
                                             releases.rustdoc_status,
-                                            doc_targets
+                                            doc_targets,
+                                            crates.versions
                                      FROM releases
                                      INNER JOIN crates ON crates.id = releases.crate_id
                                      WHERE crates.name = $1 AND releases.version = $2",
@@ -200,7 +202,8 @@ pub fn rustdoc_html_server_handler(req: &mut Request) -> IronResult<Response> {
             rustdoc_status: rows.get(0).get(4),
         };
         let platforms: Json = rows.get(0).get(5);
-        (Some(metadata), platforms)
+        let versions = rows.get(0).get(6);
+        (Some(metadata), platforms, latest_version(&versions, &version))
     };
 
     content.metadata = metadata;
@@ -210,6 +213,8 @@ pub fn rustdoc_html_server_handler(req: &mut Request) -> IronResult<Response> {
         .set_true("show_package_navigation")
         .set_true("package_navigation_documentation_tab")
         .set_true("package_navigation_show_platforms_tab")
+        .set_bool("is_latest_version", latest_version.is_none())
+        .set("latest_version", &latest_version.unwrap_or(String::new()))
         .to_resp("rustdoc")
 }
 

templates/navigation_rustdoc.hbs

@@ -11,6 +11,11 @@
             <li class="pure-menu-item">
               <a href="/crate/{{name}}/{{version}}" class="pure-menu-link" title="{{description}}"><i class="fa fa-fw fa-cube"></i><span class="title"> {{name}}-{{version}}</span></a>
             </li>
+            {{#unless ../../varsb.is_latest_version}}
+            <li class="pure-menu-item">
+              <a href="/{{name}}/{{../../varss.latest_version}}" class="pure-menu-link warn" title="You are seeing an outdated version of {{name}} crate. Click here to go to latest version."><i class="fa fa-fw fa-warning"></i><span class="title"> Go to latest version</span></a>
+            </li>
+            {{/unless}}
             <li class="pure-menu-item">
               <a href="/crate/{{name}}/{{version}}/source/" title="Browse source of {{name}}-{{version}}" class="pure-menu-link{{#if ../../varsb.package_source_tab}} pure-menu-active{{/if}}"><i class="fa fa-fw fa-folder-open-o"></i><span class="title"> Source</span></a>
             </li>

templates/style.scss

@@ -154,6 +154,15 @@ div.nav-container {
         }
     }
 
+    // used for latest version warning
+    .warn {
+        color: $color-type;
+    }
+
+    .warn:hover {
+        color: darken($color-type, 10%);
+    }
+
     div.rustdoc-navigation {
         span.title {
             display: none;