Skip to content
Run experiments across parts of the Rust ecosystem!
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
assets results: rename build-fail:broken to broken:CATEGORY Mar 12, 2019
ci
docs Auto merge of #404 - pietroalbini:recognize-try-builds, r=pietroalbini Mar 6, 2019
local-crates
src allow clippy::redundant_closure lint Apr 14, 2019
templates
tests
.appveyor.yml
.gitattributes Initial Oct 19, 2016
.gitignore
.travis.yml
CONTRIBUTING.md
Cargo.lock allow clippy::redundant_closure lint Apr 14, 2019
Cargo.toml Use rust libraries instead of OpenSSL for HMAC Feb 18, 2019
README.md minicrater: add some docs about it Jan 11, 2019
blacklist.md
build.rs
config.toml
find-bad-crates.py
rustfmt.toml
todo.md Allow capping lints with define-ex's --cap-lints Apr 2, 2018
tokens.example.toml

README.md

Crater Build Status

Crater is a tool to run experiments across parts of the Rust ecosystem. Its primary purpose is to detect regressions in the Rust compiler, and it does this by building large number of crates, running their test suites and comparing the results between two versions of the Rust compiler.

It can operate locally (with Docker as the only dependency) or distributed on the cloud. It only works on Linux at the moment, and it's licensed under both the MIT and Apache 2.0 licenses.

The current features of Crater are:

  • Discover Rust codebases on crates.io and GitHub
  • Execute experiments on custom Rust toolchains
  • Run cargo build and cargo test over all the discovered codebases
  • Build and test without dependency updates or network access
  • Run arbitrary tests over all the discovered codebases
  • Generate HTML reports with results and logs
  • Isolate tests in Docker containers

Crater is a successor to taskcluster-crater. It was subsequently named cargobomb before resuming the Crater name.

⚠️ DO NOT RUN CRATER IN AN UNSANDBOXED ENVIRONMENT ⚠️
Crater executes malicious code that will destroy what you love.

Documentation

Want to contribute to Crater? Check out the contribution guide.

User documentation:

Operations documentation:

Technical documentation:

You can’t perform that action at this time.