Skip to content

Commit

Permalink
docs: 📝 Add Readme
Browse files Browse the repository at this point in the history
  • Loading branch information
YieldingExploiter committed May 25, 2022
1 parent 75f4e65 commit 5d932c4
Showing 1 changed file with 35 additions and 0 deletions.
35 changes: 35 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
<span align="center">

## Simple ┬─┬ Bench

[![Tests](https://github.com/AstolfoBrew/SimpleBench/actions/workflows/tests.yml/badge.svg)](https://github.com/AstolfoBrew/SimpleBench/actions/workflows/tests.yml)

A Simple Lua VM Benchmarking Library

### Notice

Scores may vary depending on the device.<br/>
Please make sure to, when comparing scores, have all scores ran on the same device.

**SimpleBench does not adjust depending on the current hardware it's being ran on.**

### Compatability

SimpleBench is compatible with Lua 5.1 and upwards.<br/>
It _should_ be compatible with LuaJIT, but thats not included in the tests.<br/>
SimpleBench _is_ compatible with Luau, and therefor _almost_ any Roblox executor.

**SimpleBench is _not_ compatible with Lua 5.0 or below**

### Pre-calculated scores

There are pre-calculated scores for [Luau](out/lua-luau.log), [Lua 5.1](out/lua-5.1.log), [Lua 5.2](out/lua-5.2.log) and [Lua 5.3](out/lua-5.3.log).

### Setting Up

1. Get a Lua Enironment
2. Download SimpleBench ([Stable](https://github.com/AstolfoBrew/SimpleBench/releases/latest) (Recommended), or [Dev Build](https://github.com/AstolfoBrew/SimpleBench/blob/main/SimpleBench.lua))
3. Run SimpleBench in Lua (ie `lua SimpleBench.lua`)
4. Look for the [Final Benchmark Score](https://github.com/AstolfoBrew/SimpleBench/blob/75f4e659bd86e26bfa5a32d3bbc1de5793161442/out/lua-5.3.log#L999) at the end of the output

</span>

0 comments on commit 5d932c4

Please sign in to comment.