crate-race

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 16 Open GitHub ↗

Comparing Rust crate function speeds

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Crate Race
Wondering which crate can do some functionality faster?

Crate race feeds the same kind of inputs into crate functions, and benchmarks the results.

[Check out a list of functions here](benches).

Each benchmark comes with the actual code used to run each of the functions.

You can look through the code to judge which crate to use.

## Forewarning

Just because one crate has a faster speed for a specific function, does not automatically make that crate "better".

Other crates may specialize in other forms of functionality. Other crates may also be more user friendly to use.

Try not to generalize after just looking at one benchmark.

## Benchmarking Machine Specs

* Operating System: Windows 7 Ultimate
* Processor: [Intel Core i5-6600 Processor](https://en.wikichip.org/wiki/intel/core_i5/i5-6600) quad-core 64-bit x86, 3.3 GHz base frequency.
* Motherboard: [Gigabyte LGA1151 Intel B150 Micro ATX](https://www.amazon.com/gp/product/B017WL3V4Q/)
* RAM: [GeIL EVO POTENZA 16GB DDR4 SDRAM](https://www.amazon.com/gp/product/B01EWBFZSE) DDR4 2400 (PC4 19200)
* Graphics Card: [EVGA GeForce GTX 960](https://www.amazon.com/gp/product/B01BX3FAWU/) 4GB ACX 2.0+
* Hard Drive: [Seagate 3TB Desktop HDD SATA 6Gb/s 64MB Cache](https://www.amazon.com/gp/product/B005T3GRLY/)

## Rust and Crate Updates
All of the benchmarks here are automatically generated.

Every day Crate Race checks for new version of Rust or Crates.

If an update is detected, Crate Race will rerun the benchmarks test and update github.

## Limitations
### Only Shared functions
Crate Race will not benchmark every single crate's unique functions.

It will only benchmark functions that match other crates' functions.

If a crate has an extra function that other crates do not have, Crate Race will not benchmark it.

### Correctness checking
Although Crate Race checks that the function returned a correct value expected for that function, it will not test the functions' edge cases being handled correctly.

We are benchmarking, not QAing.

### Benchmark code isn't idiomatic
Benchmark code is meant to be as short and quick to write as possible.

The input and outputs are the same all the time.

If they ever change, the code is meant to panic. The panic will be caught by crate-race.

As a result, it is completely fine to do `unwrap`() everywhere without any further checking.

## Contributing / Communication / Suggestions

Have some code you want to add to the benchmark? Feel free to make pull request. Follow the [contributing guidelines](CONTRIBUTING.md).

Don't have code, but have a suggestion of a crate or functionality you want tested?

Write about it here: https://www.reddit.com/r/crate_race/ - I'll be judging what to add in based on how many votes it gets.

crate-race

Today's picks

Was this content helpful?

Recent Feedback

crate-race

Today's picks

Was this content helpful?

Recent Feedback

Download README