# cargo-download

[![crates.io](https://img.shields.io/crates/v/cargo-download.svg)](https://crates.io/crates/cargo-download)
[![Build Status](https://travis-ci.org/Xion/cargo-download.svg?branch=master)](https://travis-ci.org/Xion/cargo-download)

A cargo subcommand for downloading crates from _crates.io_

## About

`cargo-download` can be used to download a gzipped archive of given crate,
in the exact form that it was uploaded to _crates.io_.

This can be useful for a variety of things, such as:

* checking in your dependencies in source control (if your team/organization follows this practice)
* mirroring _crates.io_ for reproducible CI/CD pipelines
* security auditing of crates (esp. when a crate repository is missing)
* reproducing a bug that only occurs in uploaded versions of your crate

## Installation

`cargo-download` can be installed with `cargo install`:

    $ cargo install cargo-download

This shall put the `cargo-download` executable in your Cargo binary directory
(e.g. `~/.cargo/bin`), which hopefully is in your `$PATH`.

## Usage

To download the newest version of `foo` crate, do this:

    $ cargo download foo >foo.gz

You can also use the standard _Cargo.toml_ notation to specify a particular version:

    $ cargo download foo==0.9 >foo-0.9.gz

For more detailed usage instructions, run `cargo download --help`.

## License

`cargo-download` is licensed under the terms of the MIT license.