cargo/README.md
2014-07-30 10:11:36 -07:00

2.3 KiB
Raw Blame History

Cargo downloads your Rust projects dependencies and compiles your project.

Learn more at http://crates.io/.

Installing cargo from nightlies

Cargo has nightlies available for use. The cargo source is not always guaranteed to compile on rust master as it may lag behind by a day or two. Nightlies, however, will run regardless of this fact!

$ triple=x86_64-unknown-linux-gnu
$ curl -O http://static.rust-lang.org/cargo-dist/cargo-nightly-$triple.tar.gz
$ tar xf cargo-nightly-$triple.tar.gz
$ ./cargo-nightly-$triple/install.sh

Nightlies are available for the following triples:

Note that if you're using the windows snapshot you will need Mingw-w64 installed as well as MSYS. The installation script needs to be run inside the MSYS shell.

Compiling cargo

Cargo can be compiled like many other standard unix-like projects:

$ git clone https://github.com/rust-lang/cargo
$ cd cargo
$ ./configure
$ make
$ make install

More options can be discovered through ./configure, such as compiling cargo for more than one target. For example, if you'd like to compile both 32 and 64 bit versions of cargo on unix you would use:

$ ./configure --target i686-unknown-linux-gnu,x86_64-unknown-linux-gnu

Contributing to the Docs

To contribute to the docs, please submit pull requests to wycats/cargo-website. All you need to do is change the markdown files in the source directory.

Reporting Issues

Found a bug? We'd love to know about it!

Please report all issues on the github issue tracker.

License

Cargo is primarily distributed under the terms of both the MIT license and the Apache License (Version 2.0).

See LICENSE-APACHE and LICENSE-MIT for details.