Skip to content

Commit f25cece

Browse files
committed
wip
1 parent f63474b commit f25cece

File tree

1 file changed

+26
-18
lines changed

1 file changed

+26
-18
lines changed

README.md

Lines changed: 26 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -12,11 +12,11 @@
1212
<br/>
1313

1414
<p align="center">
15-
<a href="https://github.com/CodSpeedHQ/runner/releases/latest"><img src="https://img.shields.io/github/v/release/CodSpeedHQ/runner" alt="Latest Release"></a>
16-
<a href="https://github.com/CodSpeedHQ/runner/releases"><img src="https://img.shields.io/github/downloads/CodSpeedHQ/runner/total?logo=github" alt="Downloads"></a>
17-
<a href="https://github.com/CodSpeedHQ/runner/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/CodSpeedHQ/runner/ci.yml?branch=main&logo=github&label=CI" alt="CI Status"></a>
18-
<a href="https://github.com/CodSpeedHQ/runner/blob/main/LICENSE-APACHE"><img src="https://img.shields.io/github/license/CodSpeedHQ/runner" alt="License"></a>
19-
<a href="https://discord.com/invite/MxpaCfKSqF"><img src="https://img.shields.io/badge/chat%20on-discord-7289da.svg" alt="Discord Chat"></a>
15+
<a href="https://github.com/CodSpeedHQ/codspeed/releases/latest"><img src="https://img.shields.io/github/v/release/CodSpeedHQ/codspeed" alt="Latest Release"></a>
16+
<a href="https://github.com/CodSpeedHQ/codspeed/releases"><img src="https://img.shields.io/github/downloads/CodSpeedHQ/codspeed/total?logo=github" alt="Downloads"></a>
17+
<a href="https://github.com/CodSpeedHQ/codspeed/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/CodSpeedHQ/codspeed/ci.yml?branch=main&logo=github&label=CI" alt="CI Status"></a>
18+
<a href="https://github.com/CodSpeedHQ/codspeed/blob/main/LICENSE-APACHE"><img src="https://img.shields.io/github/license/CodSpeedHQ/codspeed" alt="License"></a>
19+
<a href="https://codspeed.io/discord"><img src="https://img.shields.io/badge/chat%20on-discord-7289da.svg" alt="Discord Chat"></a>
2020
<a href="https://codspeed.io/?utm_source=badge"><img src="https://img.shields.io/endpoint?url=https://codspeed.io/badge.json" alt="CodSpeed Badge"></a>
2121
</p>
2222

@@ -26,18 +26,16 @@
2626
- 🔥 **Differential flamegraphs** to pinpoint exactly what got slower, commit by commit.
2727
- 💬 **PR comments & status checks** showing performance impact directly in your workflow.
2828
- 🛡️ **Merge protection** to block PRs that degrade performance beyond your threshold.
29-
- 🐍 **Multi-language support** for Python, Rust, Node.js, Go, and C/C++.
29+
- 🐍 **Multi-language support** for Python, Rust, Node.js, Go, C/C++ and more.
3030
- 🏠 **Run locally or in CI** - works on your machine and integrates with GitHub Actions, GitLab CI, and more.
3131
- 🔌 **Plug your existing benchmarks** in less than 5 minutes - works with pytest, vitest, criterion, and more.
3232

3333
## Installation
3434

3535
```bash
36-
curl -fsSL https://codspeed.io/install.sh | sh
36+
curl -fsSL https://codspeed.io/install.sh | bash
3737
```
3838

39-
Refer to the [releases page](https://github.com/CodSpeedHQ/codspeed/releases) to see all available versions.
40-
4139
## Usage
4240

4341
> [!NOTE]
@@ -64,6 +62,25 @@ codspeed run pytest ./tests --codspeed
6462
codspeed run pnpm vitest bench
6563
```
6664

65+
## In CI environments
66+
67+
To run CodSpeed in Github Actions, we recommend using our official GitHub Action: [@CodSpeedHQ/action](https://github.com/CodSpeedHQ/action).
68+
69+
## Languages Integrations
70+
71+
On top of the generic CLI, CodSpeed provides first-class integrations for multiple languages and frameworks:
72+
73+
| Language | Repository | Supported Frameworks |
74+
| --------------- | ---------------------------------------------------------------- | ------------------------------------- |
75+
| Rust | [codspeed-rust](https://github.com/CodSpeedHQ/codspeed-rust) | `divan`, `criterion.rs`, `bencher` |
76+
| C/C++ | [codspeed-cpp](https://github.com/CodSpeedHQ/codspeed-cpp) | `google-benchmark` |
77+
| Python | [pytest-codspeed](https://github.com/CodSpeedHQ/pytest-codspeed) | `pytest` plugin |
78+
| Node.js | [codspeed-node](https://github.com/CodSpeedHQ/codspeed-node) | `vitest`, `tinybench`, `benchmark.js` |
79+
| Go | [codspeed-go](https://github.com/CodSpeedHQ/codspeed-go) | builtin `testing` package integration |
80+
| Zig (community) | [codspeed-zig](https://github.com/james-elicx/codspeed-zig) | custom |
81+
82+
Need to bench another language or framework? Open [an issue](https://github.com/CodSpeedHQ/codspeed/issues) or let us know on [Discord](https://codspeed.io/discord)!
83+
6784
## Advanced usage
6885

6986
### Installing tools before running
@@ -76,14 +93,6 @@ codspeed setup
7693

7794
This is especially useful when configuring environments with tools such as docker.
7895

79-
### Logging level
80-
81-
Use the `CODSPEED_LOG` environment variable to set the logging level:
82-
83-
```bash
84-
CODSPEED_LOG=debug codspeed run ...
85-
```
86-
8796
### Changing the mode of the runner
8897

8998
By default, the runner will run the benchmark in the `simulation` mode. You can specify the mode with the `--mode` flag of the `run` command:
@@ -97,6 +106,5 @@ codspeed run --mode walltime <my-benchmark-command>
97106
```
98107

99108
> [!WARNING]
100-
> We strongly recommend not changing this mode unless you know what you are doing.
101109
> Using the `walltime` mode on traditional VMs/Hosted Runners will lead to inconsistent data. For the best results, we recommend using CodSpeed Hosted Macro Runners, which are fine-tuned for performance measurement consistency.
102110
> Check out the [Walltime Instrument Documentation](https://docs.codspeed.io/instruments/walltime/) for more details.

0 commit comments

Comments
 (0)