https://github.com/alexcrichton/cargo-vendor

Archived as subcommand is now part of Cargo itself
https://github.com/alexcrichton/cargo-vendor

Last synced: 11 days ago
JSON representation

Archived as subcommand is now part of Cargo itself

• Host: GitHub
• URL: https://github.com/alexcrichton/cargo-vendor
• Owner: alexcrichton
• License: apache-2.0
• Archived: true
• Created: 2015-08-24T20:10:07.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2019-06-21T02:42:59.000Z (over 5 years ago)
• Last Synced: 2024-08-09T14:57:37.439Z (3 months ago)
• Language: Rust
• Homepage:
• Size: 4.72 MB
• Stars: 262
• Watchers: 11
• Forks: 30
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE-APACHE

Awesome Lists containing this project

README

        
# cargo-vendor

> **Note**: This crate is moving into upstream Cargo itself. If you're on

> the nightly channel as of 2019-06-20 you don't need to install `cargo-vendor`,

> but rather `cargo vendor` just works.

>

> All future development of a `vendor` subcommand will happen [in upstream

> Cargo](https://github.com/rust-lang/cargo) itself, and issues/bugs should not

> be reported to this repository any more.

>

> In other words this project is **DEPRECATED** since it's moved into Cargo.

[![Build Status](https://travis-ci.org/alexcrichton/cargo-vendor.svg?branch=master)](https://travis-ci.org/alexcrichton/cargo-vendor)

[![Build status](https://ci.appveyor.com/api/projects/status/0sqqqnkfgw4o3cvs?svg=true)](https://ci.appveyor.com/project/alexcrichton/cargo-vendor)

This is a [Cargo](http://doc.crates.io) subcommand which

vendors all [crates.io](https://crates.io) dependencies into a local directory

using Cargo's support for [source

replacement](http://doc.crates.io/source-replacement.html).

## Installation

Currently this can be installed with:

```

$ cargo install cargo-vendor

```

You can also install [precompiled

binaries](https://github.com/alexcrichton/cargo-vendor/releases) that are

assembled on the CI for this crate.

## Example Usage

Simply run `cargo vendor` inside of any Cargo project:

```

$ cargo vendor

add this to your .cargo/config for this project:

    [source.crates-io]

    replace-with = 'vendored-sources'

    [source.vendored-sources]

    directory = '/home/alex/code/cargo-vendor/vendor'

```

This will populate the `vendor` directory which contains the source of all

crates.io dependencies. When configured, Cargo will then use this directory

instead of looking at crates.io.

Also note that the output of `cargo vendor` that should be configuration is all

on stdout (as opposed to stderr where other messages go), so you can also do:

```

$ cargo vendor > .cargo/config

```

to vendor and initialize your config in the same step!

### Flag `--no-merge-sources`

If the vendored Cargo project makes use of `[replace]` sections it can happen

that the vendoring operation fails, e.g. with an error like this:

```

found duplicate version of package `libc v0.2.43` vendored from two sources:

...

```

The flag `--no-merge-sources` should be able to solve that. Make sure to grab

the `.cargo/config` file directly from standard output since the config gets more

complicated and unpredictable.

Example:

```

$ cargo vendor --no-merge-sources > .cargo/config

```

# License

This project is licensed under either of

 * Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or

   http://www.apache.org/licenses/LICENSE-2.0)

 * MIT license ([LICENSE-MIT](LICENSE-MIT) or

   http://opensource.org/licenses/MIT)

at your option.

### Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted

for inclusion in cargo-vendor by you, as defined in the Apache-2.0 license, shall be

dual licensed as above, without any additional terms or conditions.