https://github.com/atridadl/loadr

A lightweight REST load testing tool with robust support for different verbs, token auth, and performance reports.
https://github.com/atridadl/loadr

go golang load-testing

Last synced: about 2 months ago
JSON representation

A lightweight REST load testing tool with robust support for different verbs, token auth, and performance reports.

• Host: GitHub
• URL: https://github.com/atridadl/loadr
• Owner: atridadl
• Created: 2024-01-14T23:13:16.000Z (12 months ago)
• Default Branch: main
• Last Pushed: 2024-01-17T08:04:31.000Z (11 months ago)
• Last Synced: 2024-01-17T17:08:54.785Z (11 months ago)
• Topics: go, golang, load-testing
• Language: Go
• Homepage:
• Size: 21.5 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Loadr

A lightweight REST load testing tool with robust support for different verbs, token auth, and performance reports.

## Example using source

1. `go run main.go -rate=20 -max=100 -url=https://api.example.com/resource -type=POST -json=./data.json -token=YourBearerTokenHere`

## Example using binary

1. go build

2. `./loadr -rate=20 -max=100 -url=https://api.example.com/resource -type=POST -json=./data.json -token=YourBearerTokenHere`

## Flags

- `-v` or `-version: Prints the version of Loadr.

- `-rate`: Number of requests per second. Default is 10.

- `-max`: Maximum number of requests to send. Must be a non-zero integer. Default is 50.

- `-url`: The URL to make requests to. Default is "https://example.com".

- `-type`: Type of HTTP request. Can be GET, POST, PUT, DELETE, etc. Default is "GET".

- `-json`: Path to the JSON file with request data. If not provided, no data is sent with the requests.

- `-token`: Bearer token for authorization. If not provided, no Authorization header is sent with the requests.

## Reports

Reports are logged at the end of a test run. They are also saved in a directory called `.reports`. All reports are saved as text files with names corresponding to the unix timestamp of when they were completed.