Cargo: Can cargo specify a ref, branch, or tag for a git repository in dependencies section

[keliwang]

Since cargo support directly specify a git repository as dependency. I think specify a ref, branch, or tag for a git repository is an essential requirement.

[alexcrichton]

It can indeed!

[dependencies.foo]
git = "..."
branch = "foo"

[dependencies.foo]
git = "..."
rev = "a123456"

[dependencies.foo]
git = "..."
tag = "v0.1.0"

[keliwang]

Sorry for open this useless issue. Thanks for your reply!

[flying-sheep]

@edgarwang maybe github should offer an “official questions” feature.

or alternetively questions like this should be converted to real bugs: “please document the way cargo can specify branches, tags, or revisions in a more visible way”

[steveklabnik]

Tha'ts what Stack Overflow is for.

[BenoitJGirard]

Is it possible this features only works for GitHub repositories? It fails for me on a BitBucket repository, saying something like "Unable to update https://[email protected]/someone/project.git?branch=branchname"

Edit: I probably have a proxy problem, nevermind.

[alexcrichton]

The URL probably shouldn't include the branch name but rather explicitly specify it in Cargo.toml:

[dependencies]
foo = { git = "https://bitbucket.org/bar/foo", branch = "branch" }

[dashed]

This doesn't seem well documented on the crates website: http://doc.crates.io/manifest.html

For me, this issue is the first hit on "cargo git branch" google search keywords :)
https://www.google.ca/search?q=cargo+git+branch

[Powersource]

The feature is talked about here http://doc.crates.io/specifying-dependencies.html#specifying-dependencies-from-git-repositories

[pronebird]

I can't find a single mention about pinning to specific commits? Is this done with rev keyword?

[steveklabnik]

@pronebird please ask questions on users.rust-lang.org

(and yes, it's rev)