http-benchmarker 0.1.2

Advanced HTTP load testing tool with real-time progress monitoring and detailed performance reports.

HTTP Benchmarker

Advanced HTTP load testing tool with real-time progress monitoring and detailed performance reports.

Features

• ⚡ Asynchronous requests for high-concurrency testing
• 📊 Comprehensive metrics: RPS, latency percentiles, success rate
• 🚀 Real-time progress with TQDM integration
• 📝 Detailed error reporting with error grouping
• 💾 Automatic report generation (text/JSON)
• 📈 Statistical analysis: p50, p90, p95, p99 latency
• 🎨 Color-coded terminal output

---

Installation

From PyPI (recommended)

pip install http-benchmarker

From source (development version)

git clone https://github.com/mrasulzoda/http-benchmarker.git
cd http-benchmarker
pip install -e .

Basic Usage

Run HTTP benchmark tests from the command line using the http_benchmarker command.

Default test (100 requests, 10 concurrency)

http_benchmarker bench https://api.example.com/get

Advanced test with custom parameters

http_benchmarker bench https://api.example.com/data \
  --requests 500 \
  --concurrency 50 \
  --timeout 5

POST request with JSON data from a file

http_benchmarker bench https://api.example.com/data \
  --method POST \
  --json-file data.json

PUT request with JSON data from a file

http_benchmarker bench https://api.example.com/data \
  --method PUT \
  --json-file update.json \
  --requests 500 \
  --concurrency 50

Save results to a report file

# Save as text report
http_benchmarker bench https://api.example.com --save-report

# Save as JSON report
http_benchmarker bench https://api.example.com --save-report --json-report

Report Files

Reports are automatically saved with timestamped filenames:

• reports/http_benchmark_20250817_101533.txt

• reports/http_benchmark_20250817_101533.json

Command Options

Option	Description	Default
URL	Target URL to test	Required
-r, --requests	Total number of requests	100
-c, --concurrency	Concurrent connections	10
-t, --timeout	Request timeout (seconds)	10
-m, --method	HTTP method (GET,POST,PUT)	GET
--json-file	Path to the JSON file with the request body	None
--save-report	Save results to file	False
--json-report	Save in JSON format	False
--report-dir	Reports directory	reports

📜 License

This project uses the Creative Commons Attribution-NonCommercial 4.0 International license.

You can:

⬇️ Download and use the project

📝 Study and modify the code

↔️ Distribute original and derivative works

Under the following conditions:

👤 Attribution — You must give appropriate credit and link to the license

🚫 NonCommercial — You may not use the material for commercial purposes