feat(spec): Track git ref

Author: epage

src/cargo/core/package_id_spec.rs

@@ -115,20 +115,30 @@ impl PackageIdSpec {
         if let Some((kind_str, scheme)) = url.scheme().split_once('+') {
             match kind_str {
                 "git" => {
-                    let git_ref = GitReference::DefaultBranch;
+                    let git_ref = GitReference::from_query(url.query_pairs());
+                    url.set_query(None);
                     kind = Some(SourceKind::Git(git_ref));
                     url = strip_url_protocol(&url);
                 }
                 "registry" => {
+                    if url.query().is_some() {
+                        bail!("cannot have a query string in a pkgid: {url}")
+                    }
                     kind = Some(SourceKind::Registry);
                     url = strip_url_protocol(&url);
                 }
                 "sparse" => {
+                    if url.query().is_some() {
+                        bail!("cannot have a query string in a pkgid: {url}")
+                    }
                     kind = Some(SourceKind::SparseRegistry);
                     // Leave `sparse` as part of URL, see `SourceId::new`
                     // url = strip_url_protocol(&url);
                 }
                 "path" => {
+                    if url.query().is_some() {
+                        bail!("cannot have a query string in a pkgid: {url}")
+                    }
                     if scheme != "file" {
                         anyhow::bail!("`path+{scheme}` is unsupported; `path+file` and `file` schemes are supported");
                     }
@@ -137,10 +147,10 @@ impl PackageIdSpec {
                 }
                 kind => anyhow::bail!("unsupported source protocol: {kind}"),
             }
-        }
-
-        if url.query().is_some() {
-            bail!("cannot have a query string in a pkgid: {}", url)
+        } else {
+            if url.query().is_some() {
+                bail!("cannot have a query string in a pkgid: {url}")
+            }
         }
 
         let frag = url.fragment().map(|s| s.to_owned());
@@ -347,6 +357,11 @@ impl fmt::Display for PackageIdSpec {
                     write!(f, "{protocol}+")?;
                 }
                 write!(f, "{}", url)?;
+                if let Some(SourceKind::Git(git_ref)) = self.kind.as_ref() {
+                    if let Some(pretty) = git_ref.pretty_ref(true) {
+                        write!(f, "?{}", pretty)?;
+                    }
+                }
                 if url.path_segments().unwrap().next_back().unwrap() != &*self.name {
                     printed_name = true;
                     write!(f, "#{}", self.name)?;
@@ -625,6 +640,16 @@ mod tests {
             },
             "git+ssh://[email protected]/rust-lang/regex.git#[email protected]",
         );
+        ok(
+            "git+ssh://[email protected]/rust-lang/regex.git?branch=dev#[email protected]",
+            PackageIdSpec {
+                name: String::from("regex"),
+                version: Some("1.4.3".parse().unwrap()),
+                url: Some(Url::parse("ssh://[email protected]/rust-lang/regex.git").unwrap()),
+                kind: Some(SourceKind::Git(GitReference::Branch("dev".to_owned()))),
+            },
+            "git+ssh://[email protected]/rust-lang/regex.git?branch=dev#[email protected]",
+        );
         ok(
             "file:///path/to/my/project/foo",
             PackageIdSpec {
@@ -670,6 +695,18 @@ mod tests {
             PackageIdSpec::parse("foobar+https://github.com/rust-lang/crates.io-index").is_err()
         );
         assert!(PackageIdSpec::parse("path+https://github.com/rust-lang/crates.io-index").is_err());
+
+        // Only `git+` can use `?`
+        assert!(PackageIdSpec::parse("file:///path/to/my/project/foo?branch=dev").is_err());
+        assert!(PackageIdSpec::parse("path+file:///path/to/my/project/foo?branch=dev").is_err());
+        assert!(PackageIdSpec::parse(
+            "registry+https://github.com/rust-lang/cargo#0.52.0?branch=dev"
+        )
+        .is_err());
+        assert!(PackageIdSpec::parse(
+            "sparse+https://github.com/rust-lang/cargo#0.52.0?branch=dev"
+        )
+        .is_err());
     }
 
     #[test]

src/doc/src/reference/pkgid-spec.md

@@ -22,7 +22,8 @@ The formal grammar for a Package Id Specification is:
 
 ```notrust
 spec := pkgname |
-        [ kind "+" ] proto "://" hostname-and-path [ "#" ( pkgname | semver ) ]
+        [ kind "+" ] proto "://" hostname-and-path [ "?" query] [ "#" ( pkgname | semver ) ]
+query = ( "branch" | "tag" | "rev" ) "=" ref
 pkgname := name [ ("@" | ":" ) semver ]
 semver := digits [ "." digits [ "." digits [ "-" prerelease ] [ "+" build ]]]
 
@@ -56,6 +57,7 @@ The following are some examples of specs for several different git dependencies:
 | `https://github.com/rust-lang/cargo#[email protected]`  | <nobr>`cargo-platform`</nobr> | `0.1.2`  |
 | `ssh://[email protected]/rust-lang/regex.git#[email protected]`     | `regex`          | `1.4.3`  |
 | `git+ssh://[email protected]/rust-lang/regex.git#[email protected]` | `regex`          | `1.4.3`  |
+| `git+ssh://[email protected]/rust-lang/regex.git?branch=dev#[email protected]` | `regex`          | `1.4.3`  |
 
 Local packages on the filesystem can use `file://` URLs to reference them:
 

tests/testsuite/pkgid.rs

@@ -277,8 +277,8 @@ foo v0.1.0 ([..]/foo)
             "\
 error: There are multiple `xyz` packages in your project, and the specification `xyz` is ambiguous.
 Please re-run this command with one of the following specifications:
-  git+file://[..]/xyz#0.5.0
-  git+file://[..]/xyz#0.5.0
+  git+file://[..]/xyz?rev=[..]#0.5.0
+  git+file://[..]/xyz?rev=[..]#0.5.0
 ",
         )
         .run();