Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ChrisMacNaughton/cargo-cacher
A caching server for crates + cargo
https://github.com/ChrisMacNaughton/cargo-cacher
Last synced: 2 months ago
JSON representation
A caching server for crates + cargo
- Host: GitHub
- URL: https://github.com/ChrisMacNaughton/cargo-cacher
- Owner: ChrisMacNaughton
- License: mit
- Created: 2016-10-20T18:35:43.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2020-07-01T07:12:00.000Z (over 4 years ago)
- Last Synced: 2024-05-01T22:16:55.514Z (9 months ago)
- Language: Rust
- Size: 151 KB
- Stars: 122
- Watchers: 6
- Forks: 15
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE-MIT
Awesome Lists containing this project
README
# cargo-cacher
[](https://travis-ci.org/ChrisMacNaughton/cargo-cacher)[](https://coveralls.io/github/ChrisMacNaughton/cargo-cacher?branch=master)
`cargo-cacher` is a caching server in the same spirit as apt-cacher-ng. The goal is to allow recursive caching of the canonical crates.io index.
## Usage
To configure your system to use a copy of cargo-cacher, you need to setup a .cargo/config file in your project, or in a containing folder. The contents of that folder should look like:
```toml
[source]
[source.mirror]
registry = "http://localhost:8080/index"
[source.crates-io]
replace-with = "mirror"
```
Once this is in place, your builds will go through the local proxy, and the crates will be pulled down to the local filesystem when they are first requested. The path can be a remote host as long as the path is to /index. To run cargo-cacher, there are several arguments you probably want to use:
```
USAGE:
cargo-cacher [FLAGS] [OPTIONS]
FLAGS:
-a, --all Prefetch entire Cargo index
-d Sets the level of debugging information
-h, --help Prints help information
-V, --version Prints version information
OPTIONS:
-g Upstream git index (Default: https://github.com/rust-lang/crates.io-index.git)
-i Path to store the indexes (git and fiels) at (Default: $HOME/.crates)
-p Port to listen on (Default: 8080)
-f Path with a list of crate_name=version OR lock file to pre-fetch
-r Refresh rate for the git index (Default: 600)
-t How many threads to use to fetch crates in the background
-u Upstream Crate source (Default: https://crates.io/api/v1/crates/)
```
## Full mirror
cargo-cacher supports providing a full mirror with the `-a` flag. Passing this flag will create a background thread pool on startup that will fetch all crates currently in the upstream index.
## Prefetch
Prefetch is an option that I feel deserves further attention. Prefetch is a path to a file containing one line per crate/version, example:
```
log=0.3.6
libc=0.1.12
```
The above input will fetch log version 0.3.6 and libc version 0.1.12 before being requested by a user. This happens on a separate thread so the server can continue to start up without waiting on the pre-fetching to complete.
## TODO
- Add expiration on background thread
- Add statistics
If you would like to support me:
- [Gratipay](https://gratipay.com/~IceyEC/)
- [Bountysource](https://www.bountysource.com/teams/iceyec)